К основному содержанию
скилл CX Codex

unity-modding — скилл для Claude Code: моды Unity и установка

Скилл unity-modding помогает спроектировать моддинг Unity: загрузку ассетов, Lua-скрипты, менеджер модов и интеграцию со Steam Workshop.

MIT 132 установок ★ 66 обновлён 2026-06-18

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add JosiahSiegel/claude-plugin-marketplace --skill unity-modding -a claude-code
Открыть на GitHub

Что делает unity-modding

Скилл разбирает уровни моддинга Unity: от конфигов, текстур и звуков до Asset Bundles, скриптовых модов и патчинга кода. Он помогает выбрать между Addressables и Asset Bundles, загружать каталоги и бандлы во время работы игры, а также делать горячую перезагрузку JSON- и CSV-данных.

Для скриптов используется MoonSharp с ограниченным API игры. В материалах есть схема ModManager, манифесты с зависимостями и версиями игры, загрузка модов из Steam Workshop через Steamworks.NET или Facepunch.Steamworks, а также подходы к Harmony и BepInEx. MoonSharp ставится через NuGet или DLL. Lua нельзя давать доступ к System.IO, HTTP и сокетам: для недоверенных модов нужны ограничения API и числа инструкций.

Какие задачи решает

  • спроектировать уровни поддержки модов в Unity
  • загружать Asset Bundles и Addressables из папки мода
  • подключить Lua-скрипты через MoonSharp
  • собрать менеджер модов с манифестами и зависимостями
  • добавить загрузку контента из Steam Workshop

Примеры запросов агенту

  • Спроектируй архитектуру моддинга для Unity-игры с поддержкой конфигов, Asset Bundles и Lua через MoonSharp.
  • Сравни Addressables и Asset Bundles для загрузки модов из локальной папки и предложи схему ModManager.
  • Добавь безопасный Lua API для мода: создание сущностей, получение здоровья игрока и обработка событий.

Как установить unity-modding

1Через Skills CLI (Vercel)

npx skills add JosiahSiegel/claude-plugin-marketplace --skill unity-modding -a claude-code

2Вручную: положить файлы

~/.claude/skills/unity-modding/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/unity-modding/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы об unity-modding

Как установить unity-modding в Claude Code?

Выполните npx skills add JosiahSiegel/claude-plugin-marketplace --skill unity-modding -a claude-code. Файл скилла появится по пути ~/.claude/skills/unity-modding/SKILL.md.

Что делает скилл unity-modding?

Он помогает проектировать моддинг Unity: загрузку ассетов и данных, Lua API, менеджер модов, Steam Workshop и патчинг существующей игры через Harmony.

Как ограничить Lua-моды в Unity?

Не открывайте Lua доступ к System.IO, HTTP и сокетам. Ограничьте зарегистрированные типы и задайте лимит инструкций через script.Options.InstructionLimit.

Исходный текст

SKILL.md · MIT
---
name: unity-modding
description: |
  Unity game modding architecture and mod-loading systems.
  PROACTIVELY activate for: (1) adding modding support to a Unity game, (2) Asset Bundles for mods, (3) Addressables for mod content, (4) Lua scripting via MoonSharp, (5) Harmony patching for runtime IL injection, (6) Steam Workshop integration, (7) mod manager UI, (8) plugin architecture for user-generated content (UGC), (9) custom content loading at runtime, (10) sandboxing and security for untrusted mods.
  Provides: AssetBundle vs Addressables tradeoffs, MoonSharp setup, Harmony patch patterns, Steam Workshop SDK integration, mod manager templates, and security guidelines.
---

# Unity Modding Architecture

## Overview

Guide for designing Unity games that support community modding. Covers asset loading systems, scripted mod APIs, mod manager patterns, distribution platforms, and techniques for modding existing games.

## Modding Architecture Tiers

| Tier | What Modders Can Do | Complexity |
|------|---------------------|------------|
| **Data Mods** | Replace textures, sounds, configs (JSON/XML) | Low |
| **Asset Mods** | Add new models, maps, items via Asset Bundles | Medium |
| **Script Mods** | Custom game logic via Lua/scripting API | High |
| **Code Mods** | Patch game assemblies via Harmony/BepInEx | Expert |

Design your game to support at least Tier 1-2 from the start. Tiers 3-4 require deliberate API design.

## Asset Loading for Mods

### Addressables (Recommended)

Addressables provide a unified API for loading assets from local bundles, remote servers, or mod directories.

```csharp
// Load a mod's asset catalog at runtime
public async Awaitable LoadModCatalog(string modPath)
{
    string catalogPath = Path.Combine(modPath, "catalog.json");
    var locator = await Addressables.LoadContentCatalogAsync(catalogPath);
    Debug.Log($"Loaded mod catalog with {locator.Keys.Count()} assets");
}

// Load an asset by address (works for both base game and mods)
var prefab = await Addressables.LoadAssetAsync<GameObject>("enemies/goblin");
Instantiate(prefab);
```

**Mod workflow:**
1. Modders use a Unity project with Addressables configured
2. Build Addressable groups into Asset Bundles
3. Ship the catalog.json + .bundle files
4. Game loads catalogs at runtime from the mod directory

### Asset Bundles (Legacy but Simpler)

```csharp
public async Awaitable<AssetBundle> LoadModBundle(string path)
{
    var request = AssetBundle.LoadFromFileAsync(path);
    await request;
    return request.assetBundle;
}

// Load specific asset from bundle
var bundle = await LoadModBundle("mods/weapons/swords.bundle");
var swordPrefab = bundle.LoadAsset<GameObject>("BroadSword");
```

**Key rules:**
- Never load the same bundle twice (track loaded bundles)
- Unload bundles when mods are disabled: `bundle.Unload(true)`
- Use `AssetBundle.LoadFromFileAsync` for local files (not `LoadFromMemory`)

### Hot-Reloadable Data Mods

For simple data mods (JSON configs, CSV tables):

```csharp
public T LoadModConfig<T>(string modPath, string fileName)
{
    string filePath = Path.Combine(modPath, fileName);
    if (!File.Exists(filePath)) return default;
    string json = File.ReadAllText(filePath);
    return JsonUtility.FromJson<T>(json);
}
```

Use `FileSystemWatcher` to detect changes and hot-reload during development.

## Lua Scripting with MoonSharp

MoonSharp is a Lua interpreter written in C# that runs on all Unity platforms.

### Setup

Install via NuGet or download the DLL. Register safe API surfaces for modders:

```csharp
public class ModScriptEngine
{
    Script _lua;

    public void Initialize()
    {
        _lua = new Script();

        // Register safe game API
        _lua.Globals["SpawnEntity"] = (Func<string, float, float, float, bool>)SpawnEntity;
        _lua.Globals["GetPlayerHealth"] = (Func<float>)(() => player.Health);
        _lua.Globals["ShowMessage"] = (Action<string>)ShowMessage;
        _lua.Globals["RegisterEvent"] = (Action<string, DynValue>)RegisterEvent;
    }

    public void LoadMod(string luaFilePath)
    {
        string code = File.ReadAllText(luaFilePath);
        _lua.DoString(code);
    }

    bool SpawnEntity(string id, float x, float y, float z)
    {
        // Validate and spawn - never trust mod input
        if (!entityRegistry.Contains(id)) return false;
        var pos = new Vector3(x, y, z);
        if (!IsValidSpawnPosition(pos)) return false;
        entityRegistry.Spawn(id, pos);
        return true;
    }
}
```

### Modder-Side Lua

```lua
-- my_mod/init.lua
RegisterEvent("OnPlayerEnterZone", function(zoneName)
    if zoneName == "boss_arena" then
        SpawnEntity("dragon_boss", 0, 5, 0)
        ShowMessage("A dragon appears!")
    end
end)
```

### Security Considerations

| Risk | Mitigation |
|------|-----------|
| File system access | Do NOT expose System.IO to Lua |
| Infinite loops | Set instruction count limits: `script.Options.InstructionLimit = 100000` |
| Memory abuse | Limit table sizes, monitor allocation |
| Network access | Never expose HTTP/socket APIs |
| Reflection abuse | MoonSharp sandboxes by default, but validate registered types |

## Mod Manager Pattern

### Architecture

```text
Game
├── ModManager (singleton)
│   ├── DiscoverMods(modsFolder)     // Scan for mod manifests
│   ├── ValidateMod(manifest)        // Version compat, dependencies
│   ├── LoadMod(modId)               // Load assets + scripts
│   ├── UnloadMod(modId)             // Clean teardown
│   └── GetLoadOrder()               // Dependency-sorted order
├── ModManifest (ScriptableObject / JSON)
│   ├── id, name, version, author
│   ├── dependencies[]
│   ├── gameVersionMin / gameVersionMax
│   └── entryPoint (script path)
└── ModSandbox
    ├── Lua scripting environment
    └── Restricted API surface
```

### Mod Manifest Format

```json
{
    "id": "com.author.mymod",
    "name": "My Awesome Mod",
    "version": "1.2.0",
    "author": "ModAuthor",
    "description": "Adds new enemies and weapons",
    "gameVersionMin": "1.0.0",
    "gameVersionMax": "2.0.0",
    "dependencies": ["[email protected]"],
    "entryPoint": "scripts/init.lua",
    "assets": "bundles/"
}
```

## Steam Workshop Integration

Use Steamworks.NET or Facepunch.Steamworks for Steam Workshop integration:

1. **Upload:** Modder packages mod folder, calls `SteamUGC.CreateItem` + `SteamUGC.SubmitItemUpdate`
2. **Subscribe:** Players subscribe in Steam Workshop UI
3. **Download:** Game queries `SteamUGC.GetSubscribedItems()` at startup
4. **Load:** Read from `SteamUGC.GetItemInstallInfo` path into ModManager

## Harmony Patching (Modding Existing Games)

Harmony is used by modders (via BepInEx/MelonLoader) to patch compiled game code at runtime.

```csharp
[HarmonyPatch(typeof(PlayerHealth), "TakeDamage")]
class DamageModifier
{
    // Prefix: runs before original method
    static bool Prefix(ref float damage)
    {
        damage *= 0.5f; // Halve all damage
        return true;    // true = continue to original
    }

    // Postfix: runs after original method
    static void Postfix(PlayerHealth __instance)
    {
        Debug.Log($"Health after damage: {__instance.CurrentHealth}");
    }
}
```

If designing a game intended to be modded via Harmony, avoid aggressive code obfuscation and keep method signatures stable across updates.

## Additional Resources

### Reference Files
- **`references/mod-framework-detail.md`** -- Complete mod manager implementation, dependency resolution algorithm, mod load ordering, versioned API patterns, hot-reload systems, mod testing frameworks, BepInEx/MelonLoader setup guide

© JosiahSiegel · MIT · JosiahSiegel/claude-plugin-marketplace

Похожие скиллы

Все скиллы по теме «Геймдев и 3D: Unity, Unreal, Godot, Blender» →
scenario-unity-pipeline-automation scenario-labs Скилл scenario-unity-pipeline-automation для Claude Code, Codex, Cursor, Copilot, Gemini CLI и OpenCode — автоматизирует импорт ассетов (FBX, PNG), сборку префабов, Addressables, CI-билды в Unity 6.3. CX Codex +1 567установок Unity Game Project taste f Промпт Unity Game Project taste для ChatGPT с правилами разработки Unity-игры. Задаёт подход к коду, ассетам, тестам и сборкам проекта. GP ChatGPT ★ 178 201звёзд репо reverse-engineering rehan-remade Скилл reverse-engineering учит агента разбирать игровой код и форматы данных для моддинга. Декомпилирует .NET, IL2CPP, Java и нативный код, читает память процесса и дампит GPU-кадры. CX Codex +1 2 200установок unity-csharp-scripting gamedev-skills Скилл unity-csharp-scripting для Claude Code пишет и исправляет игровые скрипты на C# для Unity 6.3 LTS. Подключается при создании или переименовании .cs-файлов, ошибке «Missing script» и пропавшем поле в Inspector. CX Codex +1 11 700установок unity-animation gamedev-skills Скилл unity-animation для Claude Code управляет анимацией персонажей в Unity 6.3 LTS через контроллеры Animator и Mecanim. CX Codex +1 11 400установок unity-package-management Unity-Technologies Скилл unity-package-management управляет пакетами UPM вне редактора Unity через команды Pipeline или C#-скрипт. Пригодится при настройке зависимостей проекта и в CI. CX Codex +1 9 000установок

Из того же набора96

Весь набор →
advanced-array-patterns Скилл advanced-array-patterns для Claude Code собирает шаблоны работы с массивами Bash: индексированные и ассоциативные массивы, mapfile, срезы и безопасная обработка при set -u. CX Codex +1 155установок ffmpeg-noise-reduction Скилл ffmpeg-noise-reduction для Claude Code — справочник по фильтрам FFmpeg для шумного видео и звука: помогает выбрать фильтр и параметры под тип помех. CX Codex +1 150установок cloudflare-knowledge Скилл cloudflare-knowledge для Claude Code открывает справочные файлы о Workers, Pages, R2, D1, Workers AI и Zero Trust для настройки Cloudflare. CX Codex +1 139установок unity-shaders-rendering Скилл unity-shaders-rendering для Claude Code даёт справочник по шейдерам, пайплайнам URP и HDRP и освещению в Unity. Помогает писать HLSL-код и собирать графы. CX Codex +1 133установок viral-video-hook-templates Скилл viral-video-hook-templates для Claude Code содержит 10 шаблонов хуков и фильтры FFmpeg для первых 3 секунд видео. Помогает тестировать варианты заставок и удерживать внимание зрителей. CX Codex +1 131установок markdown-style Скилл markdown-style проверяет Markdown в два прохода: сначала синтаксис по канону, потом стиль. Показывает находки построчно и правит только то, что вы одобрили. CX Codex +1 125установок ffmpeg-karaoke-animated-text Скилл ffmpeg-karaoke-animated-text помогает ассистенту собирать команды FFmpeg и разметку ASS для караоке, титров и анимации текста. Пригодится при монтаже роликов и клипов. CX Codex +1 121установок skill-development Скилл skill-development для Claude Code описывает правила SKILL.md для плагинов Claude: фронтматтер, структуру каталогов и исправление скиллов, которые не срабатывают. CX Codex +1 116установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой