HyTrash

HyTrash

一款 Hytale 插件，提供便携式垃圾箱及撤销功能——随时随地删除物品，并通过简单指令恢复。就像 Hytale 背包的“回收站”。

按 Q 键快速清空！ 无需指令——手持垃圾箱按 Q 即可带确认提示快速删除。

功能特性

便携式垃圾箱物品

• 可制作容器 —— 可容纳 36 个物品（相当于一页背包容量）
• 随身携带 —— 冒险时带上垃圾箱，无需跑回固定垃圾桶
• 右键打开 —— 从快捷栏将物品放入垃圾箱
• 3D 模型 —— 手持或丢弃时显示逼真的垃圾桶外观
• 单次制作 —— 仅需 1 个碎石，在工作台（工匠台）制作

删除系统

• 关闭确认 —— 关闭包含物品的垃圾箱时弹出“删除/保留物品”对话框
• ESC 无法跳过 —— 关闭确认无法通过 ESC 键取消，必须做出选择
• Q 键清空 —— 按 Q 键带确认对话框清空
• 批量删除 —— 使用 /hytrash empty 一次清空整个垃圾箱
• 安全第一 —— 未确认前不会误删物品
• 物品数量预览 —— 对话框显示“删除 X 件物品？”及详细数量信息

背包模式

• 切换指令 /hytrash backpack —— 跳过关闭确认，物品保留在箱内
• 重启后保留 —— 背包模式偏好设置会在服务器重启后保留
• 按玩家独立设置 —— 每位玩家独立控制自己的模式

撤销功能

• 5 级撤销历史 —— 可恢复最近 5 次清空操作的物品
• 按玩家独立追踪 —— 每位玩家拥有独立的撤销历史
• 简单指令 —— 输入 /hytrash undo 即可恢复上次清空的物品
• 智能空间检查 —— 若垃圾箱空格不足则不会恢复
• 视觉通知 —— 恢复物品时显示带图标和数量的确认信息

沉浸式音效

所有音频反馈使用 Hytale 原生声音系统：

• 清空垃圾 —— 永久删除物品时播放 SFX_Campfire_Close_Local（垃圾桶盖声音）
• 撤销恢复 —— 恢复物品时播放 SFX_Divine_Respawn（魔法恢复音效）

为什么选择 HyTrash？

便携性 > 固定垃圾桶

传统垃圾系统需：

• ❌ 在基地搭建垃圾桶
• ❌ 每次要删除物品时跑回家
• ❌ 用垃圾处理系统堆满基地
• ❌ 物品永久丢失，无法恢复

HyTrash 让您：

• ✅ 在世界任意位置删除物品
• ✅ 长途冒险时保持背包整洁
• ✅ 恢复误删物品
• ✅ 只需携带一个物品，无需建造基础设施

适用场景

• 探险家 —— 清理地牢中的垃圾战利品
• 建筑家 —— 快速处理多余方块，无需塞满箱子
• 矿工 —— 途中删除圆石和泥土
• 所有人 —— 失误难免，撤销功能是救星！

指令说明

游戏中所有指令均有效：

• /hytrash —— 显示插件信息及指令列表
• /hytrash empty —— 清空手持的垃圾箱（弹出确认对话框）
• /hytrash undo —— 恢复上次清空的物品（最多 5 次）
• /hytrash backpack —— 切换背包模式（跳过关闭确认）

合成配方

工作台（工匠台）

• 输入： 1x 碎石
• 输出： 1x 垃圾箱（36 格）

碎石可通过破坏石块或碎石堆获得。

安装方法

1. 下载 HyTrash-1.1.1.jar
2. 将 JAR 文件放入 Hytale 模组文件夹：
   • %AppData%\Roaming\Hytale\UserData\Mods\
3. 重启 Hytale
4. 在工作台合成垃圾箱！

系统要求

• Hytale 抢先体验版
• Java 21+

技术细节

• 容器容量： 36 格（与背包页面大小一致）
• 撤销历史： 每位玩家 5 次操作
• 数据持久化： 基于 UUID 追踪
• 线程处理： 在世界线程上安全执行
• 界面系统： 带事件绑定的自定义交互页面

版本信息

• 版本： 1.1.1

已知限制

• Hytale UI 接口暂不支持在确认对话框中显示垃圾箱图标
• 撤销系统会完整保留物品元数据（附魔、耐久度等）

未来更新计划

• 更换垃圾箱模型/图标

支持

如有问题或建议，请在模组下方评论。

---

HyTrash —— 您的便携式背包管理方案。放心删除，轻松恢复！