? KaraokePlugin
一款功能齐全的 PaperMC 服务器卡拉 OK 活动管理插件。
KaraokePlugin 允许你在 Minecraft 服务器上直接举办现场卡拉 OK 之夜。分配歌手、管理带有实时评分显示的评委小组、为营造戏剧效果撤下舞台地板、传送人群、处理歌手队列——所有操作均可通过简洁的游戏内 GUI 完成,无需手动输入任何命令。
✨ 特性
- GUI 控制面板 — 使用
/karaoke 或 /k 打开;每个操作都有专用按钮
- LuckPerms 集成 — 歌手、评委和听众角色通过完全可配置的控制台命令自动应用和移除
- 实时评分 — 评委和观众可以投赞成/反对票;分数分别记录并显示在排行榜上
- 评委显示方块 — 世界中的混凝土方块会根据评委投票从黄色变为绿色或红色
- 评委后缀 — 评委会通过 LP 元数据自动获得彩色的
[J1]、[J2] 等后缀
- 歌手队列 — 将多名玩家加入等待名单;逐个推进
- 回合计时器 — 可选的每位歌手时间限制,带有标题倒计时;过期后自动推进队列
- 舞台掉落 — 移除歌手脚下的地板;在可配置延迟后自动恢复;如果歌手死亡,重生时会被传回舞台
- 处决室 — 通过红石触发器将歌手传送到单独的密室
- 前三名获胜者公告 — 广播格式化的结果横幅,包含评委和观众得分明细
- 出生点返回 — 活动结束后将所有玩家发送回配置的出生点
- 活动命令 — 在活动开始或结束时,代表所有玩家(需
* 权限)运行任意命令
- PlaceholderAPI 支持 — 9 个用于计分板和显示的占位符
- 完全可配置 — 所有 LuckPerms 命令、消息、评分权重、计时器和位置均在
config.yml 中设置
- 持久化设置 — 捕获的位置和分数保存到
data.yml,重启后依然存在
? 安装
- 将
KaraokePlugin.jar 放入服务器的 plugins/ 文件夹。
- 启动服务器一次以生成
plugins/KaraokePlugin/config.yml。
- 如果与默认值 (
singer, judge, listener) 不同,请在 roles: 下设置你的 LuckPerms 组名。
- 可选:编辑
luckperms-commands: 以自定义确切要运行的 LP 命令。
- 在游戏中,运行
/karaoke setup 以捕获所有必需的位置(舞台、评委席、听众区、出生点、陷阱门区域、处决室)。
- 完成 — 运行
/karaoke start 开始你的第一次活动。
依赖项
?️ 命令
所有管理命令均需 karaoke.host 权限。别名:/k
| 命令 |
描述 |
/karaoke |
打开管理员控制面板 GUI |
/karaoke start |
立即开始活动 |
/karaoke stop |
停止活动并将所有玩家送回出生点 |
/karaoke time <duration> |
设置并开始倒计时(例如 5m、2m 30s、90s) |
/karaoke setup |
打开位置设置 GUI |
/karaoke add singer <player> |
指定玩家为当前歌手 |
/karaoke add judge <player> |
将玩家添加到评委小组 |
/karaoke remove singer <player> |
移除当前歌手并将其返回观众席 |
/karaoke remove judge <player> |
从评委小组中移除玩家 |
/karaoke singer clear |
清空舞台(无歌手) |
/karaoke queue add <player> |
将玩家加入歌手队列 |
/karaoke queue remove <player> |
从队列中移除玩家 |
/karaoke queue next |
推进队列 — 指定下一位等待的歌手 |
/karaoke queue clear |
清空队列 |
/karaoke queue list |
列出队列中的所有玩家 |
/karaoke drop |
在当前歌手脚下撤下舞台地板 |
/karaoke execute |
将歌手传送到处决室 |
/karaoke winner |
公布前三名获胜者结果 |
/karaoke status |
显示当前活动状态的摘要 |
/karaoke leaderboard |
打开排行榜 GUI |
/karaoke reload |
重新加载 config.yml 而无需重启服务器 |
/vote |
打开投票 GUI(所有玩家可用) |
? 权限
| 权限 |
默认值 |
描述 |
karaoke.host |
op |
完整的活动管理 |
karaoke.judge |
op |
评委级别交互(状态、排行榜) |
karaoke.execute |
op |
访问 /karaoke drop 和 /karaoke execute |
karaoke.vote |
true |
打开 /vote GUI |
? PlaceholderAPI 占位符
需要安装 PlaceholderAPI。
| 占位符 |
返回值 |
%karaoke_event_active% |
true / false |
%karaoke_singer% |
当前歌手的名字,或 None |
%karaoke_judge_count% |
活跃评委的数量 |
%karaoke_queue_size% |
队列中等待的玩家数量 |
%karaoke_countdown% |
格式化后的剩余倒计时(例如 4m 30s) |
%karaoke_my_score% |
查看玩家的总分(评委 + 观众) |
%karaoke_my_judge_score% |
查看玩家的评委来源分数 |
%karaoke_my_audience_score% |
查看玩家的观众来源分数 |
%karaoke_is_judge% |
true / false — 查看者是否为评委 |
⚙️ 配置概览
config.yml 在运行时只读。data.yml 由插件写入,保存所有捕获的位置和运行时状态。
luckperms-commands:
为每个角色动作分发的确切控制台命令。支持 {player}、{group} 和 {ordinal} 占位符。将任何条目设置为 "" 以完全跳过。
luckperms-commands:
singer-add: "lp user {player} parent add {group}"
singer-remove: "lp user {player} parent remove {group}"
listener-add: "lp group default parent add {group}"
listener-remove: "lp group default parent remove {group}"
judge-add: "lp user {player} parent add {group}"
judge-remove: "lp user {player} parent remove {group}"
judge-suffix-set: 'lp user {player} meta addsuffix 1000 " &6[&eJ{ordinal}&6]&r"'
judge-suffix-clear: "lp user {player} meta removesuffix 1000"
event-commands:
在事件开始/结束时为所有在线玩家执行的命令。每位玩家将以临时的 * 权限执行这些命令,因此传送点和其他受权限限制的命令对所有人都可用。
event-commands:
on-start:
- "warp karaoke"
on-stop:
- "warp spawn"
其他重要设置
| 键 |
默认值 |
描述 |
countdown-auto-start |
true |
倒计时归零时自动开始事件 |
round-duration-seconds |
0 |
每位歌手的限时(0 = 禁用) |
round-auto-advance-queue |
false |
回合计时器结束后自动分配下一位歌手 |
stage-drop-restore-delay-seconds |
10 |
掉落的舞台恢复前的秒数 |
?️ 设置指南
打开 /karaoke setup 并在站在(或看向)相关位置时点击每个按钮:
| 按钮 |
捕获内容 |
| Stage Teleport |
歌手被分配时的出生点 |
| Judge Bench |
事件开始时评委传送到的位置 |
| Listener Deck |
事件开始时观众传送到的位置 |
| Spawn Point |
事件结束时所有人返回的位置 |
| Trap Region Pos 1 & 2 |
舞台地板的两个角(用于 /karaoke drop) |
| Execution Chamber |
歌手被执行时传送到的房间 |
| Execution Trigger |
在执行期间变成红石块的方块 |
| Judge Display Blocks 1–4 |
显示每位评委投票的方块(黄色 → 绿色/红色) |
所有捕获的数据都保存在 data.yml 中,重启后依然保留。
? KaraokePlugin
A full-featured karaoke event management plugin for PaperMC servers.
KaraokePlugin lets you run live karaoke nights directly on your Minecraft server. Assign singers, manage a judge panel with live scoring displays, drop the stage floor for dramatic effect, teleport the crowd, handle a singer queue — all from a clean in-game GUI without touching a single command by hand.
✨ Features
- GUI Control Panel — open with
/karaoke or /k; every action has a dedicated button
- LuckPerms Integration — singer, judge, and listener roles are applied and removed automatically via fully configurable console commands
- Live Scoring — judges and audience vote yes/no; scores are tracked separately and displayed on the leaderboard
- Judge Display Blocks — concrete blocks in the world flip from yellow → green or red as judges vote
- Judge Suffixes — judges automatically receive a coloured
[J1] [J2] etc. suffix via LP meta
- Singer Queue — add multiple players to a waiting list; advance through them one-by-one
- Round Timer — optional per-singer time limit with title countdowns; auto-advance queue when it expires
- Stage Drop — removes the floor under the singer's feet; restores it automatically after a configurable delay; teleports the singer back to stage on respawn if they die
- Execution Chamber — teleport the singer to a separate chamber via a redstone trigger
- Top-3 Winner Announcement — broadcasts a formatted results banner with judge and audience score breakdown
- Spawn Return — sends every player to a configured spawn point when the event ends
- Event Commands — run any commands on behalf of every player (with
* permissions) when the event starts or ends
- PlaceholderAPI Support — 9 placeholders for scoreboards and displays
- Fully Configurable — all LuckPerms commands, messages, scoring weights, timers, and locations are set in
config.yml
- Persistent Setup — captured locations and scores are saved to
data.yml and survive restarts
? Installation
- Drop
KaraokePlugin.jar into your server's plugins/ folder.
- Start the server once to generate
plugins/KaraokePlugin/config.yml.
- Set your LuckPerms group names under
roles: if they differ from the defaults (singer, judge, listener).
- Optionally edit
luckperms-commands: to customise exactly what LP commands are run.
- In-game, run
/karaoke setup to capture all required locations (stage, judge bench, listener deck, spawn, trapdoor region, execution chamber).
- Done — run
/karaoke start to begin your first event.
Requirements
| Dependency |
Version |
Required |
| Paper |
1.21.1 |
✅ Yes |
| LuckPerms |
Any |
⚠️ Soft (roles won't apply without it) |
| PlaceholderAPI |
Any |
⚠️ Soft (placeholders won't work without it) |
?️ Commands
All management commands require karaoke.host. Aliases: /k
| Command |
Description |
/karaoke |
Open the admin control panel GUI |
/karaoke start |
Start the event immediately |
/karaoke stop |
Stop the event and return all players to spawn |
/karaoke time <duration> |
Set and start a countdown (e.g. 5m, 2m 30s, 90s) |
/karaoke setup |
Open the location setup GUI |
/karaoke add singer <player> |
Assign a player as the active singer |
/karaoke add judge <player> |
Add a player to the judge panel |
/karaoke remove singer <player> |
Remove the active singer and return them to audience |
/karaoke remove judge <player> |
Remove a player from the judge panel |
/karaoke singer clear |
Clear the stage (no singer) |
/karaoke queue add <player> |
Add a player to the singer queue |
/karaoke queue remove <player> |
Remove a player from the queue |
/karaoke queue next |
Advance the queue — assign the next waiting singer |
/karaoke queue clear |
Empty the queue |
/karaoke queue list |
List all players in the queue |
/karaoke drop |
Drop the stage floor under the current singer |
/karaoke execute |
Teleport the singer to the execution chamber |
/karaoke winner |
Announce the top-3 winner results |
/karaoke status |
Show a summary of the current event state |
/karaoke leaderboard |
Open the leaderboard GUI |
/karaoke reload |
Reload config.yml without restarting |
/vote |
Open the voting GUI (available to all players) |
? Permissions
| Permission |
Default |
Description |
karaoke.host |
op |
Full event management |
karaoke.judge |
op |
Judge-level interactions (status, leaderboard) |
karaoke.execute |
op |
Access to /karaoke drop and /karaoke execute |
karaoke.vote |
true |
Open the /vote GUI |
? PlaceholderAPI Placeholders
Requires PlaceholderAPI to be installed.
| Placeholder |
Returns |
%karaoke_event_active% |
true / false |
%karaoke_singer% |
Name of the current singer, or None |
%karaoke_judge_count% |
Number of active judges |
%karaoke_queue_size% |
Number of players waiting in queue |
%karaoke_countdown% |
Formatted countdown remaining (e.g. 4m 30s) |
%karaoke_my_score% |
Viewing player's total score (judge + audience) |
%karaoke_my_judge_score% |
Viewing player's judge-sourced score |
%karaoke_my_audience_score% |
Viewing player's audience-sourced score |
%karaoke_is_judge% |
true / false — whether the viewer is a judge |
⚙️ Configuration Overview
config.yml is read-only at runtime. data.yml is written by the plugin and holds all captured locations and runtime state.
luckperms-commands:
The exact console commands dispatched for every role action. Supports {player}, {group}, and {ordinal} placeholders. Set any entry to "" to skip it entirely.
luckperms-commands:
singer-add: "lp user {player} parent add {group}"
singer-remove: "lp user {player} parent remove {group}"
listener-add: "lp group default parent add {group}"
listener-remove: "lp group default parent remove {group}"
judge-add: "lp user {player} parent add {group}"
judge-remove: "lp user {player} parent remove {group}"
judge-suffix-set: 'lp user {player} meta addsuffix 1000 " &6[&eJ{ordinal}&6]&r"'
judge-suffix-clear: "lp user {player} meta removesuffix 1000"
event-commands:
Commands run for every online player on event start/stop. Each player executes them with temporary * permissions, so warps and other permission-gated commands work for everyone.
event-commands:
on-start:
- "warp karaoke"
on-stop:
- "warp spawn"
Other notable settings
| Key |
Default |
Description |
countdown-auto-start |
true |
Auto-start event when countdown hits zero |
round-duration-seconds |
0 |
Per-singer time limit (0 = disabled) |
round-auto-advance-queue |
false |
Auto-assign next singer when round timer expires |
stage-drop-restore-delay-seconds |
10 |
Seconds before dropped floor restores |
?️ Setup Guide
Open /karaoke setup and click each button while standing at (or looking at) the relevant position:
| Button |
What to capture |
| Stage Teleport |
Where the singer spawns when assigned |
| Judge Bench |
Where judges teleport on event start |
| Listener Deck |
Where the audience teleports on event start |
| Spawn Point |
Where everyone returns when the event ends |
| Trap Region Pos 1 & 2 |
Two corners of the stage floor (for /karaoke drop) |
| Execution Chamber |
The room the singer is sent to on execution |
| Execution Trigger |
Block that becomes a redstone block during execution |
| Judge Display Blocks 1–4 |
Blocks that show each judge's vote (yellow → green/red) |
All captures are saved to data.yml and persist through restarts.
评论 0
登录后参与评分
还没有评论,来抢沙发吧