MyNPC

MyNPC 1.1 User Guide

Requirements

• Minecraft 1.20.1
• Forge 47.x
• MyNPC 1.1

Installation

1. Put the MyNPC jar into your instance mods folder.
2. Start the game once.
3. The mod will create config folders automatically.

Important folders:

• config/npc_types stores NPC definition JSON files.
• config/mynpc_custom_assets/textures stores custom NPC skin textures.
• config/mynpc_custom_assets/sounds stores custom NPC sound files.
• config/mynpc_custom_assets/lang can be used for extra language entries.

Default Guide NPC

The built-in guide NPC is village_guide.

By default, the guide:

• Spawns in vanilla villages.
• Has a 100% spawn chance when the village spawn check succeeds.
• Spawns at most one guide per village area.
• Knows a random set of structures.
• Can sell structure location help and teleport scrolls.
• Can fight hostile mobs, retaliate when attacked, and avoid creepers.
• Stays near its home village instead of wandering freely.

If the default config was already generated before updating, delete config/npc_types/village_guide.json and restart the game to regenerate the latest default version.

NPC Manager

Press H in game to open the NPC manager.

Main actions:

• + creates a new NPC from the default template.
• Select an NPC from the left list to edit it.
• Use the small box beside NPC entries for multi-select.
• Save saves current changes.
• Copy duplicates the selected NPC. The copy keeps most settings but gets a unique id.
• Cancel discards the current edit session.
• Delete removes selected NPC definitions after confirmation.
• Reset restores selected NPCs to the built-in default guide settings.

Tabs:

• Look: skin, name, entity id, and sounds.
• Behavior: spawn structures, spawn chance, and min/max spawn count.
• Structure: known structures and structure hint behavior.
• Trade: teleport scroll trades and custom item trades.
• Chat: random chat lines and structure-related dialogue.

Custom Skins

1. Put PNG skin files into config/mynpc_custom_assets/textures.
2. Open the NPC manager with H.
3. Select an NPC.
4. Go to Look.
5. Use the custom skin button to choose a texture.
6. Save the NPC.

The skin should use the normal Minecraft player skin layout.

Custom Sounds

1. Put sound files into config/mynpc_custom_assets/sounds.
2. Open the NPC manager with H.
3. Select an NPC.
4. Go to Look.
5. Choose sounds for interaction, hurt, death, or ambient slots.
6. Use the preview button to test sounds.
7. Save the NPC.

Structure Selection

Structure lists support:

• Search by keyword.
• Clicking the structure name for single selection.
• Clicking the small box for multi-selection.
• Scrolling when the list is longer than the panel.

Structure names use language keys where available. Unknown structures fall back to a readable id-based name.

Trading

NPCs can offer:

• Teleport scroll trades for known structures.
• Structure location hint trades.
• Custom item trades.

For each structure trade, you can configure:

• The structure name.
• The item used as currency.
• The required item count.
• Whether the structure trade is disabled.

Chat And Hints

NPCs can have general chat lines and structure-specific hint text.

Structure hint text can use:

• {structure} for the translated structure name.
• {direction} for the direction text.

Example:

If my memory serves, {structure} lies somewhere to the {direction}.

Spawn Eggs

Spawn egg NPCs use the same base initialization as naturally spawned NPCs:

• Default known structures can be generated.
• Home position is set when spawned.
• Random equipment can be assigned.
• Combat behavior is enabled.

Troubleshooting

If a custom skin shows as missing texture:

• Check that the file is inside config/mynpc_custom_assets/textures.
• Make sure it is a valid PNG.
• Reopen the selector and save the NPC again.

If a custom sound does not play:

• Check that the file is inside config/mynpc_custom_assets/sounds.
• Use the sound preview button in the Look tab.
• Restart the game if the asset pack was just created for the first time.

If the default guide settings look old:

• Delete config/npc_types/village_guide.json.
• Restart the game.
• The mod will regenerate the latest default config.