Docs → Getting Started → Welcome to TB Clan Portal
👋 Welcome to TB Clan Portal
What the portal records for you, where each thing lives, and the three settings worth fixing on your first day.
You have logged in for the first time and you are looking at a page full of boxes with your name on them. This article tells you what produced those numbers, where the rest of the portal is, and the three things worth setting before you go any further.
The short version: the portal is a record of what already happens in Total Battle. It watches your clan's chests, roster and chat, keeps a history of them, and measures each member against whatever bar your clan leadership has set. It does not play the game, it does not send anything to Total Battle about your score, and nothing you do here changes anything in your city.
Where the numbers come from
Almost nothing on your dashboard was typed in by a person. It arrives from these sources:
- Your clan's chest grabber account. A game account your clan leadership set up, which logs in on a schedule and reads the clan's chest list. This is what makes chest points, cycles, epic chests and most rewards possible.
- The in-game event board. While one of your clan's events is running, that same linked game account reads each member's current score on every check-in and writes it straight into the event. Nobody uploads a scoreboard.
- Your clan journal. When an event finishes at the daily reset, the game writes its final scoreboard into the journal and the portal collects it on its own, usually within an hour or two.
- Your clan capital resource log. Read on the same check-ins, which is how resource deliveries are counted towards an event goal.
- The roster sync. Membership, ranks and who is online come from your clan's own member list in the game.
- Chat. If your clan tracks chat activity, messages in the in-game groups it nominates are counted.
- You. A few values are yours to keep current — your troop research levels, your country and your time zone.
Everything else in the portal is arithmetic on top of those.
Your first five minutes
Some clans require it. A full-screen panel headed with your clan name and a rules version appears until you accept, and it comes back whenever leadership publishes a new version. If your clan added a rules quiz you must answer every question correctly — up to five — before ✓ Accept & Continue will take. A ⏰ Later button is only offered when there is a quiz; without one, accepting is the only way past it.
Every time in the portal is stated in UTC, because the game day is. Once Time Zone is set, your local time is shown in brackets next to it — including on the Last scan chip at the top of every page. While it is empty you get UTC alone and have to convert in your head.
The player you signed up with is already attached to your account. If you play more than one, add each of them with ＋ Register Player and the invite code from your clan admin. See Linking your players for the whole flow.
The layout you were given is a starting point, not the design. Open Configure dashboard and make it yours — see below.
The dashboard is yours to arrange
Your dashboard is a stack of rows. Each row is 1 to 4 columns wide, and every column holds one widget. You can add rows up to a limit of 12, change any row's column count, drag widgets between slots, hide a widget without giving up its place, or drop it back into the pool for later. There is no Save button — every change is stored the moment you make it, and Reset to default puts the shipped layout back.
One consequence surprises people: the width of a widget decides how much it shows. The same widget is a full chart in a 1-column row, a compact card in a 3-column row, and a single headline number in a 4-column row. If a widget looks emptier than you expected, give it a wider row. On a phone this does not apply — below 768 px every widget renders at full size in a single column.
Two widgets, Notifications and My Players, sit in a fixed row at the top. They cannot be moved or removed. Some widgets draw on clan-wide data, and your clan admin can switch those off for everyone; in the configure panel they are marked Turned off by your clan. A widget switched off keeps its slot, so it reappears exactly where it was if the admin switches it back on.
Where everything lives
| What you want to know | Where to look |
|---|---|
| How am I doing this cycle? | Dashboards → Chest Cycle Statistics |
| Which chests did I actually claim? | Dashboards → Chest Cycle Points |
| How is the whole clan doing? | Dashboards → Chest Dashboard |
| What is a chest worth? | Clan → Chest Catalog |
| Did I pass the last event? | Dashboards → Event Statistics |
| My own history, all of it | MY → My Progress |
| What have I been paid? | MY → My Clan Rewards |
| My Conquest Point balance | CP RUNs → My CP account |
| The clan's rules | Clan → Rules & Information |
| What is coming up in the game | Game Tools → Event Calendar |
If a menu path in that table is not on your bar, read Understanding the navigation menu — menus differ from person to person, and from clan to clan.
Two things new members misread
Last scan is not a page refresh. The chip at the top of every page shows when your clan's chest grabber account last collected chests for the clan you have selected. Chests you claimed after that time are not in the portal yet. If it reads Setup your account to start scanning instead, the selected clan has no active chest grabber account — that is your clan leadership's job, not yours.
The bell is not for everyone. The notification bell in the header is shown to clan admins and portal staff. As a member you read the same things at MY → Notification Hub.
When this article is not enough
The round button in the bottom-right corner of every page opens Help Center, Contact Support, Report a Bug, Suggest a Feature and My Tickets, which is where replies to anything you send land.
Three long guides go deeper than any reference article can. Read Setting up chest tracking cycles for how a cycle decides whether you passed, How to track events for how an event window is scored, and Understand the penalty system for where a penalty on your record came from.
Common questions
Why does my clan mate have menus I do not have?
Because parts of the menu are tied to a role. Everything under Clan Management is for clan administrators, and it appears only while the clan you have selected in the header is one you administer — an admin of one clan who switches to another clan loses it until they switch back. A third group of menus belongs to portal staff and is never shown to customers.
I claimed chests an hour ago and they are not here. Is something broken?
Probably not. Chests arrive when your clan's chest grabber account next collects them, and the Last scan chip at the top of the page tells you when that last happened. Anything you claimed after that time will appear at the next collection. If the chip has not moved for a long time, tell your clan admin — the schedule is set on their side.
Can I correct my own might or hero level?
Not those two. At MY → User & Player Settings you can open one of your players and edit its six research levels — Guardsmen, Specialists, Monsters, Engineers, Army Modernization and Monsters Boost. Everything else on the player card, might and hero level included, is read-only and kept current from the game.
I have players in two clans. Which clan am I looking at?
Whichever one is named in the header, next to the logo. Click it to switch; your choice sticks for the rest of the session and follows you from page to page. The one exception is your dashboard, which follows the player in Viewing as instead. You can also nominate a Default Clan at MY → User & Player Settings, which is the one selected for you at login.
Related