Ресурсы (или же Assets)
Просто кинуть файл, в папку assets - это глупая ошибка.
Папка 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 или в редакторе кода во вкладке Файл.