Skip to content

Conversation system

Alessio Gravili edited this page Dec 8, 2021 · 17 revisions

NotQuests has a very extensive and flexible conversation system integrated. With it, you can create and add remarkable conversations to both Citizens NPCs or Armor Stands (or basically anything else via commands).

The learning curve for creating conversations is steeper compared to learning other features NotQuests offers. That's mainly because the majority of the conversation cannot be created using commands (I'll add that in the future).

That means that you will have to edit conversation files to create your conversation. Each conversation = one .yml file. But don't worry! There are some commands to assist you.

Creating our first conversation

Of course, you can create the conversation file yourself by going to the plugins/NotQuests/conversations folder - but I added a helpful command which creates the initial template for you:

/qa conversations create [name]. Make sure [name] contains no spaces. For our first conversation, however, let's use this command:

/qa conversations create [name] --demo By adding the --demo flag at the end of the command, it won't just create a conversation file with the blank template - it will also fill it with a demo conversation.

Editing our first conversation

Head to the plugins/NotQuests/conversations folder and open the respective [name].yml file which the create command should have created for you.

Since you used the --demo flag, it should be filled with a demo conversation.

In-game, you can already “start” the conversation by using /qa conversations start/play [name]. Now it's up to you:

Try to understand the conversation file and how it works by comparing it with the result in-game. Make some changes and see what happens in-game. Note that after each change, you have to re-load it in-game by using /qa reload conversations.

I know that "Learn it yourself" approach isn't that easy - I'm still preparing a proper guide which explains everything for you.

Fancy conversations with chat packets

I have added an amazing, unique system which deletes previous conversations from the chat by catching the chat packets the server sends to the client and “restoring” the old chat. This makes the player experience a LOT better, and currently no other conversation plugin offers it.

However, it's currently disabled as that system is still in "beta" and not 100% tested yet (it could crash your server if you are very unlucky). If you want to try it out, head to plugins/NotQuests/general.yml and enable both packet options (set them to true). Then, restart your server (/qa reload won't do it) and enjoy!

Clone this wiki locally