Author：NineFall

Version：1.0.0

Adaptation Version：Minecraft 26.2 / NeoForge 26.2.0.7-beta

1. Project Overview

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.

2. Mod Features

🎯 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.

3. Game Items

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.

4. Command List

4.1 Player Commands

/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

4.2 Admin (Creative Mode) Commands

/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

5. Configuration File

File Path：config/monsterhunter-common.toml

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

6. Game Flow

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.

作者：NineFall

版本：1.0.0

适配版本：Minecraft 26.2 / NeoForge 26.2.0.7-beta

一、项目概述

怪物猎人积分赛是一款紧张刺激的 Minecraft PvP 竞技模组！玩家将被随机分配不同的生物作为击杀目标，通过猎杀目标生物获得积分，率先达到目标分数的玩家获胜！

二、游戏特色

🎯 随机目标系统：每位玩家随机获得目标生物，仅击杀指定目标可得分。

🏆 实时积分竞技：BossBar 实时显示比赛进度，对局结束后展示专属排行榜。

🎒 丰富功能道具：内置猎人指南、探测之眼等专属竞技道具。

⚙️ 灵活自定义配置：可自定义获胜分数、玩家人数、最大回合数等核心参数。

🔨 完整管理员指令：支持开局、停赛、生物封禁、强制开局等全套管理功能。

三、游戏道具

道具名称	获取方式	功能说明
猎人指南	进入世界自动发放	右键查看游戏状态、指令列表、全部生物列表。
探测之眼	游戏开始自动赠送 / 创造模式可直接获取	右键高亮32格范围内的目标生物，持续15秒；未探测到目标不消耗道具。

四、指令列表

4.1 玩家指令

/mh join - 加入游戏

/mh leave - 离开游戏

/mh target - 查看当前目标生物

/mh score - 查看个人当前积分

/mh leaderboard - 查看全局排行榜

/mh list hostile - 查看全部敌对生物列表

/mh list passive - 查看全部被动生物列表

/mh list neutral - 查看全部中立生物列表

4.2 管理员指令（创造模式）

/mh start [秒数] - 自定义倒计时开启游戏

/mh forcestart - 强制开局，跳过倒计时与人数限制

/mh stop - 终止当前正在进行的游戏

/mh reload - 重载模组全部配置文件

/mh ban <生物名> - 封禁指定生物（无法被选为目标）

/mh unban <生物名> - 解封指定生物

/mh banlist - 查看所有已封禁生物列表

五、配置文件

文件路径：config/monsterhunter-common.toml

配置键	默认值	配置说明
winScore	15	获胜所需积分
minPlayers	2	开启游戏所需最小玩家数
maxRounds	10	游戏最大回合数
countdownSeconds	10	游戏开启倒计时时长（秒）
allowJoinMidgame	true	是否允许玩家中途加入游戏

六、游戏流程

1. 玩家进入世界，自动获得道具【猎人指南】。

2. 管理员执行 /mh start，开启游戏倒计时。

3. 倒计时结束，游戏正式开始：

- 清空所有参与玩家背包。

- 为每位玩家发放1个探测之眼。

- 为每位玩家随机分配专属猎杀目标生物。

4. 玩家通过猎杀个人专属目标生物获取积分。

5. 率先达到设定获胜积分的玩家，即为本局胜者。

6. 游戏结束，清空所有玩家背包，重新自动发放猎人指南，等待下一局开启。

MonsterHunter