RINGO
Command reference

Every command,one line.

Ringo has no dashboard and no menus. Everything happens where your community already is — in chat. This is every command the bot answers to, what it does, and what your chat sees when you fire it.

Streamer · chat · moderator — one bot, one line each

01For streamers

Open and settle the round.

You run the round. One line opens it, one line closes it, and the overlay does everything in between.

!ringo create "your call" 100

Opens a prediction on your channel. The claim goes in double quotes — that exact sentence is what lights up the overlay — and the number is your stake.

"your call"
The claim you are making about your own stream. Keep it short and unambiguous — chat is reading it on screen while the pot fills.
100
Your stake. This is what you are putting behind the claim.
Example

!ringo create "I win this round with no damage" 100

The overlay opens on PREDICTION OPEN with your claim, and chat can start taking the other side immediately.

!ringo won · !ringo defended

Calls the round in your favour. The bot posts the verdict in chat and the overlay resolves; winners are paid without anyone claiming or signing.

In chat
The bot replies with your name and CLAIM DEFENDED, so the result is on the record even for viewers who missed the overlay.

!ringo lost · !ringo broken

Calls the round for chat. The bot posts that you conceded and CLAIM BROKEN, and everyone who took the other side gets paid automatically.

!ringo cancel

Closes the round early. What happens next depends on how far it got — this is not a blanket refund.

Nobody joined
The round simply closes and the overlay drops to PREDICTION CANCELLED.
Chat already joined
Only the unfilled part closes. Positions that are already locked in ride through to resolution as normal.

!ringo hide · !ringo show

Pulls the overlay off screen and puts it back, without touching the round underneath. Handy for a full-screen moment mid-round.

!ringo clear

Resets the overlay to its idle state.

02For your chat

Take the other side.

Nothing to install, no account to make, no wallet to connect. A viewer types one line and they are in.

!ringo join · !ringo join 25

Takes the other side of your open claim. Bare, it uses the viewer's default amount; with a number, it uses that amount instead. The pot on the overlay moves the instant it lands.

25 · $25
Optional, and the dollar sign is optional too — 25, $25 and $25.50 are all read the same way.
If it makes no sense
An amount the bot cannot read is ignored rather than rejected: the viewer simply joins with their default.

!ringo default 25 · !ringo default off

Sets the amount a bare !ringo join uses from now on, so a regular never has to type a number again.

off · clear · none · 0
Any of these four clears the default and puts the viewer back to deciding per round.

!ringo claim

One-time welcome credits, so a first-time viewer can play a round without putting anything in.

!ringo balance

Shows the viewer what they have to play with.

!ringo status

Shows the round in progress — the claim, how full the pot is, and whether it is still open.

!ringo help · !ringo

The short version of this page, in chat. Typing !ringo on its own does the same thing, and the reply changes depending on whether the sender can open a round or only join one.

03Anatomy

One command, four dials.

!ringo create takes optional parameters. Ignore all of them and it still works — every one is there for when you want a sharper round.

!ringo create "your call" 100 150

One number and both sides match. A second number sizes the other side on its own — here you put up 100 and chat's side is 150.

!ringo create "your call" 100 odds 2.5

Sets the payout multiplier instead of sizing the other side by hand. The multiplier has to be above 1.0, and the overlay shows it live so nobody has to work anything out.

What it means
A winning position pays your stake times the multiplier. At 2.5, a 100 stake returns 250.

!ringo create "your call" 100 no

Picks which side of your own claim you are on. Leave it out and you are backing the claim; yes and no let you say it explicitly.

!ringo create "your call" 100 @opponent

Turns the round into a one-on-one against a specific viewer instead of the whole chat. A handle inside the quoted claim is left alone — only a handle outside the quotes is read as the opponent.

Order and case

The quoted claim comes first, then the amounts, then the optional side and handle. Nothing is case sensitive: !RINGO Create and !ringo create are the same command.

04Who can run what

Two rings, one bot.

Moderators have exactly the same power over a round as the streamer. There is no command the streamer can run that a mod cannot.

Streamer or moderator
create · cancel · won · lost · clear · hide · show — opening a round and calling it are the privileged half.
Anyone in chat
join · status · balance · claim · default · help — everything a viewer needs is open to every viewer.
05If it goes wrong

Nothing breaks.

The bot is deliberately quiet. It never spams your chat and it never punishes a typo.

A malformed create

Forget the quotes or the amount and the bot answers with the format and waits: Try: !ringo create "your prediction" amount. Fix it and fire again.

A command it does not know

Ignored silently. Anything after !ringo that is not a real command produces no reply at all, so your chat never sees a wall of errors.

A viewer running a streamer command

The bot tells them only the streamer or mods can do that. Opening a round is quieter still — from someone without the role it is simply ignored.

A viewer with nothing to play

They are told, and pointed at !ringo claim for their welcome credits.

That is the whole surface.

Thirteen commands, no dashboard, no setup between you and a round. Drop the overlay into OBS once and every prediction after that is a single line in chat.