Установка пакетов транспорта

Пакет транспорта — это машина, которую сделал кто-то другой: файл .zip или папка. Пакет — не мод: он не кладётся в mods и не требует ничего, кроме Vettura и Vextris (см. Установка и начало).

В пакете только модели, текстуры, звуки и файлы настроек, никакого программного кода.

Куда класть

Пакеты кладутся в папку vettura/packs внутри папки игры. Папка игры — это папка, в которой лежит ваша папка mods: vettura находится рядом с mods:

<папка игры>/
├─ mods/
│  ├─ vettura-1.0.0.jar
│  └─ vextris-forge-1.20.1-0.1.2.jar
└─ vettura/
   └─ packs/
      └─ пакет-сюда.zip

Папка vettura/packs создаётся при первом запуске игры с установленной Vettura. Если её нет, запустите игру один раз и закройте, или создайте обе папки сами.

Папка игры в популярных лаунчерах:

Лаунчер	Папка игры
Официальный лаунчер	.minecraft (Windows: %appdata%\.minecraft)
Приложение CurseForge	curseforge/minecraft/Instances/<имя профиля> (у профиля: «…» → «Open Folder»)
Prism Launcher, MultiMC	instances/<имя экземпляра>/minecraft или .minecraft (правый клик по экземпляру → «Папка»)
HMCL, PCL2 с изоляцией версий (по умолчанию)	.minecraft/versions/<имя версии>
HMCL, PCL2 без изоляции версий	.minecraft

Не уверены? Откройте папку mods кнопкой лаунчера и поднимитесь на уровень выше — это и есть папка игры.

Установка

1. Закройте игру;
2. Скачайте пакет — получится файл .zip;
3. Положите этот zip как есть в <папка игры>/vettura/packs/. Не распаковывайте;
4. Запустите игру;
5. В творческом мире откройте вкладку «Vettura · Транспорт»: машины из пакета там.

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

Правильно ли он лежит

Откройте zip (или папку пакета): pack.json должен лежать на самом верхнем уровне, рядом с папками vehicles, assets и другими:

✔ Правильно
vettura/packs/
└─ coolcars.zip
   ├─ pack.json
   ├─ vehicles/
   ├─ assets/
   └─ data/

✘ Лишняя папка (самая частая ошибка)
vettura/packs/
└─ coolcars.zip
   └─ coolcars/          ← эта лишняя папка
      ├─ pack.json
      └─ ...

Пакет с лишней папкой пропускается, и его машин в игре нет. Как исправить: откройте внутреннюю папку, выделите всё, что в ней, и снова упакуйте в zip; или просто перетащите внутреннюю папку в vettura/packs (пакет в виде папки тоже работает).

Другие частые ошибки:

Что произошло	Результат и решение
Пакет в формате .rar или .7z	Не читается. Распакуйте и снова упакуйте в .zip, как выше, или положите распакованную папку
Пакет лежит в mods	Не читается. Перенесите в vettura/packs
Лежит в .minecraft/vettura/packs, но включена изоляция версий	Игра читает собственную папку версии: положите в .minecraft/versions/<имя версии>/vettura/packs
Две копии одного пакета (старая и новая)	Читается только одна, другая пропускается, и не обязательно новая. Удалите старую
Браузер дописал (1) к имени файла	Не важно: имя файла может быть любым, значение имеет pack.json внутри

Если с пакетом что-то не так

• Если в файлах пакета есть ошибка, при входе в мир в чате появится сообщение («Пакет транспорта xxx: …») с файлом и описанием ошибки. Остальные машины пакета работают. Отправьте эту строку автору пакета.
• В logs/latest.log в папке игры записано, какие пакеты прочитаны; ищите Vehicle pack:
  • Vehicle pack coolcars 1.0.0 (coolcars.zip): 3 vehicle(s): прочитан, в нём 3 машины;
  • has no pack.json at its top; skipped: лишняя папка, см. выше;
  • its id ... is taken by another pack: один и тот же пакет лежит дважды.

Обновление и удаление

• Обновление: закройте игру, удалите старый zip, положите новый, запустите игру.
• Удаление: закройте игру и удалите zip. Машины этого пакета, уже стоящие в ваших мирах, не пропадут: без пакета они пока выглядят как T15, а когда вы вернёте пакет, станут прежними.

Мультиплеер

1. Положите пакет в vettura/packs/ сервера (папка сервера — та, где лежит его папка mods) и перезапустите сервер;
2. Каждый игрок кладёт тот же самый файл пакета в vettura/packs/ своей папки игры и перезапускает игру;
3. При входе Vettura сравнивает ваши пакеты с серверными и пишет в чат, если они различаются:

Сообщение	Что значит и что делать
Пакет транспорта xxx есть на сервере, но не у вас	У вас нет этого пакета, и вы не видите эти машины. В сообщении указана папка, куда его положить; положите и перезапустите игру
Пакет транспорта xxx отличается от серверного	Другая версия или изменённый файл. Попросите тот же файл у администратора сервера
Пакет транспорта xxx есть у вас, но не на сервере	Эти машины на этом сервере появиться не могут. Больше ни на что не влияет; чтобы сообщение пропало, уберите пакет из своей vettura/packs

Администраторам: раздавайте игрокам ровно те файлы пакетов, что стоят на сервере, — так ошибок гораздо меньше, чем когда каждый качает сам.

Сделать свой пакет

См. Making a Vehicle (на английском), начиная со страницы Vehicle Pack.