Bear Tracking

🐻 Bear Tracking

Bear Tracking turns your in-game bear hunt result screenshots into stored damage records, leaderboards, and charts automatically. An admin (or anyone you allow) drops the screenshots into a channel, the bot reads them, you give the results a quick check, and the bot saves everything and draws the charts.

You don't need to track damage numbers by hand anymore, and you don't need to be technical to set it up. This page will walk you through it.

---

🧭 Where to find it

Run /settings in your Discord server and open Bear Tracking. You'll see three buttons:

• 🐻 Bear Damage - view charts, leaderboards, and past hunts.
• 📋 Bear Channel Setup - the one-time setup (which channel, which language, etc.).
• ⚙️ Settings - configuration options (timeouts, who's allowed, auto-cleanup).

Setting the channel is the one required step - everything else has a sensible default.

---

🛠️ Setting it up (one time per alliance)

Open Bear Channel Setup and pick the alliance you're configuring from the dropdown. Then work through the buttons:

1. 📢 Change Channel (required) Pick the channel where people will post bear result screenshots - for example #bear-scores. This is the only setting you must do. One channel belongs to one alliance; the bot will warn you if a channel is already used by another alliance or feature.

2. 🌐 Character Recognition (optional) Tells the bot which alphabet your members' names mostly use so it can read them. The default is Latin (English, French, German, Spanish, etc.), which is fastest. If your alliance uses Cyrillic (Russian), Arabic, Japanese, Korean, Chinese, or other scripts, pick the matching option. The bot also retries unreadable names with other alphabets on its own, so you usually only need to set your main one.

3. 📝 Keywords (optional) Words that must appear in the message for the bot to process its screenshots. Leave this blank (the default) and the bot processes every image posted in the channel. Only set keywords if people also post unrelated images in the same channel and you want to avoid false reads.

4. 📊 Damage Range (optional) How many days of history the summary chart shows after each hunt. 0 means all history (the default). Set it to e.g. 30 if you only want the last month on the auto-posted chart.

The setup screen always shows a Current Setup summary so you can confirm the channel, keywords, range, and language at a glance.

⚙️ Optional Settings

Back on the Bear Tracking menu, Settings holds the configuration knobs (all optional, per-alliance):

Setting	What it does
⏳ Session Timeout	How long the bot waits for more screenshots before it finalizes a hunt (1-60 minutes).
🗑️ Auto-Delete	Deletes the uploaded screenshots after the hunt is saved, keeping the channel tidy.
🔒 Add Permission	Who may upload hunts - admins only or everyone in the channel.
👁️ View Permission	Who may view the saved charts and leaderboards.
📜 Name History Match	Also match players by their past names, not just their current one. (Current and event-day names are always matched.)
📄 Info Message / Pin	Posts (and optionally pins) a helper message in the channel explaining what to upload.

---

⚙️ How it works behind the scenes

When screenshots land in the channel, the bot runs through these steps. You don't have to do anything for steps 1-6 - they're automatic.

1. Capture. Someone posts the in-game bear result screenshots in the bear score channel. The bot reads every image attached.

2. Read the text (OCR). The bot scans each image and pulls out the rows of text - player names, damage numbers, and ranks. It starts with the alphabet you chose (e.g. Latin) and, if some rows come out unreadable, automatically retries with other alphabets (Cyrillic, Arabic, Korean, etc.). The reading engines load only when needed, to keep memory use low.

3. Clean up the numbers. OCR often confuses letters and digits (O↔0, l↔1) and drops the thousands separators. The bot repairs damage figures so the totals come out correct.

4. Match names to your roster. Each name the bot read is compared against your alliance's member list (and, optionally, members' past names) to find who it belongs to. Before comparing, the bot "de-decorates" fancy names - converting stylized Greek/Cyrillic lookalike letters back to their normal Latin equivalents - so a name like ĎƐΔΗ is recognized as DEAH.

5. Grade each match. Every row is tagged so you can see how sure the bot is:

   Mark	Meaning
   ✅ auto	Confident - filled in automatically.
   🟡 likely	Probably right - shown for a quick confirm.
   ⚠️ ambiguous	Two close candidates - needs your pick.
   ❌ none	No match found - needs you to identify the player.
   ✏️ manual	You filled this one in yourself.

6. Use what it has learned. If a name still can't be matched confidently, the bot checks its memory of names you've resolved before. A decorated name that OCR can never read cleanly only needs to be identified by you once - after that, the bot recognizes the same garbled text next time and fills it in automatically. (A confident direct match always wins over this memory, so it can't mismatch a clearly-read name.)

7. Review and confirm. You see the rows with their match marks and fix any that need it (see below).

8. Save and chart. Confirmed rows are stored against that bear hunt, and the bot generates the damage charts and leaderboards.

---

🙋 Using it day to day

Uploading a hunt

1. Post all the bear result screenshots for one hunt in the bear channel. Upload them around the same time - the bot waits a short while (your Session Timeout) to collect everything before it finalizes.
2. The bot reads them and posts a review message.

The review screen

The review shows every row with its match mark. Use the controls to fix anything that isn't right:

• Edit a row… (dropdown) - correct a misread name or damage by typing the player's name or ID, or pick between the bot's suggestions for an ⚠️ ambiguous row.
• ➕ Add Player - add a row the OCR missed, or look up a brand-new player by ID and add them to the alliance on the spot.
• 📝 Edit Hunt - fix the hunt's details (date, trap, etc.).
• 🌐 Retry OCR - re-read the screenshots with a different alphabet if a batch of names came out garbled.
• ✅ Submit - save the hunt. The bot stores the rows and posts the charts.
• ❌ Cancel - discard this read without saving.

💡 Every correction is remembered. The next time the same garbled name shows up, the bot fills it in for you.

Viewing results

From Bear Damage you can:

• See the damage chart for an alliance over your chosen time range.
• Open the Top Players leaderboard, ranked by total damage, number of hunts, or average damage.
• Browse individual Hunts to review or fix a past hunt and its players.

---

❓ Tips & troubleshooting

"The bot isn't reacting to my screenshots."

• Check that Bear Channel Setup → Change Channel points at the channel you're posting in, and that you're posting an image (not a link). If you set Keywords, your message must contain one of them.

"Lots of names came out wrong."

• Make sure Character Recognition matches the alphabet your members use, then use Retry OCR on the review screen to re-read with a different one. Clearer, full-size screenshots (with the in-game header visible) read best.

"Damage numbers look off."

• The bot repairs most OCR digit slips automatically, but you can always correct any row by hand on the review screen before you submit.

"Someone isn't in our roster yet."

• Use ➕ Add Player on the review screen to look them up by ID and add them to the alliance without leaving the review.

---

See also: Attendance OCR for recording event participation from screenshots.