BepInEx Skill

BepInEx is the plugin framework for Unity game modding. This project uses BepInEx 5.x with .NET Standard 2.1 for SPT (Single Player Tarkov) modding. Plugins are loaded via [BepInPlugin] attributes and use ConfigFile for settings. All patches use Harmony (see the harmony skill).

Quick Start

Plugin Entry Point

csharp
1[BepInPlugin("com.blackhorse311.botmind", "BotMind", "1.0.0")]
2[BepInDependency("xyz.drakia.bigbrain", BepInDependency.DependencyFlags.HardDependency)]
3[BepInDependency("me.sol.sain", BepInDependency.DependencyFlags.SoftDependency)]
4public class BotMindPlugin : BaseUnityPlugin
5{
6    public static ManualLogSource Log { get; private set; }
7    
8    private void Awake()
9    {
10        Log = Logger;
11        Log.LogInfo("BotMind is loading...");
12        
13        // Initialize configuration
14        BotMindConfig.Initialize(Config);
15        
16        // Apply Harmony patches
17        new Harmony("com.blackhorse311.botmind").PatchAll();
18        
19        Log.LogInfo("BotMind loaded successfully!");
20    }
21}

Configuration Binding

csharp
1public static class BotMindConfig
2{
3    public static ConfigEntry<bool> EnableLooting { get; private set; }
4    public static ConfigEntry<float> SearchRadius { get; private set; }
5    
6    public static void Initialize(ConfigFile config)
7    {
8        EnableLooting = config.Bind(
9            "General",           // Section
10            "Enable Looting",    // Key
11            true,                // Default
12            "Enable bot looting behavior"  // Description
13        );
14        
15        SearchRadius = config.Bind(
16            "Looting",
17            "Search Radius",
18            50f,
19            new ConfigDescription(
20                "Loot search distance in meters",
21                new AcceptableValueRange<float>(10f, 200f)
22            )
23        );
24    }
25}

Key Concepts

Common Patterns

Soft Dependency Check

When: Integrating with optional mods like SAIN

csharp
1private static bool _sainChecked;
2private static bool _sainAvailable;
3
4public static bool IsSAINAvailable()
5{
6    if (!_sainChecked)
7    {
8        _sainAvailable = Chainloader.PluginInfos.ContainsKey("me.sol.sain");
9        _sainChecked = true;
10    }
11    return _sainAvailable;
12}

Lifecycle Hooks

When: Responding to game events

csharp
1private void Awake()    // Plugin load - register patches, config
2private void Start()    // After all plugins loaded
3private void OnEnable() // Plugin enabled
4private void OnDisable() // Plugin disabled
5private void OnDestroy() // Cleanup resources

See Also

• patterns - Plugin structure, config, logging
• workflows - Build, deploy, debug

Related Skills

• harmony - Patching game methods
• csharp - Language patterns
• unity - MonoBehaviour lifecycle
• dotnet - Build and project configuration