在 Minecraft 原生 Paper 对话框 UI 中完成限时国际象棋对局
Chess 将 Paper 的原生对话框系统转化为一个实时、可点击的 8x8 棋盘。挑战另一位玩家,选择计时模式,即可在不使用箱子菜单或实体棋盘的情况下进行完整的对局。
亮点
- 原生对话框棋盘: 64 个独立可点击的方格,界面简洁且实时更新。
- 完整的走子处理: 支持王车易位、吃过路兵、升变、将军、将死和逼和。
- 限时对局: 提供从一分钟超快棋到五小时慢棋的 17 种预设模式,并支持每步加时选项。
- 实用的棋盘反馈: 合法移动、选中高亮、最后一步、将军提示、吃子记录、坐标显示以及双方时钟均可直接在对话框内展示。
- 玩家友好控制: 翻转棋盘、提议或接受和棋、安全认输、关闭对话框,并可随时重新打开进行中的对局。
- 资源包感知: 纹理棋盘已打包内置,可通过 ResourcePackManager 自动注册,并提供可选的 Unicode 字符回退方案。
- 兼容 Folia: 游戏状态变更、时钟、命令、对话框发送和资源包分发均采用 Folia 安全的调度机制。
- 高度可配置: 可调整音效、过期计时器、棋盘行为、标签及提示信息。
游戏内预览
要求
- Java: 21
- 服务端: Paper 1.21.11 或基于相同 API 的 Folia
- 可选: ResourcePackManager
本插件依赖 Paper 的原生 Dialog API,无法在标准 Spigot 服务器上运行。
国际象棋引擎与棋盘资源包已包含在 Chess.jar 中;ResourcePackManager 并非必需。
快速开始
- 将
Chess.jar放入服务器的plugins文件夹并重启服务器。 - 若已安装 ResourcePackManager,Chess 会自动注册其资源包。
- 若未安装 ResourcePackManager,请托管文件
plugins/Chess/resourcepack.zip,并在plugins/Chess/settings.yml的resource-pack.url中设置公开访问 URL。 - 一名玩家执行
/chess duel <player> <time>发起挑战,另一名玩家执行/chess accept <player>接受挑战。
设置 ui.dialog.use-glyphs: false 可使用标准 Unicode 棋子图标而无需自定义纹理。
当由其他系统合并或分发资源包时,设置 resource-pack.use-resourcepack: false。
命令
| 命令 | 功能 |
|---|---|
/chess duel <player> <time> |
发送限时对决请求。 |
/chess accept <player> |
接受来自该玩家的请求。 |
/chess decline <player> |
拒绝来自该玩家的请求。 |
/chess open |
重新打开你当前的活跃棋盘。 |
/chess help |
显示命令帮助。 |
时间模式:1, 1|1, 2|1, 3, 3|2, 5, 5|2, 5|5, 10, 10|5, 15|10, 30,
60, 120, 180, 240, 和 300。在加时模式中,5|2 表示每步 5 分钟基础时间加上每步 2 秒的增量。
所有玩家均可使用 Chess;版本 1.0.0 没有权限节点限制。
支持
Complete timed chess matches in Minecraft's native Paper dialog UI
Chess turns Paper's native dialog system into a live, clickable 8x8 board. Challenge another player, choose a clock, and play a complete match without chest menus or a physical board.
Highlights
- Native dialog board: 64 individually clickable squares in a clean, live interface.
- Complete move handling: castling, en passant, promotion, check, checkmate, and stalemate.
- Timed games: 17 presets from one-minute bullet to five-hour games, with increment options.
- Useful board feedback: legal moves, selection, last move, check, captures, coordinates, and both clocks can be displayed directly in the dialog.
- Player-friendly controls: flip the board, offer or accept a draw, resign safely, close the dialog, and reopen an active game at any time.
- Resource-pack aware: the textured board is bundled, can register itself with ResourcePackManager, and has an optional Unicode fallback.
- Folia ready: game mutations, clocks, commands, dialog sends, and pack delivery use Folia-safe scheduling.
- Configurable: tune sounds, expiry timers, board behavior, labels, and messages.
See it in game
Requirements
- Java: 21
- Server: Paper 1.21.11 or Folia based on the same API
- Optional: ResourcePackManager
This plugin requires Paper's native Dialog API and does not run on a standard Spigot server. The
chess engine and the board pack are included in Chess.jar; ResourcePackManager is not required.
Getting started
- Put
Chess.jarin the server'spluginsfolder and restart. - With ResourcePackManager installed, Chess registers its pack automatically.
- Without ResourcePackManager, host
plugins/Chess/resourcepack.zipand set the public URL atresource-pack.urlinplugins/Chess/settings.yml. - Have one player run
/chess duel <player> <time>and the other run/chess accept <player>.
Set ui.dialog.use-glyphs: false for standard Unicode pieces without the custom textures. Set
resource-pack.use-resourcepack: false when another system will merge or distribute the pack.
Commands
| Command | What it does |
|---|---|
/chess duel <player> <time> |
Send a timed duel request. |
/chess accept <player> |
Accept a request from that player. |
/chess decline <player> |
Decline a request from that player. |
/chess open |
Reopen your active board. |
/chess help |
Show command help. |
Time modes: 1, 1|1, 2|1, 3, 3|2, 5, 5|2, 5|5, 10, 10|5, 15|10, 30,
60, 120, 180, 240, and 300. In increment modes, 5|2 means five minutes plus two
seconds after each move.
All players can use Chess; version 1.0.0 has no permission nodes.
Support
下载 Chess
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Chess
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Chess
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Chess
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Chess
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Chess
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Chess
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Chess
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
Chess v1.0.7
Chess v1.0.7 修复了当两个服务器共享同一个服务器密钥时的跨服联机问题。这种情况通常发生在将 settings.yml 从一个服务器复制到另一个服务器时。在此版本发布之前,这两个服务器会每隔几秒互相断开连接。控制台会不断刷屏显示 hub closed the link (replaced by a newer connection); reconnecting.,而 castled.codes 仪表盘中也会显示两个服务器的玩家出现又消失。
已修复
共享密钥的服务器
- 主服务器保持其连接。 当第二个使用已被占用的密钥的服务器尝试连接时,网络会检查第一个服务器是否仍然在线。如果是,新加入的服务器将被拒绝而非替换前者。如果前者已离线,则新加入的服务器像正常重连一样接管连接。
- 复制的服务器自动修复自身。 在被拒绝后,它会生成一个新的
network.server-key,将其保存到settings.yml中,并以独立服务器的身份重新加入网络。无需手动编辑任何内容,系统会记录一条警告日志说明发生的情况。 - 旧版本停止重试。 仍运行 v1.0.6 或更早版本的服务器仅被拒绝一次,并保持在网络离线状态,而不是与其他服务器争夺该密钥。请升级该服务器,或删除其
settings.yml中的network.server-key并重启,使其恢复正常。 - 延迟断连被忽略。 来自旧连接的断连报告不再导致当前连接掉线或触发第二次重连。
服务器密钥不再共享
此前发送给每个服务器的在线玩家列表包含了所有其他服务器的密钥(即服务器用于连接的凭证)。现在,服务器名称由其密钥的单向哈希值表示,且每个服务器收到的列表中不包含自身的玩家信息。
配置
没有新增设置项。network.server-key 仍在首次启动时自动生成,且仅在 v1.0.7 检测到网络中已有其他服务器使用该密钥时才会重写它。
命令
/chess duel <player> <time>
/chess duelcpu <1-10> <time>
/chess accept <player>
/chess decline <player>
/chess watch <player>
/chess open
/chess help
命令与 v1.0.6 版本保持一致。
验证
gradle clean build构建成功,85 个测试全部通过。- 网络经过测试,确保在第一个服务器的玩家列表正常显示的同时,拒绝具有相同密钥的第二个在线服务器;同时允许真正的重连替换无响应的连接。
- 经测试,不持有密钥的连接所发送的消息对持有密钥的服务器无任何影响。
- 经测试,在线玩家列表和实时游戏列表绝不会包含服务器密钥。
- 经测试,插件仅在因密钥共享被拒绝时才会更新其密钥,并在三次尝试失败后停止重试。
升级说明
替换旧的 Chess.jar 并完全重启服务器。资源包与 v1.0.6 版本保持一致。
如果您运行的是另一台服务器的副本,则无需执行任何操作:该副本在首次连接时会获取自己的独立密钥。
Chess v1.0.7 适用于 Spigot、Paper 或 Folia 平台上的 Java 21 和 Minecraft 1.21.11。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
使床在所有维度中爆炸的模组
插件
自定义你的Minecraft头像!
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为 Armor Poser 模组添加兼容性
插件
SkyBlock、OneBlock、Boxed、SkyGrid、AcidIsland、CaveBlock、Poseidon、StrangerRealms——以及更多!这些只是由 BentoBox 支持的基于岛屿的游戏模式之一。来自原版 ASkyBlock 的作者。
插件
专为 Velocity 打造的自制聊天插件,功能丰富——支持跨服群组/全局/私聊消息,并集成 LibertyBans 的禁言功能。
评论 0
登录后参与评分
还没有评论,来抢沙发吧