Biter Battles β€” Docs

Everything the website does, how the in-game askbot fits in, and how to log in. Click any section to expand.

πŸ”‘ Log in with askbot auth

Most website features (BB Bets trading, BB Coins transfers, admin actions on markets, future features) require being logged in as your in-game player. There are no passwords on the website β€” auth happens through the in-game chat bot.

Steps:

  1. In Factorio chat, type askbot auth (or /spectator-chat askbot auth during a captain game).
  2. The bot whispers you an 8-character token, valid for 10 minutes.
  3. Open biterbattles.org/science/bb-bets, paste your in-game name + the token, click login.
  4. You're now session-authed for 30 days as that player.

Requires 1+ day of total playtime. The token is one-shot and expires fast β€” get a fresh one if you take too long.

πŸ’° BB Coins β€” wallet, transfers, history

BB Coins are a soft currency earned passively for time spent on the winning team. They power the BB Bets prediction markets and can be transferred peer-to-peer.

How you earn coins

  • Win bonus β€” 1c per 4 hours of winning-team active playtime (engine-tick based). Captains: 5Γ— (winner) / 2.5Γ— (loser). Credited 5–7 min after a normal game ends, ~30s–2 min after a captain game.
  • MVP awards β€” top-3 voted contributors on each team, in games β‰₯ 25 min and avg 8+ players (top1 = 3Γ— rate, top2 = 2Γ—, top3 = 1Γ—).
  • BB Bets β€” winning trades, LP fee payouts, market resolution payouts.
  • Transfers received from other players.

Where to look

  • My account β€” your balance, transactions, open positions, PnL.
  • BB Explorer β€” global leaderboard, all transactions, top earners.

In-game commands

  • askbot coins β€” your balance.
  • askbot coins send <player> <amount> β€” peer-to-peer transfer (no fee).
  • askbot data <player> β€” public profile (PnL, last 10 transactions, win/loss bets).
πŸ“ˆ BB Bets β€” prediction markets growing fast

Polymarket-style binary & multi-outcome markets paying 1c per winning share. Mid-price = market-implied probability. Fully on-chain (BB Coins).

Live tools

  • Markets dashboard β€” list of all live markets, prices, volume.
  • Create a market β€” winner / duration / production / custom (1d+ playtime, max 2 concurrent custom).
  • Per-market detail page: live order book, trades timeline, holders table, your positions / PnL, fee + slippage preview before every trade. Click on the chart to set a limit price.
  • Admins logged in via askbot auth can resolve / cancel any market directly from its page.

Mechanics

  • AMM β€” constant-product reserves, share prices = pool ratios. Buy with coins, sell shares back, get instant fills.
  • Limit orders β€” placed at any price ∈ (0, 1c). Filled peer-to-peer when AMM crosses or another taker matches.
  • LP β€” add coins to a market's pool, earn 3% base + 3.0Γ—LVR dynamic fee on each trade (capped at 70% of trade size β€” over-compensates impermanent loss). Withdraw anytime.
  • Fees β€” 1% burn on every AMM trade + dynamic LP fee. Limit fills pay flat 4%. Always preview before clicking buy/sell.
  • Resolution β€” winner/duration auto-resolve at game end, production at game end or T-minute, custom is creator/admin-resolved.

In-game commands (read-only / non-fee)

  • askbot market list Β· info <mid> Β· orders <mid> Β· shares Β· myorders Β· burned
  • askbot market preview buy|sell <mid> <opt> <amt> β€” fee breakdown
  • askbot market create winner|duration|custom … Β· cancel <mid>
  • askbot market lp add|remove <mid> <amt|all>
  • Buy/sell/limit are web-only β€” type askbot auth first, then trade with fee preview.
  • askbot market help trade|lp|fees|create|info|admin β€” section-specific help.
βš”οΈ Captain games β€” picks, ranks, history

Organised PvP: two captains pick teams, fixed rosters, larger bonus rates. Streamed weekly with Ghostie on twitch.tv/og_gh0stie.

What's tracked

  • Captain Games page β€” full match history, top captains, top players (overall / special-only / normal-only), winrate leaderboard (default: trailing 365 days, 10+ games), top referees, side-balance stats, longest game.
  • Match cards show pick order topβ†’bottom, north then south, with green/red highlighting for the winning team.

Bonus rates (vs normal games)

  • Winning captain: 5Γ— base (5c per 4h active playtime).
  • Losing captain: 2.5Γ— base.
  • Non-captain on winning team: 1Γ— base. Losing team non-captains: 0.
  • Crediting is via captain_win_bonus.php, ~30s–2 min after game-end.

To register, watch the captain-game lobby in-game / Discord.

πŸ”¬ Science scores & efficiency leaderboards

The most-trafficked pages on the site β€” over 200k hits per category every 100 days.

Top per category

Aggregate / time-bounded

In-game commands

  • askbot science topscore Β· science <player> Β· challenge Β· challenge top
πŸ‘₯ Players online & stats

The "online" count is the canonical source: refreshed every 60s via RCON, stored in the po table. Used by the homepage counter and by the status page.

πŸ“‘ Server status

Status page β€” auto-refreshes every 30s.

Public sections

  • Factorio uptime, players online, last finished game.
  • Discord bots (radio TTS, hedwig, trustbot) state.
  • BB Bets / Captain reconciler health.
  • Tests state, network latency to NY/London/Paris/Frankfurt/Norway/Russia/Australia.

Admin sections

Visible only when logged in via askbot auth as a player in the Factorio admin list:

  • Long-running services + timer units (state, PIDs, last/next fire).
  • System metrics (CPU/RAM/network/connections charts), top UDP peers, mtr per host.
  • Recent journal errors (sanitized).
  • Reconciler lag, drift, DB stats.
πŸ† BB Masters tournament

The flagship competitive event. Organisation, brackets, schedule and replays live on the dedicated site:

bbmasters.net

Past BB Champions tournament site (bbchampions.org) is now offline.

πŸ“œ Askbot cheatsheet β€” every in-game command

Type these in the in-game chat. During a captain game, prefix with /spectator-chat to whisper the bot privately.

Auth & identity

  • askbot auth β€” get a one-shot token to log into the website.
  • askbot data <player> β€” public PnL / coins / bets summary.

BB Coins

  • askbot coins β€” your balance.
  • askbot coins send <player> <amount> β€” transfer.

BB Bets β€” read-only / informational

  • askbot market list Β· info <mid> Β· orders <mid> Β· shares Β· myorders Β· burned
  • askbot market preview buy|sell <mid> <opt> <amt>
  • askbot market help trade|lp|fees|create|info|admin

BB Bets β€” actions

  • askbot market create winner|duration|custom … β€” open a market.
  • askbot market cancel <mid> β€” cancel (creator if no trades, or admin).
  • askbot market lp add|remove <mid> <amt|all> β€” provide / withdraw liquidity.
  • askbot market resolve <mid> <opt> β€” admin-only force resolve.
  • Trading (buy/sell/limit) is web-only. Use askbot auth then the website.

Science / ELO

  • askbot science topscore Β· science <player>
  • askbot challenge Β· challenge top
  • askbot elo

Server / admin

  • /admins β€” list current admins.
  • /jail β€” for griefers (admin-only).

Something missing or out of date? Ping us on the Discord.