Marbles on Teams

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.

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. Clicking it opens the reward wheel which gives you a random cosmetic unlock.

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 4 slots unlock automatically when your team reaches 4, 8, 12, or 15 subscribed members.

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 will see the invite on their Teams page and can accept or decline. Only the captain can kick members from the team.

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.

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

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:

Reward Wheel

When you level up a Claim Reward button appears on your Dashboard. The reward wheel spins and lands on a random cosmetic unlock. If you roll a cosmetic you already have, you receive 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

Chat Commands Reference

Commands are enabled by the streamer from their Config page. What is available depends on which toggles they have turned on.

Bot Auto-Messages

These are posted by the bot automatically, not by viewers. Each one is a separate toggle in the streamer's Config:

• Show results in chat: posts a race or BR summary after each event
• Announce world records: posts when a new world record is set at the channel
• Team results in chat: posts how many points each team earned after each race
• Announce task completions: posts when one or more viewers complete a task in a race

Viewer Commands

Local Team Commands

Only available when the streamer has the Local Team Commands toggle on. See the Local Teams section above for the full list.

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.

Local Team Commands: one toggle enables or disables all 9 local team commands 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.

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.