Grab your target above, type a guid, or click 🔍 on a
Results value — see it live: name, position, health, faction and more, refreshing while connected.
✦
Assistant
Ask about your script, the Ess API, or an error. It can read
your editor, the game log, and — in agent mode — the wiki and the live game.
No AI provider is configured yet. OpenRouter's free tier works
(free account + key, pick a “:free” model — no card needed), or run a
local model with Ollama. Keys stay in this browser; nothing is proxied.
World map
hover the map for coordinates
clear
›
Examples
↑↓ navigate↵ insert / runesc close
Settings
Profile
Each profile is a full, independent provider setup — model, key, pack tier, everything. Keep one for a free local model and one for a paid frontier model, and switch between them.
AI provider
Reference pack
Context sent with each question
Advanced — tune this profile for its model
These apply to this profile only, so a 40k-context local model and a hosted long-context one can each be set up for what suits them. Defaults are good for most setups.
Ollama (local)
Sent per request on Ollama's native endpoint. The OpenAI-compatible shim ignores both, which is why these used to have to be environment variables.
Agent mode
Your key is stored in this browser and sent straight to the provider you choose. Nothing is proxied through mercs2.tools.
Changes save automatically.
That's a real taxi-fare minigame, built, edited, and deployed by you. Press the key you bound
it to in-game any time you want a new fare.
Where to go from here:
Ess.Player.giveCash(500) — pay yourself when a ride's done
Ess.Easy.Toast("...") — announce the fare on screen
the Examples tab — 45 more working scripts to pull apart
hover any Ess.* call in your code — the docs come to you
Not connected to a game
This editor runs your Lua in a live Mercenaries 2 session over the lua-bridge. To use it:
Install the WebSocket-capable lua-bridge mod and launch the game.
Make sure it's listening (default ws://127.0.0.1:27050).
Hit Connect — the dot turns green and you're live.
You can still write and save scripts offline; they'll run once you connect. Editor and API reference work with no game attached.
Still can't reach the game
After several tries the editor can't connect to ws://127.0.0.1:27050. Two common reasons:
The game or the lua-bridge isn't running — start them and this connects on its own.
Your browser is blocking it — some browsers refuse a hosted (https) page talking to 127.0.0.1. Chrome asks once and works if you click Allow; others block it outright.
The fix that always works: download the editor and open it from your disk. Same app, offline, no browser restrictions.