Available streamer commands

Quick and easy setup guide for Olden Era player stats in your live chats.

Quick answer

!oe <player> is a chat command that replies with one sentence describing the most notable stat currently true about that player across every tracked Olden Era ladder game. One minute setup with Nightbot and StreamElements.

See chat examples

viewer123: !oe easy2

😈 Favorite Victim. FEEDER is easy2's favorite victim in Single Hero: 34 wins in 50 tracked meetings (68.0% win rate).

Add !oe to your stream

Paste this into your Nightbot chat or the commands page in your Nightbot dashboard, then send it once to register !oe. Nightbot's built-in $(querystring) variable passes along whatever a viewer types after the command name.

!commands add !oe $(urlfetch https://townportal.gg/api/chat/player-insight?player=$(querystring)&source=nightbot)

Paste this into your StreamElements chat, or add it under Chatbot → Commands in your dashboard. $(customapi) calls the URL, and ${queryescape ${1:}} URL-encodes the first word a viewer types after the command.

!command add !oe $(customapi https://townportal.gg/api/chat/player-insight?player=${queryescape ${1:}}&source=streamelements)

Any bot that can make an outbound GET request can support !oe. Your bot needs to:

Capture the text a viewer types after !oe.
URL-encode it as the player query parameter.
Send GET https://townportal.gg/api/chat/player-insight?player=<encoded name>&source=<your bot>.
Post the response body — plain text, always under 400 characters — as the chat reply.

This describes what your bot needs to support to work with !oe — it is not a claim that any specific third-party bot beyond Nightbot and StreamElements has been tested.

What does !oe do?

Every tracked player is checked against 13 different possible stats — template loyalty and specialization, giant-killer upsets, head-to-head rivalries, win/loss streaks, comeback and tilt patterns, game-length specialization, and recent ladder momentum — across every ranked game mode at once. Only the single strongest, most notable one is returned; !oe never floods chat with a full stat dump.

Usage is simple: !oe <player nickname>. The nickname must match a name that has appeared on the Town Portal ladder, and is matched case-insensitively.

How Town Portal chooses the stat

A player needs at least 10 tracked games in some game mode before !oe will report a confident stat — below that threshold, chat is told exactly how many more games are needed instead of a potentially misleading result. Once eligible, every candidate stat is scored by how notable it is (sample size and how far it deviates from that player's baseline), and the highest-scoring one wins. If nothing crosses that bar, !oe reports that the player's tendencies are still unclear rather than forcing a weak stat.

FAQ

What does the !oe command do?

It looks up a player nickname from HoMM: Olden Era's ranked ladder and posts one short, ready-to-read stat about them in chat — like a win rate against a specific template, a win streak, or a rivalry with another player. It always returns exactly one sentence, picked as the single most notable thing currently true about that player.

Does it work with Streamlabs Cloudbot?

Not directly. Streamlabs Cloudbot has no equivalent to Nightbot's $(urlfetch) or StreamElements' $(customapi) variables, so it can't call an external API from a custom command today. Use Nightbot or StreamElements for !oe, or see the Other Bots panel if your bot supports outbound HTTP requests.

Why does it say a player wasn't found?

The name typed after !oe didn't match any player tracked on the Town Portal ladder. Check the spelling matches their in-game name exactly — the lookup is case-insensitive but does not guess at misspellings.

Why does it say there's a small sample size?

TownPortal only reports a stat once a player has at least 10 tracked games in some game mode — below that, results are too noisy to be a real insight, so the command reports how many more games are needed instead.

Is this free, and do I need an API key?

Yes, it's free and requires no account, API key, or authentication of any kind — the commands below work by pasting them into your bot's dashboard.

Does it work across all game modes (Single Hero, Classic, Arena)?

Yes — !oe searches a player's games across every tracked mode at once and returns whichever single stat is strongest, rather than being limited to one mode.

Troubleshooting

Nothing happens when I type !oe — make sure the command was registered (send the !commands add line once, not on every use) and that it isn't disabled or on cooldown in your bot dashboard.
It always says the player wasn't found — check the exact spelling of the in-game name; the lookup is case-insensitive but not fuzzy.
It says small sample size — that player has under 10 tracked games in every mode so far; the exact number still needed is included in the message.
The reply looks cut off — some bots truncate long messages on their own side; the API itself never returns more than 400 characters.

Related Resources

Ladder Leaderboard Example Player Profile

Enjoying TownPortal?

TownPortal is built independently. If our guides, rankings, player profiles, or community coverage are useful to you, help fund the next updates.

Support TownPortal