♟️ AstroWorld Chess Bot — Documentation

The most complete chess bot for Discord — matches, puzzles, ELO ranking, and deep social features.

🌐 Official Website · 💬 Discord · ☕ Support on Ko-fi

---

📖 About this repository

This repository (AstroWorld-docs) is the official documentation hub for the AstroWorld Chess Bot. It centralizes information about the bot's features, commands, and usage.

The bot's source code is not open source. For the full experience, guides, and to add the bot to your server, visit the official website.

✨ Features

• ♟️ 1v1 & 2v2 Matches — full chess games on Discord, with move history, board images, and internal ELO
• 🧩 Interactive Puzzles — solo puzzles, themed sets, sequences, and a daily community puzzle
• ⚔️ Puzzle Duels — real-time 1v1 speed duels
• 👤 Detailed Profiles — link your Lichess & Chess.com accounts with rating sync, badges, and stats
• 🏆 Rankings — leaderboards for rating, puzzle ELO, streaks, and duels
• 👪 Paternity System — beat rivals repeatedly to "adopt" them and climb the family tree (watch out for rebellions!)
• 🔎 Player Analysis — Scout profiles and compare head-to-head scores
• 🛡️ Ban Monitor — automatic detection and alerts when users link banned accounts
• 🎞️ Game GIFs — animated, shareable GIFs generated for played matches
• 💰 Economy & Shop — coins, board themes, and rewards, with vote integration
• 🎖️ Auto Roles — rating-based Discord roles assigned automatically
• 🌍 Multi-language — English, Portuguese, and Spanish

🎮 Commands Overview

ℹ️ Command names are localized: they automatically appear in the language of your Discord client. The names below are shown in English — a Portuguese client will see /xadrez, /perfil, etc.

Command	Description
/chess 1v1	Challenge another player to a full chess match
/2v2	Start a team consultation match (2 vs 2)
/puzzle	Solve tactical puzzles (random or themed)
/daily	View the daily community puzzle
/ranking	Server leaderboards (rating, streaks, duels)
/profile view	Show your player card
/verify	Link and verify your Lichess / Chess.com account
/paternity	Adopt, rebel, and explore the family tree
/economy shop	Browse and buy themes and items
/scout	Get a humorous analysis of a player's profile
/config ban_monitor	Configure banned-account detection (admin)

📋 See the full command list on the website.

---

Made with ♟️ by @marlonwq _{© 2025 AstroWorld Labs — All rights reserved.}