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.

Jump to: BB Coins · BB Bets · Captain Games · Science Scores · Stats · Status · BB Masters · Askbot cheatsheet
💰 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.