1-1. 简介
TarkovSearch（战利品搜索）是一款模拟《逃离塔科夫》搜刮机制的 Minecraft 插件，由曙光团队开发维护，兼容 Paper / Spigot 1.20.1，已测试支持 Mohist 混合核心。
管理员通过瞄准箱子执行 /ts create 来创建搜刮箱，并通过 54 格 GUI 可视化配置其中的战利品。玩家右键箱子触发逐格动画搜刮，根据稀有度随机获得战利品。
所有代码已在 GitHub 开源，采用 MIT License。
1-2. 命令与权限
所有命令均需要 OP 权限，普通玩家无需任何权限即可搜刮已配置的箱子。
| 命令 | 说明 | 权限 |
|---|---|---|
/ts create | 创建搜刮箱（瞄准箱子执行） | OP |
/ts edit | 编辑已有搜刮箱 | OP |
/ts delete | 删除搜刮箱（恢复为普通箱子） | OP |
/ts reload | 热重载配置 | OP |
1-3. 配置说明
插件使用两个配置文件，均在首次启动时自动生成：
config.yml — 概率与冷却配置
# 稀有度掉落概率（自动归一化）
rarities:
normal: 35.0
rare: 28.0
uncommon: 20.0
epic: 10.0
precious: 5.0
mythic: 2.0
# 搜刮箱冷却时间（秒）
cooldown: 600
messages.yml 支持多语言自定义所有聊天提示文本。
1-4. 稀有度系统
插件内置 6 级稀有度，管理员在 GUI 中右键物品即可切换其稀有度。概率在 config.yml 中配置，插件会自动归一化。
普通 (Normal)
稀有 (Rare)
罕见 (Uncommon)
史诗 (Epic)
珍品 (Precious)
仙品 (Mythic)
搜刮动画
玩家右键搜刮箱后，箱子逐格显示动画：灰板 → 望远镜 → 彩色板，每格时长 1–5 秒随机。搜刮完毕的箱子进入冷却，期间无法再次搜刮。
1-5. 安装指南
构建插件
本地执行 mvn clean package，在 target/ 获得 TarkovSearch-1.0.jar。
放入插件
将 jar 文件复制到服务器的 plugins/ 目录。
启动服务器
启动或重载服务器，插件自动生成 config.yml 和 messages.yml。
创建搜刮箱
在游戏中瞄准一个箱子，执行 /ts create，打开 GUI 拖入战利品，右键设置稀有度，双击保存。