Zyvera TicTacToe

---

Overview

Zyvera-TicTacToe adds a complete TicTacToe minigame to your Minecraft server — fully inventory-based, with automatic matchmaking, direct challenges, persistent ranked stats, and crafting table binding. No dependencies, no setup hassle. Just drop and play.

---

Features

🎮 Game Modes

- Workbench Binding — Join the matchmaking queue and get paired automatically. Wins, losses, draws, streaks — everything is tracked. - Workbench Binding — Challenge any online player directly. No stats, just fun. - Workbench Binding — Bind TicTacToe to crafting tables in your world. Right-click toggles the queue (1s cooldown).

🖥️ GUI System

- Top 10 Leaderboard — Clean layout in a 36-slot inventory - Top 10 Leaderboard — Actual Minecraft skins displayed via SkullMeta - Top 10 Leaderboard — Winning line turns green at the end - Top 10 Leaderboard — Queue, stats, and leaderboard in one place - Top 10 Leaderboard — Wins, losses, draws, winrate, total moves, streaks - Top 10 Leaderboard — Gold, silver, bronze for the best players

⏱️ Timeout System

- Challenge (Unranked) → Game gets cancelled (no stats affected) - Challenge (Unranked) → Inactive player loses automatically - Challenge (Unranked) → Timeout has no effect

🔮 Holograms

Bound crafting tables display a floating hologram above them:

> TicTacToe > [Click Me]

---

Commands

| Command | Description | Permission | |---------|-------------|------------| | `/ttt` | Open main menu | `zyvera.ttt.use` | | `/ttt play` | Join the queue | `zyvera.ttt.use` | | `/ttt leave` | Leave the queue | `zyvera.ttt.use` | | `/ttt challenge <player>` | Challenge a player | `zyvera.ttt.use` | | `/ttt accept` | Accept a challenge | `zyvera.ttt.use` | | `/ttt deny` | Deny a challenge | `zyvera.ttt.use` | | `/ttt stats [name]` | View stats (GUI) | `zyvera.ttt.use` | | `/ttt top` | Top players (GUI) | `zyvera.ttt.use` | | `/ttt quit` | Leave active game | `zyvera.ttt.use` | | `/ttt bind` | Bind a crafting table | `zyvera.ttt.bind` | | `/ttt unbind` | Unbind a crafting table | `zyvera.ttt.bind` | | `/ttt reload` | Reload config | `zyvera.ttt.admin` |

Alias: `/tictactoe`

---

Permissions

| Permission | Description | Default | |-----------|-------------|---------| | `zyvera.ttt.use` | Basic TicTacToe access | everyone | | `zyvera.ttt.bind` | Bind/unbind workbenches | OP | | `zyvera.ttt.stats.others` | View other players' stats | everyone | | `zyvera.ttt.admin` | Admin commands (reload) | OP |

---

Compatibility

| Platform | Supported | |----------|-----------| | Bukkit | ✅ 1.13+ | | Spigot | ✅ 1.13+ | | Paper | ✅ 1.13+ | | Purpur | ✅ 1.13+ | | Folia | ✅ Regionized Scheduler |

- Dependencies: 8+ - Dependencies: None - Material fallbacks ensure compatibility across all versions (e.g. `RED_CONCRETE` → `STAINED_CLAY` on legacy) - Folia support is fully reflection-based — no compile-time dependency

---

Configuration

Everything is customizable — messages, colors, materials, timeouts, and hologram text.

```yaml prefix: "&8[&6&lTTT&8] "

game: turn-timeout: 120 challenge-timeout: 60 workbench-cooldown: 1000

gui: symbol-x-material: RED_CONCRETE symbol-o-material: BLUE_CONCRETE

hologram: line1: "&6&lTicTacToe" line2: "&8[&aKlick Mich&8]" offset-y: 1.5 ```

---

Installation

1. Drop the JAR into your `plugins/` folder 2. Start or restart the server 3. Config generates automatically 4. Done — `/ttt` and play!

---