/upload Command
Upload a Black Desert Online gear screenshot. CoGM uses OCR (optical character recognition) to extract all 8 stats automatically.
What it does
When you run /upload with a gear screenshot, CoGM:
- 1.Reads your BDO gear window from the image
- 2.Extracts all 8 stats (AP, AAP/Talent, DP, Gear Score, Accuracy, Evasion, DR, TP)
- 3.Creates or updates your gear profile on CoGM
- 4.Posts confirmation in the channel and notifies officers
Command syntax
Parameters
filerequired
Image attachment
Your BDO gear screenshot. Must be a clear, unmodified screenshot of your gear window.
family_name
Text
Your in-game family name. Example: Krazor, Mythril, Foxfire. Leave it blank to keep the name already on file. On a first BDO upload the bot asks for it instead. Family names are region-scoped, so this uniquely identifies your account on your server.
class
Text (autocomplete)
BDO only. Your character's class from the dropdown: Warrior, Witch, Valkyrie, Striker, Ninja, Sage, Musa, Shai, Deadeye, Dosa, Savior, Wukong, and others. Leave it blank to keep the class already on file.
spec
Choice
BDO only. Awakening or Succession. Skip it for Shai, which has no split, or to keep the spec already on file.
target
User mention
Officer-only. Upload gear for another member. Example: /upload ... target:@Tempest
- Screenshots with UI overlays or tooltips
- Blurry or compressed images
- Non-English game clients (CoGM currently supports NA/EU/SEA English)
- Custom UI mods that hide or rearrange stats
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
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.
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
CoGM processes your screenshot
The bot runs OCR on your image. This takes 2-5 seconds. You'll see a processing indicator in Discord.
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.
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.
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.
"I could not match that to a BDO class"
Pick your class from the autocomplete dropdown instead of typing it. Common short forms like "zerk" or "succ ranger" are accepted, but "Unknown" is not. If your class is missing from the list, contact support.
target was ignored
Only officers can upload gear for another member. For everyone else the target is dropped and the gear is saved to their own profile. Ask an officer to run it on your behalf.
"You are not on this community's roster yet"
/upload saves gear against a roster row, and it does not create one. Ask an officer for the guild's Discord member role in the server, or to add you in the dashboard, then run it again.