NPCModel ✅ModelEngine

ModelNPC - Interactive NPCs with Model Engine
Create fully interactive NPCs with custom 3D models from Model Engine. Configure everything in-game with simple commands - no config files, no server restarts required.

✨ Features

• Easy NPC Creation - Spawn NPCs at your location with a single command
• Model Engine Integration - Attach any Model Engine model to your NPCs
• Interactive Commands - Execute commands when players right-click NPCs
• Dual Execution Modes - Run commands as the player or as console
• 100% In-Game Configuration - No file editing required
• Persistent Storage - NPCs automatically save and reload on server restart
• Customizable Names - Set display names with color codes support
• Teleportation - Easily move NPCs to new locations
• Permission Support - Control who can create and interact with NPCs

Requirements

• Server: Paper/Spigot 1.21+
• Dependencies: Model Engine 4.0.7+
• Java: 21+

Commands
All commands start with /npc

Command Description Example
/npc create <id> <name> [model] Create a new NPC at your location /npc create shop1 Shop_Keeper merchant
/npc remove <id> Remove an NPC /npc remove shop1
/npc list List all NPCs /npc list
/npc setmodel <id> <model> Change NPC's model /npc setmodel shop1 blacksmith
/npc setcommand <id> <player|console> <cmd> Set command executed on right-click /npc setcommand shop1 console give %player% diamond 1
/npc setexecutor <id> <player|console> Change who executes the command /npc setexecutor shop1 console
/npc setname <id> <name> Change NPC's display name /npc setname shop1 &6Gold_Merchant
/npc teleport <id> Teleport NPC to your location /npc teleport shop1
/npc info <id> Show NPC information /npc info shop1
Command Placeholders

• %player% - Replaced with the player's name who clicked the NPC

Color Codes
Use & for color codes in display names:

• &a = Green
• &c = Red
• &6 = Gold
• &e = Yellow
• And all standard Minecraft color codes

Permissions
Permission Description Default
modelnpc.admin Access to all NPC commands OP
modelnpc.interact Interact with NPCs (right-click) Everyone
Usage Examples
Create a shop NPC
/npc create shop &6Shop_Keeper merchant_model
/npc setcommand shop console give %player% diamond 1
Create a teleporter NPC
/npc create tp_spawn &bSpawn_Teleporter portal_model
/npc setcommand tp_spawn player spawn
Create a quest giver
/npc create quest1 &eQuest_Giver villager_model
/npc setcommand quest1 console quest start tutorial %player%
Move an existing NPC
/npc teleport shop
⚙️ Configuration
The plugin features automatic configuration. NPCs are stored in plugins/ModelNPC/npcs.yml and are automatically loaded on server start.

Config.yml Options
yaml
settings:
debug: false
auto-save-interval: 5 # Minutes (0 to disable)

defaults:
name-color: "&e"
entity-type: SLIME
Command Execution Types
Player Mode
Commands are executed as if the player typed them. Player permissions apply.

/npc setcommand npc1 player warp shop
Console Mode
Commands are executed by the server console with full permissions.

/npc setcommand npc1 console give %player% diamond_sword 1
Installation

1. Install Model Engine on your server
2. Download ModelNPC
3. Place the JAR in your plugins folder
4. Restart your server
5. Start creating NPCs!

Notes

• NPCs use invisible Slime entities as their base
• Model Engine models must be installed separately
• If a model doesn't exist, the NPC will be created without it
• NPCs persist through server restarts
• Display names support color codes with &
• Use _ for spaces in names (automatically converted)