NeuroNPC

NeuroNPC is a Paper plugin that adds interactive, AI-powered NPCs to Minecraft servers.

Create NPCs with custom names, skins and personalities. Players can right-click an NPC to start a private conversation and send messages through the regular Minecraft chat. The plugin sends the conversation to a configured OpenAI-compatible language model, such as OpenRouter, and displays the NPC's response to the player.

NPCs are saved automatically and restored after a server restart. Their name, skin, personality, location and head-turning setting are stored in a YAML file.

Features

• AI-powered NPC conversations
• OpenAI-compatible API support
• OpenRouter support by default
• Custom NPC names and skins
• Custom NPC personalities
• Per-NPC head-turning setting
• Persistent NPC storage
• Private conversations between players and NPCs
• Conversation history for each player and NPC
• Configurable request cooldown
• Configurable message length limit
• English and Russian localization
• Permission support for LuckPerms and other permission plugins
• Hidden NPC nametags
• Disabled NPC-player collisions
• Asynchronous HTTP requests that do not block the server

Commands

• /neuronpc create [name] [skin] [personality] [lookAtPlayer]
• /neuronpc remove
• /neuronpc list
• /neuronpc info
• /neuronpc edit <field> <value>
• /neuronpc memory clear
• /neuronpc reload

Examples:

• /neuronpc create Gena murder Friendly and calm character true
• /neuronpc edit personality A quiet and sarcastic character
• /neuronpc edit lookat false

Right-click an NPC to start a conversation. Right-click the same NPC again to close it. The words exit and выход can also be used to leave a conversation.

Configuration

Plugin files are stored in:

config/neuronpc/

The plugin creates the following files:

llm.yml - language model and API settings

messages.yml - localization and player-facing messages

npcs.yml - saved NPC data

The default model is:

poolside/laguna-xs-2.1:free

The default API endpoint is:

https://openrouter.ai/api/v1/chat/completions

You must provide your own API key in config/neuronpc/llm.yml before NPC conversations can work.

Permissions

• neuronpc.create
• neuronpc.remove
• neuronpc.list
• neuronpc.info
• neuronpc.edit
• neuronpc.memory
• neuronpc.reload
• neuronpc.*

All command permissions default to operators.

Requirements

Paper 1.21.4 or newer Java 21 or newer An API key from OpenRouter or another compatible provider for AI conversations

NeuroNPC is currently designed as a ready-to-use Paper plugin. A public developer API is not included yet.