NxSkin (v2.0.0)

NxSkin is a comprehensive Hytale plugin that revolutionizes skin management. It goes beyond simple commands, introducing a full Visual Outfit Manager that allows players to create, save, and load their own custom styles instantly.

Whether you are running a massive public server or a private singleplayer instance, NxSkin adapts to your needs with powerful configuration and security.

🚀 Key Features

🎨 Visual Outfit GUI: A brand new interface where players can customize their character, mix and match parts, and preview changes in real-time.
🪑 Cosmetic's Wardrobe (Block): A physical Wardrobe furniture block!
Players can interact with it to enter the immersive "dressing room".
The preview mannequin is smartly positioned inside the furniture based on rotation.
📏 Scale Synchronization: Added a "Save Scale" checkbox below the scale slider.
When enabled, the character's size changes in real-time in the world.
The custom scale is saved within the outfit file.
💾 Save & Load System: Players can save their favorite outfit combinations (up to a configurable limit) and load them later via GUI or Command.
💎 Smart Entitlements: The plugin respects Hytale's Editions (e.g., Supporter, Cursebreaker), verifying ownership before equipping restricted items.
🛡️ Server Safety: Includes file name sanitization, outfit limits, and world-thread synchronization to prevent crashes in multi-instance servers.
🎮 Singleplayer Friendly: New RequirePermissions config option allows casual players to use all features without needing OP status or permission plugins.

Classic Features

Instant Skin Change: Fetch and apply skins from any user instantly via commands.
Target System: Admins (or the server Console) can manage other players' skins.
Skin Persistence: Skins remain applied even after restarts.
Hot Reloading: Update configurations without stopping the server.

🪑 Crafting & Blocks

Cosmetic's Wardrobe A furniture item used to access the Outfit Manager physically.

Recipe: 6x Wood_Trunk, 4x Rock
Station: Furniture_Bench
Category: Storage (Furniture_Storage)

💻 Commands

All commands are accessed via the main /nxskin parent command.

🎨 Outfit Manager (GUI)

Usage: /nxskin cosmetic

Opens the new Visual Interface.
From here, you can Change Parts, Save your current look, or Delete old ones.

📂 Quick Load

Usage: /nxskin cosmetic load [outfitName]

GUI Mode: /nxskin cosmetic load - Opens the visual file browser to select an outfit.
Instant Mode: /nxskin cosmetic load --name=MyOutfit - Instantly applies the outfit named "MyOutfit" to your character without opening the menu.

Setting a Skin (Command Mode)

Usage: /nxskin set <skinName> [targetPlayer]

skinName: The username of the skin you want to fetch.
targetPlayer: (Optional) Applies the skin to another player. Note: If this command is run from the Server Console, targetPlayer is required.

Examples:

/nxskin set Nykoo
/nxskin set Simon--targetPlayer="Nykoo"

Resetting a Skin

Usage: /nxskin clear [targetPlayer]

Restores the player's original skin.
Aliases: reset, remove.

Reloading Configuration

Usage: /nxskin reload

Reloads config.json immediately.

👗 How the Outfit System Works

Open the Menu: Type /nxskin cosmetic or interact with a Cosmetic's Wardrobe.
Customize: Browse through categories (Capes, Overtops, Pants, etc.).
Resize: Adjust the Scale slider. Check "Save Scale" to apply the size to your character immediately.
Save: Click the Save button, type a name for your outfit (e.g., "Warrior"), and confirm.
Load: Click Load (or use /nxskin load --name=Warrior), and your character will update instantly!
Delete: Use the Delete button to remove old outfits. A confirmation screen will appear to prevent accidents.

🪄 Roadmap & Upcoming Features

We are constantly working to push the boundaries of customization in Hytale. Here is what we are developing for v3.0 and beyond:

🌍 NxSkin Loadout (Cross-Server): A groundbreaking feature allowing players to save their outfit JSONs locally. When joining any server running NxSkin, you will be able to select and apply your local saves instantly. Your style travels with you!
📦 Custom Cosmetic Import: We are working on an intuitive system to load custom cosmetics, allowing players to equip cosmetics that don't exist in the base game.
👕 Server Presets: The plugin will support pre-made outfit templates (Kits/Classes) defined by admins, perfect for RPGs or minigames where players need quick, themed uniforms.

⚙️ Configuration

NxSkin creates a config.json file in your mods/NxSkin folder.

{
  "CommandCooldownSeconds": 10,
  "CacheDurationHours": 24,
  "maxOutfitsPerPlayer": 3,
  "RequirePermissions": true
}

Option	Default	Description
`CommandCooldownSeconds`	`10`	Cooldown (in seconds) between using `/nxskin set`.
`CacheDurationHours`	`24`	How long fetched skins are kept in memory before re-checking the API.
`maxOutfitsPerPlayer`	`3`	The maximum number of custom outfits a single player can save on the server.
`RequirePermissions`	`true`	(NEW) If set to `false`, players can use all commands and GUI features without needing OP or permission nodes (Great for Singleplayer!).

🔐 Permissions

Manage access to NxSkin features using the following permission nodes. Note: If RequirePermissions is false in the config, these are ignored.

Permission Node	Description
`nxskin.command.nxskin`	Parent Permission. Grants basic access to the command structure.
`nxskin.command.cosmetic`	Allows opening the GUI menu via `/nxskin cosmetic` or the Wardrobe.
`nxskin.cosmetic.savescale`	Allows a player to apply a custom scale to their character model.
`nxskin.outfit.save`	Allows saving custom outfits to the server.
`nxskin.outfit.load`	Allows loading saved outfits (via GUI or `/nxskin load`).
`nxskin.outfit.delete`	Allows deleting saved outfits.
`nxskin.command.set`	Allows using the command-based fetcher (`/nxskin set`).
`nxskin.command.clear`	Allows resetting skins.
`nxskin.command.reload`	Allows reloading the config.
`nxskin.admin` or `nxskin.*`	Grants full access, including targeting other players.

👨‍💻 Developer API

NxSkin v2.0 introduces ECS and Standard Event hooks. Other plugins can intercept skin changes or outfit applications. Check the source code for NxEquipOutfitEvent (ECS Cancellable) and NxChangeCosmeticEvent.

📦 Installation

Download the latest release of NxSkin.
Place the jar file into your Hytale server's mods folder.
Restart the server.

Author

Nykoo - Github

Found a bug or need help? Join our discord: https://discord.gg/WbKXXKm5Gb

NxSkin | Cosmetics and Wadrobe