
DummyPool
一款为 Paper 服务器开发的高性能台球插件,采用 AI 辅助编码技术。
提供 5 种球桌类型、逼真的物理引擎以及中式八球、九球和斯诺克完整规则集。所有 34 个物理参数均按球桌独立保存,且所有消息、粒子和音效均可完全自定义。
✨ 功能特性
- ? 5 种球桌类型:中式八球、九球、斯诺克、开伦(Carom)和圆桌
- ⚙️ 独立物理系统:34 个参数(摩擦力、弹性、旋转衰减等)按球桌独立保存
- ? 完全可定制:聊天消息(message.yml)、粒子与音效(config.yml)可由服务器管理员编辑
- ? AI 辅助开发:逻辑稳定、结构良好,并经过性能优化
? 1. 球桌类型与尺寸
| 类型 |
键值 (Key) |
球桌尺寸(方块) |
袋口数量 |
描述 |
| ?? 中式八球 |
cn8 |
3 × 5 (半宽 1.5, 半长 2.5) |
6 |
全色球(混凝土 1–7)+ 花色球(羊毛 9–15)+ 黑 8 |
| ? 九球 |
9-ball / nine_ball |
3 × 5 (半宽 1.5, 半长 2.5) |
6 |
菱形摆法 1–9;首次接触必须击中号码最小的球 |
| ? 斯诺克 |
snooker |
4 × 7 (半宽 2.0, 半长 3.5) |
6 |
15 颗红球 + 6 颗彩球;D 型底岸区域 |
| ? 开伦球 |
carom |
3 × 5 |
无 |
无袋口球桌;通过撞击得分 |
| ⭕ 圆桌 |
round |
半径 = [size] 个方块 |
无 |
圆形球桌;粒子轮廓形成圆形 |
? 创建提示: 站在目标位置,面朝球桌的长边。斯诺克球桌使用特殊的 4×7 对齐方式(长边中心位于方块上,短边位于方块边界上)。
潜行触发机制: 非创建者手持球杆(副手),在距离球桌脚端外侧一个方块处(高度差 0–2 方块)潜行,若拥有相应权限将打开球库。如果球桌未被认领,第一个触发此操作的玩家将被认定为创建者并打开管理菜单。
?️ 2. 创建与管理命令
2.1 创建球桌
/dummypool create <name> <type> [size]
- Type(类型)(必填,不区分大小写):cn8 / 9-ball / snooker / carom / round
- Size(尺寸):仅圆桌需要——以方块为单位的半径;其他类型忽略此参数
2.2 列表与删除
/dummypool list # 列出所有球桌
/dummypool remove <name> # 删除球桌(仅限创建者)
2.3 成功后的效果
选定类型的默认球组会自动生成,并使用粒子效果绘制球桌轮廓。
? 3. 管理菜单(对话框)
创建者可以通过以下方式打开强大的管理面板:
/dummypool ui <table> main
# 快捷方式
/dummypool set <table>
该菜单包含 8 个核心功能按钮:
| 按钮 |
描述 |
| ⚙️ 参数 |
打开 34 个物理参数列表(共 3 页)。点击项目即可编辑;超出范围的值会自动限制 |
| ? 权限 |
4 个切换开关(? 允许 / ? 拒绝):开架、放置/拿取球、击球、游戏模式 |
| ? 开架 |
以原版箱子界面打开球桌的球架 |
| ? 一键摆球 |
根据当前规则自动摆球(若缺球会提示) |
| ✏️ 编辑球架 |
打开 54 格编辑器:移除球会剥离其球桌标签;放回则重新应用标签 |
| ⚔️ 游戏模式 |
打开比赛对话框(中式八球 / 九球 / 斯诺克) |
| ? 收集球 |
将桌上所有球收回到球架中(溢出部分掉落至感应区) |
| ❌ 关闭 |
关闭管理菜单 |
? 潜行触发区域
非创建者在距离球桌脚端外侧一个方块处(高度差 0–2),手持球杆并潜行时:
- 若拥有开架权限 → 打开球架
- 若球桌未被认领 → 第一个触发者自动成为创建者并打开菜单
脚下会出现火焰粒子环(可在 config.yml 的 sneak_zone 中配置)。
? 4. 权限设置(4 个开关)
| 权限 |
✅ 允许时 |
❌ 禁止时 |
| Open Rack(开架) |
非创建者可打开球架 |
非创建者无法通过潜行或命令打开 |
| Place/Take Balls(放置/拿取球) |
可放置、拾取和摆球 |
放置和摆球被阻止 |
| Hit Balls(击球) |
可瞄准和击球 |
无法进入蓄力状态 |
| Game Mode(游戏模式) |
可打开游戏菜单并加入比赛 |
菜单显示无权限 |
?️ 5. 球库系统
- 打开方式: 通过菜单、
/dummypool ball lib <table> 或在感应区潜行
- 交互方式: 与原版箱子相同。关闭时,非球类物品和其他球桌的球会返回玩家背包
- 编辑规则: 从编辑界面移出的球会失去其球桌标签(及描述文本)。没有标签或待处理标签的球在归还时会自动打上标签。来自其他球桌的球会被拒绝
- 收集命令:
/dummypool clear <table> 或菜单按钮可收集桌上所有球(游戏模式下禁用)
- 满库处理: 最多 54 格。当球库已满时,进袋的球会掉落在脚端感应区的地面上,可供玩家拾取
? 6. 一键摆球
命令
/dummypool ball place <table> [mode]
- 中式八球 / 斯诺克: 无需指定模式
- 开伦球: 需要指定模式参数(例如
/dummypool ball place <table> <mode>)
流程
- Pre‑clear: 在摆球前自动收集所有台面上的球(若库容量已满则直接掉落)
- Missing Balls: 聊天栏会列出缺失的球,并提供 [点击确认] / [点击取消] 交互按钮
- Break Shot: 摆球完成后,下一次击打母球的操作即视为开杆(速度×1.3 并带有开杆特效)
各桌型默认球组配置
| Table Type |
Ball Set |
| Chinese 8‑Ball |
母球 + 全色球 1–7 + 黑八 + 花色球 9–15;三角框摆放,底角两球须分属不同组别 |
| 9‑Ball |
母球 + 1–9号球;菱形框摆放 – 1号球位于顶点,9号球居中,其余随机排列 |
| Snooker |
母球 + 15颗红球 + 黄/绿/棕/蓝/粉/黑球;按标准斯诺克点位摆放 |
| Carom |
母球 + 黄/红/蓝球 |
⚙️ 7. 物理参数(共 34 项,每桌独立)
键名与 config.yml 及菜单中的标识符一致。所有参数均可通过管理菜单进行调整。
| Parameter (Key) |
Default |
Effect ↑ (数值增大) |
Effect ↓ (数值减小) |
| tableFriction |
0.11 |
球减速更快,旋转衰减更多 |
球滑行距离更远 |
| slipThreshold |
0.01 |
更早进入滚动状态,滑行距离更远 |
滑动摩擦持续时间更长,减速更快 |
| rollingDeceleration |
0.3 |
滚动停止得快 |
滚动持续更久 |
| stopThreshold |
0.02 |
球过早停止 |
球停留时间更长 |
| spinDecayX |
0.999 |
前后旋持续更久 |
前后旋消失更快 |
| spinDecayY |
0.985 |
侧旋持续更久 |
侧旋迅速消失 |
| spinDecayScale |
1.0 |
所有旋转衰减更快 |
所有旋转衰减更慢 |
| spinFrictionCouplingX |
0.55 |
摩擦力更快抵消前后旋 |
拉杆/加塞效果持续更久 |
| maxSpinSpeed |
150 |
允许施加更多旋转 |
旋转效果受限 |
| collisionDistance |
0.30 |
可能触发提前检测 |
求解器将其限制回 0.30 |
| collisionIterations |
15 |
接触/高速球碰撞更稳定,但性能开销更大 |
可能出现穿模现象 |
| collisionRestitution |
0.93 |
碰撞更具弹性 |
碰撞较柔和 |
| collisionSpinTransfer |
0.4 |
目标球更容易产生旋转 |
加塞效果减弱 |
| ballHitFriction |
0.3 |
母球偏转更多 |
几乎无偏转 |
| cushionRestitution |
0.83 |
反弹剧烈 |
吸收能量(更柔和) |
| cushionFriction |
0.6 |
香蕉球效果更明显 |
碰库时无偏转 |
| masseMinAngle |
45 |
更难打出低杆 |
可在更小角度打出低杆 |
| masseMaxAngle |
80 |
大角度下弯曲效果增强 |
曲线较早达到上限 |
| masseCurveCoeff |
6.0 |
曲线更尖锐 |
曲线更平缓 |
| masseAxisTiltMax |
60 |
侧向曲线更强 |
曲线较弱(倾斜度较小) |
| masseDecayOmegaRef |
30 |
曲线较早变直(弧长较短) |
曲线持续更久(弧长较长) |
| masseBankMax |
15 |
倾斜夸张 |
倾斜轻微 |
| masseBankOmegaRef |
30 |
需要高转速才能跳库 |
低转速即可跳库 |
| masseOffsetBoost |
3.0 |
更容易加塞和出曲线 |
低杆加塞效果减弱 |
| jumpAngleThreshold |
75 |
更难跳球 |
更容易跳球 |
| jumpMinPowerLevel |
4 |
需要更大力量才能跳球 |
轻击即可跳球 |
| jumpVelocityScale |
0.5 |
跳得更高更远 |
跳起高度较低 |
| jumpMaxHeight |
1.0 |
可跳得更高 |
跳起高度受限 |
| landingSpinLoss |
0.6 |
落地后旋转几乎消失 |
落地后仍保留旋转 |
| collisionSpinTransferX |
0.12 |
跟随/拉杆旋转传递更明显 |
碰撞时仅轻微损失旋转 |
| cushionSpinTransferX |
0.05 |
强烈的吸库/跟袋效果 |
仅依赖台面摩擦力 |
| cushionSpinLossX |
0.25 |
碰库时前后旋损失更多 |
保留更多旋转 |
| cushionSpinLossY |
0.3 |
碰库时侧旋迅速消失 |
多次碰库后仍有偏转 |
| cushionTangentialLoss |
0.1 |
沿库边滑动衰减快 |
沿库边滑行距离更远 |
? 8. 完整命令列表
| Command |
Description |
Permission |
/dummypool create <name> <type> [size] |
创建球桌 |
所有人 |
/dummypool remove <name> |
移除球桌 |
创建者 |
/dummypool list |
列出所有球桌 |
所有人 |
/dummypool clear <table> |
将桌面上的球收纳入库(游戏模式下被禁止) |
放置权限 |
/dummypool ui <table> <action> |
管理对话框(main/params/param/perms/lib/place/edit/game/invite/close) |
创建者 |
/dummypool set <table> |
等同于 ui main |
创建者 |
/dummypool game <table> enable |
启用游戏模式 |
创建者 |
/dummypool game <table> menu |
打开游戏对话框 |
游戏权限 |
/dummypool game <table> invite <player> |
邀请玩家加入 |
成员 |
/dummypool game <table> join |
加入游戏 |
所有人 |
/dummypool game <table> reject |
拒绝邀请(5分钟冷却) |
所有人 |
/dummypool game <table> start |
开始游戏 |
成员 |
/dummypool game <table> end |
结束当前对局(模式保持不变) |
成员 |
/dummypool game <table> concede |
斯诺克落后时认输 |
成员 |
/dummypool game <table> choice own/let |
斯诺克犯规后的选择权 |
非犯规方 |
/dummypool ball get <type> |
获取指定球(例如 concrete‑white, glass‑yellow) |
OP |
/dummypool ball lib <table> |
打开球库 |
库权限 |
/dummypool ball place <table> [mode] |
摆球;对缺失球进行 confirm/cancel 操作 |
放置权限 |
/dummypool cue get <name> |
领取球杆 |
所有人 |
/dummypool reloadmessages |
重载 message.yml |
OP |
/dummypool reloadconfig |
重载 config.yml |
OP |
? DummyPool 旨在为 Minecraft 服务器提供最真实且可定制的台球体验。欢迎提交 Issue 以反馈问题或报告 Bug!

DummyPool
A high-performance billiards plugin for Paper servers, developed with AI‑assisted coding.
Offers 5 table types, a realistic physics engine, and complete rule sets for Chinese 8‑Ball, 9‑Ball, and Snooker. All 34 physical parameters are saved independently per table, and all messages, particles, and sounds are fully customizable.
✨ Features
- ? 5 Table Types: Chinese 8‑Ball, 9‑Ball, Snooker, Carom, and Round
- ⚙️ Independent Physics: 34 parameters (friction, elasticity, spin decay, etc.) saved per table
- ? Fully Customizable: Chat messages (message.yml), particles & sounds (config.yml) editable by server owners
- ? AI‑Assisted: Stable, well‑structured logic with optimized performance
? 1. Table Types & Dimensions
| Type |
Key |
Table Size (Blocks) |
Pockets |
Description |
| ?? Chinese 8‑Ball |
cn8 |
3 × 5 (Half‑W 1.5, Half‑L 2.5) |
6 |
Solids (Concrete 1–7) + Stripes (Wool 9–15) + Black 8 |
| ? 9‑Ball |
9-ball / nine_ball |
3 × 5 (Half‑W 1.5, Half‑L 2.5) |
6 |
Diamond rack 1–9; first contact must hit the lowest‑numbered ball |
| ? Snooker |
snooker |
4 × 7 (Half‑W 2.0, Half‑L 3.5) |
6 |
15 Reds + 6 Colors; D‑shaped baulk area |
| ? Carom |
carom |
3 × 5 |
None |
Pocketless table; scoring via cannons |
| ⭕ Round Table |
round |
Radius = [size] blocks |
None |
Circular table; particle outline forms a circle |
? Creation Note: Stand at the target position facing the long side of the table. Snooker tables use special 4×7 alignment (long edge center on block, short edge on block border).
Sneak trigger: A non-creator standing one block outside the foot end of the table (height difference 0–2 blocks) while holding a cue in the off-hand and sneaking will open the ball library if they have the required permission. If the table is unowned, the first player to trigger this will be claimed as the creator and the management menu will open.
?️ 2. Creation & Management Commands
2.1 Create a Table
/dummypool create <name> <type> [size]
- Type (required, case‑insensitive): cn8 / 9-ball / snooker / carom / round
- Size: Only required for round – radius in blocks; ignored by other types
2.2 List & Remove
/dummypool list # Lists all tables
/dummypool remove <name> # Removes a table (creator only)
2.3 On Success
The default ball set for the selected type is automatically generated, and the table outline is drawn with particle effects.
? 3. Management Menu (Dialog)
Creators can open the powerful management panel via:
/dummypool ui <table> main
# Shortcut
/dummypool set <table>
The menu features 8 core function buttons:
| Button |
Description |
| ⚙️ Parameters |
Opens the list of 34 physics parameters (3 pages). Click an item to edit; out‑of‑range values are auto‑clamped |
| ? Permissions |
4 toggles (? Allow / ? Deny): Open Rack, Place/Take Balls, Hit Balls, Game Mode |
| ? Open Rack |
Opens the table's ball rack as a vanilla chest interface |
| ? One‑Click Rack |
Automatically racks balls per current rules (prompts if balls are missing) |
| ✏️ Rack Edit |
Opens a 54‑slot editor: removing a ball strips its table tag; placing it back re‑applies the tag |
| ⚔️ Game Mode |
Opens the match Dialog (CN8 / 9‑Ball / Snooker) |
| ? Collect Balls |
Sends all balls on the table back to the rack (overflow drops to the sensing area) |
| ❌ Close |
Closes the management menu |
? Sneak Trigger Zone
Non‑creators standing one block outside the table's foot end (height diff 0–2) with a cue in the off‑hand and sneaking will:
- If they have Rack Access → open the rack
- If the table is unowned → the first trigger automatically becomes the creator and opens the menu
Flame particle rings appear under the feet (configurable via sneak_zone in config.yml).
? 4. Permission Settings (4 Toggles)
| Permission |
✅ When Allowed |
❌ When Denied |
| Open Rack |
Non‑creators can open the rack |
Non‑creators cannot open via sneak or commands |
| Place/Take Balls |
Can place, pick up, and rack balls |
Placing and racking are blocked |
| Hit Balls |
Can aim and shoot |
Cannot enter the power‑charging state |
| Game Mode |
Can open game menu and join matches |
Menu shows no permission |
?️ 5. Ball Library System
- Opening: Via menu,
/dummypool ball lib <table>, or sneaking in the sensing area
- Interaction: Same as vanilla chest. Upon closing, non‑ball items and balls from other tables are returned to the player's inventory
- Edit Rules: Balls taken from the edit interface lose their table tag (and lore). Balls without a tag or with a pending tag get tagged automatically when returned. Balls from other tables are rejected
- Collect Command:
/dummypool clear <table> or the menu button collects all table balls (disabled during game mode)
- Full Library: Maximum 54 slots. When full, pocketed balls drop to the ground in the foot‑end sensing area and can be picked up
? 6. One‑Click Rack
Command
/dummypool ball place <table> [mode]
- Chinese 8‑Ball / Snooker: no mode needed
- Carom: requires a mode parameter (e.g.,
/dummypool ball place <table> <mode>)
Process
- Pre‑clear: Automatically collects all table balls before racking (drops if library is full)
- Missing Balls: Chat lists missing balls with [Click Confirm] / [Click Cancel] interactive buttons
- Break Shot: After racking, the next shot on the cue ball counts as the break (speed ×1.3 with break effects)
Default Ball Sets per Table
| Table Type |
Ball Set |
| Chinese 8‑Ball |
Cue + Solids 1–7 + Black 8 + Stripes 9–15; triangular rack, corner balls from different groups |
| 9‑Ball |
Cue + 1–9; diamond rack – 1 at the apex, 9 in the center, others random |
| Snooker |
Cue + 15 Reds + Yellow/Green/Brown/Blue/Pink/Black; placed at standard snooker spots |
| Carom |
Cue + Yellow/Red/Blue |
⚙️ 7. Physical Parameters (34 Items, Independent per Table)
Keys match the identifiers in config.yml and the menu. All are adjustable via the management menu.
| Parameter (Key) |
Default |
Effect ↑ (Higher) |
Effect ↓ (Lower) |
| tableFriction |
0.11 |
Balls slow faster, spin wears more |
Balls slide farther |
| slipThreshold |
0.01 |
Enters rolling earlier, travels further |
Sliding friction lasts longer, decelerates faster |
| rollingDeceleration |
0.3 |
Rolling stops quickly |
Rolls longer |
| stopThreshold |
0.02 |
Balls stop early |
Balls linger longer |
| spinDecayX |
0.999 |
Forward/back spin lasts longer |
Forward/back spin disappears faster |
| spinDecayY |
0.985 |
Side spin lasts longer |
Side spin disappears quickly |
| spinDecayScale |
1.0 |
All spins decay faster |
All spins decay slower |
| spinFrictionCouplingX |
0.55 |
Friction neutralizes forward/back spin faster |
Draw/follow lasts longer |
| maxSpinSpeed |
150 |
Allows more spin |
Spin effects are limited |
| collisionDistance |
0.30 |
May trigger early detection |
Clamped back to 0.30 by the solver |
| collisionIterations |
15 |
More stable for touching/fast balls but heavier on performance |
May cause tunneling |
| collisionRestitution |
0.93 |
Bouncier collisions |
Softer collisions |
| collisionSpinTransfer |
0.4 |
Target ball is more likely to be spun |
Less effect from english |
| ballHitFriction |
0.3 |
More cue ball deflection |
Almost no deflection |
| cushionRestitution |
0.83 |
Bounces hard |
Absorbs energy (softer) |
| cushionFriction |
0.6 |
Banana shot is more visible |
No deflection on cushion |
| masseMinAngle |
45 |
Harder to masse |
Masse possible at smaller angles |
| masseMaxAngle |
80 |
Continues strengthening at larger angles |
Curve caps earlier |
| masseCurveCoeff |
6.0 |
Sharper curve |
Gentler curve |
| masseAxisTiltMax |
60 |
Stronger side‑curve |
Weaker curve (less tilt) |
| masseDecayOmegaRef |
30 |
Curve straightens early (short arc) |
Curve lasts longer (long arc) |
| masseBankMax |
15 |
Exaggerated tilt |
Mild tilt |
| masseBankOmegaRef |
30 |
Needs high spin to bank |
Banks at low spin |
| masseOffsetBoost |
3.0 |
Easier to spin and curve |
Weaker masse english |
| jumpAngleThreshold |
75 |
Harder to jump |
Easier to jump |
| jumpMinPowerLevel |
4 |
Needs more power to jump |
Can jump with a light hit |
| jumpVelocityScale |
0.5 |
Jumps higher and farther |
Jumps lower |
| jumpMaxHeight |
1.0 |
Can jump higher |
Limited jump height |
| landingSpinLoss |
0.6 |
Spin is almost gone after landing |
Spin remains after landing |
| collisionSpinTransferX |
0.12 |
Follow/draw spin transfer is more visible |
Only slight spin loss during collision |
| cushionSpinTransferX |
0.05 |
Strong suck‑in / follow effect |
Relies only on table friction |
| cushionSpinLossX |
0.25 |
Forward/back spin drops more on cushion |
Retains more spin |
| cushionSpinLossY |
0.3 |
Side spin vanishes quickly on cushion |
Still deflects on multiple rails |
| cushionTangentialLoss |
0.1 |
Sliding along cushion decays fast |
Slides farther along cushion |
? 8. Full Command List
| Command |
Description |
Permission |
/dummypool create <name> <type> [size] |
Creates a table |
Everyone |
/dummypool remove <name> |
Removes a table |
Creator |
/dummypool list |
Lists all tables |
Everyone |
/dummypool clear <table> |
Collects table balls into library (blocked in game mode) |
Place permission |
/dummypool ui <table> <action> |
Management Dialog (main/params/param/perms/lib/place/edit/game/invite/close) |
Creator |
/dummypool set <table> |
Same as ui main |
Creator |
/dummypool game <table> enable |
Enables game mode |
Creator |
/dummypool game <table> menu |
Opens game Dialog |
Game permission |
/dummypool game <table> invite <player> |
Invites a player |
Member |
/dummypool game <table> join |
Joins the game |
Everyone |
/dummypool game <table> reject |
Rejects invite (5‑minute cooldown) |
Everyone |
/dummypool game <table> start |
Starts the game |
Member |
/dummypool game <table> end |
Ends current session (mode stays) |
Member |
/dummypool game <table> concede |
Concedes in snooker when behind |
Member |
/dummypool game <table> choice own/let |
Snooker foul choice |
Non‑offender |
/dummypool ball get <type> |
Gives a ball (e.g., concrete‑white, glass‑yellow) |
OP |
/dummypool ball lib <table> |
Opens the ball library |
Library permission |
/dummypool ball place <table> [mode] |
Racks balls; confirm/cancel for missing balls |
Place permission |
/dummypool cue get <name> |
Claims a cue |
Everyone |
/dummypool reloadmessages |
Reloads message.yml |
OP |
/dummypool reloadconfig |
Reloads config.yml |
OP |
? DummyPool aims to deliver the most realistic and customizable billiards experience for Minecraft servers. Feel free to submit issues for feedback or bug reports!
评论 0
登录后参与评分
还没有评论,来抢沙发吧