Overview

What is Marbles on Teams?

Marbles on Teams is a cross-streamer stats tracker for the Twitch game Marbles on Stream, created by thejeansentis. Participating streamers run a companion app that watches their Marbles on Stream save folder and automatically sends race and battle royale results to this server.

Results from every participating streamer are combined into a single shared season leaderboard. Your points from every channel count toward the same ranking. Seasons are managed by the site admin and reset the leaderboard when a new one starts.

Viewers

Getting Started

You do not need to sign up. Just race in Marbles on Stream on any participating stream and your account is created automatically when your first result is recorded.

To access all features

1. Log in with Twitch using the button in the top right corner.
2. Your Dashboard will show your personal season stats, XP level, and victory style settings.
3. From the Teams page you can create or join a global team and compete with your teammates across all channels.

Tilt

When a streamer plays Tilt, every level you finish pays the same points to every finisher (chat shows it as "+N each"). Falling off pays nothing for that level, and a failed level pays nobody. Your Tilt points count toward your season points, your global team and the channel's local team, just like race and Battle Royale points. Points per race (PPR) leaves Tilt out. After each level, chat lists the players who survived it with their points for the run so far; when the run ends, it posts everyone's final standings. With team results on, each level is followed by the run points so far of every team with a player who survived it, and the run's end by every team's final total.

Leaderboard

Leaderboard Tabs

Viewers

Ranks all players in the current season. Use the Season / Today toggle to switch between the full season ranking and a same-day ranking. Click any column header to sort. Click a player row to open their profile.

Streamers

Stats for each participating streamer this season. Shows total pts awarded, races hosted, BRs hosted, and world records set at their channel. Click any column to sort. Click a row to open channel details including top viewers and recent sessions.

Teams

Global team standings for the season. Click any column to sort. Click a row to open the team detail view with stats and member list. If a season prize has been set by the admin it appears as a banner above the table.

World Records

The current fastest race time per map, who holds it, and when it was set.

Maps

All maps that have been raced on, ranked by how many times they have been played. Shows the map name, play count, and how many different streamers have hosted it.

Viewer Features

Dashboard

Your personal stats page. Requires Twitch login. Shows your current season stats: total points, races played, race wins, BR results, PPR, and world records you currently hold.

XP Bar

Shows your current level and progress toward the next level. Each level requires more XP than the previous one. When you level up, a Claim Reward button appears. Pick one of three random cosmetic categories, then spin for an unlock from that collection.

Subscriber Chests

Subscribers to TheJeansentis can claim Victory Customization chests for themselves from Configuration. Tier 1 holds up to 3 and recharges every 48 hours, Tier 2 holds 5 and recharges every 36 hours, and Tier 3 holds 10 and recharges every 24 hours. Streamers use the same account balance for viewer giveaways and earn one extra charge when they complete one of their own channel's tasks, up to 10 charges above their capacity.

Streamers can also reserve a charge from chat: !wrchest gives a chest to the next player who sets a confirmed World Record on the channel, !racechest gives one to the next player who wins a race or Battle Royale there, and !tiltchest gives one to the top scorer of the next Tilt run there (when top scores tie, whoever finished the run's last cleared level first wins). Each can be armed once at a time.

Countdown Timer

During an active stream session a countdown appears showing when the next race is likely to start, based on the timing of recent races at that channel.

Victory Style

Choose how your name and animations appear in the victory overlay when you win a race. A live preview updates as you pick options. Click Replay to see the entry animation again.

My Team

If you are in a global team, your team's season pts, races, BRs, PPR, and member count are shown here.

Channel Stats (streamers only)

Streamers see their own channel stats: total pts awarded, races hosted, BRs hosted, unique players, and PPR. Your top 50 viewers are listed below with a search bar and sort options (pts or races).

Teams

Global Teams

Global teams compete across all participating streamers. Every point your teammates earn on any channel counts toward your team's season total. Teams are ranked on the Teams leaderboard.

Creating a Team

You must follow or subscribe to thejeansentis on Twitch to create a team. Your subscription tier determines how many member slots your team gets:

Bonus slots unlock automatically when your team reaches 4, 8, 12, or 15 subscriber points. Prime and Tier 1 subscriptions earn 1 point, Tier 2 earns 2 points, and Tier 3 earns 4 points. Paid, Prime, and gifted subscriptions all count, and active subscribers have a ★ SUB badge in the global roster.

If Twitch stops reporting a captain's active subscription, the team keeps the captain's last subscription-tier benefits for a 14-day grace period. The team page shows the remaining time. If Twitch reports the subscription again during grace, the live status and tier restore automatically.

If a team's capacity drops below its roster size, nobody is removed. The captain keeps a scoring slot, and the remaining slots go to members with the most recent tracked race or BR activity across all channels. For members with no tracked activity, their join date is used instead. Members outside the scoring slots stay on the roster but do not contribute team points; playing again can move them back into a scoring slot.

Team Logo

Use the in-app SVG logo creator on your captain panel. What you can customize depends on your tier:

• Follower: shape (circle, square, hexagon, shield, diamond) and background color
• Tier 1+: icon character (13 options) and icon color
• Tier 2+: border style (none, solid, glow) and border color

Inviting Members

Open your captain panel, go to the Invite Members tab, and type a viewer's username. They can accept it on their Teams page or in chat with !globalaccept. If they have several invites, !globalaccept [team name or tag] selects one; otherwise the newest invite is accepted. Members can leave with !leaveglobal. Captains and co-captains can also use !globalinvite [username] and !globalkick [username] in channels where the streamer has enabled global team management commands.

Want someone else to run the team? In the captain panel's Settings tab, use Transfer ownership to make another member the captain. You'll see what changes before you confirm. The new captain must follow or subscribe to TheJeansentis, and their Twitch status sets the team's slots, so a few members may stop scoring if they have a lower tier. Team points stay the same. You stay in the team, and if you hand over to your co-captain you become co-captain. Only the new captain can hand it back.

Inactive Member Auto-Kick

The captain can set an inactivity limit in days from the team Settings tab. Activity is the member's latest tracked race or BR across all channels; a never-active member is measured from their join date. The captain is always protected. Set the limit to 0 to disable automatic kicks.

Team PPR

Team PPR is the team's total season points divided by the combined number of races and BRs played by all members.

Celebration Settings

Available to captains who are Tier 1 or higher subscribers to thejeansentis. Set the badge style, animation, and color that appears in the victory overlay when a team member wins a race.

Weekly Team Task

Your captain or co-captain can select one shared task on the Tasks page each Monday–Sunday week (Copenhagen time). Targets scale with team size at selection. Current members’ eligible activity since Monday counts, starting from their team join date; new teammates can help after joining. Until the task is completed, the captain or co-captain can switch to a different task; switching resets the team’s progress to zero, only later races and Battle Royales count, and the new target uses the current roster size. A completed task stays locked for the rest of the week.

Reach the shared total to reward every contributing member: Easy gives 500 XP, Medium gives 1,500 XP, and Hard gives 2 personal chests. Rewards are issued once at completion; members with no contribution receive none. XP follows the usual level-up and team-XP rules. Chests can be opened on your dashboard.

Hall of Fame

Stats → Hall of Fame collects the top 10 across every season. Season Records shows each player's or channel's best single season (points, race wins, races, BR wins, world records and points per race; races, BRs, points awarded, world records and unique racers for channels). All-Time covers single-race and single-day feats, the longest win streak on one channel, the biggest race hosted, career totals, Team Raid wins, levels, Plutos and team titles. Champions lists each season's top three players, its world-record leader and its top channel. Records from the running season are marked ONGOING (they can still change until the season ends).

When logged in you also see your record book: your personal best in each player category, your rank, and how much more you need to reach the top 10. Season 69's imported pre-website totals count toward season and career totals but not toward single-race, single-day, streak, points-per-race or streamer records. Records refresh every few minutes, and players who delete their account are removed straight away.

Weekly Competition

Global Tournament

The top 32 teams on the global leaderboard qualify each Tuesday at 00:00 Europe/Amsterdam. Their team details and scoring rosters are frozen for the tournament, then the teams are randomly drawn into a five-round knockout bracket. Regular global teams continue operating normally while the tournament runs.

Scoring and tiebreakers

Each matchup counts MoT race and battle royale points earned that Amsterdam calendar day by the frozen scoring members. The higher daily point total advances. If points are tied, the system compares distinct race + BR events, then race + BR wins, then the saved Tuesday qualification rank.

Champion reward

Every member on the champion team's full Tuesday snapshot receives one Victory Customization chest, including members who were outside the team's scoring slots. The chest is claimed through the reward wheel on the Dashboard.

Local Teams

Per-Channel Team Seasons

Local teams are separate from the global leaderboard. Each streamer can run their own team season on their channel. Standings are visible on the Local page. Local team management is done entirely through Twitch chat commands.

The streamer must have Enable Local Team Commands turned on in their Config page for these commands to work.

Commands

See the complete local-team command list for aliases and permissions.

Progression

XP, Tasks, and Rewards

XP and Levels

Every race and BR finish earns you XP. Your total XP determines your level. Each level requires more XP than the last. XP you earn also flows into your global team's shared pool, helping your team level up too.

Tasks

Streamers can set up to 3 active tasks at a time on their channel. Browse active tasks on the Tasks page and filter by live streamers. Tasks are shared goals that all viewers on that channel work toward at the same time. Completing a task earns XP:

Every streamer also has a Free Slot. With Auto-pick on (the default), an empty Free Slot gets a task after your next race, Battle Royale or Tilt result, scaled to your live audience. Choose Race, Battle Royale or Tilt on the Free Slot card; Random race / BR keeps the original mixed selection. Every Free Slot task lasts 2 hours at every difficulty, including manual picks, resets and !autotask. Switch Auto-pick off on the Free Slot card to choose its task yourself; a task that is already running keeps going until it expires.

Stuck with a task you don't like? Every slot, including the Free Slot, has one reset per day. Click Reset task on a running task and pick a new one. Viewer progress on the old task is lost. Resets come back at midnight, Copenhagen time.

In a hurry? Type !autotask race, !autotask br or !autotask tilt in your own chat to put a random task of that kind on your Free Slot and every unlocked slot that is empty. Slots with a running task keep it.

Events. During a limited-time event such as 🎃 Halloween (until November 2), every streamer gets one event slot on the Tasks page and can pick one hard event task per day (picks come back at midnight, Copenhagen time; replacing a running event task uses a pick). Event tasks run for 12 hours, or until the event ends. Every viewer who completes one earns an event chest on top of the XP. Already-running tasks keep their progress and rewards until they expire; an existing second slot retires afterward and cannot be refilled. Open chests on your Dashboard: each one unlocks a style from the event's collection (32 Halloween styles, rarer ones less often; once you own them all, a chest gives XP). Event styles never come from normal reward spins, and you keep them, and any unopened chests, after the event.

Tasks come in three kinds: Race, Battle Royale and Tilt. Tilt tasks include playing or clearing levels, earning Tilt points, finishing a level first, reaching a level, clearing levels in a row or earning points within one run, scoring in several runs, and even falling off. A level counts as cleared only when you stay on the board and the level passes. Run tasks count the levels played after the task was set.

Reward Wheel

When you level up a Claim Reward button appears on your Dashboard. Before the wheel spins, choose one of three random categories that still has cosmetics to collect. The wheel then lands on a random unlock from that category. Once the full catalog is complete, duplicate spins award 75 XP instead.

Cosmetics have five rarity tiers that affect how likely they are to appear on the wheel: Common, Uncommon, Rare, Epic, and Legendary.

Viewer Cosmetics

All unlocked cosmetics are shown in your reward pool on the Dashboard. They apply in the victory overlay when you win a race. Name colors, name effects, entry animations, confetti palettes, and victory FX can all be unlocked.

Team Cosmetics

Teams have their own XP pool that grows alongside member XP. The captain can claim team rewards to unlock badge styles, badge animations, and badge colors for use in the victory overlay.

Chat

Find every chat command

The command directory lists all 30 active commands, four aliases and retired names, with examples, permissions and channel settings. Search by command or filter by category and role.

Automatic results, record notices, team scores and task completions have separate Configuration toggles. Missions announcements are enabled by default and managed in Settings → Chat messages.

Streamers

For Streamers

Getting Set Up

1. Log in to this site with your Twitch account and make sure your role is set to Streamer.
2. Go to the Configuration page and download the companion app.
3. Install and run the companion app. Point it at your MarblesOnStream save folder.
4. Back on the Config page, link your Twitch token to enable chat features.

Companion App

The companion app (Windows .exe) runs alongside Marbles on Stream. It watches your save folder for new race and royale result files and sends them to the server automatically. The app shows:

• Server connection status
• IRC bot status (whether chat commands are connected)
• Whether you are currently live on Twitch
• A download prompt when a new version is available

Chat Settings (Configuration page)

Auto Messages: each toggle controls one type of bot post in your chat.

• Show results in chat: race and BR summaries after each event
• Announce world records: alerts when a new WR is set at your channel
• Team results in chat: pts each team earned, posted after each race
• Announce task completions: posted when viewers finish tasks in a race

Viewer Commands: toggle each command independently. !mystats, !daily, !season, !myteam, and !motcommands each have their own switch. !myteamstats and !teamtask share the !myteam switch. Incoming Team Raid announcements have a separate toggle, as do Team Raid signup announcements (off by default; posted only while you're live).

Global Team Management: controls whether viewers can use !globalaccept and !leaveglobal, and captains/co-captains can use !globalinvite and !globalkick in your channel.

Local Team Commands: one toggle enables or disables all 11 local team commands (plus the !recruitment alias) at once.

Streamer vs Streamer (SvS)

Challenge other streamers to a head-to-head points competition. Points earned at each streamer's channel during the time window count toward that streamer's score. Up to 8 streamers can be in a single SvS at once. Set up and manage active challenges from the Streamer vs Streamer card on the Configuration page.

Overlays

OBS Overlays

Both overlay URLs are shown on your Configuration page. Add each one as a Browser Source in OBS. Both overlays stay connected to the server and update automatically after each race.

Stats Overlay

URL format: marblesonteams.app/overlay.html?streamer=yourname

Two display modes:

• Panel mode: full panels that cycle automatically at a configurable interval. Available panels: viewer top 10, world records, battle royale leaderboard, teams leaderboard, streamers leaderboard.
• Ticker bar: a scrolling horizontal bar showing all stats in one line. Includes today's top viewers, season totals, and the last race result.

While you play Tilt, both modes show the current run's standings first (for 30 minutes after the last level), and a season Tilt top 10 appears alongside the leaderboards once anyone has Tilt points.

All options (width, height, accent color, which sections to include, panel duration) are set from the Overlays card on the Configuration page.

Victory Overlay

URL format: marblesonteams.app/overlay-victory.html?streamer=yourname

Add as a 1920 x 1080 transparent browser source. Nothing shows between races. When a race finishes, the winner's name and animations appear and then fade out.

The overlay applies the winner's personal Victory Style settings: name color, effect, font, entry animation, confetti, and victory FX. If the winner is in a global team their team badge also appears using the team's celebration settings.