NxSkin (v2.0.0-rc2 - Early Access)
⚠️ EARLY ACCESS WARNING ⚠️ This is the second release candidate of version 2.0.0 (Beta). It introduces a completely new GUI system, file saving handling, and entitlement checks. While we have tested it extensively, bugs may occur. If you encounter any issues, please REPORT THEM immediately on our Discord Server. Your feedback is crucial for a stable release!
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.
🚀 New Features in v2.0.0-rc2
- 🎨 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 (New Block): We introduced a physical Wardrobe block!
- Players can interact with it to enter the "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.
- 💎 Smart Entitlements: The plugin respects Hytale's Editions (e.g., Supporter, Cursebreaker), verifying ownership before equipping restricted items.
- 🛡️ Safety & Security: Includes file name sanitization and limits on how many outfits a player can save to prevent server spam.
Classic Features
- Instant Skin Change: Fetch and apply skins from any user instantly via commands.
- Target System: Admins 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, 4xRock
- 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 (NEW)
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.
Examples:
/nxskin set Nykoo
/nxskin set HytaleSteve --targetPlayer="MrJoao04"
Resetting a Skin
Usage: /nxskin clear [targetPlayer]
- Restores the player's original skin.
- Aliases:
reset,remove.
Reloading Configuration
Usage: /nxskin reload
- Reloads
config.jsonimmediately.
👗 How the Outfit System Works
- Open the Menu: Type
/nxskin cosmeticor 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. While v2.0 introduces the core Outfit System, 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.
- 🛠️ Developer API: A comprehensive API allowing other developers to hook into NxSkin.
⚙️ Configuration
NxSkin creates a config.json file in your mods/NxSkin folder.
JSON
text
{
"CommandCooldownSeconds": 10,
"CacheDurationHours": 24,
"maxOutfitsPerPlayer": 3
}| <strong>Option</strong> | <strong>Default</strong> | <strong>Description</strong> |
|---|---|---|
| <code>CommandCooldownSeconds</code> | <code>10</code> | Cooldown (in seconds) between using <code>/nxskin set</code>. |
| <code>CacheDurationHours</code> | <code>24</code> | How long fetched skins are kept in memory before re-checking the API. |
| <code>maxOutfitsPerPlayer</code> | <code>3</code> | <strong>(NEW)</strong> The maximum number of custom outfits a single player can save on the server. |
🔐 Permissions
Manage access to NxSkin features using the following permission nodes. v2.0 introduces new nodes for the Outfit System.
| <strong>Permission Node</strong> | <strong>Description</strong> |
|---|---|
| <code>nxskin.command.nxskin</code> | <strong>Parent Permission.</strong> Grants basic access to the command structure. |
| <code>nxskin.command.cosmetic</code> | <strong>(NEW)</strong> Allows opening the GUI menu via <code>/nxskin cosmetic</code> or the Wardrobe. |
| <code>nxskin.outfit.save</code> | <strong>(NEW)</strong> Allows saving custom outfits to the server. |
| <code>nxskin.outfit.load</code> | <strong>(NEW)</strong> Allows loading saved outfits (via GUI or <code>/nxskin load</code>). |
| <code>nxskin.outfit.delete</code> | <strong>(NEW)</strong> Allows deleting saved outfits. |
| <code>nxskin.command.set</code> | Allows using the command-based fetcher (<code>/nxskin set</code>). |
| <code>nxskin.command.clear</code> | Allows resetting skins. |
| <code>nxskin.command.reload</code> | Allows reloading the config. |
| <code>nxskin.admin</code> or <code>nxskin.*</code> | Grants full access, including targeting other players. |
📦 Installation
- Download the latest release of
NxSkin.
- Place the jar file into your Hytale server's
modsfolder.
- Restart the server.
Author
- Nykoo - Github
Found a bug in the Beta? Join our discord: https://discord.gg/WbKXXKm5Gb
2
Favorites
7
Downloads
0 Comments