一个 Paper 插件,队伍竞速收集共享且带种子的宾果卡上的物品。率先完成一行的队伍获胜。
玩法
每局游戏使用同一张所有队伍都能看到的卡片。卡片是一个由格子组成的正方形网格(3x3 到 6x6),每个格子要么是特定物品,要么是某个类别(如“任意木板”)。卡片通过种子生成,因此相同的种子总是产生相同的卡片。
游戏开始时,玩家会被治疗、清空物品栏、在出生点周围分散,并启动倒计时。倒计时结束后,当你捡起、合成或将匹配的物品放入你的物品栏时,你便为队伍认领该格子。每半秒进行一次背景物品栏扫描作为保底机制,确保不会遗漏任何操作。已认领的格子保持认领状态(但在锁定模式下,一旦有人认领,该格子将对所有队伍锁定)。
实时动作栏显示你队伍的计数和当前领先者。可选的侧边计分板和 Boss 条追踪整个大厅的排名。当某支队伍距离胜利仅差一个格子时,会广播“差一格”的消息。
模式
- 标准 - 率先完成整行、整列或对角线
- 清屏 - 率先认领所有格子的队伍获胜
- 锁定 - 任何队伍认领格子的瞬间,该格子全局锁定;率先完成自己格子连线的队伍获胜。竞技模式,无共享格子
- 计数 - 率先达到目标格子数量的队伍获胜;忽略连线条件
额外功能
- 单人 - 每个在线玩家成为自己的队伍
- 旁观者模式 -
/bingo spectate 让你退出比赛;此时你的卡片视图将显示哪个队伍持有每个格子
- 硬核 - 死亡后你在剩余游戏中进入旁观者模式
- 限时 - 可选;时间耗尽时,拥有最多格子的队伍获胜,平局则视为平手
- 统计 - 每人的胜场和总局数持久化存储,并设有排行榜
使用方法
- 安装:将 jar 文件放入服务器的
plugins/ 文件夹并重启
- 玩家使用
/bingo join <team> 加入队伍,或开启 auto-assign 让所有人开局自动分配到队伍。运行 /bingo lobby 打开箱子菜单——点击羊毛块加入该队伍,或点击屏障方块进入旁观者模式
- 管理员运行
/bingo start [mode] [size] [seed](均为可选参数,默认值来自配置文件)
- 每位玩家获得一张宾果卡物品——右键点击以箱子 GUI 形式打开卡片。发光表示你的队伍已认领该格子,屏障方块表示其他队伍锁定了它
- 持续游玩直到某支队伍达成胜利条件。运行
/bingo stop 提前结束游戏
命令
所有命令均以 /bingo 开头(别名 /bg):
| 命令 |
作用 |
start [mode] [size] [seed] |
开始一局游戏 |
solo [mode] [size] |
开始一局游戏,其中每个在线玩家都是自己的队伍 |
stop |
结束游戏 |
lobby |
打开队伍选择箱子 UI |
join <team> / leave |
选择或离开队伍 |
team <create|remove|clear> |
在游戏前管理运行时队伍 |
spectate |
进入旁观者模式 |
card |
打开卡片 GUI |
teams |
列出队伍及成员 |
status |
模式、大小、种子、各队伍格子数量 |
reveal |
向自己打印当前卡片 |
top |
胜场/总局数排行榜 |
stats [player] |
某玩家的胜场和总局数 |
reroll |
在游戏开始前重新生成卡片 |
reload |
重新读取配置和物品池 |
权限
bingo.admin - 拥有 start、stop、reroll、reload 以及队伍管理权限(默认为 OP)
bingo.exempt - 玩家被自动分配机制跳过
配置
所有内容位于 config.yml 中:
default-mode / default-size - 用于裸执行 /bingo start 时的默认值
count-target - 计数模式中获胜所需的格子数量
start-countdown - GO 之前的倒计时秒数
time-limit - 秒数;设为 0 则禁用
auto-assign - 开局时将每个在线玩家按轮询方式分配到队伍
on-start.* - 控制清空物品栏、治疗、分散、设置时间为白天的开关
spread-radius - 从世界出生点分散玩家的区块半径
hardcore - 死亡后玩家在剩余游戏中进入旁观者模式
scoreboard - 在游戏中显示实时侧边计分板
teams - id: { display, color } 映射表,颜色为 MiniMessage 颜色名称
item-pool - 约 130 个物品加上 9 个组:distribution 权重等级、命名的 groups(“任意这些”集合),以及 easy / medium / hard 材质列表,可引用带有 #name 的组
卡片生成过程通过掷骰子确定等级(权重由 distribution 决定),然后从该等级中随机选取一项条目,并由游戏种子进行播种。每个格子要么是精确物品,要么是组——持有 #planks 组中任何成员的物品即可认领“任意木板”。
技术细节
- 平台: Paper 26.2 (Bukkit API)
- 语言: Kotlin, JDK 25
- 包名:
com.mohammadfaizan.bingo
- 卡片尺寸: 3 到 6
- 依赖项: 无
重启持久化
运行中的游戏会在关闭时写入 game.yml ——包括卡片、种子、模式、各队伍成员和已认领格子、锁定状态以及剩余时间。下次服务器启动时会自动恢复:任务、Boss 条、计分板和卡片物品都会重新创建。在正常停止、胜利或平局时,该文件会被删除。仍处于预游戏倒计时阶段的游戏不会被保存。
认领检测
认领由事件驱动——拾取、合成和物品栏移动事件会立即认领格子。每秒 0.5 次的玩家全物品栏扫描作为保底机制,处理事件可能遗漏的操作。每次认领时,排名、动作栏、计分板和“差一格”广播都会更新。
a paper plugin where teams race to collect the items on a shared, seeded bingo card. first team to complete a line wins.
gameplay
every game runs off a single card that every team can see. a card is a square grid of cells (3x3 up to 6x6), and each cell is either a specific item or a group like "any planks". the card is rolled from a seed, so the same seed always produces the same card.
when the game starts, players are healed, cleared, spread out around spawn, and a countdown runs. on GO, you claim a cell for your team the moment you pick up, craft, or move the matching item into your inventory. a background inventory sweep every half second is the backstop, so nothing gets missed. claimed cells stay claimed (except in lockout mode, where they lock for everyone).
a live action bar shows your team's count and the current leader. an optional sidebar scoreboard and boss bar track standings for the whole lobby. when a team gets within one cell of winning, a "one away" message is broadcast.
modes
- standard - first full row, column, or diagonal
- blackout - first team to claim every cell
- lockout - a cell locks globally the instant any team claims it; first to a line of their own cells wins. competitive, no shared cells
- count - first team to a target number of cells; lines are ignored
extras
- solo - every online player becomes their own team
- spectator mode -
/bingo spectate drops you out of play; your card view then shows which team holds each cell
- hardcore - dying puts you in spectator for the rest of the game
- time limit - optional; when it runs out the team with the most cells wins, a tie is a draw
- stats - wins and games played are persisted per player, with a leaderboard
how to use
- install: drop the jar in your server's
plugins/ folder and restart
- players join teams with
/bingo join <team>, or leave auto-assign on to have everyone split onto teams automatically at start. /bingo lobby opens a chest menu - click a wool to join that team, or the barrier to spectate
- an admin runs
/bingo start [mode] [size] [seed] (all optional, defaults come from the config)
- each player is handed a bingo card item - right-click it to open the card as a chest gui. glowing means your team has that cell, a barrier means another team locked it
- play until a team hits the win condition.
/bingo stop ends a game early
commands
all under /bingo (alias /bg):
| command |
does |
start [mode] [size] [seed] |
begin a game |
solo [mode] [size] |
begin a game where every online player is their own team |
stop |
end the game |
lobby |
open the team-select chest ui |
join <team> / leave |
pick or drop a team |
team <create|remove|clear> |
manage runtime teams before a game |
spectate |
go spectator |
card |
open the card gui |
teams |
list teams and members |
status |
mode, size, seed, per-team cell counts |
reveal |
print the current card to yourself |
top |
win/games leaderboard |
stats [player] |
wins and games for a player |
reroll |
roll a new card before the game starts |
reload |
re-read the config and item pool |
permissions
bingo.admin - start, stop, reroll, reload, team management (defaults to op)
bingo.exempt - player is skipped by auto-assign
configuration
everything lives in config.yml:
default-mode / default-size - used by a bare /bingo start
count-target - cells needed to win in count mode
start-countdown - seconds before GO
time-limit - seconds; 0 disables it
auto-assign - round-robin every online player onto teams at start
on-start.* - toggles for clear inventory, heal, spread, set time to day
spread-radius - blocks from world spawn to scatter players
hardcore - death spectates the player for the rest of the game
scoreboard - show the live sidebar during a game
teams - map of id: { display, color }, color is a minimessage color name
item-pool - roughly 130 items plus 9 groups: distribution tier weights, named groups ("any of these" sets), and easy / medium / hard material lists that can reference groups with #name
card generation fills every cell by rolling a tier (weighted by distribution), then a random entry from that tier, seeded by the game seed. a cell is either an exact item or a group - holding any member of a #planks group claims "any planks".
technical details
- platform: paper 26.2 (bukkit api)
- language: kotlin, jdk 25
- package:
com.mohammadfaizan.bingo
- card sizes: 3 to 6
- dependencies: none
restart persistence
a running game is written to game.yml on shutdown - card, seed, mode, per-team members and claimed cells, lockout locks, and time remaining. it resumes automatically on the next server start: tasks, boss bar, scoreboard, and card items are all recreated. the file is deleted on a clean stop, win, or draw. games still in the pre-game countdown are not saved.
claim detection
claims are event-driven - pickup, craft, and inventory-move events claim a cell immediately. a 0.5 second full-inventory scan per player runs as a backstop for anything the events miss. standings, action bar, scoreboard, and the "one away" broadcast update on each claim.
评论 0
登录后参与评分
还没有评论,来抢沙发吧