Choose the method that works best for your clan
From manual uploads to fully automatic tracking - you decide!
Fully automatic - runs in the cloud 24/7/365
Upload CSV, Excel or JSON files with chest data
Send chest data via API from your own tools
| Feature | Manual Upload | API Webhook | Cloud Auto |
|---|---|---|---|
| Setup Difficulty | Easy | Advanced | Easy |
| Automatic | ❌ | ✅ | ✅ |
| No computer needed | ❌ | ❌ | ✅ |
| Utility Account Needed | ❌ | ❌ | ✅ |
| Real-Time Updates | ❌ | ✅ | ✅ |
Create a new Total Battle account (NOT your main account!) and add it to your clan or let us create it for you
Go to Clan Settings → Auto Chest Grabber and enter the utility account credentials
Select scan frequency based on your plan (30 mins - 6 hours)
Our cloud system automatically scans and uploads chest data 24/7/365. No work required!
Create a CSV or Excel file with columns: chest_source, chest_name, player_name, date_collected
Navigate to Clan Administration → Chest Imports
Click "New Import" and upload your CSV/Excel file
System auto-matches players and chests. Review any unmatched items and import!
Go to Clan Settings → Webhook Integration and generate your webhook key
Copy the webhook endpoint: POST /webhook/chest-import/{ClanID}
Send POST request with header X-Webhook-Key: {your_key} and JSON array of chests
System automatically processes and matches data in real-time
API Documentation:
View full API docs →To automatically read chest data from the game, we need access to an account that is in your clan. We STRONGLY recommend creating a new small account (not your main account) for security and safety. This utility account only needs to be in your clan - it doesn't need to play or do anything else.
NO! Please DO NOT use your main account. Always create a dedicated utility account. While we encrypt all credentials and never store them in plain text, using a utility account provides an extra layer of security and peace of mind.
Simply create a new Total Battle account (use a different email), move it to your Kingdom, and join your clan. The account doesn't need to progress in the game - it only exists to read clan chest data. A level 1 account is perfectly fine!
The automatic system reads public clan information that any clan member can see: chest collection history for all clan members. It does NOT access private player information, messages, or anything outside of clan chest data.
Yes! You can combine methods. For example, use automatic scanning for daily tracking and manual uploads for importing historical data. The system automatically prevents duplicate entries.
No problem! Manual upload and API webhook methods are available on all plans including FREE. The Local Grabber Client (PRO+) also works without a utility account. Choose what works best for you!
Scan frequency depends on your plan: STARTER (6 hours), PRO (4 hours), PREMIUM (1 hour), PLATINUM (30 minutes). Frequency may vary slightly during high server load.
Automatic scanning will stop working and you'll receive an email notification. Simply re-add the utility account to your clan to resume automatic scanning.
Absolutely! You can switch between methods at any time. All your historical chest data is preserved regardless of which method you use.
All account credentials are encrypted using industry-standard AES-256 encryption. We never store passwords in plain text and never share your information with third parties.
Still have questions? Contact us