---

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

• Queue (Ranked) — Join the matchmaking queue and get paired automatically. Wins, losses, draws, streaks — everything is tracked.
• Challenge (Unranked) — 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

• Compact 3×3 Board — Clean layout in a 36-slot inventory
• Real Player Heads — Actual Minecraft skins displayed via SkullMeta
• Win Highlight — Winning line turns green at the end
• Main Menu — Queue, stats, and leaderboard in one place
• Stats GUI — Wins, losses, draws, winrate, total moves, streaks
• Top 10 Leaderboard — Gold, silver, bronze for the best players

⏱️ Timeout System

• No moves placed + 120s idle → Game gets cancelled (no stats affected)
• Ranked + moves placed + 120s idle → 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

• Java: 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.

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!

---