Scavenger Host

Scavenger Host is a modified GPL-3.0 fork of Scavenger for Minecraft Fabric item speedruns. It lets a server admin, moderator, or single-player/LAN host roll or choose a target block or item, choose an extra challenge modifier, select solo/duo/trio mode, and then start a timed race with /scavenger startgame.

This fork is designed for dedicated servers, LAN worlds, Radmin VPN play, and single-player worlds.

What It Adds

• Server-ready Scavenger runs with synchronized item, modifier, timer, winner, and victory screen data.
• A control menu for admins, moderators, server operators, and single-player/LAN hosts.
• A separate preparation step and start step, so choosing teams or rolling the wheels does not start the timer.
• /scavenger startgame to begin the prepared run.
• Solo, duo, and trio race modes.
• Team management commands for duo/trio runs.
• Custom Scavenger nicknames for chat, victory messages, and team display.
• Shared win announcements when a player or team finds the target item.
• Solo win flow that shows the winner and then disconnects players so the host can recreate the world.
• Support for Minecraft 1.21 through 1.21.11 with version-specific dependency requirements.
• Safer handling for world-generation modifiers: server/LAN runs reject modifiers that require a new world, while single-player can recreate the world when needed.

Installation

Install Fabric Loader 0.18.4 or newer, Fabric API, Architectury API, and the correct OctoLib or ShatterLib build for your Minecraft version.

Use exactly one Scavenger jar for your Minecraft version. For example, use the 1.21.1 Scavenger jar only on Minecraft 1.21.1.

On Modrinth, each Minecraft version should be uploaded as its own project version with one primary Scavenger jar. Do not upload jars for other Minecraft versions as additional files. Additional files should only be used for things such as sources.jar or Javadocs.

Version Dependencies

Do not mix dependencies from different Minecraft versions. For example, Architectury 19.0.1 is for Minecraft 1.21.11 and should not be installed on a Minecraft 1.21.1 profile.

How To Start A Run

1. Join the dedicated server, LAN world, or single-player world.
2. An admin, operator, moderator, or host opens the Scavenger menu or uses commands.
3. Roll or choose the target block/item.
4. Roll or choose the modifier.
5. Choose solo, duo, or trio.
6. Set up teams if the mode is duo or trio.
7. Run /scavenger startgame when everyone is ready.

Preparing a run does not start the timer. The timer starts only after /scavenger startgame.

Modes

• solo: every player races alone. The first player to obtain the target item wins.
• duo: teams can have up to 2 players. If one team member obtains the target item, the whole team wins.
• trio: teams can have up to 3 players. If one team member obtains the target item, the whole team wins.

Players without a team in duo or trio mode race as solo players. Oversized teams are blocked when the game starts.

Commands

Run management commands require server operator/admin permissions, or single-player/LAN host access.

/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

Team commands:

/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>

Nickname commands:

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

Examples:

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

Configuration

The config file is saved at:

config/scavenger.yaml

You can configure timer display, wheel behavior, rollable items, modifier blacklist entries, item blacklist/whitelist behavior, and victory screen colors.

License And Attribution

This project is a modified fork of Scavenger by catboybinary.

• Original project: https://github.com/catboybinary/scavenger
• Fork source repository: https://github.com/nrxzwq/scavenger-host
• License: GNU General Public License v3.0

This fork keeps the GPL-3.0 license, includes the original license text, and marks the project as modified. See NOTICE.md for attribution and a summary of the major fork changes.