framework

ESX Legacy

ensure oxmysql
ensure es_extended
# ... your ESX scripts, inventory, banking ...
ensure pma-voice
ensure screenshot-basic
ensure phone

• アイテム:ESX の標準インベントリなら何もする必要はありません。スマホは起動時に ESX の items テーブルにアイテムを追加し、どれを追加したかをコンソールに表示します。config/items/esx.sql は、自分で追加したい場合のために用意しています。他のインベントリの場合はセクション4を参照してください。
• お金:銀行は ESX の bank 口座、現金は money 口座です。
• キャラクター:スマホは ESX のプレイヤーの identifier に従うため、esx_multicharacter で動作します。
• ボス:boss という名前の階級が会社を管理します(bossGrade を設定した場合を除く)。
• 会社の口座:esx_addonaccount / esx_society、またはセクション7の銀行スクリプト。

QBCore

ensure oxmysql
ensure qb-core
# ... qb-inventory and your other qb scripts ...
ensure pma-voice
ensure screenshot-basic
ensure phone

• アイテム:貼り付けるものはありません。スマホは起動時に、必要なアイテムを QBCore の共有アイテムに追加し、どれを追加したかをコンソールに表示します。画像は config/items/images/ から qb-inventory/html/images/ にコピーしてください。足りないものは起動時チェックが名前を表示します。
• お金:bank と cash。
• キャラクター:citizenid を使うため、qb-multicharacter で動作します。
• ボス:ジョブで isboss = true が付いた階級です(bossGrade を設定した場合を除く)。
• 会社の口座:Renewed-Banking、qb-banking、または古い qb-management。
• マルチジョブ:ps-multijob が動いていれば、プレイヤーの他のジョブが Services に表示され、ワンタップでジョブを切り替えられます。

Qbox

ensure oxmysql
ensure qbx_core
ensure ox_inventory
# ... your other Qbox scripts, in Qbox's own order ...
ensure pma-voice
ensure screenshot-basic
ensure phone

• アイテム:Qbox は ox_inventory を使っており、他のスクリプトからアイテムを受け取れません。サーバーを一度起動すると、起動時チェックが足りない項目を、ox_inventory/data/items.lua にそのまま貼り付けられる形で表示します(セクション4)。画像は ox_inventory/web/images/ に入れます。
• お金:qbx_core 経由の bank と cash。
• キャラクター:citizenid。
• ボス:isboss = true が付いた階級です(bossGrade を設定した場合を除く)。
• マルチジョブ:組み込み済み。プレイヤーの他のジョブが Services に表示されます。
• qbx_core は qb-core としても応答します。これは正常で、スマホは両者をひとつの framework として扱います。

ox_core

ensure oxmysql
ensure ox_core
ensure ox_inventory
# ... your other scripts ...
ensure pma-voice
ensure screenshot-basic
ensure phone

• アイテム:サーバーを一度起動すると、起動時チェックが足りない項目を、ox_inventory/data/items.lua にそのまま貼り付けられる形で表示します(セクション4)。画像は ox_inventory/web/images/ に入れます。
• お金:銀行はキャラクターの ox_core 口座です。現金は ox_inventory の money アイテムです。
• キャラクター:charId。
• ジョブ:ox_core のグループには勤務フラグがないため、スマホが勤務状態を自分で管理します。会社管理(スタッフ、採用、階級)とバレーは ox_core では使えません。

ND Core

ensure oxmysql
ensure ox_lib
ensure ND_Core
ensure ox_inventory
# ... your other scripts ...
ensure pma-voice
ensure screenshot-basic
ensure phone

• 自動で検出されます(ND_Core が起動している場合)。強制指定するには:setr phone_framework nd。
• アイテム:ND は ox_inventory を使います。サーバーを一度起動すると、起動時チェックが足りない項目を、ox_inventory/data/items.lua にそのまま貼り付けられる形で表示します(セクション4)。
• お金:キャラクターの ND bank と ND cash(ox_inventory が money アイテムを同期させます)。
• キャラクター:ND のキャラクター ID。キャラクターが ND 側の電話番号を持っていれば、それが表示されます。
• ジョブ:キャラクターの ND のジョブと階級。ND には勤務フラグがないため、全員が勤務中として扱われます。会社管理、会社の口座、バレーは ND Core では使えません。
• ガレージ:所有車両は ND の nd_vehicles テーブルから読み込みます。

vRP

対応しているのは vRP 2 だけです(vRP 1 やコミュニティのフォークには対応していません)。スマホは bridge/frameworks/vrp/ から小さな拡張を vRP に読み込みます。コピーするものはありません。

ensure oxmysql
ensure vrp
# ... your other scripts ...
ensure pma-voice
ensure screenshot-basic
ensure phone

• アイテム:vRP 用のアイテムファイルはなく、vRP 2 ではスマホ用にアイテムを使用可能にできません。Config.Item.required = false(既定)のままにし、ストアがスマホを直接渡すよう Config.Store.box = false を設定してください。プレイヤーは充電用アイテムを /phonepack と /phonecable で使います。vRP のインベントリでは、これらを使うにはプレイヤーが pulse_magpack と pulse_cable を持っている必要があるため、両方のアイテムを vRP のアイテムリストに追加するか、Config.Charging.enabled = false を設定してください。
• お金:vRP の銀行と財布。
• キャラクター:vRP のキャラクター ID。
• ジョブ:会社管理とバレーは vRP では使えません。ガレージスクリプトを接続しない限り、Garage アプリは空のままです。

TMC

TMC は組み込み済みです。スマホは TMC の core を自動で認識します。追加のリソースは不要で、config/config.lua の変更も不要です(auto、tmc、custom のどれでも動きます)。

ensure oxmysql
ensure core
# ... your other scripts ...
ensure pma-voice
ensure screenshot-basic
ensure phone

起動時チェックに Framework: TMC と表示されます。

• アイテム:他のアイテムと同じ方法で、Pulse のアイテムを TMC のアイテムリストに追加してください。名前は phone、pulse_magpack、pulse_magpack_max、pulse_cable、pulse_router、pulse_burner、pulse_buds、pulse_ringlight、pulse_wallet です(config/items/tmc.lua に項目があります)。ストアの箱用には pulse_phone_box と、カラーごとにひとつ(pulse_phone_box_black ...)。ラベル、重さ、説明は config/items/qb-core.lua に、画像は config/items/images/ にあります。リストにないアイテムは拒否され、プレイヤーには「inventory full」と表示されます。そのときコンソールがアイテム名を表示します。リストに箱のアイテムがなくても販売は止まりません。ストアはそのスマホを箱なしで渡し、コンソールにその旨を表示します。箱がまったく不要なら Config.Store.box = false を設定してください。
• お金:キャラクターの現金と銀行。銀行は、TMC の banking リソースが動いていればそれ(本人の個人口座)、そうでなければコアの銀行のお金です。口座番号が BNK123456 のような形でない場合は、口座番号が入っているフィールドを config/config.lua で指定してください:Config.Providers.tmcBankAccount = 'charinfo.account'(ご自身のフィールドを使ってください)。銀行を読めないとき、Wallet は作った数字ではなくダッシュを表示します。
• キャラクター:TMC の citizen id。
• ジョブ:勤務中のジョブ(または最初のジョブ)と、その階級と勤務状態。
• 一時的な pulse_tmc コネクターを入れていましたか?ensure pulse_tmc を削除し、そのフォルダーも削除してください。まだ動いている間はコンソールが知らせます。

Standalone(framework なし)

ensure oxmysql
ensure pma-voice
ensure screenshot-basic
ensure phone

• アイテム:不要です。すべてのプレイヤーがスマホ、Reserve、ケーブルを持っています。
• お金:スマホが独自の銀行を持ちます。新しいプレイヤーの初期残高は 5000 です(startingBalance、config/apps.lua 内)。
• キャラクター:プレイヤーの Rockstar ライセンス。
• ジョブ、車、家:スマホが独自に管理します。セクション9のテストコマンドで中身を入れられます。

カスタムまたは自作の framework

1. Config.Framework = 'custom' を設定してください(config/config.lua 内)。
2. optional-developer-kit/custom_framework_bridge.lua と同じ形のブリッジテーブルをスマホに渡します。Config.Providers.custom として config/config.lua に書くか、ご自身のリソースから exports.phone:RegisterFrameworkBridge(MyBridge) で登録してください。
3. 必須なのは GetCharacterId だけです。名前、ジョブ、ライセンス、車両・家の一覧の関数を省略すると、スマホはサーバーにそのデータがないものとして動きます。お金やアイテムの関数を省略すると、その操作は拒否されます。スマホが独自の銀行から支払うことはありません。Bank アプリは、ブリッジに GetBankBalance がある場合にだけ表示されます。
4. スマホが動いたままコアが再起動する場合は、コアの準備ができた時点で exports.phone:FrameworkRestarted() を一度呼んでください。

bridge/frameworks/custom.lua で、スマホがテーブルをどう使うかがわかります。他の自作スクリプト(銀行やガレージのスクリプト)を接続するには、optional-developer-kit/custom_provider_template.lua と Exports を参照してください。2つのテンプレートはスマホのフォルダーではなく、任意の開発者キット zerodevscripts.com/downloads/PulsePhone-developer-kit.zip に入っています。