Guild Pro Bot

📖 About Guild Pro Bot

Guild Pro Bot is a Discord bot for managing strategy game guilds. It handles member verification, activity tracking, Excel-powered player statistics, growth tracking, alerts, migration applications, and more — all configurable from a web dashboard.

Every guild gets its own independent configuration and data. Supports both prefix commands (&) and slash commands.

✨ Features

🚀 Getting Started

1. Invite the Bot

Invite Guild Pro Bot to your Discord server. Grant at minimum: Manage Roles, Send Messages, Embed Links, Attach Files, Read Message History, Add Reactions — or simply Administrator.

2. Create Required Roles

• Unverified Role — assigned to new members automatically (via autorole/reaction role). Members with this role can't access guild channels until verified.
• Verified Role — assigned by the bot after successful verification (e.g. @Member, @Verified, @Guild).
• Admin / Officer Role — grants access to bot admin commands and the web dashboard.

3. Run &setup or Use the Dashboard

Use the interactive &setup command in Discord — it opens a wizard with two sections:

• Core Setup — assign Admin role, Verified role, Unverified role, bind channel, log channel, activity channel, migration channel, and toggle modules.
• Stats Setup — configure the weekly leaderboard channel and alerts channel/thresholds.

Alternatively, configure everything from the Configuration tab on the web dashboard at guildprobot.com/guild/.

4. Verify Members

Members run &bind <player_id> in the bind channel and upload a screenshot of their in-game profile. Officers see a pending embed with ✅ Approve / ❌ Reject buttons. On approval:

• Unverified role is removed
• Verified role is assigned
• Verification is logged in the log channel
• Member receives a DM confirmation

5. Upload Player Data

In the game, go to Game Tools → Realm Members → Export Settings and select: Current Power, Historical Highest Power, Total Merits, Alliance Donations, Build Time, Alliance Help. Export and upload the .xlsx file in the Player Data tab of the dashboard.

6. Set Up Migration

• Enable the Migration module in Configuration and set a Migration Channel
• In the Migration tab, set a custom URL slug (e.g. elite-warriors)
• Share the generated apply URL with applicants: guildprobot.com/apply/your-slug
• Applicants sign in with Discord, fill their stats, and submit
• Officers get an embed in the migration channel with Approve/Reject buttons and an optional note field
• Applicants receive a DM with the decision

⚙️ Configuration

Web Dashboard

Login at guildprobot.com/login with Discord OAuth. You must have the Admin role in the server to access guild settings.

Role System

• Admin Role — full access to bot commands and dashboard
• Officer Role — can approve/reject verifications, manage notes and migration; subset of admin
• Verified Role — assigned after successful &bind + approval
• Unverified Role — assigned to new members; removed on verification

Channels

• Bind Channel — restricts &bind to a specific channel (optional)
• Log Channel — all bot events: approvals, rejections, unbinds
• Activity Channel — inactivity reports
• Migration Channel — officer review embeds for the apply page
• Weekly Channel — auto-posted weekly leaderboard
• Alerts Channel — auto-posted power drop / donation alerts

Modules

• Verification — core, always on
• Activity Tracking — Discord message streak monitoring
• Admin Notes — officer notes on members
• Migration — public apply page for new applicants

📋 Player Data & Statistics

Upload .xlsx exports from the game and the bot tracks every player's stats over time, enabling growth charts, leaderboards, and alerts.

How to Export from the Game

Go to Game Tools → Realm Members → Export Settings and select these columns before confirming:

• Current Power
• Historical Highest Power
• Total Merits
• Alliance Donations
• Build Time
• Alliance Help

Missing columns are reported as warnings after upload — the file will still import with available data.

Upload & Coverage

All players from the file are imported. Verified (bound) players get full Discord-linked features. Unverified players appear on the dashboard with a ⚠️ badge and are excluded from Discord commands. Once they run &bind and get approved, they automatically gain access to all stats commands.

Guild Insights (Dashboard)

• Sparkline charts under each total showing the trend across snapshots
• Total Power / Merits / Donations with delta vs. selected period start
• 🏆 Top Gainers — ranked players with progress bars, selectable stat and period
• 📥 Export CSV — download the latest full snapshot

Alerts

The bot compares the latest snapshot against N days ago. Players are flagged if:

• Power dropped more than the configured % threshold (default: 5%)
• Zero donations recorded in the period

The check runs every 24 hours and only posts when there's something to report. Configure with &setalerts and &setalertschannel.

💬 Commands

All commands support both the & prefix and / slash commands. Use &help in Discord for the interactive help menu with category buttons.

🔓 General (Everyone)

• &help [command] — Interactive help menu. Add a command name for detailed info.
• &bind <player_id> — Start verification: link your Discord to your in-game Player ID and upload a screenshot.
• &myid [player_id] — View your own verification status. Admins can pass another user's ID to check theirs.
• &info — Show bot version, guild tier, and quick stats.

🔒 Verification Management (Admin)

• &pending — List all pending verification requests awaiting approval.
• &unbind [@user | player_id] — Remove a member's verified bind (Members Management + Admin).
• &bindchannel set #channel — Restrict &bind to a specific channel.
• &bindchannel clear — Allow &bind in any channel.
• &bindchannel status — Show current bind channel setting.
• &setup — Open the interactive setup wizard (Core + Stats sections).
• &stats — Server-wide verification statistics dashboard.

🔒 Activity Tracking (Admin)

• &activity — Show current activity module status.
• &activity setchannel #channel — Set the channel for activity reports.
• &activity setinterval <hours> — Set how often the activity check runs.
• &activity setdm on|off — Toggle DM notifications to inactive members.
• &activity run — Run the activity check immediately.
• &activity streaks [limit] — Show top activity streaks leaderboard.

🔒 Admin Notes (Members Management)

• &note add @user <text> — Add a private note to a member.
• &note list @user — View all notes for a member.
• &note delete <note_id> — Delete a note by its ID.

📊 Player Statistics (Everyone — verified players)

• &playerstats [@member | player_id] — Full stats embed: power, merits, donations, growth delta, rank.
• &profile [@member | player_id] — Comprehensive profile card with rank, verified status, and growth.
• &history [@member | player_id] [limit] — Snapshot history list (default 5, max 20).
• &growth [@member | player_id] [days] — Interactive growth chart with buttons: 7d / 30d / 90d / All, toggle power/merits. Generates a Matplotlib chart.
• &compare <player1> <player2> — Side-by-side stat comparison with 🏆 winner per category.
• &leaderboard [stat] [limit] — Guild leaderboard. Stats: power, merits, donations, buildtime, help. Aliases: &lb, &top.
• &alliance — Guild-wide aggregated totals. Alias: &guild_stats.
• &summary — Upload overview: total snapshots, last upload date, player count.

🔒 Weekly Leaderboard (Admin)

• &weekly — Post the weekly multi-category leaderboard immediately. Alias: &weeklyleaderboard.
• &setweeklychannel #channel — Set channel for automatic weekly leaderboard (auto-posts every 7 days).

🔒 Alerts (Admin)

• &setalertschannel #channel — Set the channel for automatic power/donation alerts.
• &setalerts [power_drop_pct] [check_days] — Configure thresholds (defaults: 5% drop, 7-day window).
• &alerts — Run the alert check now and preview results.

🔒 Migration (Members Management)

• &migration — Show migration module status and current apply URL.
• &migration list [status] — List applications by status: all, pending, posted, approved, rejected.
• &migration view <id> — View full details of a specific application.

🔓 Events (Everyone)

• &event — Show all event commands and their usage.

🔒 Events Management (Admin / Officer)

• /event-create — Create a new event via a modal: enter title, description, date, time, and an optional image URL. Posted as a Discord embed with a sign-up button.
• /event-edit <event_id> — Edit an existing event that has not yet started or been cancelled.
• /event-list [status] — List events. Defaults to upcoming (ACTIVE / REMINDED). Optional status filter: ACTIVE, REMINDED, STARTED, CANCELLED.
• /event-cancel <event_id> — Cancel a scheduled event.
• Events automatically send a 30-minute reminder and a start notification to the event channel via Discord embeds with sign-up buttons.

🔒 Diplomacy (Officer+)

• &diplomacy list — List all alliances and their current status.
• &diplomacy add <name> [status] — Add a new alliance. Status options: allied, friendly, neutral, nap, hostile, war (default: neutral).
• &diplomacy set <alliance_id> <status> — Update the status of an existing alliance.
• &diplomacy delete <alliance_id> — Remove an alliance record.
• &treaty add <alliance_id> <type> <terms> — Attach a treaty to an alliance. Types: Peace Treaty, Non-Aggression Pact, Trade Agreement, Military Alliance, Defense Pact, Custom.
• &treaty list [alliance_id] — List all treaties, optionally filtered to a specific alliance.
• Alliances and treaties are also fully manageable from the Diplomacy section of the web dashboard.

❓ FAQ