菜单
Creates Harmony patches for method interception and runtime modification in BepInEx plugins. Use when: intercepting EFT game methods, modifying bot behavior, hooking into game lifecycle events, or patching third-party mod methods.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Develops BepInEx plugins with hooks, patches, and mod initialization for Unity games. Use when: Creating BepInEx plugins, setting up plugin entry points, configuring mod settings, or integrating with Harmony patches.
Manages C# syntax, patterns, and language features for .NET projects Use when: Writing C# code, implementing BigBrain layers, creating BepInEx plugins, handling Unity interop, or working with EFT APIs
Integrates Unity APIs, MonoBehaviours, and game engine components for SPT/EFT modding. Use when: Working with Unity GameObjects, transforms, physics, NavMesh, coroutines, or any UnityEngine namespace.
Writes and manages xUnit tests with FluentAssertions and Moq for BotMind mod testing. Use when: writing unit tests, creating test fixtures, mocking EFT/Unity dependencies, or validating bot behavior logic.
| name | harmony |
| description | Creates Harmony patches for method interception and runtime modification in BepInEx plugins. Use when: intercepting EFT game methods, modifying bot behavior, hooking into game lifecycle events, or patching third-party mod methods. |
| allowed-tools | Read, Edit, Write, Glob, Grep, Bash |
Harmony is the runtime patching library used by BepInEx to intercept and modify game methods without touching original assemblies. In BotMind, Harmony patches are used to hook into EFT's game lifecycle (raid start/end), bot spawning events, and player interactions. All patches live in src/client/Patches/ and are auto-applied via Harmony.PatchAll() in BotMindPlugin.cs.
[HarmonyPatch(typeof(GameWorld), nameof(GameWorld.OnGameStarted))]
internal static class GameStartedPatch
{
[HarmonyPrefix]
private static void Prefix()
{
try
{
MedicBuddyController.Instance?.OnRaidStarted();
BotMindPlugin.Log?.LogInfo("Raid started - modules initialized");
}
catch (Exception ex)
{
BotMindPlugin.Log?.LogError($"GameStartedPatch error: {ex.Message}");
}
}
}
[HarmonyPatch(typeof(GameWorld), "Dispose")]
internal static class GameWorldDisposePatch
{
[HarmonyPostfix]
private static void Postfix()
{
MedicBuddyController.Instance?.OnRaidEnded();
LootFinder.ClearCache();
}
}
| Concept | Usage | Example |
|---|---|---|
[HarmonyPatch] | Declares target method | [HarmonyPatch(typeof(BotOwner), "Update")] |
[HarmonyPrefix] | Runs before original, can skip | Return false to skip original |
[HarmonyPostfix] | Runs after original | Access __result to modify return |
[HarmonyTranspiler] | IL-level modification | Inject/remove instructions |
__instance | Reference to patched object | BotOwner __instance |
__result | Return value (postfix only) | ref bool __result |
When: Skip original method based on custom logic
[HarmonyPrefix]
private static bool Prefix(BotOwner __instance)
{
// Skip original if MedicBuddy bot
if (MedicBuddyController.IsMedicBuddyBot(__instance))
return false; // Don't run original
return true; // Run original
}
When: Change what a method returns without rewriting it
[HarmonyPostfix]
private static void Postfix(ref bool __result, BotOwner __instance)
{
// Force bots to always consider looting safe
if (BotMindConfig.ForceEnableLooting.Value)
__result = true;
}
When: Read/write private state from patched class
[HarmonyPostfix]
private static void Postfix(BotOwner __instance)
{
var privateField = Traverse.Create(__instance)
.Field("_internalState")
.GetValue<BotState>();
}