Nx皮肤

Nx皮肤

NxSkin 是一款 Hytale 插件，它引入了动态皮肤管理系统，允许玩家和管理员使用简单的命令即时改变他们的外观。

实用

Nx皮肤预览查看大图

NxSkin (v2.0.0)

NxSkin 是一款全面的 Hytale 插件，彻底革新了皮肤管理。它超越了简单的指令，引入了一个完整的视觉外观管理器，让玩家可以即时创建、保存和加载自己的自定义风格。

无论您是在运行大型公共服务器还是单人游戏实例，NxSkin 都能通过强大的配置和安全性来满足您的需求。

🚀 主要特色

  • 🎨 视觉外观 GUI： 一个全新的界面，玩家可以在其中自定义角色、混搭部件，并实时预览变化。
  • 🪑 装饰衣柜（方块）： 一个实体的衣柜家具方块！
    • 玩家可以与它互动，进入沉浸式的“试衣间”。
    • 预览人体模型会根据旋转方向智能地放置在家具内部。
  • 📏 缩放同步： 在缩放滑块下方新增了一个**“保存缩放”**复选框。
    • 启用后，角色的体型会在世界中实时变化。
    • 自定义缩放会被保存到外观文件中。
  • 💾 保存与加载系统： 玩家可以保存最喜爱的外观组合（可配置上限），之后通过 GUI 或指令加载。
  • 💎 智能资格验证： 插件尊重 Hytale 的版本（例如 支持者、破咒者），在装备受限物品前会验证所有权。
  • 🛡️ 服务器安全： 包含文件名净化、外观数量限制以及世界线程同步，以防止多实例服务器崩溃。
  • 🎮 单人游戏友好： 新增的 RequirePermissions 配置选项允许普通玩家使用所有功能，无需 OP 状态或权限插件。

经典功能

  • 即时更换皮肤： 通过指令从任何用户获取并应用皮肤。
  • 目标系统： 管理员（或服务器控制台）可以管理其他玩家的皮肤。
  • 皮肤持久化： 皮肤在重启后仍然保留。
  • 热重载： 无需停止服务器即可更新配置。

🪑 合成与方块

装饰衣柜 一种用来物理访问外观管理器的家具物品。

  • 配方： 6x Wood_Trunk，4x Rock
  • 工作台： Furniture_Bench
  • 类别： 存储（Furniture_Storage）

💻 指令

所有指令都通过主指令 /nxskin 访问。

🎨 外观管理器（GUI）

用法： /nxskin cosmetic

  • 打开新的视觉界面。
  • 在此界面中，您可以更换部件、保存当前造型，或删除旧造型。

📂 快速加载

用法： /nxskin cosmetic load [outfitName]

  • GUI 模式： /nxskin cosmetic load - 打开视觉文件浏览器选择外观。
  • 即时模式： /nxskin cosmetic load --name=MyOutfit - 无需打开菜单，立即将名为“MyOutfit”的外观应用到您的角色。

设置皮肤（指令模式）

用法： /nxskin set <skinName> [targetPlayer]

  • skinName： 您要获取的皮肤用户名。
  • targetPlayer：（可选）将皮肤应用于另一个玩家。注意：如果在服务器控制台中运行此指令，则 targetPlayer 是必需的。

示例：

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

重置皮肤

用法： /nxskin clear [targetPlayer]

  • 恢复玩家的原始皮肤。
  • 别名： reset，remove。

重载配置

用法： /nxskin reload

  • 立即重载 config.json。

👗 外观系统工作原理

  1. 打开菜单： 输入 /nxskin cosmetic 或与装饰衣柜互动。
  2. 自定义： 浏览各种类别（披风、外套、裤子等）。
  3. 调整大小： 调整缩放滑块。勾选**“保存缩放”**以立即将体型应用到角色上。
  4. 保存： 点击保存按钮，为您的造型命名（例如“战士”），然后确认。
  5. 加载： 点击加载（或使用 /nxskin load --name=Warrior），您的角色将立即更新！
  6. 删除： 使用删除按钮移除旧造型。会出现确认屏幕以防止误操作。

🪄 路线图与未来功能

我们一直在努力突破 Hytale 自定义化的界限。以下是我们为 v3.0 及更高版本 开发的内容：

  • 🌍 NxSkin 配置存档（跨服务器）： 一项开创性功能，允许玩家将外观 JSON 文件保存在本地。当加入任何运行 NxSkin 的服务器时，您都可以选择并立即应用本地存档。您的风格随您而行！
  • 📦 自定义装饰导入： 我们正在开发一个直观的系统来加载自定义装饰，让玩家能够装备基础游戏中不存在的装饰品。
  • 👕 服务器预设： 插件将支持由管理员定义的预制外观模板（套装/职业），非常适合需要玩家快速获得主题统一制服的 RPG 或小游戏。

⚙️ 配置

NxSkin 会在您的 mods/NxSkin 文件夹中创建一个 config.json 文件。

{
  "CommandCooldownSeconds": 10,
  "CacheDurationHours": 24,
  "maxOutfitsPerPlayer": 3,
  "RequirePermissions": true
}
选项 默认值 描述
CommandCooldownSeconds 10 使用 /nxskin set 之间的冷却时间（秒）。
CacheDurationHours 24 获取的皮肤在内存中保留多长时间，之后才会重新检查 API。
maxOutfitsPerPlayer 3 单个玩家可以在服务器上保存的自定义外观的最大数量。
RequirePermissions true （新功能） 如果设为 false，则玩家无需 OP 或权限节点即可使用所有指令和 GUI 功能（非常适合单人游戏！）。

🔐 权限

使用以下权限节点管理对 NxSkin 功能的访问。注意：如果配置中的 RequirePermissions 为 false，则这些节点将被忽略。

权限节点 描述
nxskin.command.nxskin 父权限。 授予访问指令结构的基本权限。
nxskin.command.cosmetic 允许通过 /nxskin cosmetic 或衣柜打开 GUI 菜单。
nxskin.cosmetic.savescale 允许玩家为角色模型应用自定义缩放。
nxskin.outfit.save 允许将自定义外观保存到服务器。
nxskin.outfit.load 允许加载已保存的外观（通过 GUI 或 /nxskin load）。
nxskin.outfit.delete 允许删除已保存的外观。
nxskin.command.set 允许使用基于指令的获取器（/nxskin set）。
nxskin.command.clear 允许重置皮肤。
nxskin.command.reload 允许重载配置。
nxskin.admin 或 nxskin.* 授予完全访问权限，包括以其他玩家为目标。

👨‍💻 开发者 API

NxSkin v2.0 引入了 ECS 和标准事件挂钩。其他插件可以拦截皮肤更改或外观应用。请查看 NxEquipOutfitEvent（ECS 可取消）和 NxChangeCosmeticEvent 的源代码。

📦 安装

  1. 下载 NxSkin 的最新发布版本。
  2. 将 jar 文件放入您的 Hytale 服务器的 mods 文件夹中。
  3. 重启服务器。

作者

发现错误或需要帮助？ 加入我们的 Discord：https://discord.gg/WbKXXKm5Gb

合作方