TreasureChest-Reloaded - 宝藏箱

TreasureChest 是一款功能丰富的 Minecraft 插件，它允许你将普通的容器（如箱子、熔炉等）转变为具有特殊规则的“宝藏”，支持一次性、无限、随机、共享等多种类型，并能配置丰富的奖励和权限系统。

💡重要须知

• 如果你运行 Minecraft 1.16 或更高版本，你需要 WorldEdit 7.x 才能运行此插件。
• 所有权限均无默认值，你需要一个权限管理插件（如 LuckPerms）。
• 拥有 treasurechest.admin 权限的玩家将获得所有权限，OP 玩家自动拥有此权限。

🎮宝藏类型

普通宝藏

• 玩家第一次打开时看到物品，之后再次打开则显示为空。

无限宝藏

• 玩家每次打开都能看到并取出物品。
• 发射器/投掷器可以无限次发射/投掷其中的物品。

随机宝藏

• 每次打开时，从预设的物品中随机选取一部分显示。
• 也可以设置为无限模式。

共享宝藏

• 所有玩家共享同一个宝藏物品栏，而非每人一个独立库存。

✨核心功能

基础机制

• 遗忘时间：可以设置一个时间，在此时间过后，玩家可以再次搜刮同一个宝藏。
• 自定义消息：可以配置玩家首次发现、再次发现或发现无限宝藏时收到的提示信息。
• 等级限制：可以为宝藏设置特定等级，只有对应等级的玩家才能打开。

管理与操作

• 宝藏组：可以创建宝藏组，以便对一组宝藏进行批量操作。
• 特殊奖励：可以为宝藏添加丰富的奖励，包括：
• 金钱（需 Vault 经济插件）
• 经验值、生命值、饱食度、氧气值
• 药水效果
• 飞行一段时间
• 在指定位置创建爆炸
• 在指定位置放置红石火把
• 执行命令（可由玩家、控制台执行，或临时赋予玩家 OP 权限）
• 广播一系列消息
• 银行劫匪模式：宝藏在被搜刮后无法再次被搜刮，直到搜刮者被杀死。
• 计分板奖励

🔧权限列表

拥有 treasurechest.player 权限的玩家将自动获得以下所有权限：

• treasurechest.access
• treasurechest.count
• treasurechest.count.others
• treasurechest.list

以下是完整的权限节点说明

• treasurechest.access - 允许访问任何类型的宝藏容器。
• treasurechest.access.treasure - 允许打开宝藏箱子。
• treasurechest.access.unlimited - 允许打开无限宝藏。
• treasurechest.count - 允许统计自己找到了多少个宝藏。
• treasurechest.count.others - 允许统计自己或他人找到了多少个宝藏。
• treasurechest.delete - 允许删除宝藏，将其变回普通容器。
• treasurechest.forget - 允许让一个宝藏“忘记”你已搜刮过它。
• treasurechest.forget.others - 允许让一个宝藏“忘记”你或他人已搜刮过它。
• treasurechest.forget.all - 允许让一个宝藏“忘记”任何人已搜刮过它。
• treasurechest.ignoreprotection - 允许在宝藏上启用/禁用第三方保护插件的保护。
• treasurechest.list - 允许查看自己找到的所有宝藏的位置列表。
• treasurechest.list.all - 允许查看服务器上所有宝藏的位置列表。
• treasurechest.random - 允许将宝藏设置为随机模式。
• treasurechest.reload - 允许使用重载命令。
• treasurechest.set - 允许将普通容器变为宝藏，并设置其消息、遗忘时间等。
• treasurechest.unlimited - 允许将宝藏设置为无限模式。
• treasurechest.rank.X - 允许访问特定等级的宝藏（将 X 替换为配置的等级名称）。
• treasurechest.peek - 允许查看宝藏的真实物品栏（对于无限模式的发射器/投掷器很有用）。

🔧命令指南

主命令是 /treasurechest 或其简写 /tchest。

通用命令

• 获取命令帮助
• /tchest [页码]
• /tchest <命令> ? （例如：/tchest setmessage ?）
• 重载配置 - /tchest reload
• 统计搜刮数量 - /tchest count [玩家名]
• 列出已发现的宝藏 - /tchest list [页码]
• 列出服务器所有宝藏 - /tchest list-all [页码]

宝藏操作命令

以下所有命令都需要你正对着一个容器（箱子、双箱、熔炉、发射器、酿造台等）执行。

• 创建新宝藏 / 更新物品
• /tchest set
• /tchest create
• 创建新共享宝藏 / 更新物品 - /tchest set-shared
• 删除宝藏 - /tchest del 或 /tchest delete
• 设置为随机模式
• /tchest setrandom [数量]
• /tchest random [数量]
• /tchest r [数量]
• 例如：一个宝藏有 10 组物品，执行 /tchest random 2 后，每次打开只会随机出现其中的 2 组。
• 设置为无限模式
• /tchest setunlimited
• /tchest unlimited
• /tchest u
• 切换无视保护模式
• /tchest ignoreprotection
• /tchest ip
• 启用后，如果其他插件保护了该容器，本插件会尝试覆盖保护，让玩家仍能获取宝藏。
• 设置消息 - /tchest setmsg [索引] <消息> 或 /tchest setmessage [索引] <消息>
• 设置遗忘时间 - /tchest setforgettime <天> <时> <分> <秒> 或 /tchest setforget <天> <时> <分> <秒>
• 重置个人搜刮记录 - /tchest forget [玩家名]
• 重置所有人搜刮记录 - /tchest forget-allplayers 或 /tchest forget-all
• 管理奖励 - /tchest reward （用于添加、移除、列出奖励）
• 管理等级 - /tchest rank （用于添加、移除、列出等级，需配合权限使用）
• 管理宝藏组 - /tchest group ? （查看组操作帮助）
• 查看真实物品栏 - /tchest peek

消息设置

使用 /tchest setmsg [索引] <消息> 命令可以设置三种消息：

• 首次发现时 - 例如：/tchest setmsg 1 你发现了一个宝藏！
• 已经发现过时 - 例如：/tchest setmsg 2 你已经搜刮过这个宝藏了。
• 发现无限宝藏时 - 例如：/tchest setmsg 3 想要多少就拿多少吧！

你还可以在配置文件中配置默认消息。