Упаковка и публикация

Правильно:

example.splug
├─ manifest.json
├─ main.lua
├─ modules/
└─ assets/

Пакет можно создать любым стандартным ZIP-инструментом:

1. Откройте каталог проекта плагина.
2. Выберите manifest.json, точку входа Lua и остальные файлы и каталоги плагина. Не выбирайте внешний каталог проекта.
3. Создайте обычный ZIP-архив без пароля и шифрования.
4. Откройте архив и убедитесь, что manifest.json находится прямо в корне.
5. Проверьте, что вложенные записи используют /, например modules/settings.lua.
6. Переименуйте example.zip в example.splug.
7. Импортируйте файл в приложение и проверьте чистую установку.

Windows

Архивы с \ в именах вложенных записей отклоняются. Перед публикацией откройте готовый архив и проверьте хотя бы одну вложенную запись.

Использование Plugin Tools

Репозиторий Plugin Tools предоставляет CLI samp-plugin для автоматизации проверки и упаковки. Это рекомендуемый способ убедиться, что ваш пакет соответствует всем требованиям клиента.

# Проверить исходный каталог плагина
samp-plugin validate path/to/plugin

# Упаковать в .splug файл
samp-plugin pack path/to/plugin

# Проверить существующий .splug пакет
samp-plugin validate my-plugin-1.0.0.splug

Репозиторий также содержит примеры плагинов, демонстрирующие полный API.

Контрольная сумма

Публикуйте SHA-256 точного файла .splug:

Windows PowerShell

Get-FileHash .\example.splug -Algorithm SHA256

Linux

sha256sum example.splug

macOS

shasum -a 256 example.splug

При каждом изменении увеличивайте версию, не переиспользуйте одну версию для разных файлов, точно объявляйте permissions и API, тестируйте оба ABI и публикуйте SHA-256 точного пакета.