BEA Battle Scheduler

Quick Navigation

Overview
Switching Regions
Dashboard
Adding a Battle
Editing a Battle
Changing Status
Deleting a Battle
Calendar View
Google Calendar
Discord Posts
Battle Posters
Managing Creators
Searching and Filtering
Export and Import
Troubleshooting

1. Overview

The BEA Battle Scheduler manages TikTok PK battle schedules. All changes sync to Google Sheets in real time.

Key Features

Dashboard - Stats, filters, and battle table
Calendar - Monthly view with color-coded battles
Google Calendar Sync - Confirmed battles auto-create timezone-aware events
Discord Posts - Generate formatted posts for matchmaking
Battle Posters - Generate a branded "Agency Battle" graphic for confirmed battles
Region Color Coding - Blue = US/CA+, Red = UK+

Tip: Refresh the page to see changes made by other team members.

2. Switching Regions

Click the US/CA+ or UK+ tab at the top. The interface turns blue for US or red for UK so you always know which region you're in.

Each region has its own battle data, creator roster, Google Calendar, and timezone defaults (EST for US, GMT for UK).

3. Dashboard

Timeframe Toggle

Controls both stats and the table: Monthly (default), 30-Day Rolling (today + 30 days), or All Time.

Stats Bar

Shows Total, Confirmed, Pending, Unfilled, and Upcoming (7 days) counts for the selected timeframe.

Battle Table

All battles with date, time, username, type, power ups, diamonds, status, opponent, network, notes, and action buttons (edit, Discord post, poster, delete). Click any column header to sort. The poster button (🏆) appears only on Confirmed battles.

4. Adding a Battle

Click + New Battle in the header.

Fill in the form. Start typing in the username field to search the creator roster. For opponents, paste their full TikTok profile link to make it clickable.

Click Save Battle.

Required: Battle Date, Preferred Time, and TikTok Username.

Scheduling Recurring Battles

To set up a repeating battle, use the Repeat dropdown in the form:

Does not repeat - a single battle (default).
Daily / Weekly / Every 2 weeks / Monthly - creates a series starting from the Battle Date.

When a repeat option is selected, choose how the series Ends: either After a set number of times (e.g. 4) or On date (repeats up to and including that date). Saving creates a separate battle for each occurrence, all sharing the same time, type, and other details.

Two-month limit: a series only runs up to 2 months from its start date. If you ask for more (a higher count, or an end date further out), it's trimmed to the two-month mark and you'll get a heads-up — just set the series up again from the next date to keep it going.

Battles created together share a series ID, so the app knows they belong to the same recurring run. Series battles show a 🔁 marker next to the date in the table, and the detail popup shows their position in the series (e.g. "1 of 4").

Tip: Each occurrence is its own battle, so you can edit or confirm any single date without affecting the rest. When you delete a battle that belongs to a series, you'll be asked whether to remove just that occurrence or the entire series. Recurrence options only appear when adding a new battle.

5. Editing a Battle

Click the pencil icon in the Actions column. Make your changes, then click Save Battle.

Editing a Recurring Series

When you edit a battle that belongs to a series (marked with 🔁), a Recurring Series panel appears with two options:

Apply changes to entire series - tick this box before saving to push your edits (time, type, status, opponent, etc.) to every battle in the series. Each battle keeps its own date.
+ Add occurrence - opens the form pre-filled from this series with the next date suggested, so you can append another battle to the run. You can change the date, and you may even use the Repeat option to add several at once - they all stay in the same series.

Tip: Leave the box unticked to change just the one battle you opened.

6. Changing Status

Click the Confirmed or Pending badge directly in the table to toggle it instantly.

A battle can't be Confirmed without an opponent. Add the opponent's @username in the VS. column first — otherwise the badge stays Pending and no poster trophy appears. (Any older battle still showing Confirmed with an empty VS. column is treated as Pending until an opponent is added.)

Calendar sync: Toggling to Confirmed creates a Google Calendar event. Toggling back to Pending removes it.

7. Deleting a Battle

Click the trash icon in the Actions column and confirm.

Warning: Deletes are permanent and cannot be undone.

8. Calendar View

Click the Calendar tab to see a monthly grid. Green = Confirmed, Yellow = Pending. Click a battle for details, or click a date to filter the dashboard.

9. Google Calendar

Click the Google Calendar tab for an embedded view of the region's calendar.

Auto-Sync Rules

Only Confirmed battles create calendar events
Changing to Pending or deleting removes the event
Events are timezone-aware (e.g., 3:00 PM PST shows as 6:00 PM EST)
Confirming a battle also attaches its poster (🏆) to the event automatically

10. Discord Posts

Click the lightning bolt ⚡ on any battle to generate a formatted matchmaking post. Edit if needed, then Copy to Clipboard and paste into Discord.

Bulk Posts

Select multiple battles using the checkboxes, then click the Discord Post button in the toolbar to generate a combined post for all selected battles.

Tip: Filter by Unfilled first, select all, then bulk-post to find opponents for every open battle at once.

11. Battle Posters

Turn a confirmed battle into a ready-to-post "Agency Battle" graphic — auto-filled with the matchup, the date, every time zone, and the creators' photos. The BEA creator is always on the left, the opponent on the right.

What is what

Two spots on the Battle Scheduler do all the work:

Dashboard Actions column with an arrow pointing at the gold trophy that generates the poster — **The 🏆 trophy makes the poster** — one tap. It only appears on **Confirmed** battles, because a poster is only worth making for a locked matchup.

Dashboard VS. column with an arrow pointing at an opponent's TikTok @username — **The opponent goes in the VS. column** as a TikTok @username. The opponent's photo is pulled from it — ✓ @mannyc456 ✗ "Manny C". A display name loads a blank circle.

New Battle form: typing part of a name shows BEA creators to pick from a dropdown list — **Only the opponent is typed by hand.** The BEA creator on the left is chosen from the dropdown as you type — start typing and pick the name, so it's never wrong.

Making a poster

Confirm the battle. Set its status to Confirmed — you'll need an opponent filled in first. The 🏆 trophy then appears in the Actions column (and in the calendar detail popup).
Tap the trophy. The poster opens with the BEA creator on the left, the opponent on the right, and everything filled in.
Check the photos loaded. Both circles should show the creators' TikTok profile pictures. If one is blank, see Photos below.
Download and post. On iPhone, Download opens the Share sheet so you can save it or send it straight to your socials.

Can't confirm a battle? A battle needs an opponent before it can be set to Confirmed — no matchup, no poster. Add the opponent's @username in the VS. field first, then confirm.

Photos

Both profile pictures load on their own and are cropped to fill the gold circles. If the opponent's circle is blank, the handle is usually a display name or misspelled — fix it in the VS. field and it re-pulls. Opponents outside BEA sometimes can't be pulled — click Photo to upload one by hand (this also overrides the auto-pulled picture).

Times

Every poster lists PT · MT · CT · ET · UK so no one has to do the math.
The zone the battle was set in shows first (UK first for UK battles).
If a zone lands on the next day, it drops to its own line with that day (e.g. "SUN AUG 23 · 2 AM UK").
On-the-hour times skip the :00 — it reads "9 PM", not "9:00 PM".

What the poster looks like

Example Agency Battle poster: BEA creator versus opponent, date, and time zones

Full date with the day of week ("SAT AUGUST 22, 2026"), both handles under the photos, and all five time zones. Example only — real photos are pulled from the creators' TikTok profiles.

If the battle is part of a recurring series, the poster shows a small "SERIES" banner in the top-left corner. Standalone battles have no banner.

Saving the Poster

Download PNG saves a 1080×1920 image ready to post to TikTok / Stories. Copy Image puts it straight on your clipboard (where supported).

Automatic on the calendar: You don't have to attach the poster by hand — confirming a battle attaches its poster to the Google Calendar event for you, so anyone who opens the event sees the matchup graphic. Re-confirming (or editing a confirmed battle) refreshes it, replacing the previous poster on the event.

Tip: Names, date and times all stay editable — tweak anything before you download, e.g. to show a display name instead of a handle.

12. Managing Creators

Click Manage Creators in the header to add or remove usernames from the creator dropdown. Each region has its own roster — make sure you're on the right tab first.

13. Searching and Filtering

Status filters: All, Confirmed, Pending, or Unfilled
Search box: Filter by creator or opponent name
Date range: Use the From/To date fields to narrow by date

14. Export and Import

Export CSV downloads the current region's data. Import CSV adds battles in bulk from a CSV file.

Note: Importing adds to the existing list — it does not replace. Check for duplicates before importing.

15. Troubleshooting

"Loading battles..." won't go away

Refresh the page. If it persists, check your internet connection.

Teammate can't see my changes

They need to refresh their page. There's no auto-refresh.

Accidentally deleted a battle

Check the Google Sheet's version history (File > Version history) to recover the data.

Opponent link isn't clickable

Use a full TikTok URL: https://www.tiktok.com/@username

Can multiple people edit at once?

Yes. If two people edit the same battle simultaneously, the last save wins.

Bold Evolution Agency - Battle Scheduler v1.0

Questions? Reach out to Bea@boldevolution.net

← Back to Battle Scheduler