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
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
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, delete). Click any column header to sort.

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.

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.

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)

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. 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.

12. 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

13. 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.

14. 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