资源图标

原创 娱乐 一个幸运之柱插件 1.0.0

完成注册/登录后下载
版权类型
原创
插件中文名称
一个幸运之柱
插件英文名称
theluckypillars
原帖地址
#
支持的核心(服务端)
  1. Spigot
  2. Paper
语言支持
多语言
前置组件
multiverse https://modrinth.com/plugin/multiverse-core
适配版本(Java)
  1. 26.x
  2. 1.21
  3. 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
运行 JavaJava 26(服务端要求 Java 21+)
插件主体使用 Bukkit API;击退减小/增大 使用 Paper 的击退事件,因此请使用 Paper 服务端。

安装​

  1. 将 theluckypillars-1.0.0.jar 放入服务端 plugins/ 目录。
  2. 可选:安装 Multiverse-Core(如果你需要多世界竞技场)。
  3. 重启服务器。
  4. 首次启动会生成:
    • plugins/theluckypillars/config.yml:比赛、投票、模式、语言、物品配置
    • plugins/theluckypillars/messages.yml:中文提示文本(默认)
    • plugins/theluckypillars/messages_en.yml:英文提示文本(切换英文后生成)
    • plugins/theluckypillars/arenas.yml:竞技场数据
    • plugins/theluckypillars/stats.yml:玩家战绩
权限:pill.play 默认所有人可用;pill.admin 默认 OP。

快速开始​

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打开所有竞技场的地图 GUIpill.play
/pill info [竞技场]查看竞技场状态所有人
/pill stat [玩家]查看战绩(默认自己)pill.play
/pill reload重载 config.yml 和当前语言文本pill.admin
/pill help查看帮助所有人
命令支持 Tab 补全。

模式投票​

模式 key名称效果
none无特殊事件纯基础对局,关闭幸运事件
normal普通基础对局,保留随机幸运事件
tnt-rainTNT 雨竞技场上空持续落下 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无攻击冷却大幅提高攻击速度,取消武器攻击冷却
投票菜单会显示每个模式的当前票数。

配置说明​

语言​

yaml

language: 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。对应语言文件会在首次切换时自动生成。

比赛设置​

yaml

settings:
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 [竞技场] 会停止倒计时;比赛进行中则按平局结算并重置。

下界传送门彩蛋​

yaml

portal-easter-egg:
enabled: true
mob-count: 8
cooldown-seconds: 60
types:
- ZOMBIE
- SKELETON
- BLAZE
- PIGLIN_BRUTE
- MAGMA_CUBE
  • 比赛中存活玩家点燃下界传送门时,会在传送门附近生成一群下界敌对生物。
  • 每个竞技场有冷却时间,避免连续刷怪。
  • 生成的下界生物会在本局结束/竞技场重置时清除。
  • 玩家无法通过这个传送门进入下界,只会收到提示。

模式投票与参数​

yaml

vote:
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

幸运事件​

yaml

lucky-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

战斗玩法​

yaml

combat:
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 后恢复原版行为。
  • 击退事件“稳如泰山”也会拦截普通攻击造成的击退。

随机物品​

yaml

loot:
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 与等级

游戏流程​

  1. 玩家加入后背包清空,传送到等待大厅,获得指南针与退出床。
  2. 在线人数达到 settings.start-players 后开始倒计时;等待期间可投票、右键床退出。
  3. 倒计时结束保存竞技场快照,分配柱子,清空背包(床和指南针会被清除),应用本局模式。
  4. 比赛开始,每隔基础间隔发放随机物品;特殊模式开始生效。
  5. 存活玩家不能用床退出,只能 /pill leave(视为弃权)。
  6. 玩家死亡后进入旁观状态,背包中只有一张床;右键床返回主大厅。
  7. 最后一名存活玩家获胜;无人存活则平局。
  8. 结算后所有玩家回到主大厅、背包清空;插件重置竞技场。

床的使用规则​

玩家状态床是否可用
等待大厅 / 倒计时可以
比赛存活不可以,只能用 /pill leave
死亡旁观可以
存活玩家即使通过其他方式拿到带插件标记的床,右键也只会收到提示。

旁观模式​

原版 SPECTATOR 无法右键使用背包物品,所以旁观采用:

  • 冒险模式
  • 隐身
  • 允许飞行
  • 无敌、无碰撞
这样玩家可以飞行观战并右键床退出。

地图重置​

  • 快照在比赛开始时生成。
  • 保存方块数据;容器、告示牌、刷怪笼等额外保存 BlockState。
  • 区域内非玩家实体(掉落物、TNT、盔甲架、事件生物等)在重置时清除。
  • 区域区块在比赛期间强制加载,直到重置完成,避免 Multiverse 卸载世界。
  • 重置分批执行,reset-blocks-per-tick 越大越快、越卡。

与 Multiverse 配合​

  1. 使用 Multiverse 创建竞技场世界:
代码块

/mv create arena_world normal
  1. 进入世界后创建竞技场并设置边界:
代码块

/mv tp arena_world
/pill create 天空竞技场
  1. 等待大厅和主大厅可以放在主城世界。
  2. 不同竞技场可以位于不同世界,支持同时进行多场比赛。
  3. 竞技场无玩家时,重置完成前区块仍会被插件强制加载。

​


环境要求:JDK 17+
作者
qpalzm123
下载
2
查看
61
首次发布
最后更新

评分

0.00 星 0 次评分
后退
顶部 底部