# NPC Engine<\/p>\n
**Interactive NPC system with dialogues for Minecraft 1.21.9+**<\/p>\n
NPC Engine is a data pack for creating NPCs with a dialogue system, response options, and a cinematic camera.<\/p>\n
—<\/p>\n
## \ud83c\udfaf Features<\/p>\n
### NPCs
\n– **Mannequins** \u2014 NPCs based on `minecraft:mannequin` with custom skins
\n– **Other Entities** \u2014 Villagers, zombies, skeletons, etc.
\n– **Interactivity** \u2014 Clicking on an NPC starts a dialogue
\n– **Visual Editor** \u2014 Control via the action bar<\/p>\n
### Dialogues
\n– **Typewriter Effect** \u2014 Smooth character-by-character typing
\n– **Choice System** \u2014 Branching dialogues with multiple answer options
\n– **Navigation** \u2014 Shift to skip to the next line
\n– **Text Display** \u2014 Text is displayed above the NPC<\/p>\n
### Camera
\n– **Cinematic Mode** \u2014 Automatically zooms in on the NPC
\n– **Positioning** \u2014 The camera is positioned to the side of the NPC
\n– **Smooth Transitions** \u2014 Blindness effect at the start\/end Dialogue
\n– **Restore** \u2014 automatically returns the player to their starting position<\/p>\n
—<\/p>\n
## \ud83d\ude80 Installation<\/p>\n
1. Place the `npcs-engine` folder in your world’s `datapacks`
\n2. Run `\/reload`<\/p>\n
—<\/p>\n
## \ud83d\udccb Usage<\/p>\n
### Open the Editor
\n“`mcfunction
\n\/function _npsc:open
\n“`<\/p>\n
### Editor Controls
\n– **Mouse Wheel** \u2014 Navigate the menu
\n– **RMB (carrot on a fishing rod)** \u2014 Select an item<\/p>\n
### Editor Menu
\n| Item | Description |
\n|——-|———-|
\n| \ud83d\udcdd Create NPC | Create a new NPC |
\n| \ud83d\udccb List | View all NPCs |
\n| \ud83d\udcac Dialogues | Dialogue Editor |
\n| \ud83c\udfac Dialogue Test | Run a Dialogue Test |
\n| \u274c Exit | Close Editor |<\/p>\n
### Interacting with NPCs
\n– Click on the NPC to start a dialogue
\n– **Shift** \u2014 next line
\n– The dialogue ends automatically after the last line<\/p>\n
—<\/p>\n
## \ud83d\udd27 API for Developers<\/p>\n
### Creating an NPC
\n“`mcfunction
\n# Create a mannequin NPC
\nfunction npcs:npc\/create_player<\/p>\n
# Create an NPC entity
\nfunction npcs:npc\/create_entity
\n“`<\/p>\n
### Dialogue Management
\n“`mcfunction
\n# Add a dialogue line
\nfunction npcs:dialog\/editor\/add_line {npc_id:1,text:”Hello, traveler!”}<\/p>\n
# Add a choice
\nfunction npcs:dialog\/editor\/add_choice {npc_id:1,text:”Where shall we go?”,choices:[“North”,”South”]}<\/p>\n
# Start a dialogue programmatically
\nfunction npcs:dialog\/start_play
\n“`<\/p>\n
### Data Storage
\n– **Storage** `npcs:data` \u2014 NPC and dialogue data
\n– **Storage** `npcs:current_dialog` \u2014 currently active dialogue<\/p>\n
—<\/p>\n
## \ud83d\udccb Requirements<\/p>\n
– **Minecraft**: 1.21.9+
\n– **Permissions**: Operator for editor commands<\/p>\n
—<\/p>\n
## \ud83c\udfae Example: Quest NPC<\/p>\n
“`mcfunction
\n# 1. Create an NPC
\nfunction npcs:npc\/create_player<\/p>\n
# 2. Add dialogues (npc_id = 1)
\nfunction npcs:dialog\/editor\/add_line {npc_id:1,text:”Greetings, hero!”}
\nfunction npcs:dialog\/editor\/add_line {npc_id:1,text:”I have something for you” task.”}
\nfunction npcs:dialog\/editor\/add_choice {npc_id:1,text:”Will you accept it?”,choices:[“Of course!”,”Not now”]}
\n“`<\/p>\n
—<\/p>\n
**Create living worlds with the NPC Engine!** \ud83d\udcac\u2728<\/p>\n","protected":false},"excerpt":{"rendered":"
Interactive NPC system with dialogues for Minecraft 1.21.9+<\/p>\n","protected":false},"featured_media":114206,"template":"","meta":{"_minecraft_slug":"npcs-engine","_minecraft_project_id":"1cCIX9Vf","_minecraft_author":"Stepan1411_Studio","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":3755,"_minecraft_follows":13,"_minecraft_client_side":"unknown","_minecraft_server_side":"unknown","_minecraft_storage_type":"zip","_minecraft_archive_name":"npcs-engine.zip","_minecraft_size_bytes":4653553,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-16T01:48:00.129313Z","_minecraft_date_created":"2025-12-05T06:25:22.592590Z","_minecraft_date_modified":"2026-04-22T09:41:11.661458Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/npcs-engine","_minecraft_icon_attachment_id":114206,"_minecraft_imported_at":"2026-06-06T17:35:23+00:00","_minecraft_import_hash":"9d5f76947ecdf906084c812c5b8c99ff","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[84,156,97,104,873,158,98,867,92],"mod_loader":[86,99,106,160,100],"minecraft_version":[40,41,82,83,167,163],"class_list":["post-114205","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-datapack","mod_category-decoration","mod_category-fabric","mod_category-forge","mod_category-library","mod_category-neoforge","mod_category-quilt","mod_category-social","mod_category-utility","mod_loader-datapack","mod_loader-fabric","mod_loader-forge","mod_loader-neoforge","mod_loader-quilt","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-9","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\n