Setting Up the Tracker
The Total Battle Chests Tracker automatically captures every chest from your clan – both normal chests from activities and Triumphal Chests (Wooden, Bronze, Silver, Gold, Precious, Magic) from in-game purchases. It runs 24/7 on our secure servers, recording each chest with player attribution and source details.
How the Total Battle Chests Tracker Works
The tracker operates like a dedicated clan member who never sleeps – it logs in to Total Battle, navigates to your clan chests, clicks "Help All," and captures all chest data including player names, sources, and timestamps.
Prerequisites for Tracker Setup
Before configuring:
| Requirement | Details |
|---|---|
| Total Battle account | Any account that can view clan chests |
| Email login | The email you use to log in to Total Battle |
| Password | Your Total Battle password |
| Clan membership | Account must be in your clan |
Dedicated Tracker Account (Strongly Recommended)
Create a new Total Battle account specifically for tracking:
| Benefit | Why It Matters |
|---|---|
| Never get logged out | Tracker has its own sessions |
| Security isolation | Main account credentials not stored |
| No interference | Play your main account normally |
| Minimal permissions | Tracker account needs zero leadership roles |
Setup steps:
- Create new email (e.g., tracker-yourclan@gmail.com)
- Register new Total Battle account
- Join your clan as Soldier (lowest rank)
- Use these credentials in TB Clan Tools
Pro Tip: A Soldier-rank tracker account can still see and open all clan chests. No Superior or Officer permissions needed.
Configuring the Tracker
Step-by-Step Setup
- Navigate to Settings → Tracker
- Enter your Total Battle Email
- Enter your Total Battle Password
- Click Test Connection
- Wait for verification (1-2 minutes)
- If successful: Click Save Credentials
- Toggle Enable Tracker to ON
- Select your Scan Cadence
- Click Save Settings
Test Connection Results
| Result | Meaning | Action |
|---|---|---|
| ✅ Connection Successful | Credentials valid, clan accessible | Proceed to save |
| ❌ Invalid Credentials | Email or password wrong | Verify and re-enter |
| ❌ Account Locked | Too many failed login attempts | Wait 30 min or reset in-game |
| ❌ Maintenance Mode | Game servers down | Try again later |
| ❌ Network Error | System issue | Contact support |
Always test before saving. A failed test means the tracker won't work even if you save.
Scan Frequency (Cadence) Options
Choose how often the tracker checks for new chests:
| Frequency | Chests/Day Capacity | Best For | Your Account Impact |
|---|---|---|---|
| Every 15 minutes | ~96 scans | Event weeks, very active clans | High (frequent logins) |
| Every 30 minutes | ~48 scans | Active competitive clans | Medium |
| Every hour | 24 scans | Standard tracking | Low |
| Every 2 hours | 12 scans | Casual clans | Minimal |
| Every 3-5 hours | 5-8 scans | Shared account users | Very low |
Frequency Strategy
| Situation | Recommended Cadence |
|---|---|
| Normal weeks | Every hour |
| Rise of Ancients active | Every 15-30 minutes |
| Ragnarok event | Every 30 minutes |
| Vacation/quiet period | Every 2-5 hours |
| Testing new setup | Every 30 minutes (verify working) |
If you play on the same account: Longer intervals = fewer times you get logged out. Consider the dedicated tracker account to avoid this entirely.
Monitoring Tracker Status
Dashboard Header Indicators
The dashboard header shows real-time tracker status:
| Indicator | What It Shows |
|---|---|
| Last Scan | When the most recent scan completed |
| Next Scan | When the next scan is scheduled |
| Status Badge | Running (blue), Idle (gray), Error (red) |
Tracker Status Page
Navigate to Settings → Tracker for detailed information:
| Section | Information |
|---|---|
| Current Status | Is a scan running right now? |
| Run History | Last 10 scans with results |
| Chests per Run | How many chests captured each time |
| Error Logs | Details if something went wrong |
Understanding Tracker Runs
Each scan creates a "run" record in the system:
| Field | Description |
|---|---|
| Started | Timestamp when scan began |
| Completed | Timestamp when scan finished |
| Duration | Total time (typically 1-2 min) |
| Chests Found | New chests captured this run |
| Status | completed, failed, in_progress, aborted |
Run Status Meanings
| Status | What It Means | Action Needed |
|---|---|---|
| completed | Scan finished successfully | None – working normally |
| in_progress | Currently running | Wait for completion |
| failed | Error occurred | Check error log, verify credentials |
| aborted | Timeout or manual stop | Usually auto-recovers next run |
What's Normal?
| Metric | Normal Range | Concerning |
|---|---|---|
| Duration | 30 sec - 3 min | > 5 minutes |
| Chests/run | 0-50 | Consistent 0 after setup |
| Failed runs | Occasional | 3+ consecutive failures |
Troubleshooting the Tracker
Tracker Not Running
| Symptom | Cause | Solution |
|---|---|---|
| "Last Scan" never updates | Tracker disabled | Enable in Settings → Tracker |
| Status shows "Error" | Credentials invalid | Re-enter and test |
| Runs complete but 0 chests | Account can't see chests | Verify clan membership |
Missing Chests
| Possible Cause | Solution |
|---|---|
| Chests expired before scan | Increase scan frequency |
| OCR couldn't read text | Check if captured with wrong name |
| Player name under different spelling | Check Members for duplicates |
Repeated Login Failures
- Verify password in-game – Log in manually to confirm it works
- Check for account lock – Wait 30 minutes if locked
- Update credentials – Re-enter in Settings → Tracker
- Test connection – Must pass before enabling
- Contact support – If failures persist after above steps
Slow Scans
| Duration | Status | Action |
|---|---|---|
| 30-90 seconds | ✅ Normal | None needed |
| 2-3 minutes | ⚠️ Slow but OK | Monitor |
| 3-5 minutes | ⚠️ Borderline | Check during off-peak hours |
| 5+ minutes | ❌ Too slow | Contact support |
Slow scans usually mean: Many chests to process, game server latency, or system load. Occasional slow runs are normal.
Security Best Practices
Credential Security
| Feature | How It Works |
|---|---|
| Encryption | Credentials are securely encrypted |
| Masked display | Password shown as ••••••• after saving |
| Limited access | Only Admin and tracker.manage holders |
| No plain text | Never logged or exposed |
Account Recommendations
| Practice | Why |
|---|---|
| Dedicated tracker account | Isolates risk, no disruption to main |
| Unique password | Don't reuse passwords from other services |
| Soldier rank | Minimum permissions needed |
| Remove if compromised | Can kick tracker account without losing main |
Access Control
| Who Can Access | What They Can Do |
|---|---|
| Admin | Full tracker control |
| Manager with tracker.manage | Full tracker control |
| Manager without permission | Cannot see tracker settings |
| Public link viewers | Cannot see anything about tracker |
Disabling the Tracker
To temporarily stop automatic scanning:
- Go to Settings → Tracker
- Toggle Enable Tracker to OFF
- Click Save
What happens when disabled:
- ✅ Scheduled scans stop immediately
- ✅ All captured data preserved
- ✅ Credentials remain saved
- ✅ Can re-enable anytime
Use cases for disabling:
- Maintenance periods
- Clan vacation
- Troubleshooting issues
- Preparing for clan merger
Resetting the Tracker
For a complete fresh start:
- Click Reset Tracker
- Confirm the action
What reset does:
- 🗑️ Clears saved credentials
- 🛑 Disables the tracker
- ✅ Does NOT delete chest data
- ⚠️ Requires full re-setup
When to reset:
- Changing tracker accounts
- Credential issues that persist
- Starting over with different setup
Frequently Asked Questions
Operational Questions
Q: What if my password changes? A: Update credentials in Settings → Tracker immediately. The tracker will fail until credentials are updated.
Q: Does the tracker work during game maintenance? A: No. Scans fail during Total Battle server maintenance. The tracker automatically retries on the next scheduled run.
Q: Can I run multiple trackers for one clan? A: No. One tracker per clan. Running multiple would cause conflicts and duplicate data.
Q: What if I'm playing while the tracker runs? A: You'll be logged out when the tracker logs in. This is why we recommend a dedicated tracker account.
Data Questions
Q: What if the tracker misses a chest? A: Chests expire after a set time in Total Battle. Increase scan frequency during active periods to minimize missed chests.
Q: Does the tracker capture ALL chests? A: Yes, all Triumphal Chests visible in the clan chests section are captured with player attribution and source.
Q: Can the tracker see private messages? A: No. The tracker only accesses the clan chests screen. It cannot read mail, chat, or any private data.
Tips for Optimal Tracking
Setup Checklist
- ☐ Create dedicated tracker account (recommended)
- ☐ Join tracker account to your clan
- ☐ Enter credentials in TB Clan Tools
- ☐ Test connection successfully
- ☐ Enable tracker
- ☐ Set appropriate scan cadence
- ☐ Verify first scan completes
- ☐ Check chest data appears on dashboard
Ongoing Maintenance
| Frequency | Task |
|---|---|
| Daily | Glance at Last Scan time in header |
| Weekly | Review run history for errors |
| Before events | Increase scan cadence |
| After events | Return to normal cadence |
| If password changes | Update credentials immediately |
The TB Clan Tools tracker automates Total Battle chest tracking so you never miss a contribution. Set it up once, let it run forever.