Compatibility
Minecraft: Java Edition
Platforms
Supported environments
75% of ad revenue goes to creators
Support creators and Modrinth ad-free with Modrinth+Creators
Details
Chat-with-NPC
The mod is still in public test, please submit an issue if you find any problems. If you want to use the latest version, please compile the source code yourself, see Build.
1. Introduction
Chat With NPC allows players to freely chat with NPCs, who will answer questions based on his setting (Basic Prompt) and the setting of their Groups (Nation, City, Town ,etc.). Suitable for RPG maps or puzzle maps. The NPCs would not change the game rule (if you don't use the advanced features). NPC can also perform some actions based on the chat content if you define it.
In the future version, we will add innovative features such as NPCs chatting with each other, NPCs' viewpoints on events, etc., so that NPCs in the same Group can interact with each other.
2. How to use
Any player can talk to NPCs by shift+clicking on them, if the NPC has been registered by OPs. Then the NPC will greet with players.
The NPC's speech can be seen by everyone (in the chat bubble above their head), or by players within a certain range around NPC (in the Chat bar).
Any nearby players can reply to the NPC in the chat bar directly (or the nearest NPC if there are multiple NPCs near the player).
If you are administrator, see the Installation for more information.
3. Features
- Each
NPC
has his ownInstructions
, and he can belong to aGroup
. - Each
NPC
will manager their context of the conversation automatically by OpenAI. - Each
Group
also has its ownInstructions
to describe them, and can also record someEvent
that can be easy to change. - Each
Group
can record aParentGroup
until the group's parent group isGlobal
,Global
cannot have a parent group. - Each
NPC
's conversation will combine his ownInstructions
, the context of this conversation (or all the conversation if needMemory is true), theIntructions
of hisGroup
and all itsParentGroup
, and the content ofEvent
. - You can define the
Functions
that could be call by the NPC in the conversation.
4. Requirements
- Minecraft Server 1.19.4 or higher
- Fabric Loader 0.12.0 or higher
- Fabric API included
5. Installation
- After installing the mod in
mods
folder, grab your OpenAI API key from here, and set it with the/npchat setkey <key>
command. - You can use the command in Commands to set the basic configuration of the mod.
- For register the NPCs, please read RegisterNPC.
- For register the Groups, please read RegisterGroup.
- To know about the configuration of the mod, please read Configuration.
- If you want to use some advanced features, please read Advanced.
6. Commands
/npchat
- View configuration status/npchat help
- View commands help/npchat enable/disable
- Enable/disable the mod/npchat setKey <key>
- Set OpenAI API key/npchat setModel <model>
- Set AI model/npchat setRange <range>
- Set the range of the conversation/npchat setLanguage <language>
- Set the response language/npchat setWordLimit <wordLimit>
- Set the word limit of the response/npchat setURL <url>
- Set the OpenAI API proxy URL/npchat saveAll
- Save all the data to the disk/npchat setChatBar <true/false>
- Set to display the conversation at the chat bat at the bottom left or not,true
to display,false
to hide./npchat setBubble <true/false>
- Set to display the bubble of the conversation above our lovely NPC or not,true
to display,false
to hide./npchat setBubbleStyle Color <color preset>
- Set the preset colors for font and background./npchat setBubbleStyle timeLastingPerChar <time>
- Set the time lasting for a character in unit of second. For example, setting the time to 1.5 seconds means a sentence with 6 characters will have its bubble displayed for a total of 9 seconds.
7. To do list
- [X] Improve the chat bubble.
- [ ] NPCs chat with each other and communicate their opinion of events. (See Advanced)
- [ ] NPCs have their opinion on every event in their
Group
. - [X] NPCs performing actions based on the chat content. (See Advanced)
8. Reference
- AIMobs by rebane2001 and Eianex