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 自带完整的游戏内地图编辑器,无需外部工具。
- 运行
/editor setup 以启动引导式快速设置向导。
- 使用
/editor create <name> 开始创建新竞技场。
- 使用快捷栏工具(
/editor hotbar)放置笼子出生点。
- 导入 WorldEdit / FAWE 结构文件并将其附加到竞技场。
- 运行
/editor validate 以捕获配置错误。
- 使用
/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 中禁用此功能。
LocoPillars — Pillars of Fortune
The ultimate Pillars of Fortune minigame plugin for Minecraft 1.21+
Build high. Fight smart. Survive longer than everyone else.
What is LocoPillars?
LocoPillars is a feature-complete, production-ready Pillars of Fortune server plugin. Players spawn in isolated cages, get released into the arena, and compete to build the tallest pillar while fighting off every other player. Last one standing wins.
Under the hood it runs multi-instance arena management, fully scriptable LuckyBlocks, a drag-and-drop cosmetics shop, 27+ achievements, a per-player stats database, 100+ PlaceholderAPI placeholders, and an in-game map editor. All configurable without touching a single line of code.
Feature Overview
| Category |
Highlights |
| Gameplay |
Solo & team modes · Multi-instance arenas · Cage countdown |
| LuckyBlocks |
50 pre-designed effects · Fully scriptable via Kotlin .kts |
| Cosmetics |
64 pre-designed cosmetics · Kill / Death / Win effects · Custom cages |
| Achievements |
27+ achievements · 4 difficulty tiers · Reward system |
| Statistics |
Full stats DB · Leaderboards · Streaks · Playtime · Multi-kills |
| Voting Events |
fully scriptable via modules |
| Chat |
Context-aware formats · Team chat · Social spy · Profanity filter |
| Editor |
In-game map editor · WorldEdit/FAWE schematics · Validation |
| Scoreboards |
5 dynamic scoreboard types · Live team status · Timers |
| PlaceholderAPI |
100+ placeholders covering stats, teams, maps, achievements |
| Database |
H2 (embedded) · MySQL · MariaDB · PostgreSQL · HikariCP |
Gameplay
Players drop into cages at the start of each round. After the countdown, cages open and everyone scrambles to build a pillar and fight for survival. The last team (or player) alive wins.
Multi-Instance Arenas
Run multiple simultaneous games on the same server, each in its own isolated world. Set a number in config.yml and LocoPillars handles the rest.
Team Support
- Configurable players-per-team and number of teams
- Team-colored leather armor
- Team chat (
/teamchat)
- Team status on scoreboard & TAB list
LuckyBlocks
LuckyBlocks are fully scriptable. Each block is its own folder containing a Settings.json for metadata and a Luckyblock.kts for the effect. The plugin ships with 50 pre-designed LuckyBlocks. Drop a new folder into plugins/LocoPillars/Luckyblocks/ and it gets picked up automatically with no restart needed.
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"
}
Rarity options: COMMON, UNCOMMON, RARE, EPIC, LEGENDARY. Chances per rarity are configured in config.yml.
Luckyblock.kts
The script receives player (who broke the block) and game (utility helper). The full Bukkit/Paper API is available.
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
Cosmetics work the same way as LuckyBlocks. Each cosmetic is a folder under plugins/LocoPillars/Cosmetics/<type>/ with a Settings.json and a Cosmetic.kts script. The plugin ships with 64 pre-designed cosmetics across four categories. Players buy and equip cosmetics through /cosmetics using in-game coins.
| Type |
Count |
Trigger |
| Kill effects |
20 |
Triggered when the player gets a kill |
| Death effects |
20 |
Triggered when the player is eliminated |
| Win effects |
20 |
Triggered when the player's team wins |
| Cages |
4 |
The skin used for the spawn cage |
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
The script receives player (the cosmetic owner, killer for kill effects or the eliminated player for death effects) and 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)
Voting Events
Voting events are mid-game modifiers that players vote on during a game. This system uses the same module-based approach as LuckyBlocks and Cosmetics. Drop a folder into plugins/LocoPillars/modules/voting/ and it becomes available in-game without a restart.
Each voting event consists of two files:
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
The script receives game and players. Use game.registerEventListener to hook into Bukkit events. The listener is automatically cleaned up when the game ends.
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
}
}
Achievements
27+ built-in achievements across 4 difficulty tiers, each with configurable XP and coin rewards. Add your own by dropping a .yml file in plugins/LocoPillars/Achievements/.
| Difficulty |
Examples |
| Easy |
first_win · builder_basics · explorer |
| Normal |
warrior · demolisher · team_player |
| Hard |
champion · survivor · multi_killer |
| Extreme |
legendary · perfect_game · comeback_king |
Commands
Player Commands
| Command |
Aliases |
Description |
/pillars join <type|random> |
/pof, /games |
Join a game or a random available game |
/pillars leave |
|
Leave your current game |
/pillars list |
|
List available game types |
/pillars status |
|
View current game status |
/pillars stats |
|
View server-wide statistics |
/pillars help |
|
Show help overview |
/spawn |
/hub, /lobby |
Teleport to the lobby |
/stats |
/mystats |
View personal statistics |
/achievements |
/ach |
Open achievements overview |
/cosmetics |
/cosm |
Browse and equip cosmetics |
/luckyblocks |
/luckyb |
Open the LuckyBlocks menu |
/teamchat |
/tc |
Toggle team chat mode |
/hideme |
/hm |
Hide yourself from other players |
/hideothers |
/ho |
Hide all other players from your view |
/showothers <player> |
/so |
Show a specific player while hideothers is on |
Admin Commands
| Command |
Aliases |
Description |
/editor toggle |
/adminedit |
Enter / exit admin editor mode |
/editor create <name> |
|
Create a new arena map |
/editor edit <name> |
|
Edit an existing arena |
/editor delete <name> |
|
Delete an arena |
/editor list |
|
List all arenas |
/editor save |
|
Save current editor session |
/editor cancel |
|
Cancel without saving |
/editor spawn |
|
Manage spawn / cage positions |
/editor validate |
|
Validate arena configuration |
/editor settings |
|
Open editor settings GUI |
/editor hotbar |
|
Open the editor hotbar tool manager |
/editor files |
|
Manage arena schematic files |
/editor doctor |
|
Run auto-diagnostics on arena |
/editor setup |
|
Quick-setup wizard |
/editor resize |
|
Resize a schematic |
/editor info |
|
Show arena info |
/setspawn |
|
Set the lobby spawn point |
/vanish [player] |
/v |
Toggle vanish for yourself or another player |
/chatadmin reload |
/ca reload |
Reload chat configuration |
/chatadmin announce <msg> |
/ca announce |
Send a server announcement |
/chatadmin mute <player> |
/ca mute |
Mute a player |
/chatadmin unmute <player> |
/ca unmute |
Unmute a player |
/chatadmin clear |
/ca clear |
Clear chat for all players |
/chatadmin stats |
/ca stats |
View chat statistics |
/chatadmin cooldown <player> <s> |
|
Set a player chat cooldown |
/socialspy |
/spy, /ss |
Toggle social spy |
/cosmetics give <player> <id> |
|
Give a cosmetic to a player |
/cosmetics coins <player> <amount> |
|
Modify a player coin balance |
/cosmetics reload |
|
Reload cosmetics configuration |
/luckyblocks getluckyblock |
|
Give yourself a LuckyBlock item |
/memory check|clear|status |
/mem |
View / manage plugin memory usage |
/tab reload |
|
Reload TAB plugin config |
Admin Editor (/editor)
LocoPillars ships with a full in-game map editor, no external tools needed.
- Run
/editor setup for the guided quick-setup wizard.
- Use
/editor create <name> to start a new arena.
- Place cage spawn points with the hotbar tools (
/editor hotbar).
- Import WorldEdit / FAWE schematics and attach them to the arena.
- Run
/editor validate to catch configuration errors.
- Save with
/editor save and the arena is immediately available in-game.
Supports multiple schematics per arena, schematic resizing, and live hotbar-based spawn-point editing, all without leaving the game.
Scoreboards
Five dynamic scoreboard layouts, each showing context-relevant information:
| Scoreboard |
Shown When |
Key Info |
| Lobby |
Player is in the lobby |
Rank · Coins · Level · XP · Achievements · Online count |
| Game Lobby |
Waiting for a game to start |
Game name · Map · Player count · Min players |
| Cage |
Countdown before game starts |
Start countdown · Game info |
| Active Game |
During a live game |
Live timer · Item drop timer · Team status |
| Spectate |
Spectating a game |
Live timer · Item timer · All team statuses |
PlaceholderAPI
Requires PlaceholderAPI. All placeholders use the %locopillars_ prefix.
Player Statistics
| Placeholder |
Returns |
%locopillars_db_player_name% |
Player name |
%locopillars_db_display_name% |
Display name |
%locopillars_db_games_played% |
Total games played |
%locopillars_db_games_won% |
Total wins |
%locopillars_db_games_lost% |
Total losses |
%locopillars_db_games_quit% |
Total quits |
%locopillars_db_total_kills% |
Total kills |
%locopillars_db_total_deaths% |
Total deaths |
%locopillars_db_total_assists% |
Total assists |
%locopillars_db_best_killstreak% |
Best kill streak |
%locopillars_db_current_killstreak% |
Current kill streak |
%locopillars_db_double_kills% |
Double kills |
%locopillars_db_triple_kills% |
Triple kills |
%locopillars_db_quad_kills% |
Quad kills |
%locopillars_db_current_win_streak% |
Current win streak |
%locopillars_db_best_win_streak% |
Best win streak |
%locopillars_db_current_loss_streak% |
Current loss streak |
%locopillars_db_worst_loss_streak% |
Worst loss streak |
%locopillars_db_damage_dealt% |
Total damage dealt |
%locopillars_db_damage_taken% |
Total damage taken |
%locopillars_db_fall_damage_taken% |
Total fall damage taken |
%locopillars_db_pillars_destroyed% |
Pillars destroyed |
%locopillars_db_blocks_broken% |
Blocks broken |
%locopillars_db_blocks_placed% |
Blocks placed |
%locopillars_db_total_distance_moved% |
Total blocks walked |
%locopillars_db_total_playtime% |
Total playtime in seconds |
%locopillars_db_level% |
Player level |
%locopillars_db_experience% |
Player XP |
%locopillars_db_coins% |
Cosmetic coins |
%locopillars_db_global_rank% |
Global leaderboard rank |
%locopillars_db_perfect_games% |
Perfect games (no deaths) |
%locopillars_db_comeback_wins% |
Comeback victories |
Active Game
| Placeholder |
Returns |
%locopillars_game_name% |
Name of the current game |
%locopillars_game_state% |
State: WAITING / STARTING / ACTIVE / ENDED / RESETTING |
%locopillars_game_map% |
Map file name |
%locopillars_game_map_name% |
Map display name |
%locopillars_game_world% |
World name of the game instance |
%locopillars_game_players_in_game% |
Current player count |
%locopillars_game_players_max% |
Maximum players |
%locopillars_game_players_min% |
Minimum players to start |
%locopillars_game_timer% |
Game timer in seconds |
%locopillars_game_timer_string% |
Game timer as MM:SS |
%locopillars_game_lobby_timer% |
Lobby countdown in seconds |
%locopillars_game_items_timer% |
Seconds until next item drop |
%locopillars_active_games% |
Total active games on the server |
Teams
| Placeholder |
Returns |
%locopillars_team_name% |
The player's team name |
%locopillars_team_color% |
The player's team color |
%locopillars_team_size% |
The player's team size |
%locopillars_teams_total% |
Total number of teams in the game |
%locopillars_teams_names% |
All team names, comma-separated |
%locopillars_teams_colors% |
All team colors, comma-separated |
%locopillars_teams_sizes% |
All team sizes, comma-separated |
Replace team1 with team1, team2, team3, etc.:
| Placeholder |
Returns |
%locopillars_game_team_team1_displayname% |
Team display name |
%locopillars_game_team_team1_status_symbol% |
Status: alive / eliminated / warning / empty |
%locopillars_game_team_team1_players_alive% |
Players still alive in the team |
%locopillars_game_team_team1_players_total% |
Total team players |
%locopillars_game_team_team1_players_dead% |
Eliminated team players |
Maps & Server
Replace <mapname> with the map's folder name (e.g. arena1):
| Placeholder |
Returns |
%locopillars_map_<mapname>_players_in_lobby% |
Players in lobby for this map |
%locopillars_map_<mapname>_players_playing% |
Players currently in a game on this map |
%locopillars_map_<mapname>_players_total% |
Total players (lobby + in-game) for this map |
%locopillars_map_<mapname>_games_active% |
Active game instances on this map |
%locopillars_map_<mapname>_games_waiting% |
Waiting game instances |
%locopillars_map_<mapname>_games_starting% |
Starting game instances |
%locopillars_map_<mapname>_games_total% |
Total instances for this map |
%locopillars_online_players% |
Total online players |
%locopillars_player_name% |
Shorthand for the player's name |
Achievements
| Placeholder |
Returns |
%locopillars_achievement_total_count% |
Total achievements available |
%locopillars_achievement_total_completed_amount% |
Achievements unlocked by this player |
%locopillars_achievement_total_completed_percent% |
Completion percentage |
Replace <id> with the achievement ID (e.g. first_win):
| Placeholder |
Returns |
%locopillars_achievement_<id>_completed% |
1 if unlocked, 0 if not |
%locopillars_achievement_<id>_progress% |
Raw progress value |
%locopillars_achievement_<id>_percent% |
Progress as a percentage |
%locopillars_achievement_<id>_name% |
Achievement name |
%locopillars_achievement_<id>_description% |
Achievement description |
%locopillars_achievement_<id>_difficulty% |
EASY / NORMAL / HARD / EXTREME |
%locopillars_achievement_<id>_category% |
Achievement category |
%locopillars_achievement_<id>_type% |
Achievement type |
%locopillars_achievement_<category>_category_status% |
Percentage of a category completed |
%locopillars_achievement_<difficulty>_difficulty_status% |
Percentage of a difficulty tier completed |
Requirements & Dependencies
| Dependency |
Type |
Notes |
| Paper |
Server |
1.21+ |
| WorldEdit or FastAsyncWorldEdit |
Required |
Auto-detected at startup |
| PlaceholderAPI |
Required |
2.11+ |
| TAB |
Optional |
5.2+, enhanced player list |
| ProtocolLib |
Optional |
5.4+, tab visibility management |
| Vault |
Optional |
1.7+, economy reward integration |
| ItemsAdder |
Optional |
3.6+, custom cosmetic item textures |
Permissions
Players (default: true)
| Permission |
Description |
locopillars.pillars.* |
All /pillars subcommands |
locoPillars.play |
Join and play games |
locopillars.spawn |
Teleport to lobby |
locopillars.chat.use |
Send chat messages |
locopillars.chat.teamchat |
Use team chat |
locopillars.hideme |
Hide yourself from others |
locopillars.hideothers |
Hide other players |
locopillars.showothers |
Show a specific player |
locopillars.achievements.use |
Use achievement commands |
locopillars.luckyblocks.menu |
Open the LuckyBlocks menu |
Staff (default: op)
| Permission |
Description |
locopillars.admin |
All administrative access |
locopillars.editor |
Use /editor and all map tools |
locopillars.setspawn |
Set the lobby spawn location |
locopillars.spawn.others |
Teleport other players to spawn |
locopillars.vanish |
Toggle vanish mode |
locopillars.memory.use |
Memory management commands |
locopillars.chat.admin |
All chat administration |
locopillars.chat.socialspy |
View all player chat |
locopillars.chat.bypass-cooldown |
Skip chat cooldown |
locopillars.chat.bypass-filter |
Skip profanity filter |
locopillars.achievements.admin |
Administer achievements |
locopillars.luckyblocks.getluckyblock |
Get a LuckyBlock via command |
locopillars.notify.update |
Receive in-game update notifications |
locopillars.tab |
Reload TAB configuration |
Database
Set in config.yml, no code changes needed.
| Backend |
Notes |
| H2 |
Default, embedded, zero setup |
| MySQL |
Recommended for production / network servers |
| MariaDB |
Fully supported |
| PostgreSQL |
Fully supported |
All backends use HikariCP connection pooling.
Configuration
plugins/LocoPillars/
├── config.yml Main settings (database, arenas, chat, scoreboard, TAB)
├── language.yml All player-facing messages
├── items.yml GUI item definitions
├── Games/
│ └── <GameType>.yml Per-game-type config (timers, build limits, rewards, teams)
├── Achievements/
│ └── <id>.yml One file per achievement
├── 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
Automatic Update Checker
LocoPillars checks Modrinth on startup for new releases. Staff with the locopillars.notify.update permission receive an in-game notification when an update is available. Can be disabled in config.yml.
评论 0
登录后参与评分
还没有评论,来抢沙发吧