SCPSLBot: AI players for SCP: Secret Laboratory

SCPSLBot fills an SCP: Secret Laboratory dedicated server with AI-controlled players. Every bot is a native dummy, and the plugin drives it through the same systems a real player uses: it walks the facility, opens doors, rides elevators, aims, shoots and reloads, and uses SCP abilities. Bots can play any human role and every SCP except SCP-079.

SCPSLBot is a fork of repkins/scpsl-bot-plugin by Antons Repins (@repkins), who created the bot framework it is built on. See Credits.

Download the latest release.

What the bots do

SCPs

SCP-173: blinks toward its target and snaps necks only while nobody is watching. It drops tantrum at close range and uses Breakneck Speeds on long chases.	SCP-096: enrages at the first hostile it sees, charges down straight corridors, pries gates open and tears into its targets.
SCP-049: uses Sense and Doctor's Call on its target, closes in for the kill and revives fresh corpses as SCP-049-2.	SCP-049-2: hunts and claws humans, and consumes corpses to heal.
SCP-106: walks through doors, stalks underground to close distance, uses Hunter's Atlas to reach distant prey, and drags corroded victims into the pocket dimension.	SCP-939: lies in wait behind doors and lunges at whoever comes through, sometimes prepares an amnestic cloud before waiting, and claws its way through a chase.
SCP-3114: steals a disguise from a fresh corpse, walks up to humans disguised, then reveals itself to strangle and slap.	SCP-079 is not supported: it has no body for a bot to drive.

_{These are real-client clips of the release build, using runtime navigation at the hardest difficulty. The SCP bots were invulnerable so that each take ran its full length.}

Humans

• Militants fight; civilians prioritize survival. Bots choose targets by faction: the Foundation fights Chaos and Class-D, SCPs fight everyone, and everyone fights Tutorial. A bot fires the gun it carries, reloads when its magazine runs dry, strafes at mid range and backs off when rushed. Only Standard warmup issues a COM-15 to an unarmed bot. In normal rounds Class-D and Scientists flee noticed SCPs even when armed; unarmed humans flee SCPs and armed enemies.
• Humans pick up and use items. They pick up firearms, ammo for their gun, better armor, medical items, grenades and keycards that add permissions, taking the native search time and respecting inventory limits. They heal with medkits, SCP-500, painkillers or adrenaline once out of danger, and equip a matching keycard to open keycard doors and lockers.
• Class-D and Scientists try to escape. They search floors, lockers and rooms for keycards, upgrade them in SCP-914, and work toward the exit through keycard doors and elevators.
• Everyone else explores. Humans cover their zone and the zones next to it when their keycards allow, and SCPs roam the whole facility, preferring rooms they have not visited recently.
• Pocket dimension. Humans caught by SCP-106 run for a teleporter, and like a player they cannot tell the exits from the deadly ones.
• Four difficulty levels. bot_difficulty easy|normal|hard|hardest tunes fire rate, aim, strafing, how long bots chase a target they've lost, and SCP-096's rage.

Navigation

• For every map seed, a navmesh is baked on the server from its real collision geometry. Changes to doors, admin toys and other geometry are rebuilt incrementally.
• Routing is keycard-aware: a Class-D never plans through a door its inventory cannot open, while a Scientist holding the right card does.
• Every movement (exploring, objectives, chasing a target, orders) plans across zones and executes the crossings: bots open doors with the right keycard, ride elevators (a bot on Surface heading into the facility walks to a Gate elevator first), climb stairs and jump across clutter in door-less connectors.
• Stuck recovery runs in escalating steps: nudge, jump, back off, re-plan, then avoid that crossing for 45 s.
• Custom maps built from static admin toys can be added to the navmesh (nav rebuild <center> <size>).

How it works, the asset patch and the authored fallback: docs/navigation.md.

Optional features

The independent BotRoundControl plugin owns warmup-server management, the player SSS menu and duels. SCPSLBot alone runs plain AI bots in normal rounds. Install BotRoundControl.dll and configure LabAPI/configs/<port>/BotRoundControl/config.yml to turn the features below on; each then follows its own setting.

Feature	What it adds	Its own setting (with bots_only: false)
Standard warmup	Rounds never end and everyone respawns. Players get three arenas, each with its own bot population: Surface PvE, HCZ/EZ PvPvE and LCZ SCP. Per-player menus let them respawn as any role, request items, teleport to rooms and switch arena. The warhead, decontamination, disarming, SCP-207 drain and native respawn waves are suppressed.	warmup_mode: Standard (default) or None; RA bot_warmup standard|none
Duel / 1v1	Protected viewing, independent invitations, paired FIFO queue and configurable winner retention in one elevated arena.	duel.enabled: true in BotRoundControl; .duel, .accept, .spectate
WarmupSafezone	Damage-free safezones at the Surface escape, SCP-914 and the Class-D cells. Inside, nobody deals or takes damage, grenades and SCP items can't be thrown, and in-world boundaries and signs are shown. Surface anti-camping applies too.	Install WarmupSafezone.dll; toggle with enabled
StatsBots	Records players' bot kills, a decayed combat skill rating, unlockable titles and a profile HUD. Requires StatsSystem 2.2.	Install StatsBots.dll
Overflow cleanup	Once loose items pile up, runs the native item/corpse/decal cleanup and repairs doors.	enable_overflow_cleanup (default true)
Infinite ammo	Reload-time reserve ammo so firefights never run dry. Third-party: LabAPI_InfiniteAmmo; not controlled by bots_only.	Install the DLL

WarmupSafezone: the Class-D cells boundary and sign.

A shot fired inside the SCP-914 safezone is blocked.

The bots_only master switch

# LabAPI/configs/<port>/BotRoundControl/config.yml
bots_only: false  # management enabled; true disables this plugin's server features

With the switch on, SCPSLBot only runs bots: nothing above is active, the native players output and other plugins' Server-Specific Settings menus are left alone, and bots ignore dummies they did not create. Add bots with bot_add and make them any role, SCPs included, with native RA force-class. Restart the server after changing management settings. Details: BotRoundControl.

Install

1. Download SCPSLBot-<version>.zip from the latest release.

2. Copy its folders into the LabAPI tree for your server port:

   From the zip	To
   plugins/ (SCPSLBot.dll, SCPSLBot.Components.dll, HsmAdapter.dll)	LabAPI/plugins/<port>/
   dependencies/ (0Harmony.dll)	LabAPI/dependencies/<port>/
   optional/plugins/ (BotRoundControl.dll, ServerKeybinds.dll, WarmupSafezone.dll, StatsBots.dll)	LabAPI/plugins/<port>/, only if you want server management

3. Install HintServiceMeow for on-screen text. StatsBots also needs StatsSystem 2.2.

4. Pick a navigation backend: either patch the server assets once per game update for the default Runtime backend, or set navigation.backend: Authored. See docs/navigation.md.

5. Start the server; bot_status reports readiness.

Install exactly one ServerKeybinds.dll per port, never under dependencies/global. It keeps other plugins' Server-Specific Settings and only touches the menu while the warmup controls or StatsBots are active. HsmAdapter and ServerKeybinds are open source at sl-plugins-cement/HsmAdapter and sl-plugins-cement/serverkeybinds.

Quick start

Goal	Command (Remote Admin)
Spawn an AI bot	bot_add
Add bots to normal rounds automatically	set normal_round_bot_count: 3 with warmup off, then restart
Make it an SCP or any other role	native force-class on the bot
Change bot skill	bot_difficulty easy|normal|hard|hardest
Turn the warmup features on	set bots_only: false in the config and restart
Switch warmup modes (with bots_only: false)	bot_warmup none|standard
Check health and navigation	bot_status, bot_health, nav status

Documentation

• Warmup features: the bots_only switch, arenas, respawns and the player menu
• Navigation: backends, the asset patcher, custom maps and diagnostics
• Remote Admin commands
• Configuration
• Plugin API for other plugins that spawn and command bots
• Build and verify
• Changelog

Known limits

• SCP-079 has no bot AI.
• SCP-939 does not use mimicry.
• Bots do not throw grenades or cuff.
• On navigation.backend: Authored, bots can wedge for a minute or more on clutter or stair corners the embedded navmesh routes through, on some map seeds.
• During Standard warmup, bots on Surface hold position until they find a target.
• Do not install the legacy WarmupPlayerPanel or ScpslPluginStarter.dll alongside this suite.

Credits

SCPSLBot is a fork of repkins/scpsl-bot-plugin by Antons Repins (@repkins), who created the project in 2023. He wrote the foundation everything here builds on:

• the dummy-driven bot runtime;
• the goal-oriented AI mind (beliefs, goals and actions) and bot perception;
• movement and the original navigation mesh pathfinding, with its in-game navmesh editor;
• the first combat, door, elevator and item behaviours.

His commits make up most of this repository's history.

This fork adds the warmup layer, runtime navigation, SCP combat strategies, WarmupSafezone, StatsBots and the later AI and stability work.

SCPSLBot is built with and alongside:

• Harmony by Andreas Pardeike (MIT) for runtime patching. 0Harmony.dll ships in the release with its license.
• AssetsTools.NET by nesrak1 (MIT), used by the NavMeshAssetPatcher tool.
• HintServiceMeow by MeowServer (MIT) for on-screen text.
• StatsSystem by MedveMarci, the player statistics store StatsBots uses.
• LabAPI_InfiniteAmmo by TASA-Ed Studio (Apache-2.0), recommended for warmup ammo.
• LabAPI and SCP: Secret Laboratory by Northwood Studios.