MyNPC Changelog

Version 1.2

This update focuses on making the custom NPC workflow easier to use for modpack authors, while also improving performance, spawning behavior, and the in-game NPC interaction screens.

Added

• Added a separate creative tab for MyNPC spawn eggs, so large NPC packs no longer flood the vanilla spawn egg tab.
• Added /mynpc egg <npc_id> with command suggestions, allowing players or pack makers to create NPC spawn eggs without typing the full id.
• Added a structure spawn rules list for each NPC. Each rule can target a structure and define minimum count, maximum count, and spawn chance.
• Added compact table editors for custom trades, teleport scroll prices, known structure rules, and structure spawn rules.
• Added item picker buttons next to item id fields in trade editors.
• Added editable before-trade and after-trade text for custom trades and structure-related trades.
• Added a visited checkbox to the structure guide list. When the player reaches a guided structure, the entry is marked as visited.
• Added weighted known-structure rules, allowing some known structures to be more likely than others when random known structures are selected.

Changed

• Updated the mod version to 1.2.
• The default built-in NPC display name remains village_guide, but its internal entity id is now npc.
• Newly created NPC ids now use npc1, npc2, npc3, and so on.
• The NPC manager's Structure page is simplified. It now only shows the known-structure list button plus random known minimum and maximum values.
• The Chat page no longer has a separate "Add Text" button. Use the text list editor to view, edit, add, and delete chat lines.
• Selected NPC buttons in the left NPC list now use the same pressed visual state as selected page tabs.
• NPC nameplates are no longer shown when looking directly at an NPC.
• Natural and spawn-egg NPCs now share the same default NPC setup path.
• Guide NPC combat AI was adjusted to better handle nearby hostile mobs, retaliation, creeper avoidance, and melee spacing.
• GUI list layouts were tightened to reduce overlap and improve readability on smaller screens.

Fixed

• Fixed several editor list layouts where text boxes could visually overlap adjacent columns.
• Fixed item preview boxes covering text field borders.
• Fixed stale or confusing buttons on the Structure and Chat pages.
• Fixed inconsistent default NPC ids when creating or resetting NPC definitions.
• Fixed old structure controls remaining visible after the Structure page redesign.

Notes

• Existing NPC JSON files are not deleted automatically.
• If an old village_guide.json exists, it remains compatible, but new defaults use npc.json.
• This version is for Minecraft 1.20.1 with Forge 47.x.

Version 1.1

This update rebuilds a large part of the custom NPC workflow and fixes several stability issues found during testing.

Added

• Added a new dynamic NPC manager opened with H.
• Added editable NPC pages for appearance, behavior, known structures, trades, and chat.
• Added support for custom skins and custom sounds from the config asset folders.
• Added searchable structure selection lists with single-select and multi-select behavior.
• Added custom trade editing, scroll trade editing, structure hint text editing, and per-structure prices.
• Added automatic structure detection for structure lists.
• Added random equipment for NPCs, including weapons and armor.
• Added NPC combat behavior:
  • Retaliates when attacked.
  • Actively attacks nearby hostile mobs.
  • Avoids creepers.
  • Plays a visible attack swing animation.

Changed

• Default guide NPC settings now come from one shared default template.
• Resetting a custom NPC now restores the same default settings used by the built-in guide NPC, while keeping a unique entity id.
• The built-in guide NPC naturally spawns in villages, with one guide per village area.
• Spawned guides stay near their home structure instead of wandering away freely.
• Right-click interaction still freezes the NPC during GUI use so trades are not interrupted.
• Structure and trade selection screens now place main action buttons at the bottom.
• Right-click inquiry and trade GUIs were redesigned to use clearer text areas, lists, and scrolling.

Fixed

• Fixed custom skins not applying correctly in some cases.
• Fixed custom sounds failing to resolve from the custom asset folder.
• Fixed the game hanging or freezing during world generation from heavy spawn checks.
• Fixed repeated NPC spawning in the same village.
• Fixed NPC GUI staying open after the NPC dies or is removed.
• Fixed reset defaults being different from the built-in default NPC.
• Fixed several UI clipping, overlap, scrolling, and button layout issues.

Notes

• Existing config files are not deleted automatically. If you want the new default village_guide.json, remove the old one from config/npc_types and restart the game.
• This version is for Minecraft 1.20.1 with Forge 47.x.