Overview

Key metrics and realtime system health

Total Players group

Total Songs music_note

Active NPCs smart_toy

EchoX Posts forum

Active Hustles work

Access Codes key

Chat Statistics

Real-time messaging activity

Conversations forum

Messages chat

Reported report

Banned Users block

Analytics

Detailed insights and trends

Player Growth

Song Activity

Revenue

Player Money

Total Money

Average Balance

Median Balance

Top Player

No data yet

Players

Search and manage player accounts

Player Search

Search Players

Search for players to view their details

Song Stream Boost

Apply a temporary stream multiplier (server-side) for a player’s song. Duration is measured in in-game days.

Player ID

Song

Multiplier

Duration (in-game days)

Game Control

Manage game state and scheduled tasks

schedule

Time & Schedule

update

Daily Update

Trigger the daily update process for all players

calendar_month

Game Time

Current in-game date and time

Advance Hours

leaderboard

Weekly Charts

Rebuild song & artist weekly leaderboards using the latest 7 in-game days.

build

Maintenance Tools

public

Regional Fanbase

Rebalance regional fanbases for all players to match global totals.

query_stats

Chart Snapshots

Refresh daily chart snapshots and backfill historical peaks.

Hot 100 Spotlight 200

Concurrency

Dry run

history_edu

Bio Cache

Clear cached Wikipedia bios to force AI regeneration.

Artist ID (optional)

Clear All

groups

Roster Counts

Recalculate roster counts for all labels based on active contracts.

work

Side Hustles

work

Contract Pool Configuration

Configure the Side Hustle contract pool and generate/clean contracts.

Target Pool Size

Enabled

Min Days

Max Days

Pay Variance (0–1)

Energy Variance (0–1)

Min Energy Cost

Max Energy Cost

Min Daily Pay (optional)

Max Daily Pay (optional)

Clear contracts older than (days)

Dry run

person_off

Player Management

trending_down

Flop Era Management

Manually set/clear flop era status for players. Applies 2x fame decay, 0.7x streams.

Player ID

star

Prime Era Management

Set Prime Era status for players experiencing peak success. Configurable bonuses for streams, fan growth, and playlist placement.

Player ID

Stream Multiplier 1.3 = +30% streams

Fan Growth Multiplier 1.25 = +25% fan growth

Playlist Boost 1.2 = +20% playlist odds

Reason (optional)

warning

Danger Zone

Reset Game State

Full game reset. This action is irreversible and will delete all player data.

Admin Artists

Create/verify the built-in admin artist accounts (DJ Khaled, Metro Boomin, Dr. Dre).

If a password is generated, save it immediately (it may only be shown once).

Click "Refresh Status" to load admin artists.

Collaboration Management

Send Collab Invitation

Invite a player to collaborate with an admin artist.

Search Player

Pending Collaborations

Songs awaiting audio upload or finalization.

Player	Admin Artist	Song	Status	Created	Actions
Click "Refresh" to load

⚖️ Contract Termination Settings

Configure penalties for early contract termination.

Label Termination

Write-Off % % advance lost (0.30 = 30%)

Album Penalty Per undelivered album

Artist Compensation % % artist keeps

Artist Termination

Early (0-25%)

Mid (26-50%)

Late (51-75%)

Near (76-100%)

Fame Penalty

Fanbase Loss %

Cooldown (Days)

System Status

Loading system status...

Gifts

Send gifts to individual players or all players

🎁 Send Gift to Player

Search Player

Selected Player ID Auto-filled from search or paste manually

Gift Type

Amount

Message (optional)

🎊 Send Gift to All Players

Gift Type

Amount

Reason

VIP Management

Grant complimentary VIP or generate VIP voucher codes for giveaways

👑 Grant VIP (Comp)

Directly grant a VIP tier to a player (no payment)

Player ID (UID)

Tier

Duration (days)

Reason (optional)

🎟️ VIP Vouchers

Generate redeemable codes players can enter in-game

Tier

Duration (days)

Count

Max Uses

Campaign (optional)

Generated Codes

👥 Active VIP Players

All players with active VIP subscriptions

Player	Tier	Status	Expires	Fame	Streams	Actions
Click refresh to load VIP players

Moderation

Manage player behavior and content

Ban Player

Banned Players

Access Codes

Generate and manage access codes

Generate New Code

Max Uses

Expiry (days)

Custom Code (optional)

Allowed: A–H, J–N, P–Z, 2–9 (no I, O, 0, 1). Length 6–12.

Overwrite if exists (reactivate/update) Reset usage count (set usedCount=0)

Description / Notes

Active Access Codes

Manage and track unique invitation codes

Code	Status	Used	Max	Expires	Created	Description	Actions
Fetching access codes...

Access codes are read-only from the client (Firestore rules block writes). Manage codes using the Access Code Generator / generate_access_codes.dart scripts (see docs/features/ACCESS_CODE_SYSTEM.md) to create, edit, or deactivate entries. The table will show any server-side changes after refreshing.

Gandalf

Manage Gandalf The Black - the notorious music critic

🧙 Trigger Gandalf Post

Manually trigger a post from Gandalf The Black.

Post Type

🥊 Trigger Beef News

Generate beef-related drama news.

Beef Type

🎯 Trigger From Active Banter Beef

Generate a post using real player names from an active Banter beef.

Active Beef

Post Type

📰 Recent Gandalf Posts

Click "Refresh" to load recent posts.

Notifications

Send push notifications to players

Send Notification

Title

Message

Target

Target ID

Custom Data (JSON)

Send push notification

Diagnostics

Push notification health across platforms

Total Players group

Notifications Enabled notifications_active

Missing Token warning

Stale Token (30d) schedule

Platform Breakdown

Enabled vs. missing tokens by platform

Players With Issues

Missing or stale tokens (sample)

Player	Display Name	Platform	Status	Token Updated	Notes
Loading diagnostics...

Data Fixes

Run safe migrations for corrupted release dates

Sets invalid song release dates (e.g., 1900s) to null for released songs. Safe to run multiple times.

Not run yet.

Shadow Players

Detect duplicate/placeholder player rows that can force onboarding

Detector Controls

Backed by Supabase RPC nextwave.admin_list_shadow_players

Not loaded yet.

Min age (minutes)

Rows newer than this are ignored to avoid flagging in-flight onboarding.

Candidates

Shadow rows (id == firebase_uid) with missing/placeholder display name

—

Email	Shadow Player ID	Firebase UID (Auth UUID)	Display Name	Linked Rows	Best Linked	Created	Updated
Click Refresh to load detector results.

Awards

Manage award ceremonies, nominations, and winners

Award Shows

Latest shows and their current phase

Loading award shows...

Live Votes & Controls

Monitor voting and adjust counts

Award Show

🗳️

Select a show to view votes

Use “Load” for a snapshot or “Live” to stream updates.

Ceremony Phase Controls

🏠 Lobby

~50 min

📸 Red Carpet

~10 min

🏆 Ceremony

~30 min

✅ Complete

Final

Create Award Show

Manual show creation (admin-only)

Award Show Name

Show Type

Submission Days

Voting Days

Venue (optional) Loaded from Firestore `venues`

Award Templates

Auto-recurring annual shows

Loading templates...

Create Template

Template Name

Short Name

Type ID

Trigger Month

Trigger Day

Submission Days

Voting Days

Default Venue Name

Default Venue Capacity

Labels

Manage record labels and contracts

Major Labels corporate_fare

Artist Labels business

Active Contracts description

Total Treasury account_balance

Major Labels

Label Name	Owner	Treasury Balance	Artist Labels	Active Artists	Actions
Loading...

Artist Labels

Label Name	Owner	Parent Major	Treasury Balance	Signed Artists	Rev Share to Major	Actions
Loading...

Active Contracts

Artist	Label	Label Type	Royalty Split	Advance Paid	Start Date	Duration	Status	Actions
Loading...

Pending Label Offers

Contract offers from labels to artists awaiting response

Target Artist	Label	Parent Major	Royalty Split	Advance	Offer Date	Actions
Loading...

Verification

Review and approve verification requests

Pending Verifications

Player	Fame	Request Date	Status	Actions
Loading...

Loans

Review and manage loan applications

Pending Loans

Player	Amount	Request Date	Status	Actions
Loading...

Active Loans (Owed)

Player	Owing	Loans	Daily Payment	Missed	Last Payment	Due Date	Investments	Recent Repayments	Actions
Loading...

Investments

Player	Investment Principal	Money	Fame
Loading...

Radio Configuration

🔄 Radio Operations

Manually trigger radio rotation to process pending submissions and rebuild placement ladders.

📻 Radio Formats & Archetypes

Manage radio formats and their characteristics (demographic reach, genre flexibility, monetization potential).

🎵 Genre to Format Mappings

Define which radio formats are best for each song genre.

Playlist Configuration

⚙️ Playlist Scoring

Runs playlist scoring immediately (admin-only). This writes new rotation documents used by the in-game Playlist Placements ladders.

Playlist

🎼 Playlists

Manage playlist metadata, curation strategies, and slot allocations.

The Lux NightClub

Manage music playlist and settings

Upload Music

Playlist

Title	Artist	Uploaded	Actions
Loading...

NextWave

Overview

Chat Statistics

Analytics

Player Growth

Song Activity

Revenue

Player Money

Players

Player Search

Song Stream Boost

Game Control

Time & Schedule

Daily Update

Game Time

Weekly Charts

Maintenance Tools

Regional Fanbase

Chart Snapshots

Bio Cache

Roster Counts

Side Hustles

Contract Pool Configuration

Player Management

Flop Era Management

Prime Era Management

Danger Zone

Reset Game State

Admin Artists

Collaboration Management

Send Collab Invitation

Pending Collaborations

⚖️ Contract Termination Settings

Label Termination

Artist Termination

System Status

Gifts

🎁 Send Gift to Player

🎊 Send Gift to All Players

VIP Management

👑 Grant VIP (Comp)

🎟️ VIP Vouchers

👥 Active VIP Players

Moderation

Ban Player

Banned Players

Access Codes

Generate New Code

Active Access Codes

Gandalf

🧙 Trigger Gandalf Post

🥊 Trigger Beef News

🎯 Trigger From Active Banter Beef

📰 Recent Gandalf Posts

Notifications

Send Notification

Diagnostics

Platform Breakdown

Players With Issues

Data Fixes

Shadow Players

Detector Controls

Candidates

Awards

Award Shows

Live Votes & Controls

Create Award Show

Award Templates

Labels

Major Labels

Artist Labels

Active Contracts

Pending Label Offers

Verification

Pending Verifications

Loans

Pending Loans

Active Loans (Owed)

Investments

Radio Configuration