Пользовательские модули Lampac: Roslyn-компиляция

Lampac NextGen позволяет расширять функциональность через пользовательские модули. Достаточно создать каталог в mods/, добавить manifest.json и файлы .cs — Roslyn скомпилирует код при запуске сервера. С включённым флагом dynamic: true пересборка происходит автоматически при изменении исходников, без перезапуска.

Создайте каталог модуля

Создайте папку внутри mods/ с произвольным именем, например mods/MyModule/.

Напишите manifest.json

Манифест описывает метаданные модуля и управляет его загрузкой.

{
  "enable": true,
  "dynamic": true,
  "tree": [
    "Controller.cs",
    "ModInit.cs"
  ]
}

Поле	Тип	Описание
`enable`	boolean	Включён ли модуль
`dynamic`	boolean	Горячая пересборка при изменении `.cs`
`tree`	string[]	Файлы, включаемые в Roslyn-компиляцию

Напишите .cs-файлы

Добавьте в mods/MyModule/ один или несколько .cs-файлов с логикой модуля. Используйте интерфейсы IModuleLoaded и IModuleConfigure для интеграции с жизненным циклом приложения.

using Shared.Models.Events;
using Shared.Models.Module;
using Shared.Models.Module.Interfaces;
using Shared.Services;

namespace MyModule
{
    public class ModInit : IModuleLoaded
    {
        public static ModuleBaseConf conf;

        public void Loaded(InitspaceModel baseconf)
        {
            updateConf();
            EventListener.UpdateInitFile += updateConf;
        }

        public void Dispose()
        {
            EventListener.UpdateInitFile -= updateConf;
        }

        void updateConf()
        {
            conf = ModuleInvoke.Init("MyModule", new ModuleBaseConf { enable = true });
        }
    }
}

Перезапустите сервер

При первой загрузке Roslyn скомпилирует ваш модуль. Если dynamic включён, последующие изменения .cs-файлов будут пересобираться автоматически.

Фильтрация модулей через LoadModules

Состав загружаемых модулей можно ограничить с помощью BaseModule.LoadModules в init.conf. Поддерживаются имя модуля, группа (например, OnlineUKR) или маска по регулярному выражению.

Паттерн	Пример	Описание
Имя модуля	`MyModule`	Загружает конкретный модуль
Группа	`OnlineUKR`	Загружает все модули группы
Маска	`LME.*`	Загружает модули по регулярному выражению

{
  "BaseModule": {
    "LoadModules": [".*"]
  }
}

Монтирование в Docker

При запуске в Docker примонтируйте каталог с пользовательским модулем как том:

services:
  lampac:
    image: ghcr.io/lampac-nextgen/lampac
    volumes:
      - ./lampac-docker/mods/MyModule:/lampac/mods/MyModule

Установите "dynamic": true в manifest.json. Roslyn отслеживает изменения .cs-файлов в каталоге модуля и пересобирает сборку на лету. Это удобно для разработки и отладки.

Начало работы

Конфигурация

Архитектура

Модули

Провайдеры

Развёртывание

Обслуживание

Пользовательские модули Lampac: Roslyn-компиляция

Фильтрация модулей через LoadModules

Монтирование в Docker

​Фильтрация модулей через LoadModules

​Монтирование в Docker

Фильтрация модулей через LoadModules

Монтирование в Docker