DummyPool

插件

· 作者 MrDummy

一款基于 Paper 服务器的台球插件,由 AI 代理辅助,提供 AI 引擎、逼真的物理效果和中式八球、斯诺克及开伦的完整规则。

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

最新 1.0.3-Release · 26.2 · Paper / Purpur

一键开服(送7天)

DummyPool 支持 34 个自定义参数。提供 5 种球桌类型,具备逼真的物理引擎和智能 AI 系统 逼真的台球物理模拟。击球路径可视化。 多种可定制的粒子预设。7 级力度调节系统,带来逼真的台球手感。

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!

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源