LocoPillars

插件

· 作者 kloppie74

Fortune 之柱。#1 免费的 Fortune 之柱插件!

0 本站下载 0 关注 更新于 5 个月前

需要前置:WorldEdit、PlaceholderAPI

最新 26.05.1 · 26.1.2 · Bukkit / Paper

一键开服(送7天)

LocoPillars — 幸运之柱

适用于 Minecraft 1.21+ 的终极 Pillars of Fortune 小游戏插件

建得更高。智斗更强。比其他人活得更久。


什么是 LocoPillars?

LocoPillars 是一款功能完备、可直接投入生产环境的 Pillars of Fortune 服务器插件。玩家将在隔离的牢笼中生成,随后被释放到竞技场中,竞争建造最高的柱子并击退其他所有玩家。最后存活者获胜。

其底层运行着多实例竞技场管理、完全可脚本化的 LuckyBlocks、拖拽式外观商店、27+ 项成就、每位玩家的统计数据库、100+ PlaceholderAPI 占位符以及游戏内地图编辑器。所有配置均无需触碰任何一行代码即可完成。


功能概览

类别 亮点
游戏玩法 单人及团队模式 · 多实例竞技场 · 牢笼倒计时
LuckyBlocks 50 种预设计效果 · 通过 Kotlin .kts 完全脚本化
外观 (Cosmetics) 64 种预设计外观 · 击杀/死亡/胜利特效 · 自定义牢笼
成就 27+ 项成就 · 4 个难度层级 · 奖励系统
统计数据 完整统计数据库 · 排行榜 · 连胜记录 · 游戏时长 · 多杀统计
投票事件 通过模块完全脚本化
聊天 上下文感知格式 · 队伍聊天 · 社交间谍 · 脏话过滤器
编辑器 游戏内地图编辑器 · WorldEdit/FAWE 蓝图 · 验证功能
计分板 5 种动态计分板类型 · 实时队伍状态 · 计时器
PlaceholderAPI 100+ 占位符,涵盖统计、队伍、地图、成就等
数据库 H2(嵌入式)· MySQL · MariaDB · PostgreSQL · HikariCP

游戏玩法

每局开始时,玩家会掉入牢笼中。倒计时结束后,牢笼打开,所有人竞相建造柱子并为了生存而战。最后存活的队伍(或玩家)获胜。

多实例竞技场

在同一服务器上运行多个同时进行的游戏,每个游戏都在其独立的隔离世界中。在 config.yml 中设置一个数字,LocoPillars 将处理其余部分。

团队支持

  • 可配置每队人数和队伍数量
  • 队伍颜色的皮革盔甲
  • 队伍聊天 (/teamchat)
  • 计分板和 TAB 列表中的队伍状态

LuckyBlocks

LuckyBlocks 完全可脚本化。每个方块都是一个独立的文件夹,包含用于元数据的 Settings.json 和用于效果的 Luckyblock.kts。插件随附 50 种预设计的 LuckyBlocks。只需将新文件夹放入 plugins/LocoPillars/Luckyblocks/,即可自动加载,无需重启。

Settings.json

{
  "id": "firework_frenzy",
  "display_name": "Firework Frenzy",
  "description": "Colorful fireworks explode in every direction!",
  "icon": {
    "material": "FIREWORK_ROCKET",
    "custom_model_data": 0
  },
  "block_type": "LUCKY_BLOCK",
  "rarity": "COMMON"
}

稀有度选项:COMMON(普通)、UNCOMMON(优秀)、RARE(稀有)、EPIC(史诗)、LEGENDARY(传说)。每种稀有度的概率在 config.yml 中配置。

Luckyblock.kts

脚本接收 player(打破方块的玩家)和 game(实用工具助手)。完整的 Bukkit/Paper API 均可用。

repeat(5) {
    val offset = player.location.clone().add(
        Math.random() * 4 - 2, 0.0, Math.random() * 4 - 2
    )
    game.spawnFirework(offset)
}
game.playSound(player, org.bukkit.Sound.ENTITY_FIREWORK_ROCKET_LAUNCH, 1.0f, 1.0f)
game.sendTitle(player, "§6Firework Frenzy!", "§7Celebrate!", 5, 50, 10)

外观 (Cosmetics)

外观的工作方式与 LuckyBlocks 相同。每个外观都是位于 plugins/LocoPillars/Cosmetics/<type>/ 下的文件夹,包含 Settings.json 和 Cosmetic.kts 脚本。插件随附 64 种预设计的外观,分为四个类别。玩家使用游戏内的金币通过 /cosmetics 购买和装备外观。

类型 数量 触发条件
击杀特效 20 当玩家获得击杀时触发
死亡特效 20 当玩家被淘汰时触发
胜利特效 20 当玩家的队伍获胜时触发
牢笼 4 用作出生牢笼的皮肤

Settings.json

{
  "id": "firework_kill",
  "type": "KILL",
  "display_name": "§6Firework Kill",
  "lore": ["§7Launch a firework on every kill!"],
  "price": 300,
  "required_level": 3,
  "permission": "",
  "rarity": "UNCOMMON",
  "active": true,
  "icon": {
    "material": "FIREWORK_ROCKET",
    "custom_model_data": 0
  }
}

Cosmetic.kts

脚本接收 player(外观拥有者,对于击杀特效是击杀者,对于死亡特效是被淘汰的玩家)和 game。

game.spawnFirework(player.location.add(0.0, 0.5, 0.0))
game.spawnParticles(player.location.add(0.0, 1.0, 0.0), org.bukkit.Particle.FIREWORK, 20, 0.5, 0.5, 0.5, 0.1)

投票事件

投票事件是游戏中的中期修饰符,玩家在游戏中期进行投票。此系统使用与 LuckyBlocks 和外观相同的基于模块的方法。将文件夹放入 plugins/LocoPillars/modules/voting/,即可在游戏中使用,无需重启。

每个投票事件由两个文件组成:

settings.json

{
  "id": "no_fall_mode",
  "display_name": "No Fall Mode",
  "description": "Fall damage is completely disabled for everyone in this round.",
  "icon": {
    "material": "FEATHER",
    "custom_model_data": 0
  },
  "active": true,
  "vote_weight": 1,
  "duration": -1,
  "announce": {
    "title": "§6§lNo Fall Mode!",
    "subtitle": "§7Fall damage is disabled!",
    "chat": "§6[Event] §eNo Fall Mode is now active!"
  }
}

script.kts

脚本接收 game 和 players。使用 game.registerEventListener 挂钩 Bukkit 事件。当游戏结束时,监听器会自动清理。

game.sendTitle("§6§lNo Fall Mode!", "§7Fall damage is disabled!", 10, 60, 10)
game.broadcast("§6[Event] §eNo Fall Mode is now active!")

game.getPlayers().forEach { player ->
    player.playSound(player.location, org.bukkit.Sound.ENTITY_PLAYER_LEVELUP, 1.0f, 1.2f)
}

game.registerEventListener<org.bukkit.event.entity.EntityDamageEvent> { event ->
    val entity = event.entity
    if (entity is org.bukkit.entity.Player &&
        game.isPlayerInGame(entity) &&
        event.cause == org.bukkit.event.entity.EntityDamageEvent.DamageCause.FALL
    ) {
        event.isCancelled = true
    }
}

成就

跨 4 个难度等级的 27+ 内置成就,每个等级均可配置经验值和金币奖励。通过在 plugins/LocoPillars/Achievements/ 目录下放入 .yml 文件来添加你自己的成就。

难度 示例
简单 first_win · builder_basics · explorer
普通 warrior · demolisher · team_player
困难 champion · survivor · multi_killer
极限 legendary · perfect_game · comeback_king

命令

玩家命令

命令 别名 描述
/pillars join <type|random> /pof, /games 加入一个游戏或随机可用游戏
/pillars leave 离开当前所在的游戏
/pillars list 列出可用的游戏类型
/pillars status 查看当前游戏状态
/pillars stats 查看服务器范围的统计数据
/pillars help 显示帮助概览
/spawn /hub, /lobby 传送到大厅
/stats /mystats 查看个人统计数据
/achievements /ach 打开成就概览
/cosmetics /cosm 浏览并装备外观道具
/luckyblocks /luckyb 打开幸运方块菜单
/teamchat /tc 切换队伍聊天模式
/hideme /hm 对其他玩家隐藏自己
/hideothers /ho 从你的视角隐藏所有其他玩家
/showothers <player> /so 在开启 hideothers 时显示特定玩家

管理员命令

命令 别名 描述
/editor toggle /adminedit 进入 / 退出管理员编辑器模式
/editor create <name> 创建一个新的竞技场地图
/editor edit <name> 编辑现有的竞技场
/editor delete <name> 删除一个竞技场
/editor list 列出所有竞技场
/editor save 保存当前编辑器会话
/editor cancel 取消而不保存
/editor spawn 管理出生点 / 笼子位置
/editor validate 验证竞技场配置
/editor settings 打开编辑器设置 GUI
/editor hotbar 打开编辑器快捷栏工具管理器
/editor files 管理竞技场结构文件
/editor doctor 对竞技场运行自动诊断
/editor setup 快速设置向导
/editor resize 调整结构大小
/editor info 显示竞技场信息
/setspawn 设置大厅出生点
/vanish [player] /v 切换你自己或其他玩家的隐身状态
/chatadmin reload /ca reload 重新加载聊天配置
/chatadmin announce <msg> /ca announce 发送服务器公告
/chatadmin mute <player> /ca mute 禁言一名玩家
/chatadmin unmute <player> /ca unmute 解除禁言一名玩家
/chatadmin clear /ca clear 清除所有玩家的聊天
/chatadmin stats /ca stats 查看聊天统计数据
/chatadmin cooldown <player> <s> 设置玩家聊天冷却时间
/socialspy /spy, /ss 切换社交间谍模式
/cosmetics give <player> <id> 给一名玩家发放外观道具
/cosmetics coins <player> <amount> 修改玩家的金币余额
/cosmetics reload 重新加载外观配置
/luckyblocks getluckyblock 给自己一个幸运方块物品
/memory check|clear|status /mem 查看 / 管理插件内存使用情况
/tab reload 重新加载 TAB 插件配置

管理员编辑器 (/editor)

LocoPillars 自带完整的游戏内地图编辑器,无需外部工具。

  1. 运行 /editor setup 以启动引导式快速设置向导。
  2. 使用 /editor create <name> 开始创建新竞技场。
  3. 使用快捷栏工具(/editor hotbar)放置笼子出生点。
  4. 导入 WorldEdit / FAWE 结构文件并将其附加到竞技场。
  5. 运行 /editor validate 以捕获配置错误。
  6. 使用 /editor save 保存,竞技场将立即在游戏中可用。

支持每个竞技场多个结构文件、结构调整大小以及基于实时快捷栏的出生点编辑,全程无需退出游戏。


计分板

五种动态计分板布局,每种均显示上下文相关信息:

计分板 显示时机 关键信息
大厅 玩家在大厅中 排名 · 金币 · 等级 · 经验值 · 成就 · 在线人数
游戏等待区 等待游戏开始时 游戏名称 · 地图 · 玩家数量 · 最少玩家数
笼子 游戏开始前的倒计时 开始倒计时 · 游戏信息
活跃游戏 正在进行游戏中 实时计时器 · 物品掉落计时器 · 队伍状态
观战 正在观看游戏 实时计时器 · 物品计时器 · 所有队伍状态

PlaceholderAPI

需要 PlaceholderAPI。所有占位符均使用 %locopillars_ 前缀。

玩家统计数据
占位符 返回值
%locopillars_db_player_name% 玩家名称
%locopillars_db_display_name% 显示名称
%locopillars_db_games_played% 总游戏场次
%locopillars_db_games_won% 总胜场数
%locopillars_db_games_lost% 总负场数
%locopillars_db_games_quit% 总退场数
%locopillars_db_total_kills% 总击杀数
%locopillars_db_total_deaths% 总死亡数
%locopillars_db_total_assists% 总助攻数
%locopillars_db_best_killstreak% 最佳击杀连胜
%locopillars_db_current_killstreak% 当前击杀连胜
%locopillars_db_double_kills% 双杀次数
%locopillars_db_triple_kills% 三杀次数
%locopillars_db_quad_kills% 四杀次数
%locopillars_db_current_win_streak% 当前胜利连胜
%locopillars_db_best_win_streak% 最佳胜利连胜
%locopillars_db_current_loss_streak% 当前失败连败
%locopillars_db_worst_loss_streak% 最差失败连败
%locopillars_db_damage_dealt% 总造成伤害
%locopillars_db_damage_taken% 总受到伤害
%locopillars_db_fall_damage_taken% 总跌落伤害
%locopillars_db_pillars_destroyed% 摧毁的柱子数量
%locopillars_db_blocks_broken% 破坏的方块数
%locopillars_db_blocks_placed% 放置的方块数
%locopillars_db_total_distance_moved% 总行走距离(方块数)
%locopillars_db_total_playtime% 总游戏时长(秒)
%locopillars_db_level% 玩家等级
%locopillars_db_experience% 玩家经验值
%locopillars_db_coins% 装饰货币
%locopillars_db_global_rank% 全球排行榜排名
%locopillars_db_perfect_games% 完美游戏(无死亡)
%locopillars_db_comeback_wins% 翻盘胜利
进行中的游戏
占位符 返回值
%locopillars_game_name% 当前游戏名称
%locopillars_game_state% 状态:WAITING / STARTING / ACTIVE / ENDED / RESETTING
%locopillars_game_map% 地图文件名
%locopillars_game_map_name% 地图显示名称
%locopillars_game_world% 游戏实例的世界名称
%locopillars_game_players_in_game% 当前玩家数量
%locopillars_game_players_max% 最大玩家数
%locopillars_game_players_min% 开始游戏所需的最小玩家数
%locopillars_game_timer% 游戏计时器(秒)
%locopillars_game_timer_string% 游戏计时器格式为 MM:SS
%locopillars_game_lobby_timer% 大厅倒计时(秒)
%locopillars_game_items_timer% 下次掉落物品前的秒数
%locopillars_active_games% 服务器上活跃的游戏总数
队伍
占位符 返回值
%locopillars_team_name% 玩家的队伍名称
%locopillars_team_color% 玩家的队伍颜色
%locopillars_team_size% 玩家的队伍人数
%locopillars_teams_total% 游戏中队伍的总数
%locopillars_teams_names% 所有队伍名称,以逗号分隔
%locopillars_teams_colors% 所有队伍颜色,以逗号分隔
%locopillars_teams_sizes% 所有队伍人数,以逗号分隔

将 team1 替换为 team1、team2、team3 等:

占位符 返回值
%locopillars_game_team_team1_displayname% 队伍显示名称
%locopillars_game_team_team1_status_symbol% 状态:alive(存活)/ eliminated(已淘汰)/ warning(警告)/ empty(空)
%locopillars_game_team_team1_players_alive% 队伍中存活的玩家数
%locopillars_game_team_team1_players_total% 队伍总玩家数
%locopillars_game_team_team1_players_dead% 已淘汰的队伍玩家数
地图与服务器

将 <mapname> 替换为地图的文件夹名称(例如 arena1):

占位符 返回值
%locopillars_map_<mapname>_players_in_lobby% 该地图大厅中的玩家数
%locopillars_map_<mapname>_players_playing% 当前正在该地图上游戏的玩家数
%locopillars_map_<mapname>_players_total% 该地图的玩家总数(大厅 + 游戏中)
%locopillars_map_<mapname>_games_active% 该地图上活跃的游戏实例数
%locopillars_map_<mapname>_games_waiting% 等待中的游戏实例数
%locopillars_map_<mapname>_games_starting% 即将开始的游戏实例数
%locopillars_map_<mapname>_games_total% 该地图的游戏实例总数
%locopillars_online_players% 在线玩家总数
%locopillars_player_name% 玩家名称的简写形式
成就
占位符 返回值
%locopillars_achievement_total_count% 可用成就总数
%locopillars_achievement_total_completed_amount% 该玩家解锁的成就数
%locopillars_achievement_total_completed_percent% 完成百分比

将 <id> 替换为成就 ID(例如 first_win):

占位符 返回值
%locopillars_achievement_<id>_completed% 若已解锁则为 1,否则为 0
%locopillars_achievement_<id>_progress% 原始进度值
%locopillars_achievement_<id>_percent% 进度百分比
%locopillars_achievement_<id>_name% 成就名称
%locopillars_achievement_<id>_description% 成就描述
%locopillars_achievement_<id>_difficulty% EASY / NORMAL / HARD / EXTREME
%locopillars_achievement_<id>_category% 成就类别
%locopillars_achievement_<id>_type% 成就类型
%locopillars_achievement_<category>_category_status% 某类别的完成百分比
%locopillars_achievement_<difficulty>_difficulty_status% 某难度等级的完成百分比

要求与依赖

依赖项 类型 备注
Paper 服务端 1.21+
WorldEdit 或 FastAsyncWorldEdit 必需 启动时自动检测
PlaceholderAPI 必需 2.11+
TAB 可选 5.2+,增强型玩家列表
ProtocolLib 可选 5.4+,标签页可见性管理
Vault 可选 1.7+,经济奖励集成
ItemsAdder 可选 3.6+,自定义装饰物品纹理

权限

玩家(默认:true)

权限 描述
locopillars.pillars.* 所有 /pillars 子命令
locoPillars.play 加入并参与游戏
locopillars.spawn 传送至大厅
locopillars.chat.use 发送聊天消息
locopillars.chat.teamchat 使用队伍聊天
locopillars.hideme 对其他玩家隐藏自己
locopillars.hideothers 隐藏其他玩家
locopillars.showothers 显示特定玩家
locopillars.achievements.use 使用成就相关命令
locopillars.luckyblocks.menu 打开幸运方块菜单

工作人员(默认:op)

权限 描述
locopillars.admin 所有管理权限
locopillars.editor 使用 /editor 及所有地图工具
locopillars.setspawn 设置大厅出生点位置
locopillars.spawn.others 将其他玩家传送至出生点
locopillars.vanish 切换隐身模式
locopillars.memory.use 内存管理命令
locopillars.chat.admin 所有聊天管理功能
locopillars.chat.socialspy 查看所有玩家的聊天内容
locopillars.chat.bypass-cooldown 跳过聊天冷却时间
locopillars.chat.bypass-filter 绕过脏话过滤器
locopillars.achievements.admin 管理成就系统
locopillars.luckyblocks.getluckyblock 通过命令获取幸运方块
locopillars.notify.update 接收游戏内更新通知
locopillars.tab 重新加载 TAB 配置

数据库

在 config.yml 中设置,无需修改代码。

后端 备注
H2 默认,嵌入式,零配置
MySQL 推荐用于生产环境 / 网络服务器
MariaDB 完全支持
PostgreSQL 完全支持

所有后端均使用 HikariCP 连接池。


配置

plugins/LocoPillars/
├── config.yml              主要设置(数据库、竞技场、聊天、计分板、TAB)
├── language.yml            所有面向玩家的消息
├── items.yml               GUI 物品定义
├── Games/
│   └── <GameType>.yml      按游戏类型配置(计时器、建造限制、奖励、队伍)
├── Achievements/
│   └── <id>.yml            每个成就一个文件
├── Cosmetics/
│   ├── cages/<name>/       Settings.json
│   ├── kill/<name>/        Settings.json + Cosmetic.kts
│   ├── death/<name>/       Settings.json + Cosmetic.kts
│   └── win/<name>/         Settings.json + Cosmetic.kts
├── Luckyblocks/
│   └── <name>/             Settings.json + Luckyblock.kts
└── modules/
    └── voting/
        └── <name>/         settings.json + script.kts

自动更新检查器

LocoPillars 在启动时会检查 Modrinth 以获取新版本发布情况。拥有 locopillars.notify.update 权限的工作人员在有新版本可用时会收到游戏内通知。可在 config.yml 中禁用此功能。


由 kloppie74 制作

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源