Basics

Getting started

Install in a few minutes, then play with bots, play with friends, run a server or make something. Coming from 0.1? See what's new. Something not working? See Something's wrong?

What you need

  • Counter-Strike 1.6 or Condition Zero on Steam, the current version. Old retail or repacked copies can't run the mods (why).
  • Condition Zero's stock tutor tips are off on Loner-Strike servers (a mode's own hints still show); ls_cz_tutor 1 turns them back on.
  • Windows 10 or 11, or a Mac with the Windows version of Steam and the game in CrossOver (Mac setup).

Install

  1. Download Loner-Strike from lonerstrike.com: the -setup.exe on Windows (the .dmg on a Mac).
  2. Run it. If Windows says it protected your PC, click More info, then Run anyway (why). It installs for your Windows user, with no admin prompt, in C:\Users\<you>\AppData\Local\Loner-Strike.
  3. Close Counter-Strike: setup can't change the game's files while it runs.
  4. Open Loner-Strike. It finds your game (Steam's usual place is C:\Program Files (x86)\Steam\steamapps\common\Half-Life, and other Steam libraries are found too) and you pick what to install: about 2 to 4 minutes for the basics, 4 to 8 for everything (the fun maps take most of it).

Mac (CrossOver)

The Mac version of Counter-Strike can't run mods, so the game runs through CrossOver (paid, with a free trial):

  1. Install CrossOver in Applications.
  2. Make a bottle, install the Windows version of Steam in it, then install the game from there.
  3. Open Loner-Strike. It finds Steam in your bottles, and asks which one if there are several.

A folder you pick by hand must be inside the bottle's drive_c. With Parallels, install the Windows version of Loner-Strike inside Windows instead.

What setup installs

  • The mod loader: Metamod-P, AMX Mod X and ReGameDLL.
  • The bot brain: Loner-Strike's own bots, which play like people.
  • The Game Mode Menu on F3, which the app talks to.
  • The mods you pick. Change them later in Mods.

Replaced files are backed up, and mods only run in games you host.

Basics

What's new in 1.0

Everything from 0.1, plus the whole loop: build something, play it with bots, host it and share it.

Play

Build

A new Tools section (Beta):

Host

  • Servers update themselves when nobody's playing, and Linux servers are backed up daily.
  • New server tabs: Health, Who can join, Moderation and Stats.
  • Safer shared control, a tick rate setting, a mode rotation, crash tracking, and Discord alerts when a server goes down or crashes.

Share and connect

Every change is in the changelog.

Basics

Finding your way around

The app's sidebar, grouped the same way as a server's tabs.

The pages

GroupPages
GamePlay (mode, map, bots, presets), Bots, Rules (round time, money, friendly fire), Fun (gravity, unlimited ammo, auto bunnyhop), Add-ons, Rotation & extras
PeoplePlayers (heal, give, kick, ban, swap teams), Moderation, Stats, Admins, Welcome page
OnlinePlay with friends, Find servers
My libraryMaps, Mods, Skins & models, Sounds, Get more
HostingServers
Tools (Beta)The map editor, Game Mode Studio, every other tool, and Community
SettingsUpdates, phone access, your game folder, backup and restore, AI agents, help

Before and during a game

Bots, Rules, Fun and Add-ons can be set before a game; kicking bots or restarting the round need one running. The top bar says what you're changing: Your game, or Server: and its name, with Back to my game.

Shortcuts

Ctrl 1 to 9 jumps to the first nine pages; Ctrl , opens Settings (Cmd on a Mac).

On your phone

  1. In Settings, under Use on your phone, turn on Phone access.
  2. Scan the QR code with a phone on the same Wi-Fi. You can add it to your home screen.
  3. On Windows, set your Wi-Fi to a Private network, or the phone can't reach it.

Installing and removing only work on the computer. Sign out all phones is in the same place.

Notifications

Tell me when someone joins your game (in Settings, and on each server's Overview) notifies you on your computer. Player reports always notify.

Basics

Playing

Start a game

On Play, pick a mode and a map, set the bots, and start. The app opens the game (or restarts it if it's open) and loads straight in.

  • Presets set everything at once: Competitive 5v5, Arcade chaos, Zombie night and more.
  • Recently played starts a game you've played before.
  • Changes made while playing load on the next map, or the next round for round settings.

In the game

  • F3 (or /menu in chat): the Game Mode Menu, with modes, maps, bots and settings.
  • F4 (or /q): quick actions like restart the round, add or remove a bot, god mode, noclip, respawn, heal and $16000.

Both are for the host and admins. If F3 does nothing, type bind F3 gamemenu in the console.

The app's quick-action bar: Pause, Round (with Start a mode vote), Map, bots (Difficulty, Bot style), You, Announce and Record demo.

Game modes

Last Stand and Battle Royale come with their own maps. Zombie Plague, Warcraft 3, SuperHero, Gun Game, Deathrun, Surf, Paintball and the rest install from Mods; each is patched for bots, with a note on how well they play it. Switch modes from Play or F3 (the map reloads). Mode chat commands are under In-game commands.

The game can load only so many models at once. A map with more models than a mode leaves room for is skipped by that mode's map list, rotation and votes, and refused with a message if you pick it; if it loads anyway, the server switches to a mode that fits instead of crashing. To see the numbers, type gm_mapfit <mode> <map> in the server console (for example gm_mapfit basebuilder bb_aztec).

A Game Mode Studio mode can have settings its maker lets hosts change (points to win, round time and the like). They show under the mode on Play and on a server's Modes tab; each server keeps its own, and they apply from the next map or round. A value outside the maker's range is kept, with a warning.

A Studio mode's settings: points to win, seconds per point, whether the hill moves, and what happens when both teams are on it, two of them changed with Reset
A Studio mode's settings, as a host sees them (an example).

5v5 matches

Match mode runs warmup, /ready, a knife round for sides, and pauses, with a match panel on Play. Commands: 5v5 matches.

Basics

Maps

Browse

The Maps page shows every map you have, with pictures, search, map types, favorites and hidden maps. Open one to start a game on it or send it to your servers.

Downloaded maps work in both games. Condition Zero's own _cz maps only load in Condition Zero, so 1.6 leaves them out of lists, rotations and votes; Show lists them anyway.

Get new maps

  • Get maps downloads from GameBanana, with what each map needs.
  • Add a map file takes a .bsp or an archive (zip, rar or 7z).
  • Copy maps from your game, on a server, copies maps you already have.

Bots on new maps

Bots need two files per map:

  • Navigation (.nav): where they can walk, jump, drop and climb.
  • Map knowledge (.lsv): sightlines, cover, angles to watch and which walls bullets go through.

Maps that come ready

Maps Loner-Strike installs and the stock 1.6 maps (except de_survivor) get both files by themselves, checked every few hours; Condition Zero's come with Valve's nav. Only the exact map version gets them, files bots learned are replaced, and hand-made navs (with place names) are kept.

Any other map

A map you add is learned the first time it's played: a Learn this map banner shows on the Bots page and the map timer waits.

  • Navigation: a few minutes, or 15 or more for a big map on a slow computer. The game may seem to pause.
  • Map knowledge: in the background during the first minute or two.
  • Do it ahead of time. Teach bots maps on the Maps page learns several at once, and can Re-learn maps bots already know if they play one badly.

What bots know about your maps is shared with your servers.

When a download fails

  • GameBanana is busy: try again in a minute.
  • No map found in that download: it isn't a map, or it's for another game.
  • No longer on GameBanana: the author removed it.
  • Already installed: remove the old one first to install another version.

Basics

Mods, sounds and more

Mods

A game mode changes how the whole game plays; you switch between them. An add-on works on top of any mode and is switched on in Add-ons, like the grappling hook (bind it: bind v +hook).

  • Install and Remove each one. Removing puts back what it replaced.
  • Reinstall puts a mod's files in fresh. Didn't build needs Try again.
  • Repair puts Loner-Strike's basics back. Settings and mods stay.

Your own plugins

In Mods, Your own plugins › Add a plugin takes an AMX Mod X plugin; a .sma is compiled for you.

Skins and models

Skins & models lists the weapon skins, player models, sprays, effects, HUD and menus you installed, each with Remove (which puts the game's own back). Only you see them. Servers have their own Skins & models tab.

Get more

GameBanana's 1.6 maps, skins, models and sounds, with each page's terms shown first (Credits). Add from a file takes one you already have.

Sounds

  • Round-end music. Add tracks for your own.
  • Quake sounds (first blood, godlike and the rest), with two announcers. Off on a new setup: turn them on here or in Add-ons.
  • Sound packs: other sets of game sounds.
  • Your sounds from GameBanana, with Remove.

Sound changes load on the next map. The app also has a radio with eleven stations.

Game modes

Last Stand

Co-op against waves of creatures: everyone plays Counter-Terrorist and holds a base against zombies, runners, brutes, spitters and bosses.

ls_outpost from above: the walled courtyard, the keep and the armory
ls_outpost, the map made for it, in the map viewer.

Start it

  1. On Play, under Game mode, pick Last Stand.
  2. Pick a map from Maps for Last Stand: ls_outpost, de_dust2, de_inferno, de_nuke, de_aztec or cs_office.
  3. Press Play Last Stand on the map. Maps starting with ls_ pick the mode by themselves.

How a stand goes

  • About 45 seconds to get ready, then the waves.
  • Between waves (20 seconds): money, a supply drop, and the dead come back.
  • A boss every few waves. Endless by default (your best wave is kept); pick 5, 10 or 15 waves to play for a win.
  • You lose when nobody's standing, or the creatures overrun the base.

Holding the base

  • Barricades: hold E (use) on a gate's boards to repair them.
  • Reviving: hold use on a downed teammate. Getting someone up pays $150.
  • Buying: the buy menu works during waves, in buy zones. In the armory, B for weapons, or E at the counter (or /shop) for repair kits, armor, grenades, ammo and medkits, pricier each wave.
  • Grenades: carry up to 3 HE, 2 flashbangs and 1 smoke (hosts change it with lst_he_carry, lst_flash_carry and lst_smoke_carry).

Upgrades

  • Perks (up to 4): Tough (+50% max health), Quick hands (faster reloads and swaps), Double tap (+25% damage), Quick revive (revive others in 2 seconds; alone, get back up once) and Light feet (+10% speed). $1500 for the first, $1000 more for each one after. Look at a perk machine and press E; on maps without machines, the armory sells them. Going down loses them.
  • Upgrade bench (or the armory): the gun in your hands to Mk II ($3000, +40% damage), then Mk III ($6000, +90%, from wave 12).
  • Mystery box ($950): a random weapon. Look straight at it from close by and press E to buy. On maps without one, it's next to the armory; there, E on the shopkeeper always opens the shop.
  • Sentry turret ($2500 at the armory): press E where it should stand. It guards that spot for 150 seconds.
  • Traps: on maps that have them, pay at the switch to turn a gate's trap on for a while.
  • Power-ups: now and then a creature drops one, for the whole team. Walk over it within 25 seconds: Full resupply, Double pay (30 seconds), One-hit kills (30 seconds) or Airstrike.

Bots buy perks, upgrades and turrets too, once they have a rifle.

Knocked down

In a wave, a hit that would kill you knocks you down instead (with Revive time on). You lie on the ground with your pistol, a red pulse and a bar that counts down. Creatures leave you alone. A teammate holding E on you gets you up; when the bar runs out, you're out until the next break.

ls_outpost

Best for 4 to 16 players, and playable up to 32. A walled desert outpost at night with three barricaded gates (west, east, south) you can shoot through, a firing step creatures can't reach, the keep in the north as a last stand, and the armory shop. Supply drops land outside the west wall: take the ladder. Creatures can't climb. Players download nothing.

Settings

F3 (or say /ls) in the game:

SettingChoices
Waves5, 10, 15 or Endless (the default)
Wave difficultyEasy, Normal, Hard or Nightmare (with shared lives: 3, 5 or 10)
Revive timeOff, 15, 30 or 60 seconds
Base overrun after10, 15 or 25 seconds of creatures inside, or Never
Bots' last chanceWhen every person is down, how long the bots get to save it, or they carry on alone
ShopkeeperBarney, G-Man or nobody at the armory (from the next map)
Buy anywhereOff, or between waves
EnemiesCreatures, or knife-only zombie bots (from the next map)

Bots in Last Stand

Against creatures, every bot defends the gates, buys and repairs barricades. Against zombie bots, four defend and the rest are zombies. Make your own creatures and waves in Creature Studio.

Wave creatures hunt the defenders and never run away when hurt. Both can be changed for the whole mode or one wave (Creature Studio's Waves tab, or Game Mode Studio's Round Table On).

Game modes

Battle Royale

Solo or in squads: start with a knife, loot, and fight while the safe zone closes. Last one or last squad standing wins.

br_valley from above: a river valley with a town, a factory, farms, hills and bridges
br_valley, the map made for it.

Start it

  1. On Play, under Game mode, pick Battle Royale.
  2. Pick br_valley, de_aztec, cs_italy, de_dust2, de_inferno or de_train. Maps starting with br_ pick the mode by themselves.
  3. Bots fill the server. A game only starts once a person has joined.

How a game goes

  • Drop in: fall slowly through a thick haze (a short view, so nobody spots everyone from the sky) and steer with WASD; landing doesn't hurt.
  • Loot-up time: the start kit, and a few seconds when nothing can hurt anyone.
  • No buying: everything comes from crates, floor weapons and supply drops.
  • The zone closes in stages; the round clock counts down to each, and a horn sounds when it starts closing. Its edge is a storm wall, a purple storm fog hangs outside it, and it hurts more each stage.
  • Supply drops bring the best loot.
  • The end: the winner shows big on everyone's screen, and you see your place ("You placed #3 of 24 - 5 kills").

Finding the zone

  • The compass under the top line shows where you face; Z marks the safe zone's middle, and << or >> at an end means it's behind you that way. Outside the zone it turns red: OUTSIDE THE ZONE: go NE.
  • The zone line says where to go: Safe zone: 120 m NE (outside), Safe: inside the next zone too or Next zone: 80 m W (while the next circle is coming), Zone edge: 15 m (center N) near the edge, or In the zone.
  • When you're out, you watch a player (Space for the next) and still see the zone round them.

Loot and healing

  • Loot boxes: you can walk through them, so they never block a door. Hold E on one to open it. A box always gives you something you can carry, and says what you found.
  • Healing: bandages, medkits and energy drinks. Press F (or say /heal) to use one.
  • Armor comes in levels 1 to 3, for vests and helmets.
  • Loot glows by how good it is: white (Common), green (Uncommon), blue (Rare), purple (Epic), gold (Legendary).
  • The gear panel on the right lists your guns with their rarity tag ([C], [U], [R], [E], [L]) and ammo, your armor and your heals. It's on by default: say /gear hides or shows it, say /gearlist opens the full list.
  • Ammo is scarce: pick up ammo for the guns you carry.
  • Death crates: a player who's out leaves a crate; press E to take or swap what's in it.
  • The HUD shows who's alive, your kills, the zone and the next one (also on the radar) and a kill feed. When you're out, you can watch who got you.

Squads

  • Before the game, say /squad makes a squad, invites players, or shows its 4-letter code; friends join with say /squad CODE. Players on the same network are grouped. Everyone else is put in a squad when the game starts.
  • Duos and Squads are also their own modes in mode votes.
  • In Duos and Squads, a hit that would kill you knocks you down. Only your squad mates can get you up (hold E); other squads can finish you off. A squad is out when all of it is down.

br_valley

A river valley about 180 meters a side, with a town, factory, farms, a bunker (the best loot), radio hill (the best crate) and more, crossed by bridges, fords and tunnels. Best with 16 to 28 players; bots fill the rest.

Settings

F3 (or say /br):

SettingChoices
SquadsSolo, Duos or Squads of 4. Squad mates can't hurt each other.
Start withKnife, or knife and a pistol
Loot-up time10, 20 or 40 seconds
Zone starts after20, 40 or 90 seconds

Times scale with the player count, so small games are quick.

Bots in Battle Royale

Bots play by their playstyle: rushers and knifers hunt, roamers loot, campers, AWPers and lurkers wait. During loot-up they loot instead of fighting.

The bots

Bot styles

Who's in the lobby, picked on the Bots page.

StyleWhat it's like
Pub serverThe default: a few sharp players, most average, some bad
Newbie lobbySlow to react, spray and miss
Mixed lobbyEvery level, new to very good
LAN partyEvery level, lots of banter, play together
MatchmakingSolid players who work as a team
VeteransQuick, accurate, short bursts
Old-timersGood aim, slow, camp a lot, rarely talk
Locked InVery good and focused; bunnyhop between fights
HackersSuspiciously good; notice you from behind
GodsEverything maxed: nearly all headshots
OriginalThe game's stock bots, unchanged

Skill, style and personality

  • Bot style picks the kind of lobby (the table above).
  • Difficulty picks how strong it is: Easy brings that style's weaker players, Expert its strongest. A Pub server on Expert is a strong pub.
  • Personality sets how much each bot's character shows: Plain plays to the style, Normal lets each bot's habits lead, Exaggerated shows their quirks in full.

Each bot also has its own skill (reactions, aim, reading a fight, memory, decisions) and a playstyle:

PlaystyleHow they play
RusherPushes first, goes back in
RoamerWanders looking for fights
LurkerGoes round alone, catches you from behind
CarefulChecks every angle and holds
CamperPicks a spot and stays
AWPerHolds long angles with the AWP
KniferLoves the knife
NaderThrows lots of grenades
NinjaSneaks to the bomb when nobody's looking
ObjectiveBomb or hostages first
Odd gunsBuys what nobody else does

Every bot is someone

Bots tilt, panic when flashed and back off when outnumbered. About 1,600 regulars return with the same names, some in clans, and remember you (Bot people). They play as a team in 5v5 matches, Base Builder, and Classic with Matchmaking; elsewhere, like individuals on a pub.

The bots

How the bots work

Each bot sees, hears, aims and decides like a person in its place would, at its own skill and in its own style. Nothing is scripted per map.

The ideas behind them

Map study ahead of time, like Killzone and Quake III (sightlines, cover, angles, wallbang spots); the Unreal Tournament 2004 BotPrize goal of bots you can't tell from people; and F.E.A.R.-style decisions they call out in chat and voice. On top: each bot knows the map only as well as its skill, wallbangs follow the game's real rules, and you can give orders by typing or talking.

They only know what you would

No wallhack. A bot knows where you are only if it saw or heard you, saw the radar or kill feed, or a teammate called you out, and it forgets over time. Sounds give only a rough direction.

How they see

  • They see your body; better bots also catch a gun barrel or shoulder past cover.
  • Someone still, far off or at the edge of view takes longer to notice.
  • They turn from flashes they see coming. Smoke blocks their view.

How they aim

Like a hand on a mouse: a short delay, a flick that lands a touch off, then a correction. Better players react sooner and land closer.

How they fight

  • Each stops to shoot its own way: counter-strafe, walk, crouch, or run and gun.
  • They spread out, take cover, reload out of sight and pistol up close.
  • Better ones wallbang someone they know is there.

How they decide

After backing off, a bot remembers where the enemy was, then holds, takes another angle, goes back in with a teammate, goes round or falls back, weighing numbers, guns, health, ammo, the bomb and the clock. Newer players go more on nerves.

Playing as a team

Ts gather and take a site together; CTs hold, rotate and retake. They trade, call out what they see and follow your team chat and voice commands.

Who they are

Skill, playstyle and mood shape every choice, and the same bot plays the same way each time.

Every mode

Deathmatch and Gun Game: they play for themselves. Team modes: they play the objective, or save their gun in a lost round.

The bots

Bot settings

The Bots page, before or during a game. Reset bot and fun settings, at the bottom, restores the defaults and keeps the bot count.

How many

The Bots slider sets how many (each takes a player slot), with Add a Terrorist, Add a Counter-Terrorist, Kill all and Kick all beside it. Bot count mode keeps a fixed number, fills the server, or adds a number per human; if the count keeps changing, that's why.

Skill and style

SettingWhat it does
DifficultyEasy, Normal, Hard (default) or Expert (how it works). Changing it re-adds the bots
Bot styleWho's in the lobby
Auto difficultyAdjusts to how you're doing
PersonalityPlain to Exaggerated
Lobby moodFriendly, Normal or Toxic

Chat

SettingWhat it does
Bot chatOff, Now and then, Normal (default) or Chatty. Off means they don't listen either
Bot chatterRadio voice lines ("Enemy spotted")
Bots answer youThey answer and follow chat (what they understand)
Bots can be rudeOff by default
Dead bots' chatSeen by everyone, or only the dead
Bots stop to typeThey stand still a moment to type
Bot namesRegulars and clan tags, or the game's own
Players come & goBots leave and new ones join

Bots type with US spelling; bots from the UK use British spelling ("rubbish round that, come on lads").

The rest

Further down: how human they play, their quirks, and server life, each with a note in the app.

The bots

Talking to the bots

Type in team chat and they answer, or do what you ask.

How they listen

  • Wording close to the examples works. Start with a bot's name or nickname to ask just that one.
  • Each decides by personality: a lurker may ignore "rush b". A bot only says yes when it does it.
  • They also react to praise, trash talk and "gg".

What you can say

ForSay
Movinggo b, rush a, split a, everyone mid, go b slow, fake b, fall back, watch flank, follow me, trade me, come here, wait here, nvm
Buyingeco, force, full buy, someone buy me an awp, drop me an ak, give me the bomb
Grenadesflash for me, flash long, smoke mid, nade them
Calloutstwo long, awp mid, they're all b, bomb b, one short he's low
The bombplant b, plant here, go defuse, where's the bomb
Questionsmoney?, hp?, what gun?, how many left?, where'd they go, where are you?, who killed me, who has awp?, are they eco?
Just for funjump, crouch spam, spray that wall

The Bots page lists all of this under What you can tell the bots.

When they don't answer

  • Check Bots answer you is on, and type orders in team chat.
  • With Bot chat Off they don't listen at all. Set low, they follow orders but say less.
  • Lines starting with / or ! are commands, so bots ignore them.
  • Lots of lines in a few seconds make them stop listening for a bit.
  • A dead bot can't go anywhere, though it may answer.

The bots

Voice commands

On dedicated servers, bots understand voice chat like team chat: hold your voice key and say "rush b" or "Derek, flash for me".

Set it up

  1. Open the server's Bot voice commands tab. On this computer, click Install first: about 500 MB, once for every server here.
  2. Turn on Bots understand voice chat. On a Linux server this takes a few minutes.
  3. Join and talk on your team's voice chat.

Privacy

Speech becomes text on the server's machine; no audio is kept or sent. Heard lines are logged under What it heard. Only teammates reach the bots; muted players and filtered words are left out.

Remove it

On this computer, Remove in the same tab turns voice off on every server here and deletes the models. On Linux, turn the switch off.

When it doesn't work

  • The tab should say On, and listening, and What it heard shows each line it understood.
  • Nothing heard: check voice chat works for other players and sv_voiceenable is 1.
  • "Voice stopped by itself": turn it off and on. Its log under What it heard may say why.
  • "Port … on this computer is in use": close the program using it, or restart the computer.
  • "can't use sudo without a password" (Linux): connect as root, or give the user passwordless sudo.
  • Heard wrong? Speak a little slower and start with the order: "rush b", "flash long".

Create

The Tools

Everything for making things, under Tools in the app's sidebar. They're marked Beta while they settle in.

The Tools page: cards for every tool, grouped Create, Map tools, Personalize, Watch and inspect, and Share
Tools, with a card for each one.

What's in it

Getting around

  • Click a part of the top bar (Tools › Nav fixer › de_dust2), or Back, to go back.
  • ? shows the page's keys; / jumps to its search box.
  • Focus (Ctrl Shift Enter, Cmd on a Mac) hides everything but the tool.
  • A tool opens on the map you last used it on.

Your files are backed up

Tools back up game files before changing them; most have Put back the previous file in More. While they're Beta, keep your own copy of work you care about, and tell us on Discord when something's off.

Create

Map editor

Build maps with brushes and entities, like Hammer, in a 3D view. The map is checked as you go.

The map editor: tools down the left, br_valley in 3D, the outline and map settings on the right, the Content Browser below
br_valley in the editor: tools on the left, panels on the right and below.

Start a map

In Tools › Map editor:

  • New map: an open-sky room with two spawns per team.
  • Open a project (.lsmap), or pick from Recent.
  • Import a .map (TrenchBroom, or any GoldSrc editor) or Import from Hammer / J.A.C.K. (Importing).

Work is autosaved every 3 minutes, and each save keeps the one before. After a crash, the start screen offers Recover it.

Moving around

Pick a preset when asked (How should the 3D view move?), or later in View.

PresetHow it moves
UnrealHold right mouse to look; with it held, W A S D fly, Q/E down/up, Shift faster, scroll sets speed. Alt-drag orbits, middle-drag pans.
BlenderLeft-drag orbits, right-drag pans, scroll zooms. F flies with WASD; Esc stops.
HammerZ toggles mouse-look (WASD moves). Left-drag on empty space looks, right-drag moves forward and back.

In every preset, F frames what's picked, Ctrl 1 to 9 saves a camera spot and 1 to 9 jumps back. ? lists every key.

Views and panels

  • The editor bar: the menus, Find a command (Ctrl K), Save, Playtest and Publish….
  • Single, Quad, 1+3 and Two (Alt 1 to 4) set the views. Quad is 3D, Top, Front and Side, like Hammer.
  • Panels: Outline and Inspect on the right; the Content Browser, Gameplay, Textures, Checks, Compile and Project below. Drag tabs to move them. View has layouts and Reset the panel layout.
  • Each view's style picker also draws information, with a key in the corner: Collision (what blocks what: solid gray, CLIP orange, NULL red, triggers purple, ladders green, water blue, illusionary ghosted, model boxes as wireframes), By entity type, and Missing textures (magenta, to find them before you compile). G hides the editor's helpers (game view).
  • Help › Change keys… has Hammer's and TrenchBroom's keys.
  • New to mapping? Help › First map tour walks you through a first room, light, spawns and playtest.
  • View › Show frame time (Ctrl Alt Shift F) shows frames a second and slow frames, for judging big maps.
The Quad layout on ls_outpost: 3D, top, front and side views, a picked brush with its handles in the flat views
Quad: four views, like Hammer.

Building

ToolKeyWhat it does
SelectQClick to pick; drag a picked face to push or pull it
Move, Rotate, ScaleW E RDrag the handles
VertexVDrag corners, edges or faces (brushes stay convex)
BoxBDrag on a floor or brush to draw a box
ShapeCCylinder, wedge, spike, sphere or arch
ClipXClick two points; Tab picks the side, Enter cuts
EntityNClick a surface to place a spawn, light, weapon or anything
TextureTSlide, turn or stretch face textures; Alt-click picks one up
MeasureMDrag between two points
  • Snapping: 16-unit grid; [ ] change it, Alt ignores it.
  • Edit: Hollow (Ctrl H), Carve, Merge, Duplicate, Paste special… (a row, ring or spiral), Group, and Tie to entity for a door or func_wall.
  • Select: Select same texture, Hide (H), Hide everything else, Lock. Visgroups at the top of the Outline show and hide named sets (New visgroup).
  • Copy and paste work across maps and editors (as .map text).

Textures

The Textures panel shows the map's WADs (add more in Map properties). Click to choose; double-click or Shift T paints what's picked. Texture lock keeps textures in place when brushes move.

With faces picked, Inspect shows the face sheet: shift, scale and turn, Fit and Justify, Align to the world or to the face (good for slopes), Pick up a face's texture and Recent textures. With the Texture tool in the 3D view, right-click a face to paint the current texture on it, Alt-right-click to paint it and carry the picked face's alignment round the corner (like Hammer), and Alt-click to pick a texture up.

The map editor with the Texture tool on ls_outpost: a sandstone wall face picked, its stretch and turn handles in 3D, and the face sheet in Inspect with its texture, size, alignment, shift, scale and turn
The face sheet: a picked face's texture and how it lies.

Entities

Inspect shows a form for the picked entity, with help on every key; pick several to change them together. target → targetname links are drawn in 3D. A model, sprite or sound key has Choose…, ↗ (show it in the Content Browser) and Use selected. For a mod's own entities, add its FGD in Map properties › Entity definitions.

The I/O panel (What triggers what) lists every link (targets, multi_managers, masters and kill targets) and draws them as arrows. Show All, only Broken ones (a target no entity is named), or the Picked chain; the search box finds a name or a class. Click a row to pick it, double-click to look at it.

A model you place (a cycler_sprite) has a Collision setting in Inspect: None (walk through), Box, players only (an invisible CLIP brush fitted to the model), Box, players and bullets (the same box as a func_wall with NULL faces) or Custom (draw your own brushes). The box is made when the map compiles, from the model's bounds, scale and turn, so it follows the model; picked, it's drawn as a wireframe. A model dropped from the Content Browser starts as Box, players only; models already in a map keep what they did.

The game's own logic and moving parts are in the entity list too, each with help: random triggers (trigger_random), trigger_setorigin, the game_ rules (score, counters, team masters, player zones), env_global, momentary doors and wheels, trains on a path_track track, turrets (func_tank), health and armor chargers, and item and ammo pickups. Tracks, turret aim and what trigger_setorigin moves are drawn in the views, and the checks say when one can't work (a turret that never turns, an empty random target). game_end ends the map for everyone when set off.

The map editor on ls_outpost: a button fires a multi_manager that drops the east gate's boards and sounds a siren, its chain as arrows in 3D, the I/O panel listing the links below and the multi_manager's keys in Inspect
A multi_manager's chain: arrows in 3D, links in the I/O panel.

Content Browser

The map editor panel with Models, Sprites, Sounds, Textures, Prefabs and GameBanana. Open it from View › Content Browser (tab: Content) or as a drawer.

  • Where from: Everything, Game, Downloaded (by GameBanana page), Community, Mine (next to your project), Other, Favorites, Recent.
  • Play sounds with ▶, a double-click or Play on hover.
  • Import… (or drop files from Finder or Explorer) copies your own .mdl, .spr, .wav and .wad files into the project's folder (save the project first): they show under Mine and go with Playtest, Publish and remixes. Sounds can be .wav, .mp3, .ogg or .flac: they become a WAV the game plays well (22 kHz mono by default; Sound options picks the rate, 8-bit, stereo for 2D-only sounds and trimming silence), and the summary says what changed. Files are checked; a name that's taken gets a new one, and the game's own names are refused. Right-click a file for Show in Finder (Explorer on Windows) or Export…, which says whose work it is first.
  • Mine shows your project folder's subfolders (+ New folder). Drag a file onto a folder, or right-click for Rename…, Move to… and Delete…: the map's references follow (a model's texture and sequence files too), and one Undo puts files and references back. Delete says first when the map still uses the file. The game's, downloaded and Community files stay as they are; right-click one for Copy to Mine to make your own version.
  • Drag a tile onto the map: a model becomes a cycler_sprite, a sprite an env_sprite, a sound an ambient_generic.
  • Details show the maker, uses, Look in 3D, and a sharing badge: OK to share, Ask the author, Not allowed or Game's own (Credits).
  • Right-click: Find uses in the map, Add to favorites, Copy its path, Play.
  • GameBanana finds things to download, terms first. They land under Downloaded.

The content drawer (Ctrl Space; Cmd Shift Space on a Mac; Ctrl Shift Space with TrenchBroom's keys; also View › Content drawer) slides it up over the bottom panels; Esc or a click elsewhere closes it.

Prefabs

The Prefabs tab has starters (doorway, stairs, crates, bombsite kit, buy zone and more) and your own. Drag one in, or Place and click; R turns it. Save what's picked… makes your own; Community prefabs… finds more.

The Gameplay panel has Components (Loner-Strike's mode pieces, like wave spawners and loot crates) and Mode kits: set Made for to a mode, and it lists the markers and pieces that mode needs, with Place for each. The checks say what's missing.

Checks as you go

Checks finds broken brushes, limits, missing textures, spawns, files or targets, and what a mode still needs. Click a problem to go to it; most have a fix, like Place a CT spawn or Add halflife.wad and cstrike.wad.

Leaks show when you compile: a red line runs from an entity out to the hole, and a bar says which brush the gap is next to. Go to leak flies along the line and picks that brush; Pick brushes at the hole, Hide line and Forget it are there too. Map › Load pointfile… loads a line (.lin or .pts) from another compile.

The map editor after a Fast compile of ls_outpost with its sky lid taken out: the red leak line running up to the gap, the brush beside it picked by Go to leak, and the leak bar above
Go to leak flies to the hole and picks the brush beside it.

The game won't load a map with missing models or sprites. The Project panel lists every file the map uses, can Copy into the game or Copy next to the project, and Find missing files… searches a folder you pick.

Budget

Budget (in the panels, or View › Budget) shows how close the map is to the engine's limits: precached models and sounds (with the game's own share and a reserve for modes), brush entities, entities, edicts and textures as you build, and after a compile that map's own numbers (planes, clipnodes, faces, leaves, lighting). Green has room, yellow is over 75%, red over 90%. Click a bar for what uses the most, with the usual fix and Pick. Playtest and Publish ask first when a bar is red.

The Budget panel on br_valley: precached models at 90% in yellow, sounds at 64%, brush entities, entities, edicts and textures in green, and no compile yet
br_valley's Budget: models are getting close.

Saving and exporting

  • Save (Ctrl S) keeps a project (.lsmap) with groups, hidden things and the rest.
  • File › Export a .map… (Ctrl E) writes a Valve 220 .map with its texture list.
  • Publish… (in the bar or Map) packages a compiled map for you to upload to GameBanana.

A map you installed from Community is never compiled over: its updates would replace your changes. Compile it under your own name (Save as <name>_edit), or Remix it to get its editable source, credited to the maker. When the original of your remix is updated, the project's files and the map in Maps say so, with a link to see what changed. Your remix never changes by itself.

Next: compile and playtest.

Create

Compile and playtest

Turn your map into a .bsp and play it with bots, from the Compile panel or with F5.

The Compile panel after a Fast compile of ls_outpost with SDHLT: the quality, the Playtest settings, Compiled ls_outpost (0.5 MB) in 2 s, and the compiler's own output
A Fast compile of ls_outpost: the map and the compiler's output. (The first time, the panel offers to download SDHLT.)

The compiler

Maps compile with SDHLT, a free compiler (about 3 MB). The first time, Download SDHLT fetches it from its official GitHub release; its license is in the panel. On a Mac it runs through CrossOver in your game's bottle.

Compile

  1. Give it a Map name: letters, numbers, _ and -, up to 31.
  2. Pick the quality: Fast (no visibility pass, quick lighting, for trying things), Normal (for testing) or Final (full quality, slow on big maps).
  3. Press Compile and watch the steps.

Non-stock texture files are packed into the .bsp. Use all cores is faster but may make the computer lag.

After a Final compile, Teach bots and send to my servers puts the map in your game, teaches bots it, then copies the map and its bot files to every server you have. Bots build their map knowledge on each server the first time the map runs. A server that already has an older copy the app put there gets the new one; a server with someone else's map by that name keeps it. The summary says which servers got it and why any didn't.

When it finds a problem

Click a problem to pick the brush or entity it's about.

  • The map leaks: Show the leak line draws a red line from an entity to the gap. Close it with a brush.
  • Nothing inside: put a player spawn inside a sealed room.
  • A missing texture or texture file: add the WAD in Map properties, or replace the texture.
  • Too many faces or another limit: cover unseen faces with NULL, or simplify.

Compiler output has the full log.

Compile part of a map

Cordon compiles only what's inside the boxes you draw, sealed with sky or black walls. Nearby lights come along, and a playtest starts you inside.

Playtest with bots

  1. Under Playtest, pick the Mode and how many Bots.
  2. Leave Teach bots the map first ticked (about a minute).
  3. Press Playtest. It compiles, puts the map in your game (backing up any map with the same name) and starts it with bots.

F5 or Map › Playtest does the same from anywhere. Stock maps can't be overwritten: use another name. A missing custom model or sprite blocks the playtest (Checks); missing sounds or sky only warn.

After a playtest

Create

Hammer, J.A.C.K. and TrenchBroom maps

Open maps from other editors. The original file is never changed: saving makes a new project.

What it opens

FileFromHow
.rmf, .jmfValve Hammer Editor (3.x), J.A.C.K.Import from Hammer / J.A.C.K. on the start screen, or File › Import a Hammer .rmf or J.A.C.K. .jmf…
.mapAny GoldSrc editor, including TrenchBroomImport a .map

What comes over

Brushes, entities, groups, visgroups and paths. TrenchBroom's groups and layers come in as editor groups: a hidden or locked layer stays hidden or locked, a layer marked omit from export stays out of exports and compiles, and linked groups come in as separate copies. Export a .map… writes the groups and layers back, so the map opens in TrenchBroom as it was. Cameras, background pictures, the cordon and J.A.C.K.'s curved patches are left out, and the import says so, along with any missing models, sprites and sounds (Find missing files… in Project fetches them).

Texture files

Hammer and J.A.C.K. keep the WAD list outside the map, so the editor adds the WADs it finds beside the imported file, then in your game folders, and notes which. Still missing? Add them in Map properties, or put them beside the map or project.

Before you compile

Look the map over and open Checks first, and keep your original. If something came over wrong, send the file in a GitHub issue or on Discord.

Create

Game Mode Studio

Make a game mode from nodes, like Unreal's Blueprints: when something happens, check things and do things. The Studio turns the graph into a plugin, tests it on a hidden server with bots, and installs it.

Game Mode Studio on King of the Hill: My mode on the left with its events and variables, the round start and scoring part of the graph in the middle, Details on the right
King of the Hill, one of the example modes, open in the Studio.

Start a mode

In Tools › Game Mode Studio, start from a template (Rifle Reward, Last Stand, Battle Royale), one of the five example modes, or Blank mode. Name it and it's saved; Your modes lists them.

New to the Studio? The first time you open it, it offers a one-minute tour on the Infection example: the canvas, adding nodes, My mode, Details, the three checks, Playtest and Install. Not now or Don't show again skip it, and the ? menu next to Find has Take the Studio tour any time.

Game Mode Studio's start: the five example modes, the templates and Your modes
Start from a template or one of the example modes.

Make your first mode

Five minutes, start to finish: every kill gives the killer 300 money and a chat line.

  1. Start a Blank mode and call it Kill Bonus.
  2. Right-click the canvas (or press Space), type killed and pick Player Killed.
  3. Drag from its Attacker pin and let go on empty space: the list shows only nodes that take a player. Pick Give Money and set it to 300. Wire Player Killed's white flow pin into it.
  4. From Give Money's flow pin, add Chat Message with the text Bounty paid to, and wire Attacker into its Value.
  5. The Problems tab at the bottom should say no problems. Press Compile: the icon beside it turns green.
  6. Press Playtest. The game starts in your mode with bots, and the nodes light up as kills happen.
  7. Happy with it? Install adds it to Play and the in-game F3 menu.

A kill by the world (a fall) has no attacker, so nothing is paid: Give Money says so in the debugger. Add an Is Valid? before it to skip those.

The editor

  • My mode (left): graphs, Timelines, custom events, data tables, events, functions, macros, variables, structs, enums, map markers, snippets and My library. Drag a variable onto the graph to get or set it.
  • The graph (middle): the Event Graph and any other event graphs, plus a tab per open function, macro or Timeline.
  • Details (right): help and settings for the picked node, or the mode's name, description and game settings.
  • Results (bottom): Problems (click one to jump to the node), Compiler output and Test run.

Right-click anything for Rename…, Duplicate, Find uses, Save to my library… and Delete….

Nodes and wires

  • Right-click or Space opens the node list. It's in folders by kind (Players › Actions, Game › Settings…); typing searches titles, help and other words (gravity finds sv_gravity). Favorites (the star) and Recently used sit at the top. Arrow keys open folders and Enter places a node.
  • Drag from a pin to empty space to see only nodes that fit (Context Sensitive; untick it to see everything).
  • White pentagon pins carry the flow; round pins carry values, colored by type. Square pins hold files, a letter on an entity pin says what kind it is (C a creature, N an NPC), and # marks a whole number (types).
  • C adds a comment box, double-clicking a wire adds a reroute point, and Tidy up lays nodes out.

Over 650 nodes, for example:

KindFor example
EventsRound Started, Player Killed (weapon, headshot, distance, team kill), Player Hurt (hit where, weapon), Chat Command, Weapon Fired
FlowBranch, Sequence, Do Once, For Each Player, Switch, loops
PlayersGive Weapon, Set Health, Teleport, Respawn, Set Ammo, God Mode, Screen Fade
Game and WorldRound Number, Team Score, Change Map; Gravity, Round Time, Friendly Fire and the other settings, to read or set
Entities and effectsFind Entities, Spawn Prop, Get Entity Transform, Explosion, Beam, Play Sound At, Objective Marker, Remove Marker
Timers and the roundDelay, Repeat, Countdown, Timeline, Set Round Clock, End Round
DamageBlock Damage, Scale Damage (after Player About To Be Hurt)
MessagesShow Message, Show HUD Text, Chat Message, Menu, Play Sound, Status Icon, Kill Feed Line
Bots and creaturesBots: Goal, Bots: Friends, Bot Follow; Spawn Creature, Creature Go To (more)
ComponentsZones, crates, waves, supply drops, shops, perks, capture points
Data tablesGet Row, Get Cell, For Each Row, Find Rows
SavedNumbers kept between maps and restarts
TypesColor, Make Color, Blend Colors; Model, Sprite, Sound; As Player, As Creature, As NPC and the other casts

Icons, markers and the kill feed

  • Status Icon: shows, flashes or hides one of the game's own HUD icons (the buy zone cart, C4, the defuser, the rescue zone and the like) for one player or everyone, in a color, until they die or leave. It can only use icons every player already has; it can't show your own pictures.
  • Objective Marker: a sprite floating over something (a player, an NPC, an interactable, a component; it follows it) or at a spot, for everyone, a team or one player. Use one of the game's sprites or your own .spr, which goes with the mode when you share it. Remove Marker takes it away; it also goes when what it follows is gone. For your own pictures, use this instead of Status Icon.
  • Kill Feed Line: a line in the top-right kill feed (killer, weapon icon, victim, headshot). It's only the line: nobody dies and nothing is counted.

Model, sprite and sound inputs have Choose…: the game's files, Import… (or drop a file on the input), and files from your map projects, which are copied into your game when picked. Sprite inputs also have Make sprite…, which makes one from pictures and picks it. The picker previews it: a model in 3D, a sprite's first frame, a sound's play button. Files you add go into your game, so modes can use them; sharing packages them for you.

Files are values too: a Model, Sprite or Sound variable, table column or node. They're always picked, never typed as text, because the game loads every file a mode can use with the map. A file that isn't on the server is skipped and logged.

Engine nodes

  • Damage: Deal Damage hurts a player or anything that can be hurt (a breakable, an NPC, a creature) as if the Attacker did it, so kills, the kill feed and scores count. Pick the kind (burn, fall, blast…) and the hit zone (a head hit shows as a headshot).
  • Entities: Get/Set Entity Property reads or changes render mode, effect, color, amount, skin, body, scale, gravity, movement, collision, health and animation speed on any entity, so props and NPCs can glow or fade too. A player's movement and collision stay theirs (No Clip, Freeze). Play Animation plays a model's sequence; Attach To makes a prop or sprite follow a player or entity (or one of its model's attachment points) until Detach. Set Grenade Fuse changes when a thrown grenade goes off.
  • Messages: Big HUD Text (bigger text anywhere on screen, in a color, faded, flickering or typed out), Colored Chat (a green tag, then a team color, green or yellow; color codes in names never get through), Play Radio (the game's radio lines and announcer, to a player, a team or everyone) and Show Info Window (the message-of-the-day window with your title and text, [br] for a new line and [b] for bold; plain text only, never a web page). Too many big texts or colored lines in one moment are skipped, so the server never floods players.
  • Movement: Player Movement State (on ground, ducking, in water and how deep, on a ladder, speed), Push (along the aim, facing, a direction, away from a point or up: jump pads, dashes, knockback) and Jump Rules (block jumping or ducking, extra air jumps, auto bunny hop, each back to normal on death or at a new round if ticked).
  • Events: Grenade Thrown and Grenade Exploded (who, the grenade, its kind and where), Weapon Switched (the new and old weapon), Entered/Left Map Zone, and On Map Entity Fired: any named entity of the map being triggered or used, with who set it off, so a map's buttons, relays and timers drive a mode without an ls_event.
  • Game: Remove Map Objectives (buy zones, bomb sites, hostages, rescue, VIP and escape zones; the game notices from the next round), Map Type (bomb, hostage, VIP, escape or other), In Map Zone, and Voice Rules (everyone, teammates, dead with dead, or within a distance) with a per-player Voice Override. Mute Voice still mutes.
  • Rounds, votes and admins: Round End Rules keeps rounds going when a team is wiped out, when time runs out, or both (End Round still ends one; a new mode starts as usual). Start Vote asks a question with 2 to 8 answers and runs the winner's output, Tie or No votes; Vote Count reads the result. It never opens over the server's map or mode vote or another open menu. Has Admin Flag checks one flag from the admin list.
  • Hostages and bots: Hostage Follow, Hostage Stop and Is Following make hostages escorts on any map. Add Bots and Remove Bots use the bot brain's own commands, never more than the free slots; the host's bot count comes back at the next map.
  • NPCs: NPC Move To walks or runs an NPC to a point or an entity along the map's bot navigation (straight on a map without one), with Arrived and Failed outputs; NPC Follow Path goes through a list of points or a map's path_track chain (once or looping) with At point and Finished; NPC Stop stops it. Afterwards the NPC goes back to what it did, or stays there.

Node help

The ? menu next to Find › Node help, or F1 with a node picked, opens a panel beside the graph that explains every node: what it does, each pin and setting, related nodes, and a note when it's costly or needs care. Most nodes have an example: Add the example drops it into your graph. Search it like the node list.

Node help for Find Marker beside the graph: what it does, each pin, its settings and Add this node
F1 on Find Marker.

Variables, functions and macros

  • Variables: number, yes/no, text, vector, color, transform, player, team, a weapon, a file and more, per mode, player or team, kept for the map or reset each round. Lists and maps too.
  • Functions: reusable graphs with inputs, outputs and locals. They run straight through, so waiting nodes like Delay go in a macro.
  • Macros: copied in where used, with several flows in and out.
  • Structs group values (a loadout); enums are named choices (scout, tank, medic). A struct's field holds one value: a number, yes/no, text, a vector, a color, a file (model, sprite, sound or decal), a player, an entity or an entity handle (NPC, creature, projectile...), a team, a timer, a sound loop or an enum. For a list, make an Array of the struct.
  • Collapse to Function or Collapse to Macro tidies picked nodes.

Deleting a variable, function or custom event that's in use asks what to do with the nodes that use it (it says how many and where, with Find uses): Replace with another of the same kind (wires stay), Remove it and its nodes (the flow is joined up round them), or Remove it, keep the nodes. Each is one Undo.

Types and casting

A wire only connects pins whose types fit. The ones worth knowing (the full guide):

  • Color (red, green, blue, alpha), Transform (position, rotation, scale, velocity), Weapon, Hit Zone and Damage Kind, and the files: Model, Sprite, Sound, Decal.
  • Nodes that make a thing give it typed: Spawn Creature gives a Creature, Spawn NPC an NPC, Loop Sound a Sound Loop. These go into any Entity pin as they are.
  • From an Entity back to a kind takes a cast: As Player, As Creature, As NPC… each with Success and Failed. Drop an Entity wire on a Creature pin and the Studio offers Insert As Creature.
  • An enum into Switch on Enum gives one output per value: Player Hurt's Hit zone → head.

Modes from 1.0 open as they are and make the same plugin. If an update ever removes a pin you had wired, the wire stays on a red Orphaned pin until you re-wire or delete it.

Event graphs and custom events

  • Graphs in My mode adds more event graphs, to keep a big mode tidy (one for the shop, one for scoring). They're only for you: two of the same event, in different graphs, both run, in tab order.
  • Custom events are your own events, with inputs you choose. Call Custom Event runs every Custom Event node for it, from anywhere; Set Timer by Event runs one later or again and again.
  • A map can fire one too: tick The map can fire it, and in the map editor point a button or trigger at an ls_event entity with the event's name. Player is whoever set it off.

Timelines

A Timeline is values that change over time and events at set moments: a lifting platform, a pulsing glow, a 3-2-1 countdown. Add one under Timelines, add tracks (a number, a position, a color, or events), click to add keys and drag them. A Timeline node plays it: Update runs every tick with the tracks' values, Finished at the end, and each event track has its own pin. It can loop, reverse and jump to a time.

The Timeline editor: Hill Glow, 2 seconds and looping, with a color track from yellow to red and back, a Radius curve and two Beat keys
A pulsing glow: a color track, a number curve and event keys.

In a function with a Player input, each player gets their own copy. That's up to 32 copies, each ticking 20 times a second; the Quick check warns when that adds up. A Tick of 0.1 s still looks smooth.

Data tables

A data table is a grid of values to look up: a gun list, prices, waves. Under Data tables, add one and fill it in: each column has a type (number, text, yes/no, an enum, a weapon, an entity name, or a model, sprite or sound), and the key column names each row. Paste or import CSV… takes rows straight from a spreadsheet; Copy as CSV goes the other way.

The data table editor: Gun Game Lite's gun list with Level, Gun and Spare bullets columns
Gun Game Lite's gun list is a data table.
  • Get Row: the row with this key, every cell as a pin. Get Cell: one cell by row number (from 0).
  • For Each Row, Find Rows (where a column has a value), Row Count, Row Keys.

Tables are built into the plugin, so reading them costs almost nothing. A mode can have 16 tables of up to 16 columns and 256 rows. Gun Game Lite's gun list is a table: change the order there.

Snippets

Snippets has 14 ready-made pieces, like a wave system, shop menu, revive and shrinking zone. Click or drag one in; its variables join yours. Save the selection as a snippet makes your own.

My library

Save to my library… on a function, macro, struct or enum makes it usable in any mode; drag it in from My library. Modes using an older version offer Update from library in Details. Items and the whole library export and import as files. Library items can't go to Community yet.

Starter library

The Studio comes with ready-made functions and macros, listed in My library as built in and in the node search under Starter library. Adding one copies it into your mode, so change it however you like. Each one has a note over its graph saying what to wire into it, its settings (0 or empty uses the default it names) and what bots do with it. They use only the game's own sprites and sounds.

  • Movement: Double Jump, Dash (with a cooldown; wire Player Pressed Button in), Jump Pad (a trigger volume that launches players), Teleporter Pair (with a cooldown so nobody bounces straight back).
  • Abilities: Ability with Cooldown (a template for any ability, with Bot Wants Ability so bots use it in fights), Fireball (explodes where it hits), Proximity Mine (its owner can't set it off; bots keep away).
  • Pickups: Health Pack and Weapon Pickup on trigger volumes, coming back after a delay. They're offered to bots as pickups.
  • Player state: Spawn Protection (god mode and a glow, ended early by shooting), Lives Counter, and Burn, Slow and Freeze with timers.
  • Rounds and scoring: Kill Streak Announcer, Countdown HUD (minutes:seconds in big HUD text), Capture Zone (bots are sent to take it), Leaderboard Display (Top Players of a saved score in an info window).
  • Spectacle: Kill Cam (the victim sees the killer), Victory Camera, Hot Potato (bots chase the holder, and a bot holder runs).
  • Story: Quest Step Tracker, which pairs with Run Dialog.

Events stay in your mode: wire Begin Overlap (with the volume's name), Player Killed, Player Hurt or Round Started into the premade, as its note says.

Map markers

Under Map markers, list the spots, areas or paths a map needs for your mode, how many, and their keys; the marker nodes read them. Installing the mode makes a mode kit from them for the map editor's Gameplay › Mode kits and checks (more). Map advice tells mappers the size and player count that suit it.

Bots and creatures

Your mode can tell Loner-Strike's bots how to play it, and steer the creatures:

  • Bots: Goal gives bots something to do at an entity: defend or capture it, use it, loot it, or go and hold there, with a priority and for how long. Bots: Clear Goals takes them back.
  • Bots: Friends (teams, a tag, a player) and Bots: Tag; Bots: Phase (a loot phase where nobody is an enemy, then the fight); Bots: Don't Buy; Bots: Prefer Layer; Bots: Offer (something here can be bought or used for a price); Bots: Fight Creatures.
  • Bot Go To, Bot Hold, Bot Follow and Bot Free order one bot.
  • Creatures: Spawn Creature (health, tier, pay), For Each Creature, Nearest Creature, Can See, Creature Go To, Attack, Hold, Flee To, Resume AI, Set Creature Health, Remove Creature, and the Creature Idle event (one that has stood still: send it to the gate).

Bots still fight on the way and keep their own judgment: a goal is a strong suggestion, not a script.

Server commands: what's allowed

Run Server Command and Run AMX Command are power tools for what no node does yet. So that a shared mode can't harm a server, they only run commands that change the game:

  • Run Server Command: game rules (mp_ settings), gameplay sv_ settings (gravity, air control…), bot settings and commands, Loner-Strike's gameplay commands, say and humans_join_team.
  • Run AMX Command: slap, slay, kick, the say commands, amx_cvar on the settings above, and map changes to maps the server has.
  • Anything touching passwords, files, logs, plugins, rcon, configs or quitting is refused, and so is more than one command at a time (no ;), quotes and other tricks. The node's Ran pin says No and the debugger says why.

The same check runs twice: when you build the mode, and in the plugin as it runs (for commands put together from text). Modes that use these nodes, Kick, or Call Plugin Function say so on their Community page, in plain words, before anyone installs them.

Install and play

Install builds the plugin and adds the mode to Play and the F3 menu. More › Remove from the game takes it out, More › Show code shows the plugin, and Open in Plugin Studio carries on in code. To test as you build, use the checks and Playtest.

Share a mode

Package it from Tools › Community › Publish › A game mode and upload it to GameBanana (how). Only the graph is shared: each player's app builds the mode, so nothing that runs code travels. Your own models, sprites and sounds go with it wherever the mode names them (node settings, file variables, table cells). A mode that uses a power tool (server or AMX commands, kicking, calling other plugins) shows a badge for each, and players confirm before installing. Others can Remix in Game Mode Studio, which makes a new mode that credits yours.

Before you share: run a Test run, give it a clear description, and list the map markers it needs, so a mapper can make maps for it.

Create

Example modes

Five small, finished modes with a note on every part. Open one from the Studio's start screen to see how it's made, play it, or make it your own; they're also on Community.

ModeThe rulesWhat it shows
InfectionOne player turns zombie 15 seconds in. Whoever a zombie kills turns too; zombies come back. The humans win if anyone is left when the 3-minute clock runs out.Teams, a function (Infect), the round clock, ending a round once
Gun Game LiteFree for all. Each kill gives you the next of 14 guns; a knife kill after the last one wins. 2 seconds of God Mode on spawn.Per-player variables, a data table, spawn protection
King of the HillHold the hill (a capture point) to score a point a second; the first team to 120 wins.Components, a map marker with fallbacks, a Repeat timer, team scores
One in the ChamberA deagle with one bullet that always kills; a kill gives another. Three lives; last one standing wins.Ammo, changing damage, lives
JuggernautOne big, slow, tough player with a machine gun. Whoever kills them becomes it; 20 points win.Player looks, a bonus, bots told to hunt

Each one passes all three checks and was played with 12 bots before it shipped.

Create

Checking a mode

Three checks, from instant to real: the Quick check as you edit, Compile with the real compiler, and a Test run on a hidden server with bots.

Quick check

Runs as you edit. Problems lists what won't work (a pin that needs a wire, a node nothing runs, a setting that's out of range) and what will cost the server (a scan on every hit, a fast timer with messages in it). Click a problem to jump to its node. Errors stop a compile; warnings don't.

It also says when bots won't know about something they could use: an interactable with Bots may use off, or an NPC the mode talks through, with no Bots: Offer or Bots: Goal at it. Things the components tell bots about by themselves (capture points, extraction zones, checkpoints, loot, supply drops, perk machines, benches, mystery boxes, traps) aren't listed. The warning has a button that fixes it (turns Bots may use on, or adds a Bots: Offer after the NPC; Undo takes it back) and Don't warn for this one.

Compile

Compile (Ctrl+B or F7) runs the real compiler without installing anything or starting the game. The icon beside it: gray, not compiled since your last change; green, compiled; yellow, warnings; red, errors (click it for Problems). Compile on save does it in the background each time you save.

Test run

Test run plays the mode on a hidden server of its own, with 8 bots, for about two minutes: a stretch without the mode (to measure the server), then the mode, a round restart and a map change. Your game isn't touched, open or closed. It reports:

  • Pass, Warn or Fail, and why.
  • Errors while it ran, tied to their nodes, and a crash if there was one.
  • How heavy the mode was against the server without it, and the busiest nodes.
  • Nodes that never ran (fine for things the bots didn't do, like buying).

The log is under Copy the log. The toolbar says Tested ✓ until you change the mode.

Why won't it compile?

  • The Quick check has errors. Fix those first: Problems lists them, red, with the node.
  • Pick a variable, table, Timeline or custom event. A node that names one needs it set in Details.
  • A pin needs a wire. Required pins (often Player) have nothing to fall back on.
  • The flow loops back. Wires can't go round in a circle: use a loop node, a Repeat or a custom event.
  • A red Orphaned pin. An update removed that pin: re-wire or delete the wire. View › Refresh nodes lists what an update left behind.
  • A compiler line not tied to a node. That's our fault, not yours: More › Show code shows the line, and please report it.

It compiles, but nothing happens

  • Run a Test run and read nodes that never ran: the event above them didn't happen, or a condition went the other way.
  • Playtest and watch the nodes light up; put a breakpoint where it should run.
  • Give Weapon and friends say in the debugger why they did nothing (dead, already has one, nobody there).
  • A setting the game sets again each map (the bomb, mp_give_player_c4) can't be changed from Game settings: take the bomb with Remove Weapon (C4) at Round Started instead.

Create

Playtest and debug a mode

Playtest

  1. Pick a map and the number of bots in the Studio's toolbar.
  2. Press Playtest (F5). It saves, compiles with the debugger and starts the game in your mode, showing each step, with Cancel. Fix anything under Results first.
  3. If the game is open, Switch the open game changes the map and keeps the bots.

The first start can take a minute. The panel says Playing on the map once connected.

Watch it run

  • Nodes light up as they run and wires show the last flow. False conditions and errors are marked.
  • Hover a pin for its last value. A playing Timeline shows its time, direction and each track's value.
  • Details › Last time it ran: how often, the result and the inputs.
  • What happened lists the last 40 things that ran.

Breakpoints

Click a node's dot, or F9, to pause the world when it runs. Live values shows the round, time left, who's alive, your variables and each player's health and weapon. Resume carries on. There's no stepping node by node.

Change values while it plays

In Live values, Change next to a variable (a number, yes/no, text or enum; for the whole mode, a player or a team) sets it in the running game at once, with no recompile: tune a speed, a price or a timer while you watch. What happened logs each change. Use as start value copies the value into your graph as the variable's start value, so the next build starts with it. Changes only reach a Playtest (the debugger's build), never an installed mode.

Good to know

  • Menus need a person to answer: bots won't.
  • Up to 2000 nodes and 64 variables per mode. How much a mode may do at once (effects, loops, things out) is under its Limits settings (Limits).
  • Component and creature nodes need Loner-Strike's mode pieces on the server (your own game has them).
  • The Playtest build records every node it runs, so don't judge the mode's speed by it: Test run measures the real build.

Create

Plugin Studio

Write AMX Mod X plugins with suggestions and docs as you type, and try them in your game in a click.

Plugin Studio: the game's plugins listed on the left, antiflood.sma open read only, compiled with no problems, and the Problems, Game log, Compiler output and Help tabs below
Plugin Studio, with one of Loner-Strike's own plugins open read-only.

Community doesn't take plugins. To share one, post its .sma on GameBanana or AlliedModders yourself (Export… saves the .sma and its own .inc files where you pick; Import… brings .sma and .inc files into My plugins and never overwrites one). To share a mode here, make it in Game Mode Studio.

Your plugins and the game's

  • My plugins are yours. New plugin starts from a template: empty, game mode, chat command, on player killed, items on spawn, HUD message, menu or timer.
  • Game's plugins and Include files are read-only; Save a copy in My plugins… to change one.
  • More › Restore a previous version… brings back an earlier save.

Writing

  • Suggestions come from your game's include files.
  • Hover a function for its docs; F12 (or Ctrl-click) goes to its definition.
  • / at the start of a line, or Insert…, adds snippets.
  • Help & docs searches every function, with Put it in my code.

Compile and try it

  1. Compile (Ctrl Enter). Errors are explained, marked on their lines and listed under Problems.
  2. Try it in my game compiles, installs it and restarts the map. Game log shows its messages.
  3. Take it out removes it.

This works on your own game, not servers. Plugins can't go to Community; Game Mode Studio modes can.

loner.inc

Loner-Strike's include file has short ways to do the usual things. #include <loner> just works in Plugin Studio.

ForNatives
Modesls_register_mode, ls_mode_active, ls_mode_current
HUD and chatls_hud (four slots other plugins don't wipe), ls_announce, ls_chat
Playersls_give_weapon, ls_strip, ls_set_health, ls_set_armor, ls_teleport, ls_set_team, ls_count_alive
Rolesls_set_role, ls_is_role, ls_count_role
Timersls_after, ls_every, ls_stop, ls_countdown
Botsls_is_bot, ls_bot_goto, ls_bot_hold, ls_bot_follow, ls_bot_release
ComponentsZones, doors, waves, loot and more, with forwards like ls_on_wave_start and ls_on_capture

A whole mode in a few lines:

#include <amxmodx>
#include <hamsandwich>
#include <loner>

public plugin_init()
{
	ls_register_mode("deagleduel", "Deagle Duel", "1.0", "me")
	RegisterHamPlayer(Ham_Spawn, "on_spawn", 1)
}

public on_spawn(id)
{
	if (!ls_alive(id) || !ls_mode_active())
		return
	ls_strip(id)
	ls_give_weapon(id, "deagle", 35)
	ls_set_health(id, 150)
	ls_hud(id, LS_HUD_LEFT, 5.0, "Deagle Duel^nLast one standing wins")
}

Full reference: LONER-INC.md on GitHub, also under Help & docs.

Create

Creature Studio

Make the creatures modes throw at you (zombies, aliens, animals, turrets, bosses) and their waves.

Creature Studio: creature types on the left, the zombie's settings in the middle, its model playing an animation on the right
A creature type, with its model in the preview.

Creature types

  1. Pick one of the eight built in (zombie, runner, brute, spitter, hound, turret, boss, headcrab), or New from a template… or Duplicate.
  2. Change Look (model, size, tint, blood), Health and speed, Senses, Attack (melee or ranged, damage, rate), Behavior, Sounds and Rewards. The preview plays its animations.
  3. Save and apply to game. With the game running, Spawn one in front of me tries it.

Behavior: stand, wander, patrol, guard, horde or keep away; target the nearest, weakest or last attacker; flee when hurt or not. New models and sounds load on the next map.

Models: CS player models (gign, terror…) aren't supported for creatures yet: they'd stand in the floor. Use an NPC for human characters, or a Half-Life-style model (like hgrunt).

Waves

In Waves & spawn groups, pick the mode, then set the Boss and how often it comes, enemies and health per wave, and The mix of creatures per wave. Start from the mode's own mix is a good start. Save waves; Place in map… opens the map editor to place spawners.

Creatures hunt players (on by default) sends every wave creature after the defenders; off, each type keeps its own aggression. Flee when badly hurt is Never by default; Creature's own uses each type's flee point. Set both for the whole mode, or for some waves in the These waves column. In Game Mode Studio they're settings on Round Table On.

How creatures work

  • What it edits. The Studio changes creatures.ini and waves.ini in the game picked at the top: your Counter-Strike 1.6 or Condition Zero, or a server on this computer. Servers on another computer can't be edited from here.
  • When changes apply. After Apply to game (the running map reads your types again) or the next map change. New models and sounds load with the next map.
  • Waves. The Waves tab starts from Last Stand's own lineup. Saving makes this game's Last Stand use your list. Reset to Last Stand's own removes your list, and the mode goes back to its own.
  • Who gets them. Only games you host from this computer use your creatures. Nothing is sent to other players or to servers elsewhere.
  • Sharing. A map, mode or prefab you publish carries the custom creatures it uses (and their custom models and sounds); Publish lists them ("Includes: crawler (with its model)"). They're named for your GameBanana account, so they never clash with anyone else's, and people see them as "crawler by you". In Creature Studio, Share… publishes one type on its own; Remix… on someone's type makes your own copy that credits them.
  • Your servers. Send to servers… puts your own types (with their models and sounds) on servers of yours, here or on another computer. Each server shows which of your types it has and whether they're up to date, with Update and Remove. A server's own types are never changed.
  • Your own models and sounds. The model and sound pickers have Import… (or drop a file on them) and list what's in your map projects. Files you add go into your game, so creatures and modes can use them; sharing packages them for you.
  • What installing does. Shared creatures go into their own marked block in creatures.ini; your own types are never touched. Uninstalling removes only that block, and a type two installs share stays until both are gone. Updates and Go back swap the block too. Servers you put the map or mode on get the same block.

Create

NPCs and interactables

Characters people talk to, and things they use with E. They work in any map with Loner-Strike's components; Game Mode Studio adds dialog choices on top, for story or RPG modes.

Two good places to start: the example mode The Quest Giver, and Run Dialog from Game Mode Studio's My library (below).

In the map editor

  • NPC (ls_npc): a character with any model (barney, gman, scientist, or your own .mdl), a name, a behavior (stand, wander, patrol, follow after a talk), an optional greeting, who can talk to it, and Unkillable (on by default: bots never shoot it). Pressing E on it starts a talk and sets off its On talk target.
  • Interactable (ls_interactable, or ls_interactable_brush for a brush): a lever, terminal, note or pickup. It shows its prompt when someone looks at it up close ("Press E to open"), has a cooldown, works once or every time, can be for one team only, and sets off its target: doors, buttons, a multi_manager. No mode needed. Turn on Bots may use and bots press it now and then on their own, when things are calm.
  • Both show their model in the 3D view; Checks flag a missing model or an empty name.

In Game Mode Studio

  • Events Talked To NPC (player, NPC) and Used Interactable (player, entity).
  • Say: one line from an NPC or a narrator. Say and Choose: a line and up to 6 replies; one output per reply, plus Timed out and Walked away (closed on death, leaving, or walking off), and the chosen reply as a number. Its texts and the number of replies can come from wires.
  • The example The Quest Giver: an NPC asks you to find his note; you pick it up, bring it back to him, and he pays. Two per-player flags keep track.
  • Bots: an interactable needs Bots may use on; for an NPC your mode talks through, add a Bots: Offer or Bots: Goal at it. The Studio's checks say when bots won't know about one.

Dialog from a table

A whole dialog tree can be a data table (one row per line: the text, the replies, and which row each reply goes to) plus a macro that reads a row, runs Say and Choose, and goes to the row the chosen reply names.

It comes with the app: in Game Mode Studio's My library, add the built-in Run Dialog. It brings the Dialog table (columns id, speaker, line, Reply 1-6 and Next 1-6, with a 5-row sample conversation to change) and the macro: wire Talked To NPC's player and NPC into it with the id of the first row. Each reply goes to its Next row; end (or empty) ends the talk. A Next that no row has ends it too, and Problems names it; a talk stops after 64 lines in case the table goes round in a circle. Ended runs once, with the row it stopped at.

Sharing

An NPC's own model and sounds go with the map or mode you publish, in your own folder, the same way shared creatures do.

Map tools

Map doctor

Check a map's files without playing it, and fix what's missing. To see how bots play it, use the Map simulator.

Map doctor on de_dust2: every check passed, grouped by map and files, textures, download list and bots
  1. Pick a map. The list marks ones with No bot nav.
  2. Needs a look shows only problems; All checks covers the files, textures and WADs, download list (.res), the bots' nav, places and knowledge, and the overview.
  3. Use each fix: copy missing files from another game folder, Make the list, Teach bots this map, Search GameBanana, Name places or Make one (an overview).
  4. Fix all safe does the harmless fixes at once. Check again when done.

Map tools

Map simulator

Bots play a match on a hidden server for a few minutes. The report shows on the map where they fight, die, fall, get stuck and never go, who wins rounds, and any errors.

The Map simulator's report on de_dust2: 10 bots for 3 minutes, Looks fine, and the map colored by where bots went, with pins for fights
  1. Under Simulate a match, pick a map with a bot nav (teach bots the map first if needed).
  2. Pick the Game mode, How long (2 to 15 minutes; longer is fairer) and how many Bots.
  3. Close the game and your servers, then Run the simulation. You can leave the page. With no server on this computer, it makes a hidden temporary one from your game's files and removes it afterward.
  4. The verdict: Looks fine, Worth a look or Problems. Watch in Replay beside a finding opens the moment, following that bot. Stuck means trying to move but staying in one small spot for 8 seconds; holding an angle, camping, planting and defusing don't count.
  5. The map: Where bots went, Where they died, Where kills came from or Where nobody went, with pins for falls, stuck spots and big fights.
  6. Rounds and sides and Where fights happen show balance and choke points.
  7. Watch in Replay to see it. Earlier runs stay listed.

A good run earns the Checked with bots badge in Community.

Map tools

Callouts

Name places on a map, so bots say where they are and understand where you mean.

Callouts on de_dust2: the map from above, painted in colors by place, with the list of places on the right
  1. Pick a map with a bot nav.
  2. Type a name (like Catwalk) and Paint (P) it on; Erase (E) takes it off. Or start from Suggestions: bomb sites and spawns, the usual callouts, or Condition Zero's.
  3. Save names. The bots' map knowledge stays as it is.

New names go into the game's place list (BotChatter.db, backed up first), so they work in chat and orders like "go catwalk", and on servers you send the nav to. Only names with a voice line (🔊 in Names bots know) are said on the radio.

Map tools

Radar maker

Make a map's overview, the top-down picture spectators and HLTV viewers see (not the round radar you see while alive).

Radar maker on de_dust2: the overview drawn from the map with the bomb sites marked
  1. Pick a map and a look: Game, Clean or Simple.
  2. Choose what's drawn: bomb sites, buy zones, hostages and spawns, outlined walls, roofs or not.
  3. Compare it side by side with the installed one.
  4. Install overview. Put the old one back restores the old files; Send it to players adds it to the download list.

Personalize

Crosshair & config

Your crosshair, keys, mouse and connection settings, with a live crosshair preview.

Crosshair and config: a live crosshair preview, presets, and the crosshair settings
  1. Pick CS 1.6 or CZ.
  2. Optionally start from a preset (The game's own, Pro, Classic 2004): it sets crosshair, connection and weapon switch, and keeps your keys and sensitivity.
  3. Use the tabs: Crosshair, Keys (press a key's button, then the key), Mouse, Network, Video & HUD.
  4. Save. It writes its own block in userconfig.cfg, keeping your lines; config.cfg isn't touched.

More › Take out Loner-Strike's lines removes it. F3 and F4 stay Loner-Strike's menus.

Personalize

Bot people

Decide who the bots are (more).

Bot people: kinds of people on the left, one kind's name, how common it is, how it chats and plays, and its traits
  • Kinds of people: name, how common (per 100 new bots), how it chats and plays, and fixed or rolled traits. Add, Duplicate, Remove.
  • How common traits are: a slider each, and Never together for pairs.
  • Regulars' names: who has which. Fresh names for everyone starts over.

Save applies straight away; name changes show from the next map. More has Import…, Export… and Start from Loner-Strike's.

Personalize

Spray maker

Make your spray from pictures, words and stickers, and see it as the game draws it.

Spray maker: a spray with a pink splat, a crown and the word NAME, stickers on the left and the layers below them
  1. Designs & templates…: your designs and 16 templates.
  2. Add a Picture…, Words or a sticker and arrange them. Pictures can lose their background; every layer has Opacity.
  3. Check it In game on a plaster, sandstone or crate wall. Only a one-color spray lets the wall show through; full color is always solid.
  4. Install spray for the games you tick. Put back the previous one undoes it.

Watch & inspect

Map viewer

Walk around any map: spawns, doors, triggers, the bots' nav and what they learned.

The map viewer on de_dust2 with the bots' nav drawn over the map and places named
de_dust2 with Bots' nav on.
  • Camera: Orbit, Fly or Top-down.
  • Show: textures, lighting (Like the game or Bright), spawns and items, doors and breakables, triggers and zones, Bots' nav. With the nav on, What bots learned shows cover, sightlines, wallbang spots, corners and angles.
  • Click anything to see what it is, or find it in In this map.
  • Go to takes coordinates or a link. Keep this view, Picture and Copy link save the spot.

Watch & inspect

Replay

Watch a recorded bot match in 3D: where every bot went, why, and where it fell.

Replay with a Map simulator match on de_dust2 open: the map in 3D with a bot's trail, the timeline with its kill marks, and the list of players
  1. Pick a recording (the Map simulator makes them), or Open a recording….
  2. Play at up to 16x. The bar marks rounds, kills and falls.
  3. Click a player to pick them; double-click to Follow.
  4. Heat map: time spent, deaths or stuck spots.
  5. With a bot's trace recorded, read why it did what it did.

Watch & inspect

Demos

Your demos and your servers' HLTV ones, in one list.

Demos: three short bot rounds on de_dust2 in the list with their length, date and size; the first one picked, showing its map, server, length and the players seen, with Watch and Show my path in Replay
  1. Sort, filter (All, Recorded in game, HLTV) or search; pick one for who played and where.
  2. Watch it (a server's demo: Copy to my game and watch; with the game open you get the console command). Show my path in Replay draws where you went.
  3. Rename, show in folder (Explorer), or Delete. The game only plays demos with plain names.

Record with the app's Record demo button, or turn on HLTV on a server.

Watch & inspect

Textures & models

Browse every texture and model in your game. Browsing changes nothing.

Textures and models: the AK-47 view model in 3D with its animations and textures listed
  • Textures: search every WAD, see where a texture comes from and which maps use it, Save as picture…. Make your own… turns a picture into a texture. Make sprite… turns one picture, or several as animation frames, into a sprite (.spr): pick the size (a multiple of 8, up to 512), how it faces you, how it's drawn (normal, glow, see-through color or one color) and a clear color, with a live preview; it goes into your game's own sprites.
  • Models: players, weapons (in hand, carried, on the ground) and hostages, in 3D with animations and skins.
  • Get more: Add a WAD…, Add a model…, or download from GameBanana. A replaced file comes back when you remove yours.

Multiplayer

Playing with friends

Friends only need Counter-Strike, not Loner-Strike. Your server sends them the maps, sounds and models.

Your game is the server: when you quit, everyone drops. For bigger groups, run a dedicated server (which?).

Play with friends sets your server's name and join password, and walks you through one of these:

WayWhen to use it
This networkSame Wi-Fi, or a LAN party
DirectInternet, through your router (the app opens the port)
playit.ggInternet, nothing to open on your router
Tailscale, ZeroTierA private network with your friends
Radmin VPN, HamachiClassic LAN over internet (Radmin: Windows only)

Trouble? See Friends can't join.

Find a server to join

  • Internet: servers other Loner-Strike players listed.
  • Favorites and History: saved or played on.
  • LAN: games on your network.

Connect or double-click to play; filters narrow the list. To list your server, turn on On the Loner-Strike server list in its Who can join tab.

Multiplayer

LAN party

Everyone on the same Wi-Fi or router finds your server in the LAN tab, with nothing to install.

Your game or a dedicated server

Host fromBest for
Your gameA few people, quickly. Ends when you quit
A dedicated serverBigger parties or a whole evening: it runs on its own, so nobody drops when you leave

From your game

  1. In Play with friends, pick This network, a server name and, if you like, a password.
  2. Start a game from Play.
  3. Everyone opens Find Servers › LAN in Counter-Strike and joins.

With a dedicated server

  1. In Servers, New server › This computer.
  2. Under Who can join, pick This network.
  3. Start it, and Join from the app.
  4. Others find it under LAN, or type connect and the address from Who can join.

Before everyone arrives

  • Same game for everyone: Condition Zero or 1.6, matching the server.
  • Firewall: allow the game when asked. On Windows, set the Wi-Fi to a Private network.
  • Guest Wi-Fi often keeps devices apart. Use the main network, or plug into the router.

Friends who can't be there

With ZeroTier, Radmin VPN or Hamachi, remote friends join the same virtual network and see your server in their LAN tab. Playing with friends walks you through each.

Multiplayer

In-game commands

What players type in chat. The / is optional for most.

For everyone

TypeWhat it does
rtvVote to change the map (mode first, then map)
nominate <map>Put a map in the next vote
rtm, nominatemode <mode>Vote for, or suggest, a mode
/report <name> <what happened>Tell the admins about a player (one a minute)
/rank, /top15, /statsme, /hpStats, and who hurt you
/welcome, /rulesThe server's welcome page and rules
votekick, votebanVote against a player, if allowed
/vips, /donateWho's VIP, and how to support the server

For the host and admins

  • F3 (/menu) and F4 (/q): see In the game.
  • VIPs, if their role allows: /vip, /noclip, /god, /respawn, /save and /tp.

5v5 matches

TypeWhat it does
/ready, /notreadyThe match starts when all are ready; the first ready on each team is captain
/score, /matchThe score and the match's state
/stay, /switchThe knife round's winners pick a side
/pause, /unpauseCaptains and admins; pauses at the next freeze time
/start, /restart, /warmupAdmins: start now, start over from 0 - 0, or stop the match

In some modes

  • Deathmatch: /guns to pick your weapons again.
  • Zombie Plague: zpmenu.
  • Warcraft 3: /war3menu, /changerace, /shopmenu.
  • SuperHero: /herolist, /myheroes, /drop <hero>.

Servers

Your servers

A dedicated server runs on its own, apart from your game, and you join it like anyone else.

Make one

In Servers, click New server:

  • This computer: ready in a few minutes. Keep running after I close Loner-Strike keeps it up when you quit the app.
  • A Linux server (VPS): always on, on a rented machine, set up over SSH. See Run a server on a VPS.

A server's name can be in any language, up to 63 characters. Letters outside plain English take more room, so the name field counts down what's left.

Add one you already run brings in an existing server. Bots play on an empty server (Overview) keeps a few bots on so it looks alive in the list.

A server's tabs

TabWhat's in it
OverviewStatus, main settings, console
Who can joinVisibility, password, address, the server list
HealthUpdates, security, backups, daily restart, repair, crashes
Rotation & extrasRotation, adverts, kicks, votes
Spectators & demosHLTV
Website statusSite, Discord, fast downloads (Linux)
Modes, Bots, Rules, Fun, Add-onsAs for your game
Bot voice commandsVoice commands
Players, Moderation, Stats, Admins, Welcome pageIts people
Shared controlHelpers
Maps, Mods, Skins & models, Sounds, Get moreIts content; changes go up as you make them

Tick rate

Game updates per second, bots included, on Overview › Advanced (from the next start): 300 (default) suits most, 500 if there's CPU to spare, 1000 mostly costs CPU, 100 for a slow machine. Players get at most 101 updates a second either way. +sys_ticrate in Extra start options, or sys_ticrate in server.cfg, overrides the pick.

Health and repairs

On the Health tab, under Updates and Repair or remove. Stop the server first.

  • Update Valve's server files: the latest server from Valve. Mods and settings stay.
  • Repair (in its Mods tab) puts Loner-Strike's basics back. Reinstall Loner-Strike and its mods (this computer) fixes a server that won't start or lost its mods; settings, admins and maps stay.
  • Wipe and rebuild (Linux) deletes the server's folder and sets it up again in 5 to 15 minutes. Bans, admins, stats and added maps go. Last resort only.
  • Delete the server stops it and deletes its folder. Servers added with Add one you already run have Remove, which leaves the folder alone.

Crashes

A server that crashed shows a badge on its card and page (like 3 crashes in 24 h). Health › Crashes lists each one, newest first: when, the map, what went wrong and the last log lines, with Copy to send it to a mod's maker. Turn on Post crashes to Discord to get new ones in a Discord channel while Loner-Strike runs: a Linux server uses its status channel (Website and Discord); for a server on this computer, paste the channel's webhook link under the switch (in Discord: Edit Channel, Integrations, Webhooks).

A Crash-prone module warning means the server runs a module known to crash servers. The usual one is the official Ham Sandwich, which crashes on map changes: Loner-Strike puts its fixed copy back before every Play and local server start (a Linux server does it before each start), keeping the replaced file beside it.

Health › Crashes: a Ham Sandwich warning, two crashes in the last 24 hours with Details and Copy, and Post crashes to Discord switched on
Health › Crashes on a server (an example).

Servers

Run a server on a VPS

An always-on server on a rented Linux machine, set up by the app over SSH in 15 to 30 minutes.

What you need

  • Loner-Strike on Windows, or on a Mac with the game in CrossOver.
  • Ubuntu or Debian (Ubuntu 22.04 or 24.04 is safest) on an x86 (AMD or Intel) CPU, with a public IPv4 address.
  • Not Arm: Oracle Ampere A1, AWS Graviton, Hetzner CAX and Raspberry Pi can't run the server.

1. Choose a host and size

Players (bots included)CPUMemory
Up to about 10, a few bots1 vCPU1 GB
20 to 32, with bots2 vCPU2 to 4 GB

A fast core beats many (the game uses one). About 2 GB of disk plus maps. Free: Oracle Cloud's Always Free AMD machines (VM.Standard.E2.1.Micro), when available. Paid: small x86 plans at Hetzner, Vultr, DigitalOcean, OVH or Linode, near your players.

2. Make an SSH key

Windows 10 or 11, in PowerShell (press Enter twice at the passphrase prompt):

mkdir $HOME\.ssh -Force
ssh-keygen -t ed25519 -f $HOME\.ssh\loner-strike -C loner-strike
Get-Content $HOME\.ssh\loner-strike.pub

Mac or Linux, in Terminal:

mkdir -p ~/.ssh
ssh-keygen -t ed25519 -f ~/.ssh/loner-strike -N "" -C loner-strike
cat ~/.ssh/loner-strike.pub

Copy the last line (ssh-ed25519 …), the public key. Keys with a passphrase aren't supported yet. Convert a PuTTY key (.ppk) in PuTTYgen first (Conversions, then Export OpenSSH key).

3. Create the machine

  1. Create a server (instance, droplet) with Ubuntu 24.04 or 22.04 on an x86 plan, with a public IPv4 address.
  2. Under SSH keys, paste the public key.
  3. Note its public IP and SSH user: ubuntu on Oracle and AWS, root on Hetzner, DigitalOcean and Vultr.
Oracle Cloud

Shape: AMD, VM.Standard.E2.1.Micro (not Ampere). Turn on Assign a public IPv4 address; if it has none, add an ephemeral public IP on the VNIC (Attached VNICs, IPv4 addresses, edit). Firewall: the subnet's security list (Virtual cloud networks, your network, Security). "Out of capacity": try another availability domain, shape, or later.

Hetzner Cloud

Shared vCPU x86 (CX or CPX), not Arm (CAX). Keep Public IPv4 on. If you attach a firewall (Firewalls), allow inbound UDP 27015 to 27020.

DigitalOcean

Any Basic droplet with Ubuntu. If you use a firewall (Networking, Firewalls), add inbound UDP 27015 to 27020.

Vultr

Cloud Compute, Intel or AMD. In a firewall group (Network, Firewall), add inbound UDP 27015 to 27020.

AWS Lightsail

Linux/Unix, OS only, Ubuntu. Upload your key under Change SSH key pair. Firewall: Networking tab, IPv4 firewall, Add rule (Custom, UDP, 27015 to 27020). Attach a static IP so the address survives restarts.

4. Open UDP 27015 to 27020

The app opens the machine's own firewall, but not your provider's (security list, security group, firewall group). Add an inbound rule there: UDP, ports 27015 to 27020, source anywhere (0.0.0.0/0). Keep SSH (TCP 22) open; the app uses it.

5. Add it in Loner-Strike

  1. In Servers, New server › A Linux server (VPS).
  2. Address: the public IP. User: ubuntu or root.
  3. SSH key: the private key (the file without .pub), in C:\Users\<you>\.ssh on Windows. On a Mac, press Cmd+Shift+G in the picker and type ~/.ssh.
  4. Check the machine. It shows the fingerprint (SHA256:...) and whether it matches your known_hosts. For a new machine, compare with ssh-keygen -lf /etc/ssh/ssh_host_ed25519_key.pub in your provider's web console.
  5. Pick a name, the game, and Set it up like: My game (your modes, settings, admins and maps) or Start fresh.
  6. Who can join: Listed on Steam, or Anyone with the address (unlisted). A join password keeps strangers out either way.
  7. Make the server.

Setup takes 5 to 15 minutes. The server runs on UDP 27015, app closed or not, and restarts after a crash or reboot. If setup stops, Try again carries on.

6. Join and manage it

  • Join, Start, Stop and Open are in Servers. Joining an unlisted server restarts the game to connect.
  • Friends use connect <address>:27015 in the console, or Find servers if it's listed.
  • The Overview tab's console takes commands like status.

Over SSH (ssh -i ~/.ssh/loner-strike ubuntu@<address>), lsctl manages it:

lsctl list        the servers on the machine
lsctl status      running or not
lsctl restart     also start, stop
lsctl logs        the last 100 console lines

7. Website status, and keeping ports closed

Optional: Website status (also used for shared control) needs a web address, served one of two ways:

  • Cloudflare Tunnel (recommended if your domain is on Cloudflare): no web ports are opened. In Cloudflare's dashboard (Zero Trust, then Networks, then Tunnels), make a tunnel, copy its token and paste it in Website status. The app installs and runs it.
  • Its own HTTPS (Caddy): no Cloudflare needed, but opens TCP 80 and 443 on the machine and in your provider's firewall.

The game still needs UDP 27015 to 27020 open. With a tunnel, close everything else except SSH (TCP 22). See Security and health.

Removing it

Delete the server on its Health tab stops the service and removes its folder. Then delete the machine at your provider so it stops costing money.

Problems: Can't connect to a Linux machine, Friends can't join.

Servers

Running a server

Each server has these as tabs; your own game has them in the sidebar.

Admins and VIPs

In Admins, add people by SteamID as admins or VIPs, for good or for some days. What each role gets sets their powers; VIP perks (free armor, a defuse kit, extra money, a tag) and an optional donate link are under VIP & donations. Admin and ban lists can be shared across your servers.

Moderation and stats

Moderation: player reports (they notify you), chat log, mutes, word filter, bans and player history. Stats: ranks and 5v5 results.

Welcome page

What players see on joining: pick a style or write your own HTML. /welcome shows it again.

Rotation and extras

Map rotation, adverts, AFK and high-ping kicks, join and leave messages, vote kick and vote ban, and what happens when it empties. The daily restart is on the Health tab; players are warned 5 minutes and 1 minute before.

Fast downloads

A player who doesn't have one of your server's custom maps, models or sounds downloads it when they join. From the game server itself that's slow (often minutes for one map). With fast downloads (FastDL) the game fetches the same files from a web address instead, in seconds. Turn it on under Rotation & extras, Fast downloads:

  • A server on a Linux machine: turn on Fast downloads in its Website status. The machine serves the files itself and fills in the address. Nothing to upload.
  • Any other server: Copy files for your web server puts the custom files (never the game's own) in a folder laid out like the game's. Upload that folder to any web host that serves plain files, and paste its address.

The app sets sv_downloadurl and turns on sv_allowdownload for you. The address is used from the next map. Players without fast downloads still get the files from the game server.

Spectators and demos

HLTV lets people watch with a delay and records demos. Copy a demo to your game from the list, then viewdemo <name> in the console.

Website status

On Linux: a live player count for your website, a Discord message of who's playing, down alerts and fast downloads, each checked from outside. Setup: step 7.

Skins and models

The server's skins and models and who sees each (everyone, one team, admins), plus each map's use of the 512 models and 512 sounds limit.

Servers

Shared control

Friends help run your server from their Loner-Strike, through Website status (Linux) or TCP 27030 on this computer while the app is open (Open the port on my router opens it).

  1. In the server's Shared control tab, make an invite and pick a role. Adding their SteamID is recommended (they see it with status in the console). An invite works once, for 24 hours.
  2. They paste it in Servers › Add a shared server.

What each role can do

  • Moderators: kick, mute and gag, ban up to 7 days, change or restart the map, announce, but never against you, your admins or helpers. They see Players, Moderation and Stats.
  • Admins: also ban for good, start and stop, change the mode, name, map, slots and bots, and invite Moderators.
  • Only you: who can join and the password, the machine, files and plugins, deleting the server.

With a Cloudflare Tunnel

Add the route the tab shows: a second published application on your status hostname, path ^/control/, service http://127.0.0.1: and the port it shows. Drag it above the route without a path (Cloudflare uses the first match). With the app's own web front, there's nothing to add.

Taking access away

Helpers see tabs their role can't use dimmed (Owner only, Admins only). The tab logs what helpers change, with Undo. Remove next to a helper cuts their access at once; then change the join password (the app offers to).

Servers

Updates, security and backups

Updates

After an app update, each server updates its plugins and bot brain once nobody's playing (bots don't count). Update now (Servers or the Health tab) does it at once; turn off Update by itself when nobody's playing to update only by hand.

On Linux, security updates install themselves; for the rest, sudo apt update && sudo apt upgrade. Valve's files: Health and repairs. Mod, map and sound changes load on the next map.

Security and health

Each Linux server's Health tab checks logins, RCON, updates, fail2ban, pending restarts, the sandbox, disk, memory and CPU, and fixes what it can. The app already sandboxes the game, keeps RCON local and installs fail2ban. Only you can:

  • Set your provider's firewall to allow only UDP 27015 to 27020 and TCP 22, with SSH limited to your address if it doesn't change.
  • Guard your SSH key (the file without .pub). If it leaked, remove its line from ~/.ssh/authorized_keys on the machine and make a new one.
  • Keep password logins off; the panel can do it. Loner-Strike always uses your key.
  • Prefer a Cloudflare Tunnel for Website status: it opens no web ports.
  • Decide about RCON if another game server shares the machine: closing it to the internet affects every server there, so it stays open until you choose in the panel.

Backups

  • Linux servers are backed up daily while Loner-Strike is open (bans, admins, settings; last 7 kept on your computer). Turn it off in Settings › Backup & restore.
  • Back up to a file in Settings saves everything (Back up everything) or Just your game. Passwords are only included if you lock the backup with your own password.
  • Restore a backup in Settings restores all or part (close the game first). The same button in Servers restores one server; each Health tab has Back up this server.

Share

Community

Maps, modes, prefabs, sprays and textures made with Loner-Strike, under Tools › Community. Find one, try it in a click, play it with bots.

The Community browser: search and a filter for maps, modes, prefabs, sprays, textures and creatures, with cards for ls_outpost, br_valley, King of the Hill, Infection and Gun Game Lite, each with its badges and how bots play it

How it works

Files, pictures, likes and comments live on GameBanana; a page with a Custom Tag whose value is LonerStrike shows up in Community (on GameBanana's Technical tab, under Tags, add a Custom Tag with the value LonerStrike, the title can stay empty, then press + and save). Loner-Strike adds badges, featured picks and moderation, and checks every packaged file is what it claims to be. A creation belongs to the GameBanana member who first uploaded it: others can't post an "update" to it, only a remix that credits it.

Try something

  1. On Browse, search by name, maker or mode, and filter by Maps, Modes, Prefabs, Sprays or Textures (and, for modes, Bots).
  2. Press Try it, then Install it.
  3. Play with bots. A prefab opens in the map editor instead.

Installed things appear in their usual places, marked From Community. Installed has Update, Remove and Remix in Game Mode Studio. Servers carry it from Library › Community content.

On lonerstrike.com, Open in Loner-Strike opens a creation's page in the app. It only opens the page: installing still takes Try it and Install it.

Updates

A count on Tools and Community shows waiting updates; Installed lists them first, with the creator's notes. Press Update or Update all.

  • Never while in use: the map or mode you're playing updates at the next map change.
  • Servers too, once nobody's playing it there (bots don't count).
  • Go back to the previous version restores the old one; a failed update does it by itself.
  • Your work stays yours: placed prefabs and remixed modes don't change.

Badges

  • Works with bots: comes with a bot nav and map knowledge.
  • Checked with bots: passed a map simulation.
  • Settings only: a Game Mode Studio mode, built on your computer.
  • On modes, as the maker rated it: Bots play this well, Bots are so-so, Best with a friend or Solo, no bots.
  • Featured: picked by the Loner-Strike team.
  • On modes that do more than their own game: Runs server commands, Runs AMX Mod X commands, Calls other plugins or Can kick players. You're asked before one installs, and asked again if the mode does more than its listing said.

What it will install

Content and Game Mode Studio modes (built by your app); never anything that runs code. Items marked Plugins, Not checked or Pulled won't install.

Report something

Report on any creation sends only the page, a reason and your note. Moderators can pull it from every app within about half an hour; installed copies stay, marked as pulled.

Share

Publishing

Package it in the app and upload it to GameBanana, with the credits filled in for you, and it shows up in Community. The app never uploads or signs in to GameBanana for you.

What can be shared

You can share

  • Maps you made or added, with their nav, knowledge and overview, and their own sounds, models, sprites and textures
  • A map's editable source, so others can remix it
  • Game Mode Studio modes: only the graph; each player's app builds it
  • The custom creatures and NPC models a map or mode uses, carried along in your own folder
  • Creature types on their own
  • Prefabs, textures and sprays

Not shared

  • The game's own files: stock maps, models, sounds and textures
  • Plugins and compiled code: .amxx .sma .dll .exe and scripts. A plugin from Plugin Studio: post its .sma on GameBanana yourself
  • Game settings files: .cfg liblist.gam and plugin lists
  • Archives inside the package
  • Metamod and dlls folders

Share your own work or work you may share, and credit what you used. Sprays are checked by a moderator first.

Publish a map

  1. Compile the map into your game (the editor's Publish… brings you here once it has).
  2. In Tools › Community › Publish, choose A map and pick it. The app says what's missing.
  3. Fill in Name, Made by (your GameBanana name), About it, the modes it's for, and up to 6 screenshots.
  4. Check Credits for the files it uses (below).
  5. Make the package: a .zip with the map, nav and knowledge, a fresh download list, the overview, the files it uses and a README.txt with the credits.
  6. Open GameBanana and sign in there. Upload the package unchanged in the Counter-Strike 1.6 section, with the screenshots. On GameBanana's Technical tab, under Tags, add a Custom Tag with the value LonerStrike (the title can stay empty), then press + and save: that's how Community finds it. Paste the credits into GameBanana's Authors section. The app has copy buttons for the name, description, the tag's value and the credits.
  7. Once GameBanana has checked the file, paste the page's link in the app and press Add to Community.

Most things are Listed within a few minutes; some go to a moderator first. If it's turned down, the app says why.

Publish a game mode

The same steps, with A game mode:

  • Checks first: the graph has to compile, and every file the mode uses (in node settings, file variables and table cells) has to be on your computer or linked to the GameBanana item that has it (My mode › Details › Requirements in the Studio).
  • Set How well bots play it (the Studio may suggest it); it shows as a badge and in the Bots filter.
  • Screenshots: a cover card drawn from the name and line comes first (untick it to leave it out), then up to 5 of yours.
  • If the mode runs server commands, kicks players or calls other plugins, the listing says so with a badge.

Others can play and remix it, with your name on it.

Publishing King of the Hill: the checks (the graph passes; what players need), the name, maker and about text, how well bots play it, and the maps it's made for, with Make the package below
Publishing a mode: the checks come first.

Credits

Loner-Strike tracks where every file came from:

  • Before you download. Get more and the Content Browser show a page's terms (sharing, commercial use, who to credit, license) and keep them with the files.
  • When you package it. Credits for the files it uses lists each file's source, makers and what its page allows.
  • Ask first. Most GameBanana pages want you to ask the maker. Once they say yes, press Permission granted… and note who, where and when.
  • Not allowed. The package isn't made until you record permission.
  • Unknown files. Add credit… names the maker and, if you know, its GameBanana page.

The credits go into README.txt, the Community listing, and a block for GameBanana's Authors module: one line per person, like jam — Map. It names you, the maker of the original when it's a remix, the makers of shared creatures it carries, and the makers of the files above. Nobody else.

Share and remix maps

When you publish a map, tick Include the editable source (others can remix it) and pick the map's project (the one named like the map is picked for you). The package then also has a source/ folder:

  • the map editor's project (.lsmap);
  • a Valve 220 .map that TrenchBroom, Hammer and J.A.C.K. open;
  • a texture file with only the map's own textures (the game's own textures are never in it: every player has them);
  • a short note.

Players who try it get the map as usual; source/ never goes into their game. On a map shared with its source, Remix this map on its Community page saves a copy as a new project of yours (<map>_remix, never over one you have) and opens it in the map editor. When you publish your remix, the package, its README and the GameBanana text say "A remix of" the original, by its maker.

A map's custom creatures (an ls_creature or wave spawner using your own type) go with it, named for your account; players get them in their own block in creatures.ini, removed again with the map. How creatures work.

After it's up

The Published tab lists what you've shared. To update one, upload the new file to its GameBanana page, then paste the link in Publish again. Players get it as an update.

Unlist takes one off Community (installed copies stay). If the app asks, put the short code it gives you on the GameBanana page, so it knows the page is yours; List again puts it back.

Share

Community and your privacy

Loner-Strike's community server keeps nothing about you.

Browsing and installing

The list comes from dl.lonerstrike.com and the files from GameBanana. No account needed, and the list doesn't know who fetched it.

Publishing

Add to Community sends only the GameBanana page's address and the app's version. The listing is built from the public page and the package.

Reports

A report keeps the page, reason and note for 90 days, plus a scrambled tag of your address (its key lives only in memory) to spot floods. Your address is never stored or shown to moderators.

Rate limits and logs

Requests are counted per address in memory only, then forgotten. Logs say what happened to which page, never who asked.

On your computer

What you published and installed, and a copy of the Community list, stay in Loner-Strike's folder. See also the privacy page.

AI agents

Connect an AI agent

Let coding agents like Claude Code, Codex, OpenCode or Cursor use Loner-Strike's tools through MCP (the Model Context Protocol).

Turn it on

  1. Open Settings › AI agents.
  2. Turn on Let AI agents connect. Agents can then only look.
  3. Turn on Allow changes to let them edit maps and navs and start or stop servers.
  4. Under Connect an agent, pick yours, press Copy and paste where it says. The copy has the app's real path.

Each agent

Replace <app> with the app's path, usually C:\Users\<you>\AppData\Local\Loner-Strike\loner-strike.exe (on a Mac: /Applications/Loner-Strike.app/Contents/MacOS/loner-strike); Copy fills it in.

Claude Code

In a terminal:

claude mcp add --scope user --transport stdio loner-strike -- "<app>" --mcp-stdio

claude mcp list should say it's connected, and /mcp inside Claude Code lists the tools.

Codex

In ~/.codex/config.toml:

[mcp_servers.loner-strike]
command = "<app>"
args = ["--mcp-stdio"]

OpenCode

In opencode.json:

"mcp": {"servers": {"loner-strike": {"type": "local", "command": ["<app>", "--mcp-stdio"]}}}

Cursor

In ~/.cursor/mcp.json:

"mcpServers": {"loner-strike": {"type": "stdio", "command": "<app>", "args": ["--mcp-stdio"]}}

Claude Desktop

In claude_desktop_config.json (Settings › Developer › Edit Config):

"mcpServers": {"loner-strike": {"command": "<app>", "args": ["--mcp-stdio"]}}

VS Code

In .vscode/mcp.json, or MCP: Open User Configuration:

"servers": {"loner-strike": {"type": "stdio", "command": "<app>", "args": ["--mcp-stdio"]}}

Others

Other MCP agents (Windsurf and the rest) use the same shape: command is the app's path, with --mcp-stdio as its argument. HTTP-only agents can use Connect over HTTP with the token instead: http://127.0.0.1:8029/mcp with Authorization: Bearer <token>. The token is on the same page and changes every launch unless you tick Keep the same token across restarts.

What agents can do

  • Read and check maps, build, compile and playtest in the map editor, fix navs, name places, make overviews.
  • See what you've picked in the map editor, so "make this taller" works, and pick things for you to look at.
  • Work in Game Mode Studio and Plugin Studio, read replays and demos.
  • Run your servers and read their consoles, logs, crashes and bots' thinking.

More than 170 tools in all; /mcp in Claude Code (or your agent's tool list) shows them.

Try: "make a small aim arena, check it for bots and playtest it".

What keeps you in charge

  • Off until you turn it on, and only reachable from your own computer. Web pages can't use it.
  • Look-only until Allow changes is on.
  • The app asks you (An AI agent is asking) before deleting, kicking or banning, stopping a server people are on, starting the game, compiling into the game, or anything public or online.
  • Off limits: these settings, updates and removing the app, phone access, shared control and secrets. Passwords, tokens, keys, webhooks and Steam IDs are never shown.
  • What agents did lists every call: done, not allowed, or didn't work.

Reference

Reference

Made from the app's own catalogs, so it always matches the app. The docs search finds every entry.

Open the reference: it has its own search with filters.

Reference · Guide

Types and casting

Numbers, text, players, entities, vectors and lists, and turning one into another.

Read the guide. In it:

Reference · Guide

Events and flow

What starts a graph running, and Branch, Sequence, loops and timers.

Read the guide. In it:

Reference · Guide

Variables and saving

Mode, round and player variables, and what's kept between maps.

Read the guide. In it:

Reference · Guide

Spawning and transforms

Making props, creatures and effects, and moving, turning and attaching them.

Read the guide. In it:

Reference · Guide

Limits

The comfort limits on effects and searches, and when the game itself runs out.

Read the guide. In it:

Reference · Guide

Steering bots

Goals, offers, friends and avoid areas: telling bots what matters in your mode.

Read the guide. In it:

Reference · Guide

Sharing

What travels with a mode, what players need, and how credits work.

Read the guide. In it:

Help

Something's wrong?

Find what you see, then follow the link to the fix.

Setup and the app

Bots

Servers and friends

Making maps

Sharing

  • My upload doesn't show in Community: check the publishing steps. The page needs the Counter-Strike 1.6 section, a Custom Tag with the value LonerStrike (on GameBanana's Technical tab, under Tags; the title can stay empty; press +, then save), and GameBanana's file check done (then press Add to Community again). A moderator may be checking it first, and a daily re-check drops pages that lose the tag or are taken down.

Still stuck? Send diagnostics.

Help

No bots or Bad Rcon

The app checks for these itself and fixes what it can; its message says what's left.

No bots, or the app can't connect to the game #

Loner-Strike isn't loading in the game.

  1. Quit the game completely and start it again from Play.
  2. Still nothing? Mods › Repair, then restart the game. Settings and mods stay.
  3. If your antivirus removed files, allow the game's folder first (more).
  4. Still stuck? Copy your diagnostics.

"Bad Rcon" lines in the game console #

The app is using a console password the game doesn't know (Loner-Strike sets it each map).

  • rcon_password in the console shows "": Loner-Strike isn't loading. See No bots.
  • It shows another password: a config sets its own. Remove the rcon_password line from server.cfg, autoexec.cfg or listenserver.cfg in cstrike or czero, then restart the map.

It stopped working after a Steam update #

Steam updates, and "Verify integrity of game files", restore the original liblist.gam, which unhooks the mods. The app fixes it by itself; restart the game afterwards.

To check by hand, the gamedll line in Half-Life\cstrike\liblist.gam (or czero\) should read

gamedll "addons\metamod\dlls\metamod.dll"

and meta list in the console should list AMX Mod X ("Unknown command" means the mods aren't loading).

Files keep disappearing #

Windows Defender and some other antivirus programs remove metamod.dll or amxmodx_mm.dll by mistake. Allow the game's folder, then Repair in Mods.

"A different copy of the game is running" #

You started a copy Loner-Strike isn't set up in. Close it and start from Play, or switch copies in Settings › Game.

Help

Setup and updates

"No game found" #

  • Install Counter-Strike 1.6 or Condition Zero from Steam, then click Look again.
  • Somewhere else? Choose the game folder and pick the Half-Life folder (the one with cstrike or czero).
  • Mac (CrossOver): it must be the Windows version, in a CrossOver bottle (Mac setup).

"This copy of the game is older than Loner-Strike supports" #

A copy from before Valve's 2013 update (old retail or repacked) can't load the mods. Use the Steam version.

"Counter-Strike is open" during setup or restore #

Quit the game and try again. If it says Counter-Strike didn't close, quit it yourself (Task Manager on Windows).

Setup or a download failed #

  • Couldn't download: check your internet connection and try again.
  • Couldn't unpack a download: try again; if it keeps happening, clear downloads in Settings › Storage.
  • A mod didn't build: Try again next to it in Mods. Mac (CrossOver): CrossOver must be in Applications.
  • Mod files missing from the app: reinstall Loner-Strike.

The game doesn't start, or keeps saying "Starting" #

If the first start is slow (more often on a Mac with CrossOver), after a while Play offers to start again. If the game sits at its menu on another screen, close it and start from Play. Changing resolution while hosting drops you to the main menu: start again.

Windows says it protected my PC #

SmartScreen warns about apps that aren't widely downloaded yet. Click More info, then Run anyway. The code is open on GitHub.

The app won't update #

  • Couldn't check for updates: check your internet connection.
  • Something is being set up or restored: wait, then update.
  • Otherwise, install the newest version from lonerstrike.com over the old one. Settings stay.

Help

Connecting

Friends can't join #

  • They need the same game: a Condition Zero server needs Condition Zero.
  • Check the address and join password.
  • Over the internet without a tunnel, forward UDP 27015 on your router and allow it in your firewall (or use playit.gg or Tailscale).
  • Allow the game when Windows Defender Firewall asks (on a Mac, when macOS asks), on private networks at least. Each server has its own hlds.exe, so a new server asks again.
  • Clicked Cancel by mistake? Open Windows Security › Firewall & network protection › Allow an app through firewall › Change settings, find hlds.exe (add it with Allow another app… from the server's folder if it isn't there) and tick both Private and Public.
  • "Failed to contact game server" on Linux: allow UDP 27015 to 27020 in the provider's firewall.

A server won't start #

  • "… is using port … already": stop the server it names, or change this one's port on Overview.
  • "Port … is in use by another program": something else on this computer has it (another game server, a server Loner-Strike isn't managing). Close it, or change this server's port on Overview.
  • "keeps crashing, so it was left off": check the console on Overview. A newly added mod is the usual cause: remove it.
  • On this computer, Reinstall Loner-Strike and its mods (Health tab) fixes lost files.
  • Mac (CrossOver): CrossOver must be in Applications and the servers folder inside the game's bottle.
  • Windows user name in another language than Windows? The old server can trip over it. Move servers to a plain folder like C:\LonerStrike in Settings › Servers folder.

Can't connect to a Linux machine #

  • Couldn't reach it: check it's running and SSH (TCP 22) is open in your provider's firewall.
  • Key rejected: check the user (often root or ubuntu), that the key was added to the machine, and that you picked the private key, not the .pub. Passphrase keys aren't supported yet.
  • The machine's identity changed: expected after a rebuild. Run ssh-keygen -R <address> and add the server again. If you didn't rebuild it, don't connect: check the fingerprint in your provider's web console.
  • Only runs on x86: use an AMD or Intel machine, not ARM.
  • Can't use sudo: connect as root, or give the user passwordless sudo.
  • Can't reach port 22 on Oracle: the machine has no public IP (add one).
  • Setup stopped part way: Try again carries on. Wipe and rebuild starts over.

My phone can't connect #

  • The phone must be on the same Wi-Fi, with Loner-Strike open on the computer.
  • On Windows, set the Wi-Fi to a Private network.
  • "This phone isn't signed in any more": scan the QR code in Settings again.
  • "Port 8028 is busy": close whatever uses it (often an older phone panel) and try again.

Help

Tools, the editor and the studios

The 3D view is black or empty #

Update your graphics driver; on Windows, don't force Loner-Strike onto a basic display adapter. Big maps take a few seconds the first time.

Compiling doesn't start on a Mac #

The compiler runs through CrossOver in your game's bottle, so set the game up in Loner-Strike first. "Compiling maps works on Windows, and on a Mac with CrossOver" means CrossOver isn't in Applications. The first compile is slower.

"The map leaks" #

Press Show the leak line and follow the red line to where it leaves the map; close that gap with a brush. Only world brushes seal a map, not entities like a func_wall or door.

Textures are missing #

A WAD the map lists isn't on this computer, or none has the texture. Put the WADs beside the map, or add them in Map properties › WADs. For Hammer, J.A.C.K. or TrenchBroom maps, see Texture files.

A playtest doesn't start, or bots stand still #

  • Close the game if it asks, and let it restart into the playtest.
  • Bots standing still haven't learned the map: leave Teach bots the map first ticked, or use Teach bots this map in the Map doctor.
  • Bots stuck in one place: run the Map simulator and fix the spot in the Nav fixer.

Game Mode Studio won't playtest #

Playtest waits until Problems is empty: click each to go to its node. If nothing happens, check the events are wired (a node only runs when a wire leads to it).

A plugin won't compile #

Errors under Problems are explained and marked on their lines. "Couldn't find your game's install to run the compiler" means Loner-Strike isn't set up in the game yet: run setup first.

Something else is off #

Tell us on Discord or in a GitHub issue, with diagnostics and the map or mode if you can share it.

Help

Questions

Is it really free? #

Yes. It's open source (GPL-3), with every release on GitHub.

Will it mess up my game? #

No. Changed files are backed up and put back on removal. As a last resort, Steam can restore the game: right-click it in your library, then Properties, Installed Files, Verify integrity of game files. Then Repair in Mods sets Loner-Strike up again.

What about VAC and other people's servers? #

The mods are standard server mods (Metamod and AMX Mod X) and only load in games you host. On other servers nothing of Loner-Strike's runs.

1.6 or Condition Zero? #

Both work, and you can set up both; switch in Settings › Game. Friends need the same one to join you.

How do updates work? #

The app checks at start and shows what's new before you install. Servers update afterwards, once nobody's playing. See the changelog.

How do I remove it? #

  • From one game: Settings › Setup › Remove from Counter-Strike 1.6 or Remove from Condition Zero. Your files are put back; settings, admins and stats are kept.
  • Everything: Remove everything there removes it from every game and deletes your servers on this computer and all its data. Servers on Linux machines keep running.
  • Then uninstall the app like any other.

Do the tools work on a Mac? #

Yes, all of them. The map compiler runs through CrossOver, in your game's bottle.

What does Beta mean on the tools? #

They're new and still settling in (more).

Where are its files? #

Settings › Storage (where you can also clear downloads) and Servers folder.

Still stuck? Send diagnostics #

In Settings › Help, click Copy next to Copy diagnostics: a short report (version, game folders, what's installed, recent errors) with no passwords. Paste it in a GitHub issue; Report a problem opens one.