SCP: Secret Laboratory bot addon

Adds goal-oriented AI controlled players to game server running on Unity Engine.

Overview

• GOAP inspired AI framework featuring strongly-typed states persistance (contained in belief classes), actions traversal from goal to find conditions-fulfilling (aka enabled) action with least total cost using pathfinding algorithm and running it (mind runner class).
• Multithreaded perception system using Unity Jobs System.
• Custom mesh-based navigation system, pathfinding algorithm based on A*, navigation mesh editor using primitives for navmesh visualization.
• Introduced escaping the facility AI of human players with action graph set up to reach such goal on top on general action graph (opening doors, picking up items etc.)

Action finder visited actions debugging graph (in yellow - action path starting from found action to goal)

Demo 1, Demo 2

Project setup

• Requires the following enviroment variables set up:
  • SL_REFERENCES: directory where shipped server managed assemblies located of a game.
  • SL_APPDATA: directory where application data is located of server.
• References the following packages:
  • Lib.Harmony v2.2.2;
  • Northwood.PluginAPI v13.1.1.
• SDK style project file targeting .NET Framework 4.8.
• C# 11 language support enabled.

Quick start

1. In LocalAdmin use command bot_add to add bot player to server while waiting for players.
2. Then connect yourself, assign yourself Overwatch and force start the round.
3. Then spectate the bot player. It should start moving with debug graph visible (debug graph visible is only for Overwatch spectators)