SnAssets Library - General [26.2] [26.1.2] [1.21.11]

SnAssets - Как ссылаться на ассеты из другого мода
====================================================

ID мода / пространство имён:

snassets

SnAssets - это библиотека ассетов. Ваш мод должен зависеть от неё, а затем ссылаться на её ассеты по пространству имён.
Не копируйте фактические файлы PNG или OGG в ваш собственный мод.

1. Ссылки на текстуры частиц
--------------------------------

Текстуры частиц находятся здесь внутри SnAssets:

assets/snassets/textures/particle/

При ссылке на текстуру частиц из вашего собственного JSON-файла частиц используйте:

snassets:

Пример файла SnAssets:

assets/snassets/textures/particle/bang0.png

Ссылка из JSON-файла частиц вашего мода выглядит так:

assets/examplemod/particles/example_bang.json

{
"textures": [
"snassets:bang0"
]
}

Пример с несколькими кадрами:

{
"textures": [
"snassets:bang0",
"snassets:bang1",
"snassets:bang2",
"snassets:bang3"
]
}

Если текстура находится в подпапке, сохраняйте путь к подпапке.

Пример файла SnAssets:

assets/snassets/textures/particle/bulletholes/bullethole_basic.png

Ссылка:

snassets:bulletholes/bullethole_basic

Важно:

SnAssets предоставляет только файлы текстур.
Ваш собственный мод по-прежнему должен регистрировать или определять тип частиц, если это требуется вашим загрузчиком/версией.

2. Ссылки на звуки
---------------------

Звуковые файлы находятся здесь внутри SnAssets:

assets/snassets/sounds/

SnAssets также включает:

assets/snassets/sounds.json

Этот файл определяет ID звуковых событий для всех включённых OGG-файлов.

Пример звукового файла SnAssets:

assets/snassets/sounds/bulletimpact/bullethit_glass0.ogg

Прямой ID звукового события SnAssets:

snassets:bulletimpact/bullethit_glass0

Не включайте ".ogg" при ссылках на звуки.

Рекомендуемый метод совместимости
--------------------------------

Для наилучшей совместимости определите собственное звуковое событие в вашем моде и укажите в нём OGG-файл SnAssets.

Пример файла в вашем моде:

assets/examplemod/sounds.json

{
"weapon.bullet_hit_glass": {
"sounds": [
"snassets:bulletimpact/bullethit_glass0"
]
}
}

Ваш мод затем будет воспроизводить:

examplemod:weapon.bullet_hit_glass

Это позволяет вашему моду владеть звуковым событием, пока SnAssets предоставляет фактический аудиофайл.

Альтернативный прямой метод
-------------------------

Там, где ваш загрузчик, версия Minecraft, команда или API принимают звуковой идентификатор напрямую, вы можете использовать ID звукового события SnAssets:

snassets:bulletimpact/bullethit_glass0

Если ваш программный API требует зарегистрированные объекты SoundEvent, зарегистрируйте собственное звуковое событие и используйте рекомендуемый метод совместимости, описанный выше.

3. Примеры зависимостей
----------------------

Fabric fabric.mod.json:

{
"depends": {
"snassets": "*"
}
}

Forge / NeoForge mods.toml:

[[dependencies.examplemod]]
modId="snassets"
mandatory=true
versionRange="[1.0.0,)"
ordering="NONE"
side="BOTH"

Замените "examplemod" на ID вашего мода.

4. Правило использования
-------------

Разрешено:

Добавлять SnAssets как зависимость и ссылаться на его ассеты через JSON или код.

Запрещено:

Извлекать файлы PNG, OGG или другие файлы ассетов из SnAssets и вставлять их в ваш собственный мод.