Version：1.0.0

Adaptation Version：Minecraft 26.2 / NeoForge 26.2.0.7-beta

Monster Hunter Tournament is an exciting Minecraft PvP competition mod. Each player is randomly assigned a mob target. Players gain points by hunting their assigned targets, and the first player to reach the target score wins the game.

🎯 Random Target System：Every player gets a random mob target; points are only awarded for killing your assigned target.

🏆 Live Score Competition：BossBar displays match progress, with a leaderboard shown once the game ends.

🎒 Diverse Utility Items：Functional gear including Hunter’s Guide and Detection Eye.

⚙️ Customizable Game Settings：Tweak winning score, player limits, round count and more.

🔨 Full Admin Command Suite：Tools to start, stop, ban mobs, force matches and other moderator controls.

<colgroup><col width="200"><col width="200"><col width="200"></colgroup>

Item Name	Acquisition Method	Function Description
Hunter’s Guide	Automatically given on world join	Right-click to view game status, command list and mob roster.
Detection Eye	Granted at match start / Available in Creative Mode	Right-click to highlight target mobs within a 32-block radius for 15 seconds; item is not consumed if no targets are detected.

/mh join - Join the tournament

/mh leave - Exit the tournament

/mh target - Check your current assigned mob target

/mh score - View your current point total

/mh leaderboard - Pull up the match leaderboard

/mh list hostile - List all hostile mobs

/mh list passive - List all passive mobs

/mh list neutral - List all neutral mobs

/mh start [seconds] - Launch the tournament with a customizable countdown timer

/mh forcestart - Instantly begin the match, skipping countdown and minimum player requirements

/mh stop - Terminate the active tournament

/mh reload - Refresh all mod configuration files

/mh ban <mobname> - Block a specific mob from being assigned as a target

/mh unban <mobname> - Remove a mob from the banned list

/mh banlist - Show all currently banned mobs

File Path：config/monsterhunter-common.toml

<colgroup><col width="200"><col width="200"><col width="200"></colgroup>

Config Key	Default Value	Explanation
winScore	15	Points required to win the tournament
minPlayers	2	Minimum number of players to start a match
maxRounds	10	Maximum number of match rounds allowed
countdownSeconds	10	Length of pre-game countdown (in seconds)
allowJoinMidgame	true	Toggle whether players can join an ongoing tournament

1. Players load into the world and automatically receive a Hunter’s Guide.

2. An admin runs /mh start to trigger the pre-match countdown.

3. The match officially starts:

- Clear all players’ inventories.

- Grant 1 Detection Eye to every participant.

- Assign a random unique mob target to each player.

4. Players earn points by hunting their assigned target mobs.

5. The first player to reach the winning score is declared the victor.

6. Match concludes: all player inventories are cleared, and Hunter’s Guides are reissued to everyone for the next round.