ChallengeUtil - 高级速通与挑战插件
平台: Minecraft 1.21.11 (Paper/Spigot)
依赖项: PlaceholderAPI(可选,用于团队聊天前缀)
概述
ChallengeUtil 是一款专为速通服务器和挑战游戏模式设计的综合 Minecraft 插件。它具备即时世界重置功能(约 30 秒,无需重启服务器!)、内置计时器系统、多种游戏模式以及各种挑战机制,旨在创造独特且引人入胜的游戏体验。
完美适配 Velocity/BungeeCord 代理网络——在世界再生期间,玩家保持连接状态!
主要特性
即时世界重置系统
- 10-20 秒世界再生,无需重启服务器
- Holodeck 策略:在速通世界再生的同时,玩家被平滑转移至等待房间
- 每次重置生成随机种子
- 兼容代理:完全支持 Velocity/BungeeCord,支持自动重连
- 无断线:在整个重置过程中,玩家始终保持连接
- 异步世界删除:世界再生期间零卡顿
高级计时器系统
- 热键栏上方(动作栏)实时显示计时器
- 格式:
HH:MM:SS,带有视觉指示器
- 颜色编码状态:
- 运行时显示浅紫色
- 暂停时显示红色并带有暂停符号 (⏸)
- 支持开始、暂停、重置和恢复功能
- 在暂停/恢复周期中保持持久化
- 支持 PlaceholderAPI 供外部插件使用
多种游戏模式
追猎者模式 (Manhunt Mode)
经典的速通者对抗猎人的玩法:
- 速通者队伍:1+ 名速通者试图击败末影龙
- 猎人队伍:1+ 名猎人试图阻止速通者
- 追踪指南针:猎人获得一枚追踪最近速通者的指南针
- 队伍保护:队友之间免受伤害(可配置)
- 观察者模式:观察者可以观看而不干扰游戏
- 动态生成:猎人在
/start 后 10 分钟生成,以确保平衡性
团队竞速模式 (Team Race Mode)
竞争性的团队速通玩法:
- 2-10 支队伍:可自定义队伍数量,使用德语名称和颜色
- 可用队伍:Rot, Blau, Grün, Gelb, Lila, Aqua, Weiß, Orange, Pink, Grau
- 队伍追踪指南针:每支队伍追踪最近的敌方队伍成员
- 颜色编码 UI:队伍名称以其各自的颜色显示
- 胜利条件:率先击败末影龙的队伍获胜
- 记分板集成:实时跟踪队伍状态和进度
挑战模式
区块物品挑战 (Chunk Items Challenge)
- 进入新区块时获得随机物品
- 玩家专属:不同玩家在同一个区块会获得不同的物品
- 持久化:玩家再次进入同一区块时,获得的物品相同
- 追猎者模式集成:猎人在 10 分钟后才获得物品
- 可配置排除项:自定义哪些物品不会掉落
- 默认排除项:默认排除超强力物品(鞘翅、下界合金装备、不死图腾)
友军伤害 = OP 物品挑战 (Friendly Fire = OP Items Challenge)
攻击队友,获取奖励:
- 伤害同步:攻击者和受害者受到相同的伤害量
- 禁用自然回复:禁用自然生命值回复
- 基于血量的奖励:血量越低,获得的物品越好
- 80-100% HP:基础物品(金苹果、箭矢、铁锭)
- 50-79% HP:中级物品(钻石、附魔铁装备)
- 25-49% HP:强力物品(锋利 V 的钻石装备、不死图腾)
- 1-24% HP:极度超模物品(下界合金、全套附魔钻石装备、多个不死图腾)
- 队伍集成:兼容追猎者模式和团队竞速模式
高级配置
双世界系统
- 等待房间:玩家在重置期间等待的大厅世界(和平模式,时间冻结)
- 速通世界:主世界,使用新种子进行再生
- 自动游戏规则管理:每个世界有不同的游戏规则
- 智能传送:基于地表检测的出生点系统
世界生成设置
- 世界类型:NORMAL, FLAT, LARGE_BIOMES, AMPLIFIED
- 结构生成开关
- 可配置难度
- 随机或固定种子生成
- 自定义出生点坐标
代理集成
- 完全支持 BungeeCord/Velocity
- 世界重置期间自动重连
- 可配置服务器名称
- 包含配套的代理插件
命令
主要命令
| 命令 |
别名 |
描述 |
权限节点 |
/start |
- |
开始或恢复计时器 |
challenge.start |
/pause |
- |
暂停计时器 |
challenge.pause |
/reset |
- |
仅重置计时器(不重置世界) |
challenge.reset |
/fullreset |
/resetworld, /worldreset |
Holodeck 重置 - 即时再生世界(3-5 秒) |
challenge.fullreset |
/join |
/play, /go |
从等待房间加入速通世界 |
challenge.join |
/settings |
/config, /cfg |
打开设置 GUI(仅限等待房间) |
challenge.settings |
/team <name> |
- |
加入队伍(追猎者模式或团队竞速模式) |
challenge.team |
队伍命令示例
追猎者模式:
/team runner - 加入速通者队伍
/team hunter - 加入猎人队伍
/team spectator - 加入观察者
团队竞速模式:
/team - 列出所有可用队伍及成员数量
/team Rot - 加入 Rot 队(红色)
/team Blau - 加入 Blau 队(蓝色)
/team Grün - 加入 Grün 队(绿色)
- 等等。
权限
主要权限
| 权限节点 |
描述 |
默认值 |
challenge.host |
主权限 - 授予所有管理员命令 |
OP |
challenge.start |
开始/恢复计时器 |
OP |
challenge.pause |
暂停计时器 |
OP |
challenge.reset |
仅重置计时器 |
OP |
challenge.fullreset |
执行 Holodeck 重置(世界再生) |
OP |
challenge.settings |
打开设置 GUI |
OP |
challenge.join |
从等待房间加入速通世界 |
True (所有玩家) |
challenge.team |
在追猎者/团队竞速模式中加入队伍 |
True (所有玩家) |
challenge.* |
授予所有权限 |
OP |
权限层级
challenge.host 权限包含以下内容:
challenge.start
challenge.pause
challenge.reset
challenge.fullreset
challenge.settings
主机控制功能
拥有 challenge.host 权限的玩家将获得特殊工具:
主机控制物品
- 附魔的下界之星 在加入时自动发放
- 右键点击 打开主机控制 GUI
- 无需输入指令即可快速访问所有主机命令
主机控制 GUI
具有三个选项的交互式菜单:
- 开始挑战 (绿色羊毛) - 执行
/start
- 设置 (比较器) - 打开
/settings GUI
- ⚠ 完全重置 ⚠ (屏障) - 执行
/fullreset 并显示警告
配置
该插件通过 config.yml 提供广泛的配置功能:
代理设置
proxy:
lobby-server: lobby1 # 代理配置中的大厅服务器名称
this-server-name: challenge1 # 此服务器在代理配置中的名称
世界设置
world:
waiting-room: waiting_room # 备用世界(大厅)
speedrun-world: speedrun_world # 将被重新生成的世界
generation:
type: NORMAL # NORMAL, FLAT, LARGE_BIOMES, AMPLIFIED
generate-structures: true
random-seed: true
difficulty: NORMAL # PEACEFUL, EASY, NORMAL, HARD
teleport:
waiting-room-spawn:
x: 0
y: 65
z: 0
speedrun-spawn:
x: 0
y: 100 # 自动寻找地表
z: 0
游戏规则
为等待室(和平模式、时间冻结)和速通世界(正常游戏)分别配置游戏规则。
挑战设置
challenge:
allow-respawn: true # false = 硬核模式(死亡后变为旁观者)
chunk_items:
excluded: # 从随机奖励中排除的物品
# - DIAMOND
# - EMERALD
friendly_fire_item:
enabled: false # 通过 GUI 切换
PlaceholderAPI 集成(可选)
可用占位符
| 占位符 |
描述 |
示例输出 |
%ch_prefix% |
带颜色的队伍前缀 |
[RUNNER], [HUNTER], [Red] |
%ch_suffix% |
队伍后缀(保留) |
- |
%ch_team% |
原始队伍名称 |
runner, hunter, Rot |
%ch_team_color% |
旧版队伍颜色代码 |
§d, §6, §c |
使用示例
EssentialsX Chat:
format: '{ch_prefix}{DISPLAYNAME}{ch_suffix}§r: {MESSAGE}'
游戏模式对比
模式兼容性矩阵
| 功能 |
Manhunt |
Team Race |
Solo |
| 计时系统 |
✅ |
✅ |
✅ |
| 即时重置 |
✅ |
✅ |
✅ |
| 队伍系统 |
✅ |
✅ |
❌ |
| 追踪指南针 |
✅ (仅限猎人) |
✅ (所有队伍) |
❌ |
| 区块物品挑战 |
✅ |
✅ |
✅ |
| 友军伤害挑战 |
✅ |
✅ |
❌ |
| 多支队伍 |
❌ (2 支队伍) |
✅ (2-10 支队伍) |
❌ |
| 可同时运行 |
❌ |
❌ |
✅ |
注意: Manhunt 和 Team Race 不能同时启用。
技术细节
性能
- 重置时间:通常为 10-30 秒
- 世界删除:异步(非阻塞)
- 世界创建:同步(主线程,已优化)
- 计时器更新:每秒(20 ticks)
- 指南针更新:每秒(20 ticks)
安装
基本安装
- 下载
ChallengeUtil.jar
- 放入服务器的
plugins 文件夹
- 配置
server.properties:
level-name=waiting_room
- 重启服务器
- 配置
plugins/ChallengeUtil/config.yml
- 重载或重启
可选:PlaceholderAPI
- 从 SpigotMC 安装 PlaceholderAPI
- 重启服务器
- 占位符将自动注册
- 在聊天插件中使用(EssentialsX, ChatControl 等)
使用示例
基本速通设置
- 服务器启动时玩家位于等待室
- 管理员:
/settings - 配置挑战设置
- 玩家:
/join - 进入速通世界
- 管理员:
/start - 开始计时
- 玩家:完成速通
- 管理员:
/fullreset - 瞬间完成 3-5 秒重置以进行下一轮
Manhunt 设置
- 在
/settings > Challenges 中启用 Manhunt 模式
- 玩家加入队伍:
/team runner (速跑者)
/team hunter (猎人)
- 管理员:
/start
- 速跑者获得 10 分钟领先优势
- 猎人出生并获得追踪指南针
- 首先击败末影龙获胜
Team Race 设置
- 在
/settings > Challenges 中启用 Team Race
- 玩家:
/team 查看可用队伍
- 玩家加入队伍:
/team Rot, /team Blau 等
- 管理员:
/start
- 所有队伍获得追踪指南针
- 竞速击败末影龙
- 第一支获胜的队伍胜出!
故障排除
常见问题
"Waiting room not found"
- 验证
server.properties 中的 level-name=waiting_room
- 确保等待室世界文件夹存在
重置缓慢 (>60 秒)
- 使用 Paper 而非 Spigot
- 使用 SSD 而非 HDD
- 减小世界尺寸/减少预生成
- 检查服务器 TPS
玩家掉入虚空
- 在 config.yml 中将
speedrun-spawn.y 增加到 120+
- 插件会自动寻找地表,但较高的 Y 坐标更有帮助
每次重置种子相同
- 在 config.yml 中设置
random-seed: false
指南针无效
- 确保玩家在同一个维度
- 检查目标玩家是否在线
- 使用
/team 验证队伍分配
聊天前缀未显示
- 安装 PlaceholderAPI
- 检查扩展是否已注册:
/papi list
- 重载 PlaceholderAPI:
/papi reload
- 验证聊天插件配置
适用场景
- 速通服务器:用于练习或比赛的即时重置
- 挑战服务器:独特的游戏玩法机制
- Manhunt 服务器:经典的猎人与速跑者对抗
- 团队竞赛:多队伍竞速
- 练习服务器:快速重置以提升技巧
- 内容创作:主播和 YouTuber
- 代理网络:多个并行的速通实例
许可证
MIT License - 任何服务器均可免费使用!
为什么选择 ChallengeUtil?
即时重置 - 10-30秒,无需重启服务器
独特挑战 - 区块物品、友军伤害
代理优化 - 完美适用于网络
高度可配置 - 自定义一切
PlaceholderAPI - 完全集成
性能优先 - 经过优化和测试
用户友好 - 基于 GUI 的配置界面
活跃开发 - 定期更新
为 Minecraft 速通社区用心打造 ❤️
立即下载,革新你的速通服务器!
ChallengeUtil - Advanced Speedrunning & Challenge Plugin
Platform: Minecraft 1.21.11 (Paper/Spigot)
Dependencies: PlaceholderAPI (optional, for team chat prefixes)
Overview
ChallengeUtil is a comprehensive Minecraft plugin designed for speedrunning servers and challenge gamemodes. It features instant world resets (~30 seconds, no server restart!), a built-in timer system, multiple game modes, and various challenge mechanics to create unique and engaging gameplay experiences.
Perfect for Velocity/BungeeCord proxy networks - players stay connected during world regeneration!
Key Features
Instant World Reset System
- 10-20 second world regeneration without server restart
- Holodeck Strategy: Players are smoothly transferred to a waiting room while the speedrun world regenerates
- Random seed generation for each reset
- Proxy-friendly: Full Velocity/BungeeCord support with auto-reconnect
- No disconnections: Players remain connected throughout the entire reset process
- Async world deletion: Zero lag during world regeneration
Advanced Timer System
- Real-time timer display above the hotbar (action bar)
- Format:
HH:MM:SS with visual indicators
- Color-coded states:
- Light Purple when running
- Red with pause symbol (⏸) when paused
- Start, pause, reset, and resume functionality
- Persistent through pause/resume cycles
- PlaceholderAPI support for external plugins
Multiple Game Modes
Manhunt Mode
Classic speedrunner vs hunters gameplay:
- Runner Team: 1+ speedrunners trying to defeat the Ender Dragon
- Hunter Team: 1+ hunters trying to stop the runners
- Tracking Compass: Hunters receive a compass that tracks the nearest runner
- Team Protection: Friendly fire protection within teams (configurable)
- Spectator Mode: Spectators can watch without interfering
- Dynamic Spawning: Hunters spawn 10 minutes after
/start for balanced gameplay
Team Race Mode
Competitive team-based speedrunning:
- 2-10 Teams: Customizable team count with German names and colors
- Available Teams: Rot, Blau, Grün, Gelb, Lila, Aqua, Weiß, Orange, Pink, Grau
- Team Tracking Compass: Each team tracks the nearest enemy team member
- Color-coded UI: Team names appear in their respective colors
- Win Condition: First team to defeat the Ender Dragon wins
- Scoreboard Integration: Real-time team tracking and status
Challenge Modes
Chunk Items Challenge
- Receive random items when entering new chunks
- Player-specific: Different players get different items from the same chunk
- Persistent: Each chunk gives the same item to a player on re-entry
- Manhunt Integration: Hunters receive items only after 10 minutes
- Configurable Exclusions: Customize which items can drop
- Default Exclusions: Overpowered items (Elytra, Netherite gear, Totems) excluded by default
Friendly Fire = OP Items Challenge
Damage teammates, get rewards:
- Damage Sync: Both attacker and victim take the same damage
- No Natural Regen: Natural health regeneration disabled
- Health-Based Rewards: Lower health = better items
- 80-100% HP: Basic items (Golden Apples, Arrows, Iron)
- 50-79% HP: Medium items (Diamonds, Enchanted Iron gear)
- 25-49% HP: Strong items (Diamond gear with Sharpness V, Totems)
- 1-24% HP: Extremely OP items (Netherite, fully enchanted diamond gear, multiple totems)
- Team Integration: Works with both Manhunt and Team Race modes
Advanced Configuration
Dual-World System
- Waiting Room: Lobby world where players wait during resets (peaceful, frozen time)
- Speedrun World: Main world that gets regenerated with new seeds
- Automatic Gamerule Management: Different gamerules for each world
- Smart Teleportation: Surface-detection spawn system
World Generation Settings
- World types: NORMAL, FLAT, LARGE_BIOMES, AMPLIFIED
- Structure generation toggle
- Configurable difficulty
- Random or fixed seed generation
- Custom spawn coordinates
Proxy Integration
- Full BungeeCord/Velocity support
- Auto-reconnect during world resets
- Configurable server names
- Companion proxy plugin included
Commands
Main Commands
| Command |
Aliases |
Description |
Permission |
/start |
- |
Start or resume the timer |
challenge.start |
/pause |
- |
Pause the timer |
challenge.pause |
/reset |
- |
Reset timer only (no world reset) |
challenge.reset |
/fullreset |
/resetworld, /worldreset |
Holodeck reset - regenerate world instantly (3-5 sec) |
challenge.fullreset |
/join |
/play, /go |
Join the speedrun world from waiting room |
challenge.join |
/settings |
/config, /cfg |
Open settings GUI (waiting room only) |
challenge.settings |
/team <name> |
- |
Join a team (Manhunt or Team Race) |
challenge.team |
Team Command Examples
Manhunt Mode:
/team runner - Join the runner team
/team hunter - Join the hunter team
/team spectator - Join spectators
Team Race Mode:
/team - List all available teams and member counts
/team Rot - Join Team Rot (Red)
/team Blau - Join Team Blau (Blue)
/team Grün - Join Team Grün (Green)
- etc.
Permissions
Main Permissions
| Permission |
Description |
Default |
challenge.host |
Master permission - grants all admin commands |
OP |
challenge.start |
Start/resume the timer |
OP |
challenge.pause |
Pause the timer |
OP |
challenge.reset |
Reset timer only |
OP |
challenge.fullreset |
Execute Holodeck reset (world regeneration) |
OP |
challenge.settings |
Open settings GUI |
OP |
challenge.join |
Join speedrun world from waiting room |
True (all players) |
challenge.team |
Join teams in Manhunt/Team Race |
True (all players) |
challenge.* |
Grant all permissions |
OP |
Permission Hierarchy
The challenge.host permission includes:
challenge.start
challenge.pause
challenge.reset
challenge.fullreset
challenge.settings
Host Control Features
Players with the challenge.host permission receive special tools:
Host Control Item
- Enchanted Nether Star automatically given on join
- Right-click to open Host Control GUI
- Quick access to all host commands without typing
Host Control GUI
Interactive menu with three options:
- Start Challenge (Green Wool) - Executes
/start
- Settings (Comparator) - Opens
/settings GUI
- ⚠ FULL RESET ⚠ (Barrier) - Executes
/fullreset with warning
Configuration
The plugin features extensive configuration through config.yml:
Proxy Settings
proxy:
lobby-server: lobby1 # Lobby server name in proxy config
this-server-name: challenge1 # This server's name in proxy config
World Settings
world:
waiting-room: waiting_room # Fallback world (lobby)
speedrun-world: speedrun_world # World that gets regenerated
generation:
type: NORMAL # NORMAL, FLAT, LARGE_BIOMES, AMPLIFIED
generate-structures: true
random-seed: true
difficulty: NORMAL # PEACEFUL, EASY, NORMAL, HARD
teleport:
waiting-room-spawn:
x: 0
y: 65
z: 0
speedrun-spawn:
x: 0
y: 100 # Auto-finds surface
z: 0
Gamerules
Separate gamerule configurations for waiting room (peaceful, frozen time) and speedrun world (normal gameplay).
Challenge Settings
challenge:
allow-respawn: true # false = hardcore mode (spectator on death)
chunk_items:
excluded: # Items to exclude from random rewards
# - DIAMOND
# - EMERALD
friendly_fire_item:
enabled: false # Toggle via GUI
PlaceholderAPI Integration (optional)
Available Placeholders
| Placeholder |
Description |
Example Output |
%ch_prefix% |
Team prefix with color |
[RUNNER], [HUNTER], [Red] |
%ch_suffix% |
Team suffix (reserved) |
- |
%ch_team% |
Raw team name |
runner, hunter, Rot |
%ch_team_color% |
Legacy team color code |
§d, §6, §c |
Usage Example
EssentialsX Chat:
format: '{ch_prefix}{DISPLAYNAME}{ch_suffix}§r: {MESSAGE}'
Game Modes Comparison
Mode Compatibility Matrix
| Feature |
Manhunt |
Team Race |
Solo |
| Timer System |
✅ |
✅ |
✅ |
| Instant Reset |
✅ |
✅ |
✅ |
| Team System |
✅ |
✅ |
❌ |
| Tracking Compass |
✅ (Hunters only) |
✅ (All teams) |
❌ |
| Chunk Items Challenge |
✅ |
✅ |
✅ |
| Friendly Fire Challenge |
✅ |
✅ |
❌ |
| Multiple Teams |
❌ (2 teams) |
✅ (2-10 teams) |
❌ |
| Can Run Simultaneously |
❌ |
❌ |
✅ |
Note: Manhunt and Team Race cannot be enabled simultaneously.
Technical Details
Performance
- Reset Time: 10-30 seconds typical
- World Deletion: Async (non-blocking)
- World Creation: Sync (main thread, optimized)
- Timer Updates: Every second (20 ticks)
- Compass Updates: Every second (20 ticks)
Installation
Basic Installation
- Download
ChallengeUtil.jar
- Place in your server's
plugins folder
- Configure
server.properties:
level-name=waiting_room
- Restart your server
- Configure
plugins/ChallengeUtil/config.yml
- Reload or restart
Optional: PlaceholderAPI
- Install PlaceholderAPI from SpigotMC
- Restart server
- Placeholders automatically register
- Use in chat plugins (EssentialsX, ChatControl, etc.)
Usage Examples
Basic Speedrun Setup
- Server starts with players in waiting room
- Admin:
/settings - Configure challenge settings
- Players:
/join - Enter speedrun world
- Admin:
/start - Begin timer
- Players: Complete speedrun
- Admin:
/fullreset - Instant 3-5 second reset for next run
Manhunt Setup
- Enable Manhunt mode in
/settings > Challenges
- Players join teams:
/team runner (speedrunners)
/team hunter (hunters)
- Admin:
/start
- Runners get 10-minute head start
- Hunters spawn and receive tracking compass
- First team to defeat Ender Dragon wins
Team Race Setup
- Enable Team Race in
/settings > Challenges
- Players:
/team to see available teams
- Players join teams:
/team Rot, /team Blau, etc.
- Admin:
/start
- All teams receive tracking compasses
- Race to defeat the Ender Dragon
- First team wins!
Troubleshooting
Common Issues
"Waiting room not found"
- Verify
level-name=waiting_room in server.properties
- Ensure waiting room world folder exists
Slow resets (>60 seconds)
- Use Paper instead of Spigot
- Use SSD instead of HDD
- Reduce world size/pregenerate less
- Check server TPS
Players fall into void
- Increase
speedrun-spawn.y to 120+ in config.yml
- Plugin auto-finds surface, but high Y helps
Same seed every reset
- Set
random-seed: false in config.yml
Compass not working
- Ensure players are in the same dimension
- Check that target players are online
- Verify team assignments with
/team
Chat prefixes not showing
- Install PlaceholderAPI
- Check if expansion is registered:
/papi list
- Reload PlaceholderAPI:
/papi reload
- Verify chat plugin configuration
Perfect For
- Speedrunning Servers: Instant resets for practice or races
- Challenge Servers: Unique gameplay mechanics
- Manhunt Servers: Classic hunter vs speedrunner
- Team Competition: Multi-team races
- Practice Servers: Quick reset for skill improvement
- Content Creation: Streamers and YouTubers
- Proxy Networks: Multiple parallel speedrun instances
License
MIT License - Free to use for any server!
**Why Choose ChallengeUtil?
**
Instant Resets - 10-30 seconds, no server restart
Unique Challenges - Chunk Items, Friendly Fire
Proxy Optimized - Perfect for networks
Highly Configurable - Customize everything
PlaceholderAPI - Full integration
Performance Focused - Optimized and tested
User-Friendly - GUI-based configuration
Active Development - Regular updates
Built with ❤️ for the Minecraft speedrunning community
Download now and revolutionize your speedrunning server!
评论 0
登录后参与评分
还没有评论,来抢沙发吧