Exports

차량의 연료를 읽거나 변경해야 하는 다른 리소스를 위한 4개의 클라이언트 사이드 export입니다. 이 페이지에는 리소스에 실제로 존재하는 내용만 문서화되어 있습니다.

client-side

local fuel = exports['bupa-fuel']:GetFuel(vehicle)
exports['bupa-fuel']:SetFuel(vehicle, 75.0)
local kind = exports['bupa-fuel']:GetFuelType(vehicle)
local ev   = exports['bupa-fuel']:IsElectric(vehicle)

Export	Arguments	Returns
`GetFuel`	`vehicle` (entity handle)	숫자 형태의 연료 잔여량, `0.0`–`100.0`
`SetFuel`	`vehicle`, `level` (number)	없음
`GetFuelType`	`vehicle` (entity handle)	연료 키 문자열 — `'gasoline'`, `'diesel'`, `'premium'`, `'electric'`
`IsElectric`	`vehicle` (entity handle)	`true` 또는 `false`

Notes

**GetFuel**은 유효하지 않거나 존재하지 않는 엔티티에 대해 0.0을 반환합니다. 차량이 한 번도 등록된 적이 없는 경우, 이 호출이 Config.Consumption.SpawnFuel 수치를 적용하여 상태 백(state bag)에 기록하므로, 새로운 차량의 연료를 읽는 것만으로도 연료가 설정됩니다.

**SetFuel**은 0.0에서 100.0 사이로 값이 제한됩니다. 네트워크화된 차량의 경우 모든 클라이언트에 동기화되는 엔티티 상태 백에 기록하며, 로컬 차량의 경우 네이티브 수치만 설정합니다. 리터가 아닌 백분율 단위이므로, 리터 단위가 필요한 경우 해당 차량 클래스의 탱크 용량을 곱해서 사용해야 합니다.

**GetFuelType**은 주유소와 동일한 순서로 판별됩니다: 전기차 목록, Config.VehicleFuel.Model, 클래스 테이블 순으로 확인하며, 모두 해당하지 않으면 'gasoline'으로 기본 설정됩니다.

**IsElectric**은 GetFuelType(vehicle) == 'electric'을 위한 단축 표현입니다.

ℹ

연료는 차량 엔티티의 fuel 상태 백을 통해 동기화됩니다. 폴링 방식 없이 연료 변화를 감지하려는 리소스는 GetFuel을 반복 호출하는 대신 자체적으로 AddStateBagChangeHandler('fuel', ...)를 사용할 수 있습니다.

Inventory item handler

bupa-fuel.useJerryCan은 jerrycan 아이템을 위한 ox_inventory 아이템 사용 핸들러입니다. 아이템 정의에서 이를 참조하면 되며, 직접 호출할 필요는 없습니다.

ox_inventory/data/items.lua

client = { export = 'bupa-fuel.useJerryCan' }

QBox, QB-Core 및 ESX에서는 사용 가능한 아이템이 리소스 내부에서 자동으로 등록되므로 별도의 export 연결이 필요하지 않습니다.

PreviousAnti-cheat Next Configuration