How to add a basic Conversationalist NPC with dialogue

Discussion in 'Ink NPC Dialogue Composition' started by Anpu, Jan 1, 2021.

  1. Anpu

    Anpu Bug Hunter

    Likes Received:
    Trophy Points:
    Pacific Northwest
    This will be a very easy to understand basic guide to add a Conversationalist NPC's with a custom script that you can now use in the game. This guide will just go over the very basics and explain these step by step. I only have a Windows PC and can only cover that type of computer at this time.

    1 - Craft or Purchase a Conversationalist NPC
    Currently you can craft 2 different Conversationalist NPC's from recipes from a NPC in the town of Xenos or purchase ones on the Crown Shop.
    Speak to Isabeau D'Anjou in the town of Xenos. She is a Housing Decorations Merchant that can be found in Xenos, upstairs from the bank. The recipes cost around 100 gold each and will require an Alchemy Skill of 70 to create them. These are the Conversationalist, Beggar Male 1 and the Conversationalist, Beggar Female 1.

    You will then also need a lot that you own or have access too, and enough NPC space on the lot. For example, even the free taxed no trade player owned town row lot deed you can get allows up to 2 NPC's on the lot! Just make sure first you do have 1 NPC slot available on the lot you are wanting to place this Conversationalist NPC.

    2 - Custom NPC Folder
    First, you will need to know where the Data Folder is for Shroud of the Avatar. Load up the game, and in the Chat Window type the command /datafolder and then press enter. A window will now open to the Data Folder that Shroud of the Avatar uses:


    If you do not see a directory here named Custom NPC you will need to create one:

    Right click anywhere on the screen and then select New > Folder option.
    This will create a new folder now on the screen highlighted in blue. Name the folder Custom NPC so it looks like this:


    You now have the directory the game will default to when looking for scripts for NPC's!

    We will now add a quick shortcut to find this Custom NPC folder very quickly! Left click and highlight the Custom NPC folder. Now right click on it and select the Pin to Quick Access option. You will now always see see this directory any time when using any programs or viewing folders!


    3 - A Basic NPC Script File
    Open the Notepad app for Windows, and leave that open as we will need it in a minute.
    I have provided a very basic NPC script that you can alter easily to fit for you. For this specific example, all of the keywords will go away one you speak about them on the Conversationalist. In the window below, copy all the text below and then right click on your mouse and select Copy.
    Greetings! My name is NPCNAME and this is our place that I share with YOURNAME. I can answer any questions if you wish?
    *What do you do?
    *Who is YOURNAME?
    *Where am I?
    *Can I help you with anything?
    I help around here where I can and keep the place all tidy!
    YOURNAME? Why they are one of the most powerful Avatars in all of New Britannia! Well, at least they seem so to me.
    Why, this is the wonderful town of TOWNNAME you are in! Do feel free to look around the town.
    Oh I need no help at this time, but thank you. But I do recall hearing about a Seer in the town of Noreach, at the docks there, was looking for some help. Perhaps you could go speak and help them?
    +I have another question
    Noreach is a town located North in the Paladis Region.
    Fare Thee Well and good luck to you!
    Go back to Notepad and select the Edit > Paste option to place all of this basic script there. Check and make sure you DID copy and paste all of the text correctly posted above.

    In this script I used a number of words in all capital letters. Change all these to fit your character:
    NPCNAME change to the name of this Conversationalist NPC's name.
    YOURNAME change this to your Avatars name.
    TOWNNAME change this to the town you are placing this Conversationalist NPC at.
    Here is what this script looks like for me:


    In Notepad, click the File and Save As option. At the left side of this window, under Quick access, select the Custom NPC directory. You will need to change one option:


    In the Save as type select the drop down box so it has the All Files (*.*) option.
    And in the File Name type and then click the Save button.

    Now go back to the datafolder window and select the Custom NPC directory. At the top of the folder view is a View tab and several options. You will need to select the View tab, then have the option File name extensions option selected, if it isn't already:


    Now your Custom NPC directory should look like this:


    Just make sure that any conversation script you might want to use always has the .ink at the end of the name of the file!

    OK! Now pat yourself on the back! Grab a beverage refreshment of your choice and celebrate, because most all the hard work is over!!! :D

    4 - Adding the Custom Script to your Conversationalist NPC

    You now will need to load up the game and have any of the conversationalist NPC's you will be using in your players inventory. Right click on the Conversationalist NPC in your inventory and select the Edit Dialogue option. A new Window will appear. At the bottom of this window click the green Import Content button. The window will now look like this:


    Select the file.

    Of note, see that number at the bottom left? This shows the count of how many characters are in your current custom NPC script. Every single character in a custom NPC script counts, even spaces! So do make sure to check that when you decide to play around with other custom NPC scripts!

    Of note, the craftable NPC's currently in the game have a limit of ONLY 2000 characters.

    The Crown store Conversationalist NPC's have a much higher limit.

    Now click the green Import button. The window will now display the code we just imported. Now click the red X at the top right of the window to close it.

    That's it! Your NPC now has a custom script attached to it!

    Now just place that Conversationalist NPC somewhere on a lot you own or have access to and wait a few moments for the character to load. And then speak to them.

    And that is it! Hopefully this was very easy to understand, for basically anyone to be able to add one to your own lot. Just let me know if I just didn't explain something very clearly!

    The script I provided is really basic, and does a easy example of some very basic options. Now feel free to now start editing that basic Custom NPC script and feel free to experiment! But on THAT, you will now be on your own......

    Give the Ink NPC Dialogue Composition forum a look for further examples (like Merrik's Conversationalist, A Tutorial) for some more basic information, or start your own thread!

    Information for this post was from Release 85, build 1329.
    All of the content in this post can be freely used or copied by anyone with my permission. Feel free to add this to any of your guides if you wish!
    Last edited: Jan 2, 2021
  2. Lilith Ayin

    Lilith Ayin Avatar

    Likes Received:
    Trophy Points:
    Lightbringer Isle
    A simple and very useful guide, thank you very much!
    Wilfred and Anpu like this.
  3. Koimiko

    Koimiko Avatar

    Likes Received:
    Trophy Points:
    A Dark Cave
    WOW thanks so much, you made it so simple
    Wilfred likes this.
  4. majoria70

    majoria70 Avatar

    Likes Received:
    Trophy Points:
    United States
    Thank you Anpu. You did a great job explaining.
    Wilfred, Anpu and Elgarion like this.