BDO

/upload Command

Upload a Black Desert Online gear screenshot. CoGM uses OCR (optical character recognition) to extract all 8 stats automatically.

**Class:** `Warrior` **Guild:** `Vanguard (Iron Pact)`**Attack (AP):** `312` ⚔️ **Awakening (AP):** `314` 🌀 **Defense (DP):** `401` 🛡️ **Gear Score:** `713` (#4) 📊 ▰▰▰▱▱▱▱▱▱▱**Accuracy:** `847` 🎯 **Evasion:** `709` 💨 **DR:** `421` 🔰2 hours agoCoGM

What it does

When you run /upload with a gear screenshot, CoGM:

  1. 1.Reads your BDO gear window from the image
  2. 2.Extracts all 8 stats (AP, AAP/Talent, DP, Gear Score, Accuracy, Evasion, DR, TP)
  3. 3.Creates or updates your gear profile on CoGM
  4. 4.Posts confirmation in the channel and notifies officers

Command syntax

/upload file:<screenshot> family_name:<name> class:<class> [target:<user>]

Parameters

filerequired

Image attachment

Your BDO gear screenshot. Must be a clear, unmodified screenshot of your gear window.

family_namerequired

Text

Your in-game family name. Example: Krazor, Mythril, Foxfire. Note: family names are region-scoped, so this uniquely identifies your account on your server.

classrequired

Text (autocomplete)

Your character's class from the dropdown: Warrior, Witch, Valkyrie, Striker, Ninja, Sage, Musa, Shai, Deadeye, Dosa, Savior, Wukong, Unknown, and others.

target

User mention

Officer-only. Upload gear for another member. Example: /upload ... target:@Tempest

What gets extracted

CoGM extracts these stats from your gear screenshot:

AP

Attack Power

AAP/Talent

Absolute AP or Talent stat

DP

Defense Power

Gear Score

Overall gear level (sum of enchantments)

Accuracy

Hit rate bonus %

Evasion

Dodge rate bonus %

DR

Damage Reduction %

TP

Transcendence Power

Step-by-step example

1

Take a gear screenshot in BDO

Open your gear window in Black Desert Online. Make sure all stats are visible and clear. Don't have tooltips or other UI overlays in the way.

2

Run the /upload command

In Discord, type /upload and the command autocomplete will guide you through.

Example: /upload file:gear.png family_name:Mythril class:Witch

3

CoGM processes your screenshot

The bot runs OCR on your image. This takes 2-5 seconds. You'll see a processing indicator in Discord.

4

Review extracted stats

CoGM posts a confirmation with the extracted stats. Review them for accuracy. If a stat is wrong, an officer can use /edit to manually correct it.

The confirmation includes: AP, DP, Gear Score, Accuracy, Evasion, DR, TP, and a timestamp.

Officers can upload gear for other members using the target parameter. Useful for bulk gear collection or when members aren't available.

Rate limits

Rate limits apply per community, not per individual member.

Free tier

30 uploads per week per community. 40 OCR extractions per week per community.

Pro tier

Unlimited uploads and OCR extractions.

If you hit the rate limit, wait until the weekly reset (Monday 00:00 UTC) or upgrade to Pro.

Troubleshooting

OCR failed or returned wrong stats

Make sure your screenshot is clear and not zoomed in. Try taking a fresh screenshot without UI overlays. Officers can manually correct stats with /edit.

"Invalid family name"

Check that you're using your actual in-game family name, not your character name. Family names are shown in the top-right of the BDO gear window.

"Class not found"

Select your class from the autocomplete dropdown. If your class isn't listed, contact support or use "Unknown" and an officer will update it manually.

Permission denied for target

Only officers can upload gear for other members. If you're not an officer, ask one to use the target parameter on your behalf.