Перейти к основному содержимому
Версия: Далее

Ресурсы (или же Assets)

Просто кинуть файл, а папку assets - это глупая ошибка.

resources

Папка assets работает как и ресурс-паки, но без необходимости создания архивов под ваши ресурсы.



Resource Location​

Resource Location в Minecraft часто используется в качестве идентификатора для предметов, а также для указания местоположения файлов ресурсов, таких как модели и текстуры.

Структура​

Resource Location состоит из двух строк: пространства имён (namespace) и пути (path). Пространство имён, как правило, является идентификатором мода (mod id). Путь может быть именем (для предметов) или путём к файлу (для ресурсов).

Также, Resource Location можно записать как: namespace:path.

Регистр символов​

В Resource Location не следует использовать заглавные буквы и специальные символы. Это может привести к проблемам при работе с ресурсами, особенно на разных операционных системах.

Рекомендуется, чтобы Resource Location состоял только из строчных букв (английского алфавита), цифр, символов подчёркивания (_) и дефисов (-).

Преобразование в путь к файлу​

Когда Resource Location указывает на ресурс мода или файл, он ссылается на определённое место в файловой системе. Все ресурсы загружаются одинаково.

Для загрузки ваших ресурсов рекомендуется использовать папки assets и data, которые автоматически создаются в папке hollowengine, но можно использовать и другие методы для загрузки ресурсов, включая сторонние моды и ресурс-паки.


Папка assets используется для клиентских ресурсов, включая модели, текстуры, файлы перевода, аудио и т.п.


Папка data используется для серверных ресурсов, включая рецепты, структуры, достижения и т.п.

Полный путь формируется следующим образом:

  • Размещаете ваши ресурсы по корневому пути (.minecraft/hollowengine/assets/ или .minecraft/hollowengine/data/).
  • Создаёте пространство имён. (mod id)
  • Указываете оставшийся путь до вашего ресурса.

Например: .minecraft/hollowengine/assets/mod_id/models/npcs/example.gltf.


Здесь у нас корневой путь: .minecraft/hollowengine/assets/.


Пространство имён: mod_id.


Оставшийся путь models/npcs/example.gltf.

А в скрипте уже указывается путь в формате namespace:path, в данном случае: mod_id:models/npcs/example.gltf.

Модели​

Модели

Список поддерживаемых форматов:

  • glTF [.gltf]
  • GLB [.glb]

Все модели указываются в вашем пространстве имён в папке models. В ней вы уже можете создавать дочерние папки при необходимости.

Подсказка: Если вам нужна информация о модели, попробуйте команду /hollowengine model <resource location>


Текстуры​

Текстуры

Список поддерживаемых текстур:


Статичные:

  • PNF [.png]
  • Jpeg [.jpg, jpeg]

Анимированые:

  • GIF [.gif]
  • APNG [.png] - рекомендуется использовать его, у него лучше цветопередача.

Все текстуры указываются в вашем пространстве имён в папке textures. В ней вы уже можете создавать дочерние папки при необходимости.


Аудио, Звуки, Музыка​

Звуки

Список поддерживаемых звуков:

  • Vorbis [.ogg]
  • Waveform Audio File [.wav]
  • MP3 [.mp3]

Все звуки указываются в вашем пространстве имён в папке audio. В ней вы уже можете создавать дочерние папки при необходимости. Примечание: Стандартная папка sounds не используется, чтобы не было конфликтов с другими модами и их звуками, HollowCore использует свой способ загрузки для поддержки разных форматов.


Предупреждение

Игра сама не перезагрузит ваши ресурсы при изменении. После любого изменения ресурсов необходимо перезагрузить ресурсы.
Сделать это можно сочетанием клавиш F3 + T или в редакторе кода во вкладке Файл.