Chess

Chess gives you a live, clickable 8x8 board. Challenge another player, choose a clock, and play a complete match without a physical board. On Paper and Folia it uses the native dialog system; on Spigot it draws the same game as an inventory board.

Highlights

• Native dialog board: 64 individually clickable squares in a clean, live interface.
• Spigot fallback: no Dialog API, no problem — the board is drawn from inventories instead, selected automatically.
• 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: Spigot, Paper or Folia on 1.21.11
• Optional: ResourcePackManager

Note: Chess runs on Spigot, Paper and Folia. On Paper and Folia it uses the native Dialog API; on Spigot it automatically falls back to the inventory board, which needs no Paper API at all. The inventory board covers core chess — premoves, spectating and focus mode are dialog-board features.

The chess engine and board pack are included in Chess.jar; ResourcePackManager is not required.

Getting started

1. Put Chess.jar in the server's plugins folder and restart.
2. With ResourcePackManager installed, Chess registers its pack automatically.
3. Without ResourcePackManager, host plugins/Chess/resourcepack.zip and set the public URL at resource-pack.url in plugins/Chess/settings.yml.
4. 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

• /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

• GitHub repository
• Issue tracker
• Discord community