Skip to content

feat: enhance NPC and Skin management with subfolder support & add PNX 3.0.0 support#1

Open
TraxTRL wants to merge 14 commits into
PowerNukkitX-Bundle:masterfrom
Lifeblock-Network:master
Open

feat: enhance NPC and Skin management with subfolder support & add PNX 3.0.0 support#1
TraxTRL wants to merge 14 commits into
PowerNukkitX-Bundle:masterfrom
Lifeblock-Network:master

Conversation

@TraxTRL

@TraxTRL TraxTRL commented Jun 26, 2026

Copy link
Copy Markdown

This PR adds support for PNX API 3.0.0, allows subfolders in NPC and Skin folder and adds a new overhauled README which showcases all the features RsNPC offers.

Note

Claude Opus 4.8 was used for:

  • Adding subfolder support
  • Reworking README
  • Translating comments
  • Helping migrate to PNX 3.0.0 (Skins & Entity Registration)

TraxTRL and others added 12 commits June 8, 2026 14:23
Load NPC and skin files recursively from subdirectories so they can be
organized into folders. NPCs and skins are now keyed by their path
relative to their root (e.g. shops/blacksmith), so same-named files in
different folders no longer collide. Skin directories containing
skin.png/skin_slim.png are still treated as 4D skins; other directories
are organizational. Track each NPC's source file so deletion works for
NPCs in subfolders, and let /rsnpc create accept a subfolder/name path
(creating parent directories and using the leaf as the display name).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Replace the stub README with an English guide covering features,
commands, permissions, in-game menus, folder layout, NPC config fields,
skins, dialog pages, and placeholders. Documents the subfolder /
path-based naming for Npcs and Skins, and credits the original
MemoriesOfTime founding authors (SmallasWater, LT_Name) as a fork.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Translate javadoc and inline comments across the source to English.
Leaves user-facing strings, log messages, chs-only flavor text, built-in
skin filenames, and legacy migration config keys unchanged.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
updateRsNPC2_0_0_To_RsNPC2_2_3 listed Npcs non-recursively and its skip
guard never excluded directories, so with subfolder organization it
tried to open/save each subfolder as a YAML config, spamming
FileNotFoundException / "Is a directory" errors on enable. Recurse into
subdirectories and only process .yml files.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@TraxTRL
TraxTRL marked this pull request as draft July 11, 2026 23:31
@TraxTRL

TraxTRL commented Jul 11, 2026

Copy link
Copy Markdown
Author

Need to fix a bug - somehow an NPC got saved to a chunk

@TraxTRL
TraxTRL marked this pull request as ready for review July 18, 2026 17:17
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant