☀ SunManhunt
追逐光明。
SunManhunt 是一款专为 Paper 服务器打造的完整追捕类插件。它提供了一套开箱即用的稳定默认追捕玩法,并允许你在团队需要不同风格的追捕时,添加社交推理、轮换猎物、商店、缩圈以及随机混乱事件等元素。
一个 jar 包。无需客户端模组。无需资源包。无需 NMS(非标准 Minecraft 代码)。
为什么选择 SunManhunt?
- 首次启动即用。 默认游戏为末影龙追捕,包含一名 Runner(逃跑者)、一组 Hunters(追捕者)、60 秒的安全期以及一条 Runner 命。
- 易于运行。 可通过命令启动,或使用四步设置向导。插件自动处理角色分配、指南针、安全期冻结、死亡、重生、断线、结果判定和清理工作。
- 专为多样性打造。 六种可选的变体模式可单独启用或组合启用(需兼容)。
- 管理员友好。 强制加入所有在线玩家、批量分配角色、创建预设、暂停与恢复,以及恢复已保存的活跃对局。
- 无需编码即可配置。 目标、商店、消息和大多数模式调整均位于 YAML 配置文件中。
- 原生适配 Paper。 直接使用 Adventure 和 MiniMessage 格式。没有阴影库(shaded libraries),不依赖服务器内部实现。
默认追捕流程
- 至少两名玩家在线。
- 操作员执行
/sm start。
- SunManhunt 随机选择一名 Runner。其余玩家成为 Hunter。
- 在 60 秒的安全期内,Hunter 被冻结且 PvP 禁用。Runner 可立即移动。
- 每位 Hunter 获得一枚追踪指南针,指向最近的 Runner 并显示距离。
- Runner 通过击败末影龙获胜。Hunter 通过消灭所有 Runner 获胜。
默认设置使用当前生存世界和当前背包物品。SunManhunt 不会创建或重置世界,也不会将玩家传送至大厅。
如果不存在大厅或角色分配,/sm start 将使用所有符合条件的在线玩家。如需更多控制权,请使用 /sm setup、/sm join 或角色命令。
六种可选变体模式
| 模式 |
新增内容 |
| Ghost(幽灵) |
当仍有其他 Runner 存活时,阵亡的 Runner 会变成幽灵。幽灵无法与世界交互,但可以通过脉冲信号揭示附近的 Hunter。 |
| Imposter(内鬼) |
一名 Runner 暗中与 Hunter 结盟。忠诚的 Runner 中有一名侦探可以揭发内鬼。错误的指控会导致侦探死亡。 |
| Rotating Prey(轮换猎物) |
多名 Runner 轮流担任活跃猎物。库存、生命值和经验值可在轮次间转移。 |
| Economy(经济系统) |
通过压力、命中和里程碑赚取 Sun Coins,然后购买雷达扫描、抓钩、烟雾弹和末影珍珠。余额在对局之间保留。 |
| Shrinking Border(缩圈) |
世界边界在可配置的时间内逐渐缩小,并在关键 Runner 里程碑处暂停。对局结束后恢复原始边界。 |
| Scenario Roulette(场景轮盘) |
随机短事件中断追捕。包括“地板是岩浆”、“赏金交换”、“补给空投”、“禁止跳跃”和“随机配方”。 |
模式冲突会在命令和 GUI 中得到强制执行。基础模式始终处于激活状态,所有变体模式默认禁用。
以下是一些值得了解的模式细节:
- Ghost 模式在有多名 Runner 时效果最佳。若只有一名 Runner,死亡会像往常一样结束追捕。
- Imposter 模式至少需要两名 Runner,否则会自动禁用。
- Rotating Prey 可以在启用库存转移时替换 incoming Runner 的库存。启用前请查看模式设置。
- Shrinking Border 影响每个加载的世界,并在事后恢复原始边界。
目标引擎
目标不限于末影龙。支持的目标类型包括:
- 击杀特定实体:龙、凋灵、监守者或其他生物。
- 获取一件物品或全套物品。
- 完成一项进度(advancement)。
- 到达某个世界、环境或坐标。
- 结合 ANY(任意)或 ALL(全部)逻辑组合多个目标。
新的目标和预设可以通过 YAML 添加。添加普通目标无需更新插件。
管理员与服务器工具
/sm setup 打开一个四步设置向导,用于配置角色、目标、模式和启动。
/sm joinall 将所有在线玩家拉入追捕大厅。
/sm role all hunter 强制加入所有在线玩家并分配相同角色。
/sm role add Alice runner 将一名玩家提升为 Runner。
/sm mode 打开模式选择 GUI。
/sm objective 和 /sm preset 管理目标和已保存的配置。
/sm pause、/sm resume、/sm reset 和 /sm reload 涵盖对局管理。
/sm status 显示当前状态、目标、模式、计时器、角色计数和大厅人数。
预设存储目标和模式选择。它们使得为活动、直播或不同玩家群体保持独立配置变得轻松易行。
指南针按可配置的时间间隔更新,通过传送门链接处理跨维度旅行,并且仅在被显示的目标发生变化时重写物品文本。
权限
SunManhunt 为每个命令路径检查单独的权限。
默认玩家默认获得 sunmanhunt.player。这涵盖了帮助、状态、加入和离开、商店、幽灵脉冲、指控以及私人内鬼频道。
操作员默认获得 sunmanhunt.admin。这包括玩家集加上对局管理、设置、重载、强制加入、名单、模式、目标和预设管理。
每个操作都有细粒度的权限选项,包括 sunmanhunt.joinall、sunmanhunt.role.all、sunmanhunt.mode.enable、sunmanhunt.objective.set 和 sunmanhunt.preset.load。完整的权限参考包含在项目文档中。
兼容性
- 需要 Paper。不支持 Spigot。
- 该 jar 包适用于 Paper 1.21.x 至 26.3。主要目标版本为 26.x。
- 该工件使用 Java 21 字节码。1.21.x 服务器请使用 Java 21,当前 26.x 服务器请使用 Java 25。
- 代码基于最旧的受支持 1.21 API 编译,对版本敏感的内容使用能力检查(capability checks),且不包含任何 NMS(非标准 Minecraft 代码)。
- 当前构建已在 Paper 26.3 上通过启动验证,并具备自动化的单元测试和集成测试覆盖率。完整的真实服务器游戏场景矩阵记录在项目仓库中。
安装
- 将 SunManhunt 的 jar 文件放入服务器的
plugins 文件夹中。
- 1.21.x 服务器使用 Java 21,或 26.x 服务器使用 Java 25。
- 重启服务器。
- 可选:安装 PlaceholderAPI 以使用
%sunmanhunt_*% 占位符。
- 运行
/sm setup,或者确保至少两名玩家在线并运行 /sm start。
配置
SunManhunt 会生成四个文件:
config.yml:比赛规则、宽限时间、生命值、指南针间隔、默认模式、持久化设置。
objectives.yml:目标预设。
modes.yml:模式调优、商店、边界设置、情景。
messages.yml:MiniMessage 文本和 SunManhunt 调色板。
默认模式选择位于 config.yml 中的 defaults.modes 下。/sm mode enable 和 /sm mode disable 命令会自动更新此设置。
持久化
启用活跃比赛持久化后,角色、初始角色、目标、模式集、货币、生命值、名称、原始游戏模式、剩余宽限时间、断开连接截止时间以及比赛计时都会定期保存并在关闭时保存。在恢复时,冒充者身份和收缩边界状态会被还原,而旋转猎物(Rotating Prey)会根据保存的初始角色重新构建其旋转候选名单。恢复策略可设置为自动、手动或禁用。
玩家货币和统计数据存储在 plugins/SunManhunt/data/players 中。经济余额跨比赛保留。
PlaceholderAPI
可选占位符包括状态、目标、模式列表、奔跑者、猎人、经过时间、角色、余额、货币名称、距离、大厅人数、比赛 ID 和获胜者。
致谢
SunManhunt 是 Lethargos 开发的 Paper 插件。它专为服务器活动、SMP 追捕以及希望拥有完整基础配置而不愿将所有比赛锁定在单一规则集下的创作者设计。
☀ SunManhunt
Chase the light.
SunManhunt is a complete manhunt plugin for Paper servers. It gives you a stable, default chase that works immediately, then lets you add social deduction, rotating prey, shops, a shrinking border, and random chaos scenarios when your group wants a different kind of hunt.
One jar. No client mod. No resource pack. No NMS.
Why SunManhunt?
- Ready on first start. The default game is an Ender Dragon hunt with one Runner, a team of Hunters, a 60 second grace period, and one Runner life.
- Easy to run. Start with a command or use the four step setup wizard. The plugin handles roles, compasses, grace freezing, deaths, respawns, disconnects, results, and cleanup.
- Built for variety. Six optional twist modes can be enabled individually or in compatible combinations.
- Admin friendly. Force join all online players, mass assign roles, create presets, pause and resume, and recover a saved active match.
- Configurable without code. Objectives, shops, messages, and most mode tuning live in YAML.
- Paper native. Adventure and MiniMessage are used directly from the platform. There are no shaded libraries and no server internals.
The default hunt
- At least two players are online.
- An operator runs
/sm start.
- SunManhunt randomly selects one Runner. Everyone else becomes a Hunter.
- Hunters are frozen and PvP is disabled during the 60 second grace period. The Runner can move immediately.
- Every Hunter receives a tracked compass that points to the nearest Runner and shows the distance.
- The Runner wins by defeating the Ender Dragon. Hunters win by eliminating all Runners.
The default setup uses the current survival world and current inventories. SunManhunt does not create or reset a world and does not teleport players to a lobby.
If no lobby or role assignments exist, /sm start uses all eligible online players. For more control, use /sm setup, /sm join, or the role commands.
Six optional twist modes
| Mode |
What it adds |
| Ghost |
Fallen Runners become ghosts when another Runner remains. Ghosts cannot interact with the world, but they can pulse to reveal nearby Hunters. |
| Imposter |
One Runner is secretly allied with the Hunters. A Detective among the loyal Runners can expose the Imposter. A wrong accusation kills the Detective. |
| Rotating Prey |
Multiple Runners take turns as the active prey. Inventory, health, and XP can transfer between turns. |
| Economy |
Earn Sun Coins through pressure, hits, and milestones, then buy radar pings, grappling hooks, smoke bombs, and ender pearls. Balances persist between matches. |
| Shrinking Border |
The world border closes over a configurable duration and pauses for key Runner milestones. The original border is restored when the match ends. |
| Scenario Roulette |
Random short events interrupt the hunt. Includes Floor is Lava, Bounty Swap, Supply Drop, No Jump, and Randomizer Recipes. |
Mode conflicts are enforced in both the command and GUI. The base mode is always active, and every twist mode is disabled by default.
Some mode details worth knowing:
- Ghost mode works best with multiple Runners. With a single Runner, death ends the hunt as usual.
- Imposter mode requires at least two Runners and disables itself otherwise.
- Rotating Prey can replace the incoming Runner's inventory when inventory transfer is enabled. Review the mode settings before enabling it.
- Shrinking Border affects every loaded world and restores the original borders afterward.
Objective engine
The objective is not limited to the Ender Dragon. Supported objective types include:
- Kill a specific entity: dragon, wither, warden, or another mob.
- Obtain one item or a full set of items.
- Complete an advancement.
- Reach a world, environment, or coordinate.
- Combine objectives with ANY or ALL logic.
New objectives and presets can be added in YAML. No plugin update is required to add a normal objective.
Admin and server tools
/sm setup opens a four step setup wizard for roles, objective, modes, and launch.
/sm joinall pulls every online player into the hunt lobby.
/sm role all hunter force joins every online player and assigns the same role.
/sm role add Alice runner promotes one player to Runner.
/sm mode opens the mode selection GUI.
/sm objective and /sm preset manage the objective and saved configurations.
/sm pause, /sm resume, /sm reset, and /sm reload cover match management.
/sm status shows the current state, objective, modes, timer, role counts, and lobby size.
Presets store an objective and a mode selection. They make it easy to keep separate configurations for events, streams, or different playgroups.
The compass updates on a configurable interval, handles cross dimension travel through portal links, and rewrites item text only when the displayed target changes.
Permissions
SunManhunt checks a separate permission for each command path.
Default players receive sunmanhunt.player by default. This covers help, status, joining and leaving, shops, ghost pings, accusations, and the private imposter channel.
Operators receive sunmanhunt.admin by default. This includes the player set plus match management, setup, reload, force join, and roster, mode, objective, and preset management.
Granular leaves are available for every action, including sunmanhunt.joinall, sunmanhunt.role.all, sunmanhunt.mode.enable, sunmanhunt.objective.set, and sunmanhunt.preset.load. A complete permission reference is included in the project documentation.
Compatibility
- Paper is required. Spigot is not supported.
- The jar is built for Paper 1.21.x through 26.3. The primary target is 26.x.
- The artifact is Java 21 bytecode. Use Java 21 for 1.21.x servers and Java 25 for current 26.x servers.
- The code is compiled against the oldest supported 1.21 API, uses capability checks for version-sensitive content, and contains no NMS.
- The current build is boot verified on Paper 26.3 and has automated unit and integration coverage. The full real-server gameplay matrix is documented in the project repository.
Installation
- Put the SunManhunt jar in your server's
plugins folder.
- Use Java 21 for 1.21.x, or Java 25 for 26.x.
- Restart the server.
- Optional: install PlaceholderAPI for the
%sunmanhunt_*% placeholders.
- Run
/sm setup, or have at least two players online and run /sm start.
Configuration
SunManhunt generates four files:
config.yml: match rules, grace, lives, compass interval, default modes, persistence.
objectives.yml: objective presets.
modes.yml: mode tuning, shops, border settings, scenarios.
messages.yml: MiniMessage text and the SunManhunt palette.
Default mode selection lives in config.yml under defaults.modes. /sm mode enable and /sm mode disable update it for you.
Persistence
With active-match persistence enabled, roles, initial roles, objective, mode set, currency, lives, names, original game modes, remaining grace, disconnect deadlines, and match timing are saved periodically and on shutdown. Imposter identity and Shrinking Border state are restored on resume, while Rotating Prey rebuilds its rotation candidates from the saved initial roles. The resume policy can be set to automatic, manual, or disabled.
Player currency and statistics are stored in plugins/SunManhunt/data/players. Economy balances carry across matches.
PlaceholderAPI
Optional placeholders include state, objective, mode list, runners, hunters, elapsed time, role, balance, currency name, distance, lobby size, match ID, and winner.
Credits
SunManhunt is a Paper plugin by Lethargos. It is designed for server events, SMP manhunts, and creators who want a complete baseline without locking every match into a single rule set.
评论 0
登录后参与评分
还没有评论,来抢沙发吧