SANDBOX — this is a test environment. No servers are actually deployed and no real payments are charged.
Source-checkedCreatures & NPCs

Chat-With-NPC

by WDRshadow · for Minecraft

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.

4.6KDownloads
20 mo agoLast updated
LGPL-3.0-or-laterLicense
FabricLoaders

About Chat-With-NPC

From Modrinth

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.

Chat-with-NPC

GitHub release GitHub license test workflow

> 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.

Chinese Version

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).

A greeting from NPC.

If you are administrator, see the Installation for more information.

3. Features

  1. Each NPC has his own Instructions, and he can belong to a Group.
  2. Each NPC will manager their context of the conversation automatically by OpenAI.
  3. Each Group also has its own Instructions to describe them, and can also record some Event that can be easy to

change.

  1. Each Group can record a ParentGroup until the group's parent group is Global, Global cannot have a parent

group.

  1. Each NPC's conversation will combine his own Instructions, the context of this

conversation (or all the conversation if needMemory is true), the Intructions of his Group and all its ParentGroup, and the content of Event.

  1. 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

  1. After installing the mod in mods folder, grab your OpenAI API key

from here, and set it with the /npchat setkey <key> command.

  1. You can use the command in Commands to set the basic configuration of the mod.
  2. For register the NPCs, please read RegisterNPC.
  3. For register the Groups, please read RegisterGroup.
  4. To know about the configuration of the mod, please read Configuration.
  5. 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

and Eianex

Highlights

From source data

Game versions

Supports 13 Minecraft versions, the newest being 1.21.4.

Loaders

Runs on Fabric.

Footprint

Rated a light load on a server.

Chat-With-NPC on Nxeon

From our catalogue
One-click install
Supported on Nxeon Minecraft servers. We download it from Modrinth, place it, and restart the server.
Server side
Required on the server
Server type needed
Fabric
Server load
light
Smallest plan we suggest
Minecraft — 1.5 GB (2 GB RAM). This follows our own load rating above, not a benchmark.
Latest build
0.1.2-1.19.4, released 2025-03-20

Game versions by loader

LoaderGame versionsNewest
Fabric1.19.4 to 1.21.4 (13 versions)1.21.4

From 3 recorded builds of Chat-With-NPC.

Recent builds

BuildReleasedGame versionsLoaders
0.1.2-1.19.42025-03-201.19.4 to 1.21.4 (13 versions)Fabric
0.1.0-1.202024-03-281.20 to 1.20.1 (2 versions)Fabric
0.1.02024-03-271.19.4Fabric

Dependencies

  • Required: modrinth project P7dR8mSH (modrinth, not in our catalogue)

Declared by the newest build that lists any. Required ones are installed with it on one-click installs.

Run Chat-With-NPC on a Minecraft server

Pick a server or deploy a new one above; it is installed in one click.

What kind of mod it is

From the catalog
Listed on Modrinth as “Mods”

Creatures & NPCs

Adds or changes creatures, NPCs and how they behave.

Runs on your server

From source side support

Modrinth lists Chat-With-NPC as required on the server. Check its Modrinth page to see whether players need it too.

Compatibility

Game
Minecraft
Loaders
Fabric
Runs on
Serverrequired on the server
Game versions
1.21.4 and 12 earlier

Verified at the source

  • ✓ModrinthOfficial listing, checked 2026-10-17Open ↗
  • ✓AuthorWDRshadow, as published on Modrinth
  • ✓LicenseLGPL-3.0-or-laterFree

Chat-With-NPC, answered

Generated from the mod’s own source data.

Do my players need to install Chat-With-NPC?

Modrinth lists Chat-With-NPC as required on the server. Check its Modrinth page to see whether players need it too.

Which loaders does it support?

Fabric.

Is it free?

Yes. Chat-With-NPC is free to download from Modrinth. Its license is LGPL-3.0-or-later.

How do I add it to my Nxeon server?

Use “Add to a server” on this page, or open NxLabs from your dashboard. We install it, restart your server and switch it on.

NxLabs

Run Chat-With-NPC on a Minecraft server.

Deploy in about a minute from $4.20 a month, then add Chat-With-NPC in one click.