⚔️ BDO Battle Buddy — The Ultimate Black Desert Online Guild Management Bot

Your all-in-one guild operations hub. Node War events, gear tracking, boss timers, grind analytics, recruitment — all from Discord.

---

🚀 Why BDO Battle Buddy?

Managing a BDO guild shouldn't feel like a second job. BDO Battle Buddy automates the tedious stuff so you can focus on PvP. With 65 slash commands, 8 interactive dashboards, and deep integrations with Garmoth, BDOLytics, and the Central Market API — it's the most complete guild management solution for Black Desert Online.

✅ Built for Real Guilds

• Trusted by active Node War & Siege guilds
• Handles 100+ member rosters with ease
• Works across NA, EU, SEA, JP, KR regions
• Supports PC, Console, and Mobile platforms

---

📋 Feature Overview

⚔️ Node War Event Management

The core of every competitive guild. Create, manage, and track attendance for Node War events with a streamlined system.

• 📅 Multi-day event creation — Create events for one or more days with a single command
• ✅ One-click signups — Members tap Can / Maybe / Can't directly on the event embed
• 🎯 NW Role sorting — Tanks, Ranged, Ball groups automatically organized in the signup list
• 📊 Tier-based caps — Set participant limits per tier (T1/T2/T3) and per day group
• 🔔 Waitlist system — When events fill up, extras go on a waitlist and get promoted automatically
• 📢 NW Alerts — DM blast to all signed-up members with custom messages
• 🕐 Auto-scheduling — Daily reminders at noon, auto-close at 9 PM, weekly archive on Saturday
• 📜 Detailed attendance tracking — See who showed up, who flaked, and who's most reliable

📊 Analytics & Attendance Reports

Five built-in analytics reports to keep your roster sharp:

• 📈 Top 20 Highest Attendance — Your most reliable members
• 📉 Top 20 Lowest Attendance — Members who need a nudge
• ❔ Top 20 Most Undecided — Chronic "Maybe" responders
• 🚫 No-Show Analysis — Members who said "Can" but didn't show
• 📋 Full Roster Overview — Complete paginated member list with stats

---

🔗 Garmoth Integration

Link your guild's Garmoth API key and let the bot keep gear scores up to date — automatically.

• 🔑 One-time API key setup for the entire guild
• 🔗 Members link their Garmoth character profile
• ⚡ Auto gear sync — AP, AAP, DP pulled from Garmoth on demand
• 📊 Force-sync all linked members at once
• 🖼️ Members can also upload gear screenshots

---

🕐 Boss Timer & Notifications

Never miss a world boss again. Smart notifications across all BDO regions.

• 🌎 4 Region support — NA, EU, EU Summer, Asia
• 🔔 3-tier alerts — Notified at 60 min, 15 min, and 5 min before spawn
• 📺 Interactive dashboard — See all upcoming bosses at a glance
• ⚙️ Per-region channels & roles — Each region gets its own notification setup
• ✨ Auto-create roles — Bot can create Boss NA, Boss EU, etc. roles for you
• 📡 Real-time schedule — Powered by Garmoth API boss data

---

🎮 Grind Tracker & Silver Analytics

Track your grind sessions and compare results with guildmates.

• ▶️ Session tracking — Start, grind, end — the bot records everything
• 🗺️ 100+ grindspots — Organized by 6 AP tiers (sub-200 to 310+)
• 💰 Silver/hour calculations — Real-time pricing from Central Market API
• 📊 Guild leaderboards — See who's grinding the hardest
• 🏆 Grindspot analytics — Guild averages, personal bests, top drops per location
• 🔑 Market API integration — Link your Central Market cookie for live prices
• 🔄 Auto-refreshing data — Grindspot database powered by BDOLytics API

---

🔍 Recruitment System

A complete recruitment pipeline built into Discord — from application to full member.

For Officers:

• 📝 Application review — Accept, decline, or start a trial period
• 👤 Free Agent browser — Search by class, sort by GS or attendance
• 📨 Recruitment DMs — Message free agents directly (spam-protected: 1 DM per guild)
• 🧪 Trial management — 14-day trials with auto-reminders before expiration
• 📊 Recruitment stats & history — Track your pipeline

For Prospects:

• 📝 One-click applications — Fill out a form and submit directly in Discord
• 🎭 Auto-role assignment — Prospect role given automatically on application
• 📊 Status tracking — Check your application status anytime
• 🆓 Free Agent registration — List yourself for guilds to find you

---

🛡️ 8 Interactive Dashboards

Persistent button-based dashboards that live in your channels. No commands to memorize — just click.

Dashboard	For	Buttons
⚙️ Setup Dashboard	Admins	Roles, channels, Garmoth key, region, NW roles
⚔️ Officer Dashboard	Officers	Events, roster, alerts, recruitment, no-shows
👥 Member Dashboard	Members	Register, gear, Garmoth link, stats
📊 Admin Dashboard	Admins	Analytics & archived events
🕐 Boss Timer Dashboard	Everyone	Boss schedule, region subscriptions
🎮 Grind Dashboard	Everyone	Start/end sessions, leaderboard, spot info
🔍 Prospect Dashboard	Prospects	Apply, check status, free agent signup
👔 Recruitment Dashboard	Officers	Review apps, browse agents, stats

---

🏁 5-Minute Setup

Getting started is fast:

1. /setup          — 5-step guided wizard (roles, channels, region)
2. /post_dashboard — Posts all dashboards to your channels
3. /boss_dashboard — Boss timer with notifications
4. Done! Members /register and officers /nwcreate

The setup wizard walks you through everything:

• Step 1 — Assign Member, Officer, Admin, Prospect roles
• Step 2 — Set channels manually or auto-create a full Nodewar category
• Step 3 — Enter your Garmoth API key (optional)
• Step 4 — Set your region (NA/EU/SEA) and platform (PC/Console)
• Step 5 — Review and confirm

---

📜 65 Slash Commands

Member Commands (20): /register /update /update_class /profile /upload_gear /link_garmoth /sync_garmoth /unlink_garmoth /help /can /unsign /boss_next /free_agent /free_agent_remove /my_free_agent_status /grind_start /grind_end /grind_link /grind_history /grind_cancel

Officer Commands (25): /nwcreate /nwedit /viewevents /delevents /delete_all_events /event_close /event_info /event_reconnect /event_list_all /event_close_by_id /event_fix_message /event_reopen /set_tlimit /nw_alert /set_role /guild_list /remove_member /check_blocked /set_bot_roleassign /browse_free_agents /dm_free_agent /recruitment_review /recruitment_history /trial_promote /trial_extend

Admin Commands (20): /setup /post_dashboard /post_setup_dashboard /post_admin_dashboard /set_channels /view_channels /set_garmoth_key /check_garmoth_key /test_garmoth_api /force_sync /serverinfo /boss_dashboard /grind_dashboard /grind_refresh /grind_region /recruitment_system_check /mock_data /mock_recruitment /clear_mock_data

Context Menu: Right-click any user → Set Nodewar Role

---

🎭 31 BDO Classes Supported

Warrior • Ranger • Sorceress • Berserker • Tamer • Musa • Maehwa • Valkyrie • Kunoichi • Ninja • Wizard • Witch • Dark Knight • Striker • Mystic • Lahn • Archer • Shai • Guardian • Hashashin • Nova • Sage • Corsair • Drakania • Woosa • Maegu • Scholar • Dosa • Deadeye • Igneous • Wukong

---

🔒 Permission System

Role-based access keeps everything organized:

• 🛡️ Admin — Full configuration, analytics, dashboards
• ⚔️ Officer — Events, roster, recruitment, alerts
• 👥 Member — Registration, signups, gear, grind, boss alerts
• 🔍 Prospect — Applications, free agent registration

---

🌐 Multi-Region Support

Region	Boss Timers	Grind Data	Recruitment
🌎 North America	✅	✅	✅
🌍 Europe	✅	✅	✅
☀️ Europe (Summer)	✅	✅	✅
🌏 Asia (SEA/JP/KR)	✅	✅	✅

---

⚡ Automated Background Tasks

The bot works even when you're sleeping:

• 🕐 12:00 PM — Daily NW reminders in event channels
• 🌙 9:00 PM — Auto-close today's events
• 📦 Saturday 10 PM — Archive the week's events
• 🔔 Boss notifications — 60 / 15 / 5 minute alerts, 24/7
• 🔄 Grind data refresh — Periodic BDOLytics sync
• 🧪 Trial expiration — 2-day warning before trials end
• 💾 Database maintenance — SQLite WAL mode for reliability

---

🗄️ What Gets Tracked

26 database tables power the bot:

• Members & Profiles — Family name, class, gear, level, Garmoth link
• Events & Signups — Full event lifecycle with attendance history
• NW Roles — Custom roles with party caps and grouping
• Boss Schedules — Per-region notification preferences
• Grind Sessions — Location, duration, drops, silver/hr
• Recruitment — Applications, trials, blacklist, free agents
• Guild Settings — Roles, channels, API keys, region, platform

---

💬 Support & Links

• Need help? Use /help or click ❓ on any dashboard
• Found a bug? Join our support server
• Feature request? We're always improving

---

BDO Battle Buddy — Stop managing spreadsheets. Start winning wars. ⚔️