Scavenger-Host

Scavenger Host

Scavenger Host 是 Scavenger 的 GPL-3.0 修改版分支，面向 Minecraft Fabric 物品速通。服务器管理员、版主或单人游戏/LAN 房主可以随机生成或选择目标方块或物品，选择一项额外挑战修饰项，选择单人/双人/三人模式，然后使用 /scavenger startgame 开始限时竞赛。

此分支专为专用服务器、LAN 世界、Radmin VPN 联机和单人游戏世界设计。

新增内容

• 适用于服务器的 Scavenger 挑战，物品、修饰项、计时器、获胜者和胜利画面数据均会同步。
• 为管理员、版主、服务器运营者以及单人游戏/LAN 房主提供控制菜单。
• 将准备步骤与开始步骤分开，因此选择队伍或转动转盘不会启动计时器。
• /scavenger startgame以开始已准备好的挑战。
• 单人、双人和三人竞赛模式。
• 用于管理双人/三人挑战队伍的命令。
• 可自定义 Scavenger 昵称，用于聊天、胜利消息和队伍显示。
• 玩家或队伍找到目标物品时，会发布共享获胜公告。
• 单人获胜流程会显示获胜者，随后断开玩家连接，以便房主重新创建世界。
• 支持 Minecraft 1.21 至 1.21.11，并要求使用对应版本的依赖项。
• 对世界生成修饰项进行更安全的处理：服务器/LAN 挑战会拒绝需要新世界的修饰项，而单人游戏可在需要时重新创建世界。

安装

安装 Fabric Loader 0.18.4 或更高版本、Fabric API、Architectury API，以及适用于你的 Minecraft 版本的 OctoLib 或 ShatterLib 构建版本。

针对你的 Minecraft 版本，只使用一个 Scavenger jar。例如，仅在 Minecraft 1.21.1 上使用 1.21.1 版 Scavenger jar。

在 Modrinth 上，每个 Minecraft 版本都应作为独立的项目版本上传，并附带一个主要 Scavenger jar。不要将其他 Minecraft 版本的 jar 作为额外文件上传。额外文件仅应用于 sources.jar 或 Javadocs 等内容。

版本依赖项

| Minecraft | Fabric API | Architectury | 前置库 |
| — | — | — | — |
| 1.21 | 0.102.0+1.21 | 13.0.8+ | OctoLib 0.6.2+1.21 |
| 1.21.1 | 0.116.12+1.21.1 | 13.0.8+ | OctoLib 0.6.2+1.21 |
| 1.21.2 | 0.106.1+1.21.2 | 14.0.4+ | OctoLib 0.6.2+1.21 |
| 1.21.3 | 0.114.1+1.21.3 | 14.0.4+ | OctoLib 0.6.2+1.21 |
| 1.21.4 | 0.119.4+1.21.4 | 15.0.3+ | OctoLib 0.6.2+1.21 |
| 1.21.5 | 0.128.2+1.21.5 | 16.1.4+ | OctoLib 0.6.2+1.21 |
| 1.21.6 | 0.128.2+1.21.6 | 17.0.6+ | OctoLib 0.6.2+1.21 |
| 1.21.7 | 0.129.0+1.21.7 | 17.0.8+ | OctoLib 0.6.2+1.21 |
| 1.21.8 | 0.136.1+1.21.8 | 17.0.8+ | ShatterLib 0.6.0.4+1.21.8 |
| 1.21.9 | 0.134.1+1.21.9 | 18.0.5+ | ShatterLib 0.6.0.5+1.21.9 |
| 1.21.10 | 0.138.4+1.21.10 | 18.0.8+ | ShatterLib 0.6.0.5+1.21.9 |
| 1.21.11 | 0.141.4+1.21.11 | 19.0.1+ | ShatterLib 0.6.0.8+1.21.11 |

不要混用不同 Minecraft 版本的依赖项。例如，Architectury 19.0.1 适用于 Minecraft 1.21.11，不应安装在 Minecraft 1.21.1 配置中。

如何开始挑战

1. 加入专用服务器、LAN 世界或单人游戏世界。
2. 管理员、运营者、版主或房主打开 Scavenger 菜单或使用命令。
3. 随机生成或选择目标方块/物品。
4. 随机生成或选择修饰项。
5. 选择 solo、duo 或 trio。
6. 如果选择的是 duo 或 trio 模式，则设置队伍。
7. 所有人准备就绪后，运行 /scavenger startgame。

准备挑战不会启动计时器。只有在 /scavenger startgame 后，计时器才会开始。

模式

• solo：每位玩家单独竞速。第一个获得目标物品的玩家获胜。
• duo：每支队伍最多可有 2 名玩家。队伍中任意一名成员获得目标物品，整支队伍即获胜。
• trio：每支队伍最多可有 3 名玩家。队伍中任意一名成员获得目标物品，整支队伍即获胜。

在 duo 或 trio 模式中，没有加入队伍的玩家将以单人身份竞速。游戏开始时，人数超限的队伍将无法参赛。

命令

运行管理命令需要服务器操作员/管理员权限，或拥有单人游戏/LAN 主机访问权限。

/scavenger
/scavenger help
/scavenger menu
/scavenger random
/scavenger random <solo|duo|trio>
/scavenger start <item> <modifier>
/scavenger start <item> <modifier> <solo|duo|trio>
/scavenger startgame
/scavenger stop
/scavenger clear

队伍命令：

/scavenger addteam <leader> add <player>
/scavenger addteam <leader> remove <player>
/scavenger addteam <leader> list
/scavenger addteam <leader> delete
/scavenger addteam <leader> clear
/scavenger team <leader> add <player>
/scavenger teams
/scavenger teamlist
/scavenger teams clear
/scavenger unteam <player>

昵称命令：

/scavenger nick
/scavenger nick <nickname>
/scavenger nick clear
/scavenger nick set <player> <nickname>
/scavenger nick clearplayer <player>
/scavenger nick list

示例：

/scavenger random duo
/scavenger addteam minesgames11 add vanya228
/scavenger nick SpeedRunner
/scavenger start minecraft:diamond scavenger:none trio
/scavenger startgame

配置

配置文件保存在：

config/scavenger.yaml

你可以配置计时器显示、转盘行为、可抽取物品、修饰符黑名单条目、物品黑名单/白名单行为，以及胜利界面的颜色。

许可证与署名

本项目是 catboybinary 的 Scavenger 的修改分支。

• 原项目：https://github.com/catboybinary/scavenger
• 分支源代码仓库：https://github.com/nrxzwq/scavenger-host
• 许可证：GNU 通用公共许可证 v3.0

此分支沿用 GPL-3.0 许可证，包含原始许可证文本，并注明项目经过修改。署名信息及主要分支改动摘要请参阅 NOTICE.md。