Skip to content

Exports

Exports

車両の燃料を読み取るまたは変更する必要がある他のリソース向けに、4つのクライアントサイドエクスポートを用意しています。このページでは、リソース内に実際に存在する機能のみをドキュメント化しています。

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 のレベルが抽選され、ステートバッグに書き込まれます。そのため、新しい車両の燃料を読み取るだけで燃料が初期化されます。

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 では、使用可能なアイテムがリソースによって内部的に登録されるため、エクスポートの手動配線は必要ありません。

PreviousAnti-cheatNext Configuration