Ultimate NPC

A Fabric mod for Minecraft 1.20.6 (Java 21) that lets you create and fully customize NPCs in-game. NPCs support custom textures, equipment, loot tables, boss bars, wandering AI, dialogues, and trading.

Features

Items

• NPC Creator: Left-click in the air to spawn an NPC. Left-click on an existing NPC to open the editor.

NPC Editor (NpcEditScreen)

Full editor interface with 5 tabs:

General

• NPC name
• Model selection (dropdown of all registered entity types)
• Texture selection (dropdown of available textures per variant)
• Max HP and damage
• Change: invincible, invisible, show name, boss bar, wander, second layer

Inventory

• Armor: 4 slots (helmet, chestplate, leggings, boots)
• Hands: 2 slots (main hand, off hand)
• Loot table: 9 slots with individual drop chance percentage on death
• Drag and drop from the player inventory

Trade

• 9 configurable deals (3 per page with pagination)
• Each deal: up to 3 demanded items + 1 offered item
• Drag and drop from the player inventory

Factions

Coming soon

Quests

Coming soon

Dialogue

Coming soon

Trade System

• Right-click an NPC that has at least 1 deal (without holding the NPC Creator) to open the trade screen.
• 9 deal slots displayed (5 rows x 2 columns).
• Click an offer item to execute the trade.
• Automatic validation that the player has the required items.

Loot System

• 9 loot slots per NPC with individual drop chance (0-100%).
• Items are dropped on NPC death based on their probability.
• Worn equipment is never dropped (only the custom loot table is used).

Rendering

• Dynamic rendering: the renderer adapts to the chosen entity type variant.
• Feature support: armor, held items, head, elytra.

Custom Textures

To add custom textures, place PNG files in:

<game_directory>/npc/<namespace>/<entity_name>/

Example for a custom player skin:

npc/minecraft/player/texture.png

The texture will appear in the editor's dropdown. You can do this for all entities, even those from other mods.

npc/modid/entity/texture.png

Your file name will appear in the dropdown menu, so choose it carefully.

Roadmap

• Dialog System: Interact with an NPC via dialogue lines and responses, in order to give items, quests, etc...
• Quests System: Give the player a quest to complete in order to obtain a reward.

Installation

1. Install 1.20.6 version of the Fabric Loader.
2. Download the Fabric API mod and place it in your mods folder.
3. Download Ultimate NPC .jar file and place it in your mods folder.
4. Launch the game and run !