Whether the current project contains any paid features, is paid only, or is 100% free to use.

This project is free to use and contains no paywalls for core functionality.

Has Paid Features

# ⚔️ 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.* ⚔️

BDOBattleBuddy

Complete Node War Management and Recruitment Center for BDO Guilds

The Salty Recluse

BDO Nodewar Manager, Grind Tracking, Global Recruitment Center

Votando em BDOBattleBuddy

Quer nos ajudar?