ArdaNPCs 1.1.0

Minecraft 1.21.8 · Fabric · Release

This release includes the 1.1 feature set, including the quest, scripting and appearance work from the earlier development build. Back up your world and try it on a separate test world first.

Added

• NPC scripting: an in-game script editor, event hooks, timers, persistent data, diagnostics and a dry-run mode. Scripts use ArdaNPCs' own limited server API and shared execution budgets.
• Expanded quests and conditions: nested ALL / ANY / NOT conditions, up to eight objectives with ALL / ANY / SEQUENTIAL completion, and quest links and turn-in across NPCs.
• NPC capes and appearance tools: cape configuration, standard/slim player models, skin and cape selection, and an expanded appearance editor.
• Mail: inbox, sent messages, read state, known offline recipients, item attachments and an optional NPC postman service. Open your mailbox with /ardanpcs_mail.
• Hireable companions: configurable price and duration, Follow / Wait / Defend modes, persistent ownership, expiry and dismissal. Supports up to three hired companions per player.
• Scripted items and blocks: arda_npcs:script_focus and arda_npcs:script_anchor, server-managed programs, interaction events, timers and persistent instance data.
• Player-profile skins: look up a Minecraft skin by player name or UUID, with profile caching and standard/slim model selection.
• Server texture imports: import your own PNG skins and capes from config/arda_npcs/import_textures/. Imported assets are stored with the world and synchronized to clients.
• Script migration tools: an AST-based analyzer and converter with line-level diagnostics. Conversion is deliberately limited; unsupported operations are reported and converted programs stay disabled until reviewed.

Improvements and fixes

• Added a Shift + right-click service menu so dialogue, trading, banking, teleporting, mail and companion services can remain available on the same NPC.
• Expanded the editor panels and updated English and Czech translations.
• Preserved existing quest identifiers and added checks for cyclic quest links, invalid conditions and repeated reward requests.
• Improved handling of stale editor replies, unsaved drafts and rejected saves.
• Added shared inventory-transfer tracking and explicit recovery tools for mail attachments and companion payments. An uncertain transfer does not automatically refund or grant items again.
• Fixed shutdown saving before server data has finished loading, protecting existing mod data when startup fails.

Compatibility

• Requires Minecraft 1.21.8, Java 21 or newer, Fabric Loader 0.19.3 or newer, and Fabric API 0.136.1+1.21.8 or a compatible newer 1.21.8 build.
• Install the same ArdaNPCs version on the server and all clients.
• NPC scripts use the ArdaNPCs API. Existing CustomNPCs scripts are not drop-in compatible.
• Retired scripted_item and scripted_block IDs remain inert for old-world compatibility; the new executable items use separate IDs.
• Existing NPC data receives disabled defaults for the new optional services. Clones and templates copy settings, not active companion ownership or runtime state.
• Rhino is bundled; no separate scripting-engine installation is required.

Verification

Compilation, 795 automated assertions and 7 checks under Fabric passed. The failed-start test also preserved all 16 prepared data files.

Full gameplay, GUI rendering, multiplayer transfers and long-session testing remain outstanding. Network restrictions in the test environment prevented a complete server startup and a live profile lookup.