- 版权类型
- 原创
- 插件中文名称
- 一个幸运之柱
- 插件英文名称
- theluckypillars
- 原帖地址
- #
- 支持的核心(服务端)
- Spigot
- Paper
- 语言支持
- 多语言
- 前置组件
- multiverse https://modrinth.com/plugin/multiverse-core
- 适配版本(Java)
- 26.x
- 1.21
- 1.20
幸运之柱 theluckypillars
一个面向 Paper 1.20+ 的中文多人小游戏插件:玩家站在各自的柱子上,持续获得随机物品,活到最后的人获胜。支持等待期指南针投票、多个特殊模式、Multiverse 多世界多竞技场、每柱多人、比赛限时和战绩统计。- 插件名:theluckypillars
- 主命令:/pill
- 默认语言:中文;可在配置中切换 其他语言
- 默认倒计时开始人数:4 人(settings.start-players)
- 默认每根柱子最多 1 人(/pill teammax 可改)
- 默认最大比赛时间:1800 秒;超时平局
- 默认倒计时:30 秒
- 默认基础发物品间隔:5 秒
- 等待期间右键指南针打开模式投票
- /pill arenas 打开所有竞技场地图 GUI,点击地图直接加入
- /pill autojoin 自动加入等待人数最多的竞技场
- 竞技场创建后默认禁用,需要 /pill enable <竞技场> 启用
- 随机幸运事件:回满血、飞行、打乱背包、关闭击退、生物入侵
- 比赛结束后自动恢复边界内所有方块(含流体、容器内容),并清除边界内非玩家实体
已测试环境
| 项目 | 版本 |
|---|---|
| 服务端 | Paper 1.21.11 |
| 世界管理 | Multiverse-Core 5.8.2 |
| 编译目标 | Java 17,Paper API 1.20.1 |
| 运行 Java | Java 26(服务端要求 Java 21+) |
安装
- 将 theluckypillars-1.0.0.jar 放入服务端 plugins/ 目录。
- 可选:安装 Multiverse-Core(如果你需要多世界竞技场)。
- 重启服务器。
- 首次启动会生成:
- plugins/theluckypillars/config.yml:比赛、投票、模式、语言、物品配置
- plugins/theluckypillars/messages.yml:中文提示文本(默认)
- plugins/theluckypillars/messages_en.yml:英文提示文本(切换英文后生成)
- plugins/theluckypillars/arenas.yml:竞技场数据
- plugins/theluckypillars/stats.yml:玩家战绩
快速开始
1. 创建竞技场
代码块/pill create 竞技场1
2. 设置三维边界
先站到竞技场最低角:代码块
/pill pos 1 竞技场1
再飞到最高角:
代码块
/pill pos 2 竞技场1
3. 设置等待大厅
代码块/pill wainlobby 竞技场1
/pill waitlobby 竞技场1 也可以。
4. 添加柱子
站在每根柱子顶部:代码块
/pill pl add 竞技场1
柱子数量、每柱人数和开始人数共同决定容量:最大人数 = 柱子数 × 每柱人数。默认每柱 1 人、开始人数 4 人,因此默认至少需要 4 根柱子。
5. 设置主大厅
代码块/pill lobby
6. 开始游戏
代码块/pill autojoin
autojoin 会优先选择当前等待人数最多的可加入竞技场;人数相同则随机。也可以:
代码块
/pill join 竞技场1
8. 查看地图 GUI
代码块/pill arenas
打开所有竞技场的地图列表,可查看状态、启用状态、人数、柱子数、等待大厅、当前模式;点击地图图标直接加入该竞技场。禁用或不满足条件的竞技场会提示原因。超过 45 个竞技场时支持翻页。
7. 等待期间投票
加入等待大厅后快捷栏会获得指南针,右键指南针打开模式投票菜单,点击图标投票:- 每个玩家一票,可以随时改票。
- 票数最多的模式生效;平票时随机。
- 没有玩家投票时使用 vote.default-mode(默认 normal)。
- 开局后菜单关闭,指南针被清除。
命令列表
| 命令 | 说明 | 权限 |
|---|---|---|
| /pill create <竞技场> | 创建竞技场 | pill.admin |
| /pill del <竞技场> | 删除竞技场(进行中会先清场并恢复地图) | pill.admin |
| /pill lobby | 将当前位置设为主大厅 | pill.admin |
| /pill pos <1|2> <竞技场> | 设置竞技场边界角点 | pill.admin |
| /pill pl add <竞技场> | 在当前位置添加一根柱子 | pill.admin |
| /pill pl del <竞技场> | 删除最后添加的柱子 | pill.admin |
| /pill wainlobby <竞技场> | 设置该竞技场的等待大厅 | pill.admin |
| /pill event <竞技场> mob-invasion | 手动触发一次生物入侵(测试/管理) | pill.admin |
| /pill enable <竞技场> | 启用竞技场 | pill.admin |
| /pill disable <竞技场> | 禁用竞技场(disabled 也可) | pill.admin |
| /pill teammax <竞技场> <人数> | 设置每根柱子的最大人数 | pill.admin |
| /pill maxtime <竞技场> [秒数] | 设置/查看比赛最大时间,超时平局 | pill.admin |
| /pill start [竞技场] | 强制开始比赛,省略竞技场时使用当前竞技场 | pill.admin |
| /pill stop [竞技场] | 停止比赛,省略竞技场时使用当前竞技场 | pill.admin |
| /pill autojoin | 加入等待人数最多的可加入竞技场 | pill.play |
| /pill join <竞技场> | 加入指定竞技场 | pill.play |
| /pill leave | 离开比赛并返回主大厅 | pill.play |
| /pill list | 查看所有竞技场 | 所有人 |
| /pill arenas | 打开所有竞技场的地图 GUI | pill.play |
| /pill info [竞技场] | 查看竞技场状态 | 所有人 |
| /pill stat [玩家] | 查看战绩(默认自己) | pill.play |
| /pill reload | 重载 config.yml 和当前语言文本 | pill.admin |
| /pill help | 查看帮助 | 所有人 |
模式投票
| 模式 key | 名称 | 效果 |
|---|---|---|
| none | 无特殊事件 | 纯基础对局,关闭幸运事件 |
| normal | 普通 | 基础对局,保留随机幸运事件 |
| tnt-rain | TNT 雨 | 竞技场上空持续落下 TNT |
| lava-rise | 岩浆上涨 | 岩浆从竞技场底部一层层上涨 |
| player-swap | 位置互换 | 周期性随机交换存活玩家位置 |
| fast-loot | 快速给予物品 | 发物品间隔改为配置值(默认 2 秒) |
| slow-loot | 慢速给予物品 | 发物品间隔改为配置值(默认 12 秒) |
| low-knockback | 击退减小 | 受到的击退降低 |
| high-knockback | 击退增大 | 受到的击退增强 |
| long-reach | 攻击距离变长 | 额外攻击距离(需要 1.20.5+) |
| one-hit | 一击必杀 | 玩家造成的攻击直接致命 |
| jump-speed | 跳跃提升 + 迅捷 | 所有存活玩家获得跳跃提升与速度 |
| magma-floor | 岩浆地面 | 玩家脚下方块周期性变成岩浆块 |
| no-attack-cooldown | 无攻击冷却 | 大幅提高攻击速度,取消武器攻击冷却 |
配置说明
语言
yamllanguage: zh_CN # 中文(默认)
# language: en_US # English
# language: ja_JP # 日本語
# language: ru_RU # Русский
# language: de_DE # Deutsch
# language: ko_KR # 한국어
- 中文:plugins/theluckypillars/messages.yml
- 英文:plugins/theluckypillars/messages_en.yml
- 日文:plugins/theluckypillars/messages_ja.yml
- 俄文:plugins/theluckypillars/messages_ru.yml
- 德文:plugins/theluckypillars/messages_de.yml
- 韩文:plugins/theluckypillars/messages_ko.yml
- 切换语言后执行 /pill reload。对应语言文件会在首次切换时自动生成。
比赛设置
yamlsettings:
start-players: 4 # 倒计时开始所需人数
countdown-seconds: 30
lobby-protection-radius: 24.0 # 等待/主大厅保护半径
loot-interval-seconds: 5 # 基础发物品间隔
first-loot-delay-seconds: 0
end-delay-seconds: 5
max-region-blocks: 1000000
reset-blocks-per-tick: 10000
allow-building: true
restore-gamemode: true
restore-inventory: true # 退出比赛后恢复进入前的背包、等级和经验
give-bed-in-waiting-lobby: true
spectator:
invisible: true
allow-flight: true
invulnerable: true
- restore-inventory: true 会保存玩家进入等待大厅前的背包、等级和经验,比赛结束/离开后恢复;设为 false 则退出时保持原来的清空行为。
- 竞技场容量 = 柱子数 × teammax。
- start-players 不能大于竞技场容量,否则无法加入。
- 竞技场默认创建为禁用状态,设置完成后需 /pill enable <竞技场>。
- 等待大厅和主大厅半径内禁止破坏方块、放置方块和 PvP。
- /pill maxtime <竞技场> <秒数> 可单独设置每个竞技场的最大比赛时间,默认 1800 秒;达到后平局。
- /pill start [竞技场] 可低于 start-players 强制开局;省略竞技场时使用自己当前所在竞技场。
- /pill stop [竞技场] 会停止倒计时;比赛进行中则按平局结算并重置。
下界传送门彩蛋
yamlportal-easter-egg:
enabled: true
mob-count: 8
cooldown-seconds: 60
types:
- ZOMBIE
- SKELETON
- BLAZE
- PIGLIN_BRUTE
- MAGMA_CUBE
- 比赛中存活玩家点燃下界传送门时,会在传送门附近生成一群下界敌对生物。
- 每个竞技场有冷却时间,避免连续刷怪。
- 生成的下界生物会在本局结束/竞技场重置时清除。
- 玩家无法通过这个传送门进入下界,只会收到提示。
模式投票与参数
yamlvote:
enabled: true
compass-slot: 0 # 指南针在快捷栏的位置 0-8
default-mode: normal # 无人投票时的模式
modes:
fast-loot:
interval-seconds: 2
slow-loot:
interval-seconds: 12
low-knockback:
multiplier: 0.4
high-knockback:
multiplier: 1.8
long-reach:
bonus: 2.0 # 实际攻击距离 = 3.0 + bonus
jump-speed:
jump-amplifier: 1
speed-amplifier: 1
magma-floor:
interval-seconds: 3
tnt-rain:
interval-seconds: 8
count: 2
fuse-ticks: 60
lava-rise:
interval-seconds: 15
player-swap:
interval-seconds: 60
no-attack-cooldown:
attack-speed: 100.0
幸运事件
yamllucky-events:
enabled: true
cooldown-seconds: 180 # 默认 3 分钟
duration-seconds: 15 # 默认持续 15 秒
mob-invasion:
enabled: true
weight: 2
count: 3
types: [ZOMBIE, SKELETON, SPIDER, CREEPER]
full-heal:
enabled: true
weight: 5
flight:
enabled: true
weight: 4
shuffle-inventory:
enabled: true
weight: 4
no-knockback:
enabled: true
weight: 4
| 事件 | 效果 |
|---|---|
| full-heal 天降恩惠 | 所有存活玩家立刻回满生命值和饱食度 |
| flight 自由翱翔 | 所有存活玩家临时获得飞行能力 |
| shuffle-inventory 背包大乱斗 | 随机打乱所有存活玩家的物品栏 |
| no-knockback 稳如泰山 | 持续期间免疫击退 |
| mob-invasion 生物入侵 | 生成一群敌对生物 |
- weight 越大越容易被抽中;默认回血/飞行/打乱/无击退的概率高于生物入侵。
- 冷却从上一个事件结束后开始计算。
- “无特殊事件”模式不会触发幸运事件。
- 和平难度下敌对生物会被服务端立刻移除,建议普通/困难难度。
- 手动测试:
/pill event 竞技场1 full-heal
战斗玩法
yamlcombat:
fireball:
enabled: true
explosion-power: 2.0
incendiary: false
eggs-snowballs:
enabled: true
egg-damage: 1.0
snowball-damage: 1.0
knockback: 0.6
- 烈焰弹(火焰弹)右键可以发射一个会爆炸的大火球。
- 鸡蛋和雪球命中会造成配置的伤害与击退;关闭 eggs-snowballs.enabled 后恢复原版行为。
- 击退事件“稳如泰山”也会拦截普通攻击造成的击退。
随机物品
yamlloot:
items:
- material: DIAMOND_SWORD
amount: 1
weight: 2
name: "&b幸运钻石剑"
lore:
- "&7这是一把幸运的剑"
enchantments:
sharpness: 1
- material: COBBLESTONE
amount: "32-64"
weight: 10
| 字段 | 说明 |
|---|---|
| material | 原版物品 ID |
| amount | 数字,或 "最小值-最大值" |
| weight | 抽取权重 |
| name | 可选,支持 & 颜色 |
| lore | 可选,字符串列表 |
| enchantments | 可选,附魔 ID 与等级 |
游戏流程
- 玩家加入后背包清空,传送到等待大厅,获得指南针与退出床。
- 在线人数达到 settings.start-players 后开始倒计时;等待期间可投票、右键床退出。
- 倒计时结束保存竞技场快照,分配柱子,清空背包(床和指南针会被清除),应用本局模式。
- 比赛开始,每隔基础间隔发放随机物品;特殊模式开始生效。
- 存活玩家不能用床退出,只能 /pill leave(视为弃权)。
- 玩家死亡后进入旁观状态,背包中只有一张床;右键床返回主大厅。
- 最后一名存活玩家获胜;无人存活则平局。
- 结算后所有玩家回到主大厅、背包清空;插件重置竞技场。
床的使用规则
| 玩家状态 | 床是否可用 |
|---|---|
| 等待大厅 / 倒计时 | 可以 |
| 比赛存活 | 不可以,只能用 /pill leave |
| 死亡旁观 | 可以 |
旁观模式
原版 SPECTATOR 无法右键使用背包物品,所以旁观采用:- 冒险模式
- 隐身
- 允许飞行
- 无敌、无碰撞
地图重置
- 快照在比赛开始时生成。
- 保存方块数据;容器、告示牌、刷怪笼等额外保存 BlockState。
- 区域内非玩家实体(掉落物、TNT、盔甲架、事件生物等)在重置时清除。
- 区域区块在比赛期间强制加载,直到重置完成,避免 Multiverse 卸载世界。
- 重置分批执行,reset-blocks-per-tick 越大越快、越卡。
与 Multiverse 配合
- 使用 Multiverse 创建竞技场世界:
/mv create arena_world normal
- 进入世界后创建竞技场并设置边界:
/mv tp arena_world
/pill create 天空竞技场
- 等待大厅和主大厅可以放在主城世界。
- 不同竞技场可以位于不同世界,支持同时进行多场比赛。
- 竞技场无玩家时,重置完成前区块仍会被插件强制加载。
环境要求:JDK 17+