Zyvera TicTacToe

<div align="center"> # ⚔ Zyvera-TicTacToe ### Classic TicTacToe as a fully GUI-based Lobby Minigame. !(https://img.shields.io/badge/Minecraft-1.13--1.21+-brightgreen?style=flat-square) !(https://img.shields.io/badge/Platform-Bukkit%20%7C%20Spigot%20%7C%20Paper%20%7C%20Purpur%20%7C%20Folia-blue?style=flat-square) !(https://img.shields.io/badge/Version-1.0-orange?style=flat-square) !(https://img.shields.io/badge/Java-8+-red?style=flat-square) !(https://img.shields.io/badge/Dependencies-None-green?style=flat-square) **by Thomas U. & Zyvera-Systems** </div> --- ## 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** > --- ## 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 ` | 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. ```yaml prefix: "&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" 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! --- <div align="center"> **Made with ❤️ by Thomas U. & Zyvera-Systems** ⭐ *Enjoying TicTacToe? Leave a review!* </div>