?️ EasyCTF - Minecraft CTF 插件
Minecraft Paper 服务器的策略性夺旗插件
? 概述
EasyCTF 是一款功能丰富的 Minecraft Paper 服务器夺旗插件。红蓝两支队伍在防守己方旗帜的同时,争夺并夺取对方的旗帜。
✨ 主要特性
- ? 多局并发游戏 - 在同一服务器上同时运行多个夺旗游戏
- ?️ 护盾系统 - 在敌方区域受到伤害,仅在己方区域恢复
- ? 商店系统 - 队伍共享货币用于购买战略物品
- ? 比赛系统 - 多轮比赛以决出最终胜者
- ? 多语言支持 - 完整支持日语和英语
- ? 事件宝箱 - 战斗阶段期间的特殊奖励
? 游戏阶段
1️⃣ 建造阶段(2 分钟)
- 放置方块进行防御和进攻
- 禁用玩家对战(PvP 关闭)
- 商店可用
- 无法进入敌方领土
- 立即重生(无延迟)
2️⃣ 战斗阶段(2 分钟)
- 主要夺旗玩法
- 启用玩家对战(PvP)
- 夺取敌方旗帜
- 任何地方均可使用商店(右键点击绿宝石)
- 立即重生(无延迟)
3️⃣ 策略阶段(15 秒)
- 查看回合结果
- 为下一回合做准备
- 立即过渡到下一阶段
? 商店系统
右键点击绿宝石打开商店(任何地方均可使用)
分类
- 武器 - 剑、斧、弓等
- 护甲 - 各种护甲套装
- 消耗品 - 末影珍珠、金苹果、箭矢
- 建筑方块 - 各种方块、TNT
货币获取
- 初始资金:50G
- 击杀奖励:15G(持旗者击杀:25G)
- 助攻奖励:10G
- 夺旗成功:50G
- 夺旗助攻:20G
- 阶段结束奖励:100G
- 连杀奖励:5G-20G
折扣系统
根据分差为落后队伍提供折扣:
- 落后 1 分:9 折
- 落后 2 分:8 折
- 落后 3 分:7 折
- 落后 4 分及以上:6 折
?️ 特殊系统
护盾系统
- 最大值:100
- 在敌方方块/信标区域每秒减少 2
- 护盾为 0 时每秒受到 1.5 点伤害
- 仅在己方领土每秒恢复 5 点(重要的战术元素)
- 警告:低于 40 发出警告,低于 20 危急状态
信标区域效果
- 3x3 区域为特殊区域
- 敌方:伤害区域(护盾减少)
- 友方:饥饿与护盾恢复
队伍方块系统
- 红队:仅能使用红色混凝土
- 蓝队:仅能使用蓝色混凝土
- 需要方块连接(断开连接时失效)
- 无限使用次数
事件宝箱
- 在战斗阶段出现一次
- 获取昂贵的商店物品
- 通知所有玩家
?️ 地图创建
自动检测法(推荐)
-
建造地图
- 红色混凝土:红队出生点(允许多个)
- 蓝色混凝土:蓝队出生点(允许多个)
- 信标 + 红色玻璃:红队旗帜
- 信标 + 蓝色玻璃:蓝队旗帜
-
设置区域
/ctf setpos1 game1 # 设置第一个角
/ctf setpos2 game1 # 设置第二个角
-
保存
/ctf savemap game1 # 自动检测并保存
临时世界系统
- 游戏开始时生成专用世界
- 地图自动还原
- 箱子内容物自动清空
- 游戏结束时删除世界
? 管理员指令
| 指令 |
描述 |
/ctf create <game> |
创建新游戏(交互式) |
/ctf update <game> |
更新游戏设置 |
/ctf delete <game> |
删除游戏 |
/ctf list |
列出所有游戏 |
/ctf info <game> |
游戏详情 |
/ctf start <game> [match] [count] |
开始游戏/比赛 |
/ctf stop <game> |
强制停止 |
/ctf setflag <game> <team> |
设置旗帜位置 |
/ctf setspawn <game> <team> |
设置出生点 |
/ctf addspawn <game> <team> |
添加出生点 |
/ctf removespawn <game> <team> <number> |
移除出生点 |
? 玩家指令
| 指令 |
描述 |
/ctf join <game> |
加入游戏 |
/ctf leave |
离开当前游戏 |
/ctf team [red/blue] |
查看/切换队伍 |
/ctf spectator <game> |
作为观察者加入 |
/ctf status [game] |
游戏状态 |
⚙️ 配置
主配置文件:config.yml
# 语言设置
language: "en" # "en" 或 "ja"
# 阶段时长
default-phases:
build-duration: 120 # 建造阶段(秒)
combat-duration: 120 # 战斗阶段(秒)
result-duration: 15 # 结果显示(秒)
build-phase-gamemode: "SURVIVAL" # ADVENTURE/SURVIVAL/CREATIVE
# 重生设置
default-game:
respawn-delay-base: 0 # 立即重生
respawn-delay-per-death: 0
respawn-delay-max: 0
# 货币设置
currency:
initial: 50 # 初始货币
kill-reward: 15 # 击杀奖励
kill-assist-reward: 10 # 击杀助攻奖励
carrier-kill-reward: 25 # 持旗者击杀
carrier-kill-assist-reward: 10 # 持旗者击杀助攻
capture-reward: 50 # 夺旗奖励
capture-assist-reward: 20 # 夺旗助攻奖励
phase-end-bonus: 100 # 阶段结束奖励
kill-streak-bonus: # 连杀奖励
2-kills: 5
3-kills: 10
4-kills: 15
5-plus-kills: 20
# 护盾设置
shield:
enabled: true
max-shield: 100
decrease-rate: 2.0 # 敌方区域的减少速率
recovery-rate: 5.0 # 己方区域的恢复速率
damage-amount: 1.5 # 护盾为 0 时的伤害量
# 事件宝箱
event-chest:
enabled: true
spawn-count: 1 # 战斗阶段生成数量
? 构建说明
git clone https://github.com/0x48lab/easy_ctf.git
cd easy_ctf
./gradlew shadowJar
生成的 JAR 文件:build/libs/easy_ctf-x.x.x-all.jar
? 更新日志
最新变更
- ✅ 移除阶段之间的间隔(即时转换)
- ✅ 将重生延迟设置为 0(即时重生)
- ✅ 调整货币奖励(击杀 15G,旗手击杀 25G,占领 50G,阶段奖励 100G)
- ✅ 限制护盾恢复仅限己方领地
- ✅ 移除商店使用范围限制(可在任何地方使用)
- ✅ 统一队伍方块为混凝土
- ✅ 信标区域变为伤害区域
- ✅ 事件宝箱内容仅限于商店物品
- ✅ 基于距离的旗帜检测算法
性能优化
- 批量传送处理
- 异步聊天处理
- 高效的方块连接检查
- 地图存储的 GZIP 压缩
? 贡献
欢迎提交拉取请求!请在 Issues 中报告错误并提出功能建议。
? 支持
? 许可证
本项目采用 MIT 许可证发布。
为 Minecraft 社区 ❤️ 制作
?️ EasyCTF - Minecraft CTF Plugin
Strategic CTF Plugin for Minecraft Paper Servers
? Overview
EasyCTF is a feature-rich Capture The Flag plugin for Minecraft Paper servers. Two teams (Red and Blue) compete to capture each other's flags while defending their own.
✨ Key Features
- ? Multiple Concurrent Games - Run multiple CTF games simultaneously on the same server
- ?️ Shield System - Take damage in enemy territory, recover only in your own
- ? Shop System - Team-shared currency for strategic item purchases
- ? Match System - Multiple rounds to determine overall winner
- ? Multi-language - Full support for Japanese and English
- ? Event Chests - Special rewards during combat phase
? Game Phases
1️⃣ Build Phase (2 minutes)
- Place blocks for defense and offense
- No PvP (combat disabled)
- Shop available for purchases
- Cannot enter enemy territory
- Instant respawn (no delay)
2️⃣ Combat Phase (2 minutes)
- Main CTF gameplay
- PvP enabled
- Capture enemy flags
- Shop available anywhere (right-click emerald)
- Instant respawn (no delay)
3️⃣ Strategy Phase (15 seconds)
- View round results
- Prepare for next round
- Transitions immediately to next phase
? Shop System
Right-click emerald to open shop (usable anywhere)
Categories
- Weapons - Swords, axes, bows, etc.
- Armor - Various armor sets
- Consumables - Ender pearls, golden apples, arrows
- Building Blocks - Various blocks, TNT
Currency Earning
- Initial funds: 50G
- Kill reward: 15G (Flag carrier: 25G)
- Kill assist: 10G
- Capture: 50G
- Assist: 20G
- Phase end bonus: 100G
- Kill streak bonus: 5G-20G
Discount System
Discounts for losing team based on score difference:
- 1 point behind: 10% off
- 2 points behind: 20% off
- 3 points behind: 30% off
- 4+ points behind: 40% off
?️ Special Systems
Shield System
- Maximum: 100
- Decreases by 2/sec on enemy blocks/beacon area
- 1.5 damage/sec when shield is 0
- Recovers 5/sec only in own territory (important tactical element)
- Warning: Below 40 warning, below 20 critical
Beacon Area Effects
- 3x3 area is special zone
- Enemy: Damage zone (shield decrease)
- Ally: Hunger & shield recovery
Team Block System
- Red Team: Red concrete only
- Blue Team: Blue concrete only
- Block connection required (neutralizes when disconnected)
- Unlimited usage
Event Chests
- Appear once during combat phase
- Obtain expensive shop items
- Notification to all players
?️ Map Creation
Auto-Detection Method (Recommended)
-
Build Map
- Red concrete: Red team spawn (multiple allowed)
- Blue concrete: Blue team spawn (multiple allowed)
- Beacon + Red glass: Red team flag
- Beacon + Blue glass: Blue team flag
-
Set Region
/ctf setpos1 game1 # Set first corner
/ctf setpos2 game1 # Set second corner
-
Save
/ctf savemap game1 # Auto-detect and save
Temporary World System
- Dedicated world generated at game start
- Map automatically restored
- Chest contents automatically cleared
- World deleted at game end
? Admin Commands
| Command |
Description |
/ctf create <game> |
Create new game (interactive) |
/ctf update <game> |
Update game settings |
/ctf delete <game> |
Delete game |
/ctf list |
List all games |
/ctf info <game> |
Game details |
/ctf start <game> [match] [count] |
Start game/match |
/ctf stop <game> |
Force stop |
/ctf setflag <game> <team> |
Set flag position |
/ctf setspawn <game> <team> |
Set spawn |
/ctf addspawn <game> <team> |
Add spawn |
/ctf removespawn <game> <team> <number> |
Remove spawn |
? Player Commands
| Command |
Description |
/ctf join <game> |
Join game |
/ctf leave |
Leave current game |
/ctf team [red/blue] |
Check/change team |
/ctf spectator <game> |
Join as spectator |
/ctf status [game] |
Game status |
⚙️ Configuration
Main configuration file: config.yml
# Language setting
language: "en" # "en" or "ja"
# Phase durations
default-phases:
build-duration: 120 # Build phase (seconds)
combat-duration: 120 # Combat phase (seconds)
result-duration: 15 # Result display (seconds)
build-phase-gamemode: "SURVIVAL" # ADVENTURE/SURVIVAL/CREATIVE
# Respawn settings
default-game:
respawn-delay-base: 0 # Instant respawn
respawn-delay-per-death: 0
respawn-delay-max: 0
# Currency settings
currency:
initial: 50 # Initial currency
kill-reward: 15 # Kill reward
kill-assist-reward: 10 # Kill assist reward
carrier-kill-reward: 25 # Flag carrier kill
carrier-kill-assist-reward: 10 # Flag carrier kill assist
capture-reward: 50 # Capture reward
capture-assist-reward: 20 # Capture assist reward
phase-end-bonus: 100 # Phase end bonus
kill-streak-bonus: # Kill streak bonus
2-kills: 5
3-kills: 10
4-kills: 15
5-plus-kills: 20
# Shield settings
shield:
enabled: true
max-shield: 100
decrease-rate: 2.0 # Decrease rate in enemy territory
recovery-rate: 5.0 # Recovery rate in own territory
damage-amount: 1.5 # Damage when shield is 0
# Event chest
event-chest:
enabled: true
spawn-count: 1 # Spawns during combat phase
? Build Instructions
git clone https://github.com/0x48lab/easy_ctf.git
cd easy_ctf
./gradlew shadowJar
Generated JAR file: build/libs/easy_ctf-x.x.x-all.jar
? Release Notes
Latest Changes
- ✅ Removed intervals between phases (instant transition)
- ✅ Set respawn delay to 0 (instant respawn)
- ✅ Adjusted currency rewards (Kill 15G, Flag carrier kill 25G, Capture 50G, Phase bonus 100G)
- ✅ Limited shield recovery to own territory only
- ✅ Removed shop usage range restriction (usable anywhere)
- ✅ Unified team blocks to concrete only
- ✅ Beacon area becomes damage zone
- ✅ Event chest contents limited to shop items
- ✅ Distance-based flag detection algorithm
Performance Optimizations
- Batch teleport processing
- Asynchronous chat processing
- Efficient block connection checking
- GZIP compression for map storage
? Contributing
Pull requests are welcome! Report bugs and suggest features in Issues.
? Support
? License
This project is released under the MIT License.
Made with ❤️ for Minecraft Community
评论 0
登录后参与评分
还没有评论,来抢沙发吧