Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[2.0.0-rc.2] - 2026-01-29

Added

• Wardrobe Interaction: Introduced the Cosmetic Wardrobe block.
  • Players can now physically interact with a Wardrobe furniture to open the Outfit Manager.
• Scale Synchronization: Added a "Save Scale" checkbox to the Scale slider.
  • When enabled, changes to the character's scale in the GUI are instantly applied to the actual player model in the world.
  • The custom scale is persistent and saved with outfits.
• New Command: /nxskin load <name>
  • Added Player Load Cosmetic Command allowing players to instantly equip saved outfits via chat (without opening the GUI if you want).

[2.0.0-rc1] - 2026-01-26

Added

• Outfit Management System: A fully integrated GUI interface allowing players to manage their custom looks without commands.
  • Save: Players can name and save their current combination of cosmetics.
  • Load: Instantly apply previously saved outfits via a visual file browser.
  • Delete: Remove unwanted outfits with a Safety Confirmation GUI to prevent accidental deletion.
• Security & Limits:
  • File Sanitization: Strict input validation prevents malicious file naming or directory traversal attacks when saving outfits.
  • Configurable Limits: Server owners can now set a maximum number of outfits per player in config.json (Default: 3) to prevent storage abuse.
• Expanded Permissions: Granular control over the new outfit features.
  • nxskin.outfit.save: Allows saving new outfits.
  • nxskin.outfit.load: Allows loading saved outfits.
  • nxskin.outfit.delete: Allows deleting existing outfits.

[1.0.0] - 2026-01-19

Added

• Initial Release: Complete and robust system for dynamic player skin management.
• Dynamic Command System:
  • /nxskin set <skinName>: Fetches and applies skins instantly from the Hytale API.
  • /nxskin clear (aliases: reset, remove): Restores the player's original skin.
  • /nxskin reload: Hot-reloads the configuration file without restarting the server.
• Auto-Cleanup: Automatically removes data entries when a player reverts to their original skin, keeping the JSON database lightweight.
  • Skin Persistence: Skins remain applied across server restarts and player rejoins.
• Customization & Config:
  • Command Cooldowns: Configurable delay to prevent API spam.
  • Local Cache: High-performance skin caching with configurable expiration (default 24h).
• Granular Permissions: - Complete integration with Hytale's permission system (Nodes: nxskin.command.set, nxskin.command.clear, nxskin.command.reload, nxskin.admin).