Гараж FiveM: owned_vehicles и player_vehicles, отсутствующие машины исправлены

Типичные симптомы:

You bought a car, and the garage says "No vehicles". Or the car was parked at the street, the server restarted, and it is gone.

Почти каждый скрипт гаража читает то же самое: одна таблица с одной строкой за принадлежащее транспортное средство. Когда машина отсутствует, строка неправильна, а не скрипт. Эта статья объясняет две стандартные таблицы, что означают сохраненные и столбцы состояния, и SQL, который исправляет обычные случаи.

#Две таблицы

ESX использует owned_vehicles. QBCore и QBox используют player_vehicles. Имена одинаковые на серверах, точные столбцы зависят от вашей версии и вашего скрипта гаража, поэтому сначала посмотрите вашу:

DESCRIBE owned_vehicles;
DESCRIBE player_vehicles;

#ESX: owned_vehicles

Основные столбцы в ESX Legacy:

Скрипты гаража добавляют свои собственные столбцы, например для названия гаража или состояния фунта.

#QBCore и QBox: player_vehicles

QBox использует ту же таблицу с теми же идеями. Другие столбцы, такие как финансовые данные, различаются.

#Свойства как JSON

Столбец vehicle на ESX и столбец mods на QBCore содержат внешний вид и настройку машины как JSON: цвета, моды, колеса, номер и так далее. Гараж читает это, когда вы выводите машину, и пишет это снова, когда вы ее паркуете.

-- when storing, on the client
local props = lib.getVehicleProperties(vehicle)
TriggerServerEvent('my_garage:store', plate, json.encode(props))

JSON должна быть действительна. Если скрипт написал сломанную строку, машина не может быть восстановлена и спавнится обычная или вообще не спавнится. Статья о vehicle properties показывает, как построить и применить их.

#Транспортные средства отсутствуют в гараже

Запустите эти по порядку.

#1. Строка существует, но принадлежит кому-то еще

Список гаража фильтруется по владельцу. Если значение владельца не то, которое использует сервер для вашего персонажа, строка невидима:

SELECT owner, plate, stored FROM owned_vehicles WHERE plate = 'MIC 001';

SELECT citizenid, license, plate, state FROM player_vehicles WHERE plate = 'MIC 001';

Сравните владельца с вашим реальным персонажем:

• ESX: идентификатор в users.identifier для этого персонажа. С многопласштным скриптом он может иметь префикс, такой как char1:, и машина, купленная до установки мультиперсонажа, имеет старое значение без него.
• QBCore и QBox: citizenid в таблице players.

После изменения фреймворка, импорта с другого сервера или ручной вставки это наиболее распространенная причина. Исправьте это, направив строку на правильное значение:

UPDATE owned_vehicles SET owner = 'char1:abcdef...' WHERE plate = 'MIC 001';
UPDATE player_vehicles SET citizenid = 'ABC12345' WHERE plate = 'MIC 001';

Замените значения на реальные из ваших таблиц.

#2. Состояние застряло "снаружи"

Машина, которую вы вывели и которая никогда не вернулась, например после краша или перезагрузки, остается помеченной как снаружи. Гараж перечисляет только припаркованные машины.

ESX, установите сохраненный флаг обратно:

UPDATE owned_vehicles SET `stored` = 1 WHERE `stored` = 0;

QBCore и QBox, установите состояние на garaged:

UPDATE player_vehicles SET state = 1 WHERE state = 0;

Внимание: на живом сервере это также хранит машины, на которых игроки ездят прямо сейчас. Запустите это при запуске, или ограничьте это WHERE на один номер или одного владельца.

Многие серверы запускают очистку подобно этому автоматически, когда ресурс запускается, так как после перезагрузки машина не может быть снаружи. Если ваш не запускает, вы можете сделать это сами:

-- server side, runs when the garage resource starts
AddEventHandler('onResourceStart', function(resource)
    if resource ~= GetCurrentResourceName() then return end
    MySQL.update('UPDATE player_vehicles SET state = 1 WHERE state = 0')
end)

Обратите внимание на обратные кавычки вокруг stored в запросе ESX: stored — зарезервированное слово в MySQL и не работает без них. Некоторые скрипты затем отправляют эти машины в состояние фунта вместо гаража, поэтому проверьте, что ожидает ваш гараж.

#3. ID гаража не совпадает

На QBCore столбец garage говорит, в каком гараже живет машина. Гараж, названный в вашем конфиге, который не в строке, или переименованный гараж, не показывает ничего. Перечислите используемые значения:

SELECT garage, COUNT(*) FROM player_vehicles GROUP BY garage;

Установите машины в гараж, который существует в вашем конфиге.

#4. Тип машины не совпадает

Скрипты гаража разделяют машины, лодки и самолеты по столбцу type или классу транспортного средства. Лодка, сохраненная как car, никогда не показывается в гараже лодок.

#Номера

Номер связывает мир, базу данных и ключи. Держите эти правила:

• Номер уникален за строку. Дубликат вызывает загрузку неправильной машины.
• Номер не более 8 символов в игре, столбец может быть длиннее на ESX.
• Пробелы считаются. MIC 001 и MIC001 — два номера, поэтому используйте один формат.

Для ключей смотрите vehicle keys.

#Добавить машину игроку с помощью SQL

Вы можете дать транспортное средство, вставив строку. Возьмите список столбцов из вашей собственной DESCRIBE, так как отсутствующий требуемый столбец делает вставку неудачной:

INSERT INTO owned_vehicles (owner, plate, vehicle, type, `stored`)
VALUES ('identifier-here', 'MIC 001', '{"model":-1130810103,"plate":"MIC 001"}', 'car', 1);

model в JSON — это хеш модели, а не имя. Ваш фреймворк или ваш гараж обычно имеют команду или функцию, которая делает это правильно, что является более безопасным способом, когда он существует.

#Контрольный список