RuinedWardrobe
RuinedWardrobe 是一款适用于 Paper 和 Folia 的衣柜插件,旨在为服务器提供整洁的玩家护甲外观体验以及可靠的员工管理功能。玩家可将护甲套装保存至 GUI 槽位中,通过单击即可装备或卸下;支持重命名已保存的套装,插件还会处理数据持久化、绑定护甲保护、诊断工具、审计日志以及相关的存储迁移工作。
亮点
- 采用 Hypixel 风格的衣柜 GUI,支持拖拽编辑护甲、分页导航、锁定槽位及装备按钮。
- 支持 Paper 和 Folia 调度器。
- 运行时兼容 Paper/Folia
1.21至26.2版本。 - 需要 Java
21+。 - 通过
ruinedwardrobe.slots.<amount>权限节点实现权限分级槽位,并附带管理员额外槽位。 - 默认使用 SQLite,网络服可选配 MySQL 或 MariaDB。
- 异步数据库管道,具备队列限制、重试机制、健康指标监控及批量同步功能。
- 绑定护甲防重复保护,涵盖点击、拖拽、丢弃、交换、护甲分发等操作,并支持容器锁定选项。
- GUI 编辑可防止因覆盖已占用部位而导致的静默物品丢失,并会恢复未送达的已取物品。
- 完整支持 Bukkit
ItemStack存储,通过 Bukkit API 暴露自定义护甲元数据。 /wardrobe doctor命令可报告存储、缓存、同步、数据库探测状态及常见的可选插件钩子信息。- 默认行为与原版死亡掉落一致,并提供在死亡时保留衣柜套装的选项。
- 审计日志记录装备操作、编辑、死亡、清理器移除、同步变更、存储错误及物品反序列化失败等情况。
- 提供匿名 bStats 指标,用于统计服务器/插件版本的采用情况,配置文件中包含本地退出选项。
- 配置文件、GUI、语言包及权限模板均专为实时服务器管理设计。
安装
- 下载适用于你服务器版本的 jar 文件。
- 将其放入服务器的
plugins文件夹中。 - 启动一次服务器,以便 RuinedWardrobe 创建其配置文件。
- 编辑
plugins/RuinedWardrobe/config.yml、gui.yml、lang/en_US.yml以及权限设置。 - 重启服务器,或在仅更改配置后使用
/wardrobe reload命令重载。
命令
/wardrobe或/rw打开衣柜 GUI。/wardrobe help显示命令帮助信息。/wardrobe list [player]列出已保存的衣柜套装。/wardrobe rename <slot> <name>重命名其中一个已保存的套装。/wardrobe doctor打印运行时诊断信息。/wardrobe reload重载配置文件、GUI 文件和语言文件。/wardrobe migrate <sqlite|mysql> [--dry-run] [--force]迁移存储并附带快照验证。/wardrobe admin open <player>打开其他玩家的衣柜。/wardrobe admin setslots <player> <amount>为管理员添加额外槽位。/wardrobe admin clearslots <player>移除管理员额外槽位。
兼容性说明
RuinedWardrobe 会存储和还原盔甲部件的完整 Bukkit 物品堆栈(ItemStack)。自定义物品和资源包插件在将盔甲暴露为常规 Bukkit ItemStack 数据时效果最佳。RuinedWardrobe 不会创建这些物品;它仅存储、装备并将服务器提供的物品堆栈返回。
链接
- 源码:
- Wiki:
- Issues:
- bStats:
许可证
RuinedWardrobe 可在任何服务器(包括收费服务器)上免费使用。其源码与 JAR 文件可免费使用、修改和分享,但插件本身不得转售或进行商业再分发。完整条款请参阅仓库中的许可证文件。
RuinedWardrobe
RuinedWardrobe is a Paper and Folia wardrobe plugin for servers that want armor cosmetics to feel clean for players and dependable for staff. Players save armor sets into GUI slots, equip or unequip them with one click, rename saved sets, and the plugin handles persistence, bound armor protection, diagnostics, audit logs, and storage migration around it.
Highlights
- Hypixel-style wardrobe GUI with drag and drop armor editing, page navigation, locked slots, and equip buttons.
- Paper and Folia scheduler support.
- Runtime support for Paper/Folia
1.21through26.2. - Java
21+. - Permission tier slots through
ruinedwardrobe.slots.<amount>plus admin bonus slots. - SQLite by default, with optional MySQL or MariaDB for networks.
- Async database pipeline with queue limits, retries, health metrics, and batch sync.
- Bound armor anti-dupe protection for clicks, drags, drops, swaps, armor dispense, and optional container locking.
- GUI editing avoids silent item loss by preventing occupied-piece overwrites and restoring undelivered taken pieces.
- Full Bukkit
ItemStackstorage for custom armor metadata exposed through Bukkit. /wardrobe doctorreports storage, cache, sync, DB probe, and common optional plugin hooks.- Vanilla-compatible death behavior by default, with an option to preserve wardrobe sets on death.
- Audit logs for equips, edits, deaths, sanitizer removals, sync changes, storage errors, and item deserialization failures.
- Anonymous bStats metrics for server/plugin version adoption, with a local opt-out in config.
- Config, GUI, language, and permission templates made for live server management.
Install
- Download the jar for your server version.
- Put it in your server
pluginsfolder. - Start the server once so RuinedWardrobe creates its files.
- Edit
plugins/RuinedWardrobe/config.yml,gui.yml,lang/en_US.yml, and permissions. - Restart the server, or use
/wardrobe reloadafter config-only changes.
Commands
/wardrobeor/rwopens the wardrobe GUI./wardrobe helpshows command help./wardrobe list [player]lists saved wardrobe sets./wardrobe rename <slot> <name>renames one of your saved sets./wardrobe doctorprints runtime diagnostics./wardrobe reloadreloads config, GUI, and language files./wardrobe migrate <sqlite|mysql> [--dry-run] [--force]migrates storage with snapshot verification./wardrobe admin open <player>opens another player's wardrobe./wardrobe admin setslots <player> <amount>adds admin bonus slots./wardrobe admin clearslots <player>removes admin bonus slots.
Compatibility Notes
RuinedWardrobe stores and restores the full Bukkit item stack for armor pieces. Custom item and resource-pack plugins work best when their armor is exposed as normal Bukkit ItemStack data. RuinedWardrobe does not create those items; it stores, equips, and returns the item stack the server gives it.
Links
- Source:
- Wiki:
- Issues:
- bStats:
License
RuinedWardrobe is free to use on any server, including monetized servers. The source and jar can be used, modified, and shared for free, but the plugin itself cannot be resold or commercially redistributed. See the license in the repository for the full terms.
下载 RuinedWardrobe
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 RuinedWardrobe
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 RuinedWardrobe
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 RuinedWardrobe
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 RuinedWardrobe
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 RuinedWardrobe
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 RuinedWardrobe
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 RuinedWardrobe
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 RuinedWardrobe
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 RuinedWardrobe
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
- 将原版风格的死亡物品丢失改为事务性处理:绑定掉落物在衣柜存储提交前暂不释放,随后释放一个标准的未绑定副本。
- 确保 GUI 拾取和放置操作在物品交付或数据库回滚完成前保持锁定状态。
- 修复 Paper/Folia 重载与关闭时的调度问题,防止玩家任务出现死锁或遗留未完成的动作锁。
- 新增 Folia 退役处理机制,用于清理被遗弃的玩家调度工作。
- 通过启用 WAL、完全同步写入、外键约束以及为每个连接设置忙超时,增强 SQLite 的持久性。
- 将数据库重试限制为仅针对真正的瞬时连接、事务、忙锁和锁定失败。
- 在架构升级过程中保留现有配置值,并阻止不安全的配置降级。
- 更新 Gradle wrapper、Shadow、Paper 26.2 验证目标、数据库驱动、bStats、PlaceholderAPI、Caffeine、HikariCP 及测试依赖项。
- 验证 Java 21 基础下从 1.21 到 26.2 版本的 Paper 和 Folia 支持情况。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
插件
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。
评论 0
登录后参与评分
还没有评论,来抢沙发吧