Oraxen: ресурспак, текстуры и свои предметы

Установка

1. Купите Oraxen на SpigotMC или BuiltByBit и положите jar в plugins. Ядро должно быть Paper, Purpur или Folia.
2. Запустите сервер. Oraxen создаст plugins/Oraxen с папками items и pack и файлом settings.yml, а нужный PacketEvents скачает сам.
3. Сразу смените хостинг пака (следующий раздел), иначе игроки из России его не получат.
4. Выполните /oraxen reload all и перезайдите на сервер.

Хостинг ресурспака: почему не качается в России

По умолчанию Oraxen загружает пак в Oraxen Atlas (сервис Polymath на atlas.oraxen.com). В документации прямо сказано, что Atlas заблокирован в России и Китае. Если у вас русские игроки, переключите Pack.upload в settings.yml на свой хостинг.

Self-host: пак раздаёт сам сервер по HTTP. Нужен отдельный открытый порт.

Pack:
  upload:
    enabled: true
    type: self-host
    self-host:
      host: "0.0.0.0"
      port: 8080
      domain: "your-domain.example:8080"

В domain укажите внешний адрес сервера и тот же порт. На хостинге попросите выделить дополнительный порт. Мультиверсионные паки этот способ не поддерживает.

Другие варианты: lobfile (бесплатный файлообменник, нужен API-ключ из аккаунта Lobfile), собственный Polymath из репозитория oraxen/polymath и external для своего провайдера. Неизвестный type откатывается на Polymath.

Как пак отправляется игроку, задаёт секция Pack.dispatch: ключи send, mode (JOIN или PRE-JOIN), mandatory, prompt и delay.

Свой предмет с текстурой

Предметы описываются в любых yml внутри plugins/Oraxen/items/. Пример меча из документации:

my_item:
  itemname: "<red>My Cool Item"
  material: IRON_SWORD
  Pack:
    generate_model: true
    parent_model: item/handheld
    textures:
      - weapons/swords/ice_sword

• Картинку кладёте в plugins/Oraxen/pack/textures/weapons/swords/ice_sword.png. Путь в textures считается от pack/textures/ и пишется без .png.
• generate_model: true обязателен, если модель строится из текстуры: по умолчанию он фактически выключен.
• parent_model: item/handheld держит предмет в руке как инструмент, для плоских предметов берут item/generated.
• Имя пишется в формате MiniMessage, отсюда <red>.

Дальше /oraxen reload all и /oraxen give ник my_item.

Меню предметов Oraxen

Все загруженные предметы собраны в браузере /oraxen inventory (коротко /o inv). Для него нужно право oraxen.command.inventory.view, а для самой команды корневое oraxen.command. Выдавать это игрокам стоит только на креативе или тестовом сервере: из меню можно забрать любой предмет.

Игрокам обычно открывают /oraxen emojis (право oraxen.command.emojis) и просмотр рецептов /oraxen recipes show (право oraxen.command.recipes.show).

Oraxen и Nexo

Nexo часто называют преемником Oraxen, но официально это отдельный платный плагин (€19.99, Paper и Folia 1.21.4+). Oraxen при этом продолжает обновляться. У Nexo есть официальная инструкция по переезду с конвертером конфигов: docs.nexomc.com/migrate/oraxen-nexo. Переходить имеет смысл, если сервер уже на 1.21.4+ и вам нужны возможности именно Nexo.

Частые проблемы

• Игроки видят ванильные предметы. Пак не скачался: проверьте тип хостинга, у русских игроков Atlas не работает.
• Пак собрался криво после правок. Удалите plugins/Oraxen/pack/pack.zip и выполните /oraxen reload pack.
• Плагин не запускается на Spigot. Oraxen работает только на Paper и форках.
• Нужна стандартная структура пака. /oraxen pack extract_default распакует файлы по умолчанию.