NPGuys
NPGuys is an Citizens extension that brings NPC interaction to a whole new level...
Overview
NPGuys (Non-Player Guys) - the most anticipated (by me, at least) RPG plugin - has finally arrived! At first it was created for polish server at Ragecraft.pl, it has been rewritten twice so far, but at last, after over one-and-half year I release this masterpiece to public. Now you can easly create complex conversation trees and enjoy talking with NPCs, using smart, scoreboard-based UI. Don't forget to donate.
Features
- You can actually talk with NPCs! I mean, seriously, it's just like in the RPG games! Wow! (see: screenshots)
Planned Features / TO DO
- More dialogue UIs
- Update tutorials
- Support for SkillAPI classes
- Any other ideas? You can post a ticket or a comment.
Technical Stuff
Configuration
If you installed NPGuys and don't know what to do now, you could start your adventure from Basic Guide, then eventually go to other help pages. New tutorials will be added over time.
Commands
- /npguy list
- Lists all created NPGuys
- /npguy select [name]
- Selects an NPGuy for further editing
- /npguy
- Displays selected NPGuy's data
- /npguy attach [id]
- Attaches the NPGuy to NPC with specified ID
- /npguy attached [id]
- Checks which NPGuy is attached to NPC with specified ID
- /npguy activate
- Activates the NPGuy (so you could talk with him)
- /npguy deactivate
- Deactivates the NPGuy (so you could edit him)
- /npguy create [name]
- /npguy remove
- /dialogue list
- Lists all dialogue lines of the selected NPGuy
- /dialogue select [name]
- Selects a dialogue line fro further editing
- /dialogue
- Displays dialogue data
- /dialogue shortcut [shortcut]
- Changes dialogue shortcut (displayed when you pick from several dialogue options)
- /dialogue message set|add [message]
- Changes player's message
- /dialogue message clear
- Clears player's message (so it won't be displayed on chat)
- /dialogue npcmsg set|add [message]
- Changes NPC's message
- /dialogue npcmsg clear
- Clears NPC's message (so it won't be displayed on chat)
- /dialogue response add [dialogue]
- /dialogue response remove [dialogue]
- /dialogue action add [type] (data)
- Adds a new action to be peformed when the dialogue is called (see: actions list)
- /dialogue action remove [index]
- /dialogue requirement add(r|reversed) [type] (data)
- Adds a new requirement needed to choose the dialogue (see: requirements list)
- /dialogue requirement remove [index]
- /dialogue create [name]
- /dialogue remove
- /npguys save
- Saves all changed data to YML files
- /npguys reload
- Loads all data from YML files (All unsaved changes will be lost!)
- /npguys requirements
- Lists all available requirements
- /npguys actions
- Lists all available actions
Permissions
- npguys.manage
- The only permission in the plugin; it allows you to execute all commands
For developers
Missing a feature in the plugin? Want to implement some weird GUI for a modded server? Having too much spare time? If so, there's an API specially for you! Just head for the...
Documentation and tutorials coming soon. Probably.
@tacirus
:O
Is that really true? That would not be very cool.
I can`t make it work with "Quests" plugin.
Npguy says "The quest is not found" through the console. But the quest exists and works fine if it`s started all alone.
PS:
I found what is the problem. The npguy understands only one-word quest names.
@Goldob
Sorry! In that case, what an amazing plugin! Thanks so much!
@stalkerzombie
I don't think you've really read the description... :P This plugin is actually based on Citizens NPC and you could make any type of NPC "talkable".
I think a good feature to add would be citizens 2 npcs. This is a super cool plugin but having npcs that actually look like players would make it amazing!!! Squidwards are just too weird looking and tall for me XD
@TheCoolGuy123_5_Minecraft_
I know, managing dialogues may seem a bit complex, especially at a first glance. I'm thinking about some more user-friendly (or prettier, at least) command system or even an inventory-based editor. But those are plans for a rather distant future ;)
@tomori_peti
Well, now that's a puzzle, because I typed your commands and everything works fine for me. Could you show how does the generated YAML file look like?
And btw, use %player and %npc rather than %playername and %npcname ;)
@TheCoolGuy123_5_Minecraft_
I write down what commands you should use.
These would be the commands, but it's much simpler to write the config file. I have aready tested the commands, however they are right, the npc doesn't work for me... I think the problem is the <msg> or maybe the %npcname. Error log: http://pastebin.com/grnfvLMt Other Npcs work well.
Could you possibly make it a bit easier to change stuff? I'm confused how to do dialogue.
I just want maybe something like this:
YOU: Hi %npcname, How's your day?
NPC: Good, How about you %playername
Responses: [Good] [Bad] [Bye]
YOU [Good]: <msg>
YOU [Bad]: <msg>
YOU [Bye]: Cya!
kinda like that
Nice Plugin I am going to do some testing whit this
@iarepande
If by "start doing something" you mean any activity (like walking, f.eg) that doesn't fit to the permission/requirement dialogue standard, I'm afraid I can't help :(
Other thing is, if (just like tomori_peti said) you just want for certain dialogue lines to be available only at a certain time. Then all you have to do is wait, I'm planning a new update near the beggining of the next month (haven't started working yet, though).
@iarepande
It's included in my ticket. Just vote to it. :)
So I am part of a harry potter server, and the thing I am most interested is having a citizen start doing something at a certain time of the day on certain days for classes.
@celehman
I know this pain, YAML tends to be tricky. I recommend using some input validator in the future, f.eg. YAMLlint. It often saves a lot of trouble. You can also try text editors with YAML support, like Notepad++.
@celehman
its was the spaces, I must not of got them all last time, but posting it here showed me all of them
@celehman
I tried fixing those spaces in a different version of this sample
Can someone tell me why this script completely breaks the plugin and corrupts the file
you can down a 1.7.10 version of citiznes on their dev builds page.
@PapiDimmi
Assuming from what tomori_peti said, Citizens (which are required) may not work for 1.7.10 and that could be a reason of your problems. I'll look into that, but probably you'll just have to wait for Citizens update.
@TheCoolGuy123_5_Minecraft_
UID? Oh, sorry, my bad. It was supposed to be dialogue name, please don't ask how did I see a connection between these two. It's fixed now.
What does uid mean?
Aka /npguy <name> dialogue <uid??>