mirror of
https://github.com/BeamMP/Docs.git
synced 2026-05-19 16:20:28 +00:00
add: examples of data parameters
For both onVehicleSpawn and onVehicleEdited
This commit is contained in:
carsakiller
@@ -1173,6 +1173,213 @@ Cancellable: YES
|
||||
|
||||
Triggered when a player spawns a new vehicle. The `data` argument contains the car's configuration and positional/rotational data for the vehicle as a json string.
|
||||
|
||||
<details>
|
||||
|
||||
<summary>Example <code>data</code> value</summary>
|
||||
|
||||
The data string begins with a unique vehicle identifier, which is the player's ID, a hyphen, and then the vehicle ID. This is followed by a JSON object containing information about the vehicles configuration and positioning.
|
||||
|
||||
```
|
||||
0-0: {
|
||||
"abs": "realistic",
|
||||
"ign": 3,
|
||||
"jbm": "van",
|
||||
"pid": 0,
|
||||
"pos": [
|
||||
907.93902587891,
|
||||
773.50201416016,
|
||||
238.87800598145
|
||||
],
|
||||
"pro": "0",
|
||||
"rot": [
|
||||
0,
|
||||
0,
|
||||
0.99999994039536,
|
||||
0
|
||||
],
|
||||
"vcf": {
|
||||
"licenseName": "H30 9VV",
|
||||
"mainPartName": "van",
|
||||
"mainPartPath": "/van",
|
||||
"model": "van",
|
||||
"paints": [
|
||||
{
|
||||
"baseColor": [
|
||||
0.21999999880791,
|
||||
0.37000000476837003,
|
||||
0.33000001311302,
|
||||
1.2000000476837
|
||||
],
|
||||
"clearcoat": 0,
|
||||
"clearcoatRoughness": 0,
|
||||
"metallic": 0,
|
||||
"roughness": 0.070000000298023
|
||||
},
|
||||
{
|
||||
"baseColor": [
|
||||
0.62300002574921,
|
||||
0.62300002574921,
|
||||
0.62300002574921,
|
||||
1.2000000476837
|
||||
],
|
||||
"clearcoat": 0.80000001192093,
|
||||
"clearcoatRoughness": 0.070000000298023,
|
||||
"metallic": 0.80000001192093,
|
||||
"roughness": 0.64999997615814
|
||||
},
|
||||
{
|
||||
"baseColor": [
|
||||
0.21999999880791,
|
||||
0.37000000476837003,
|
||||
0.33000001311302,
|
||||
1.2000000476837
|
||||
],
|
||||
"clearcoat": 0,
|
||||
"clearcoatRoughness": 0,
|
||||
"metallic": 0,
|
||||
"roughness": 0.070000000298023
|
||||
}
|
||||
],
|
||||
"partConfigFilename": "vehicles/van/h15_xt_passenger.pc",
|
||||
"parts": {
|
||||
"brakepad_F": "brakepad_F_premium",
|
||||
"brakepad_R": "brakepad_R_premium",
|
||||
"gps": "",
|
||||
"licenseplate_design_2_1": "",
|
||||
"linelock": "",
|
||||
"load_seat_FR": "",
|
||||
"n2o_system": "",
|
||||
"paint_design": "van_skin_twotone",
|
||||
"pickup_engine_v8_ecu": "pickup_engine_v8_ecu",
|
||||
"pickup_engine_v8_internals": "pickup_engine_v8_internals",
|
||||
"pickup_enginemounts": "pickup_enginemounts",
|
||||
"pickup_oilpan_v8": "pickup_oilpan_v8",
|
||||
"pickup_reversewarn": "",
|
||||
"pickup_sparetire": "pickup_sparetire_5l",
|
||||
"pickup_towhitch": "",
|
||||
"skin_glass": "van_skin_glass_tint",
|
||||
"skin_interior": "van_skin_interior_black",
|
||||
"soundscape_horn": "soundscape_horn_115",
|
||||
"tire_F_16x7_alt": "tire_F_225_75_16_alt_standard",
|
||||
"tire_R_16x7_alt": "tire_R_225_75_16_alt_standard",
|
||||
"van_ABS": "van_ABS",
|
||||
"van_ESC": "",
|
||||
"van_ac": "van_ac",
|
||||
"van_body": "van_body_passenger",
|
||||
"van_brake_F": "van_brake_F",
|
||||
"van_brake_R": "van_brake_R_drum",
|
||||
"van_bumper_F": "van_bumper_F_altb",
|
||||
"van_bumper_F_lip": "",
|
||||
"van_bumper_R": "van_bumper_R_altb",
|
||||
"van_bumper_accessory_F": "",
|
||||
"van_bumpersignal_FL": "van_bumpersignal_FL",
|
||||
"van_bumpersignal_FR": "van_bumpersignal_FR",
|
||||
"van_coilover_IFS": "van_coilover_IFS",
|
||||
"van_converter": "van_converter",
|
||||
"van_differential_F": "",
|
||||
"van_differential_R": "van_differential_R",
|
||||
"van_door_FL": "van_door_FL",
|
||||
"van_door_FR": "van_door_FR",
|
||||
"van_doordetent_FL": "van_doordetent_FL",
|
||||
"van_doordetent_FR": "van_doordetent_FR",
|
||||
"van_doordetent_RL": "van_doordetent_RL",
|
||||
"van_doordetent_RR": "van_doordetent_RR",
|
||||
"van_doorglass_L": "van_doorglass_L",
|
||||
"van_doorglass_R": "van_doorglass_R",
|
||||
"van_doorpanel_FL": "van_doorpanel_FL",
|
||||
"van_doorpanel_FR": "van_doorpanel_FR",
|
||||
"van_driveshaft_R": "van_driveshaft_R",
|
||||
"van_engine": "van_engine_v8_4.5",
|
||||
"van_exhaust_v8": "van_exhaust_v8",
|
||||
"van_fascia_F": "van_fascia_F_high",
|
||||
"van_fender_L": "van_fender_L",
|
||||
"van_fender_R": "van_fender_R",
|
||||
"van_fenderflare_FL": "",
|
||||
"van_fenderflare_FR": "",
|
||||
"van_fenderflare_RL": "",
|
||||
"van_fenderflare_RR_sidedoor": "",
|
||||
"van_finaldrive_R": "van_finaldrive_R_355",
|
||||
"van_frame": "van_frame",
|
||||
"van_fueltank": "van_fueltank",
|
||||
"van_header": "van_exhmanifold",
|
||||
"van_headlight_L_high": "van_headlight_L_high",
|
||||
"van_headlight_R_high": "van_headlight_R_high",
|
||||
"van_hood": "van_hood",
|
||||
"van_hub_F": "van_hub_F_5",
|
||||
"van_hub_R": "van_hub_R_5",
|
||||
"van_intake_v8": "van_intake_v8",
|
||||
"van_intcarpet_roof": "van_intcarpet_roof",
|
||||
"van_interior": "van_interior",
|
||||
"van_lettering_doors_F": "van_lettering_doors_F_h15",
|
||||
"van_lettering_reardoor_L": "van_lettering_gavril_reardoor_L",
|
||||
"van_lettering_reardoor_R": "van_lettering_h15_xt_reardoor_R",
|
||||
"van_licenseplate_F": "van_licenseplate_F",
|
||||
"van_licenseplate_R": "van_licenseplate_R",
|
||||
"van_lightbar": "",
|
||||
"van_mirror_L": "van_mirror_L",
|
||||
"van_mirror_R": "van_mirror_R",
|
||||
"van_mod": "",
|
||||
"van_muffler": "van_muffler",
|
||||
"van_power_steering": "",
|
||||
"van_radiator": "van_radiator",
|
||||
"van_radio": "van_radio",
|
||||
"van_reardoor_L": "van_reardoor_L",
|
||||
"van_reardoor_R": "van_reardoor_R",
|
||||
"van_reardoorglass_L": "van_reardoorglass_L",
|
||||
"van_reardoorglass_R": "van_reardoorglass_R",
|
||||
"van_reardoorpanel_L": "van_reardoorpanel_L",
|
||||
"van_reardoorpanel_R": "van_reardoorpanel_R",
|
||||
"van_rollcage": "",
|
||||
"van_roof": "van_roof",
|
||||
"van_roof_accessory": "",
|
||||
"van_runningboard": "",
|
||||
"van_seat_1R": "van_seat_1R",
|
||||
"van_seat_2R": "van_seat_2R",
|
||||
"van_seat_3R": "van_seat_3R",
|
||||
"van_seat_FL": "van_seat_FL",
|
||||
"van_seat_FR": "van_seat_FR",
|
||||
"van_shifter": "van_shifter_A",
|
||||
"van_shock_R": "van_shock_R",
|
||||
"van_sidedoor_FR": "van_sidedoor_FR_alt",
|
||||
"van_sidedoor_RR": "van_sidedoor_RR_alt",
|
||||
"van_sidedoorglass_FR": "van_sidedoorglass_FR",
|
||||
"van_sidedoorglass_RR": "van_sidedoorglass_RR",
|
||||
"van_sidedoorpanel_FR": "van_sidedoorpanel_FR",
|
||||
"van_sidedoorpanel_RR": "van_sidedoorpanel_RR",
|
||||
"van_sideglass_FL": "van_sideglass_FL",
|
||||
"van_sideglass_ML": "van_sideglass_ML",
|
||||
"van_sideglass_RL": "van_sideglass_RL",
|
||||
"van_sideglass_RR": "van_sideglass_RR",
|
||||
"van_snorkel": "",
|
||||
"van_spring_R": "van_spring_R",
|
||||
"van_steer": "van_steer",
|
||||
"van_steering": "van_steering",
|
||||
"van_suspension_F": "van_IFS",
|
||||
"van_suspension_R": "van_axle_R",
|
||||
"van_swaybar_F": "van_swaybar_F",
|
||||
"van_swaybar_R": "",
|
||||
"van_taillight_L": "van_taillight_L",
|
||||
"van_taillight_R": "van_taillight_R",
|
||||
"van_taillightguard_L": "",
|
||||
"van_taillightguard_R": "",
|
||||
"van_transfer_case": "van_transfer_case_RWD",
|
||||
"van_transmission": "van_transmission_4A",
|
||||
"van_tubs": "van_tubs",
|
||||
"van_valance_F": "van_valance_F",
|
||||
"van_wheeldata_F": "van_wheeldata_F",
|
||||
"van_wheeldata_R": "van_wheeldata_R",
|
||||
"van_windshield": "van_windshield",
|
||||
"wheel_F_5": "wheel_25a_16x7_5_F",
|
||||
"wheel_R_5": "wheel_25a_16x7_5_R"
|
||||
},
|
||||
"vars": {}
|
||||
},
|
||||
"vid": 29339
|
||||
}
|
||||
```
|
||||
|
||||
</details>
|
||||
|
||||
##### `onVehicleEdited`
|
||||
|
||||
Arguments: `player_id: number`, `vehicle_id: number`, `data: string`
|
||||
@@ -1180,6 +1387,204 @@ Cancellable: YES
|
||||
|
||||
Triggered when a player edits their vehicle and applies the edit. The `data` argument contains the car's updated configuration as a json string but does **not** include positional or rotational data. You can use [MP.GetPositionRaw](#mpgetpositionrawpid-number-vid-number-tablestring) to get positional and rotational data.
|
||||
|
||||
<details>
|
||||
|
||||
<summary>Example <code>data</code> value</summary>
|
||||
|
||||
The data string begins with a unique vehicle identifier, which is the player's ID, a hyphen, and then the vehicle ID. This is followed by a JSON object containing information about the vehicles configuration.
|
||||
|
||||
```
|
||||
0-0: {
|
||||
"abs": "realistic",
|
||||
"ign": 3,
|
||||
"jbm": "van",
|
||||
"pid": 0,
|
||||
"pro": "0",
|
||||
"vcf": {
|
||||
"licenseName": "P60 1EP",
|
||||
"mainPartName": "van",
|
||||
"mainPartPath": "/van",
|
||||
"model": "van",
|
||||
"paints": [
|
||||
{
|
||||
"baseColor": [
|
||||
0.40000000596046,
|
||||
0.050000000745058,
|
||||
0.050000000745058,
|
||||
1.2000000476837
|
||||
],
|
||||
"clearcoat": 0,
|
||||
"clearcoatRoughness": 0,
|
||||
"metallic": 0,
|
||||
"roughness": 0.070000000298023
|
||||
},
|
||||
{
|
||||
"baseColor": [
|
||||
0.40000000596046,
|
||||
0.050000000745058,
|
||||
0.050000000745058,
|
||||
1.2000000476837
|
||||
],
|
||||
"clearcoat": 0,
|
||||
"clearcoatRoughness": 0,
|
||||
"metallic": 0,
|
||||
"roughness": 0.070000000298023
|
||||
},
|
||||
{
|
||||
"baseColor": [
|
||||
0.40000000596046,
|
||||
0.050000000745058,
|
||||
0.050000000745058,
|
||||
1.2000000476837
|
||||
],
|
||||
"clearcoat": 0,
|
||||
"clearcoatRoughness": 0,
|
||||
"metallic": 0,
|
||||
"roughness": 0.070000000298023
|
||||
}
|
||||
],
|
||||
"partConfigFilename": "vehicles/van/h15_passenger.pc",
|
||||
"parts": {
|
||||
"brakepad_F": "brakepad_F_premium",
|
||||
"brakepad_R": "brakepad_R_premium",
|
||||
"gps": "",
|
||||
"hubcap_F_16": "hubcap_09c_F_altd",
|
||||
"hubcap_R_16": "hubcap_09c_R_altd",
|
||||
"licenseplate_design_2_1": "",
|
||||
"linelock": "",
|
||||
"load_seat_FR": "",
|
||||
"n2o_system": "",
|
||||
"paint_design": "",
|
||||
"pickup_engine_v8_ecu": "pickup_engine_v8_ecu_late",
|
||||
"pickup_engine_v8_internals": "pickup_engine_v8_internals",
|
||||
"pickup_enginemounts": "pickup_enginemounts",
|
||||
"pickup_oilpan_v8": "pickup_oilpan_v8",
|
||||
"pickup_reversewarn": "",
|
||||
"pickup_sparetire": "pickup_sparetire_6l",
|
||||
"pickup_towhitch": "",
|
||||
"skin_glass": "",
|
||||
"skin_interior": "van_skin_interior_ivory",
|
||||
"soundscape_horn": "soundscape_horn_115",
|
||||
"tire_F_16x7_alt": "tire_F_225_75_16_alt_standard",
|
||||
"tire_R_16x7_alt": "tire_R_225_75_16_alt_standard",
|
||||
"trimring_F_16x7": "",
|
||||
"trimring_R_16x7": "",
|
||||
"van_ABS": "van_ABS",
|
||||
"van_ac": "van_ac",
|
||||
"van_body": "van_body_passenger",
|
||||
"van_brake_F": "van_brake_F",
|
||||
"van_brake_R": "van_brake_R",
|
||||
"van_bumper_accessory_F_late": "",
|
||||
"van_bumper_F": "van_bumper_F_late_alt",
|
||||
"van_bumper_F_lip_late": "",
|
||||
"van_bumper_R": "van_bumper_R_late_alt",
|
||||
"van_coilover_IFS": "van_coilover_IFS",
|
||||
"van_converter": "van_converter",
|
||||
"van_differential_F": "",
|
||||
"van_differential_R": "van_differential_R",
|
||||
"van_door_FL": "van_door_FL",
|
||||
"van_door_FR": "van_door_FR",
|
||||
"van_doordetent_FL": "van_doordetent_FL",
|
||||
"van_doordetent_FR": "van_doordetent_FR",
|
||||
"van_doordetent_RL": "van_doordetent_RL",
|
||||
"van_doordetent_RR": "van_doordetent_RR",
|
||||
"van_doorglass_L": "van_doorglass_L",
|
||||
"van_doorglass_R": "van_doorglass_R",
|
||||
"van_doorpanel_FL": "van_doorpanel_FL",
|
||||
"van_doorpanel_FR": "van_doorpanel_FR",
|
||||
"van_driveshaft_R": "van_driveshaft_R",
|
||||
"van_engine": "van_engine_v8_4.5",
|
||||
"van_ESC": "van_ESC",
|
||||
"van_exhaust_v8": "van_exhaust_v8",
|
||||
"van_fascia_F": "van_fascia_F_late",
|
||||
"van_fender_L": "van_fender_L",
|
||||
"van_fender_R": "van_fender_R",
|
||||
"van_fenderflare_FL": "",
|
||||
"van_fenderflare_FR": "",
|
||||
"van_fenderflare_RL": "",
|
||||
"van_fenderflare_RR_sidedoor": "",
|
||||
"van_finaldrive_R": "van_finaldrive_R_355",
|
||||
"van_frame": "van_frame",
|
||||
"van_fueltank": "van_fueltank",
|
||||
"van_grille_F_late": "van_grille_F_late",
|
||||
"van_header": "van_exhmanifold",
|
||||
"van_headlight_L_late": "van_headlight_L_late",
|
||||
"van_headlight_R_late": "van_headlight_R_late",
|
||||
"van_hood": "van_hood_late",
|
||||
"van_hub_F": "van_hub_F_6",
|
||||
"van_hub_R": "van_hub_R_6",
|
||||
"van_intake_v8": "van_intake_v8_late",
|
||||
"van_intcarpet_roof": "van_intcarpet_roof",
|
||||
"van_interior": "van_interior",
|
||||
"van_lettering_doors_F": "van_lettering_doors_F_h15",
|
||||
"van_lettering_reardoor_L": "van_lettering_gavril_reardoor_L",
|
||||
"van_lettering_reardoor_R": "van_lettering_h15_reardoor_R",
|
||||
"van_licenseplate_F_late": "van_licenseplate_F_late",
|
||||
"van_licenseplate_R_late": "van_licenseplate_R_late",
|
||||
"van_lightbar": "",
|
||||
"van_mirror_L": "van_mirror_L",
|
||||
"van_mirror_R": "van_mirror_R",
|
||||
"van_mod": "",
|
||||
"van_muffler": "van_muffler",
|
||||
"van_power_steering": "",
|
||||
"van_radiator": "van_radiator",
|
||||
"van_radio": "van_radio",
|
||||
"van_reardoor_L": "van_reardoor_L",
|
||||
"van_reardoor_R": "van_reardoor_R",
|
||||
"van_reardoorglass_L": "van_reardoorglass_L",
|
||||
"van_reardoorglass_R": "van_reardoorglass_R",
|
||||
"van_reardoorpanel_L": "van_reardoorpanel_L",
|
||||
"van_reardoorpanel_R": "van_reardoorpanel_R",
|
||||
"van_rollcage": "",
|
||||
"van_roof": "van_roof",
|
||||
"van_roof_accessory": "",
|
||||
"van_runningboard": "",
|
||||
"van_seat_1R": "van_seat_1R",
|
||||
"van_seat_2R": "van_seat_2R",
|
||||
"van_seat_3R": "van_seat_3R",
|
||||
"van_seat_FL": "van_seat_FL",
|
||||
"van_seat_FR": "van_seat_FR",
|
||||
"van_shifter": "van_shifter_A",
|
||||
"van_shock_R": "van_shock_R",
|
||||
"van_sidedoor_FR": "van_sidedoor_FR_alt",
|
||||
"van_sidedoor_RR": "van_sidedoor_RR_alt",
|
||||
"van_sidedoorglass_FR": "van_sidedoorglass_FR",
|
||||
"van_sidedoorglass_RR": "van_sidedoorglass_RR",
|
||||
"van_sidedoorpanel_FR": "van_sidedoorpanel_FR",
|
||||
"van_sidedoorpanel_RR": "van_sidedoorpanel_RR",
|
||||
"van_sideglass_FL": "van_sideglass_FL",
|
||||
"van_sideglass_ML": "van_sideglass_ML",
|
||||
"van_sideglass_RL": "van_sideglass_RL",
|
||||
"van_sideglass_RR": "van_sideglass_RR",
|
||||
"van_snorkel": "",
|
||||
"van_spring_R": "van_spring_R",
|
||||
"van_steer": "van_steer_facelift",
|
||||
"van_steering": "van_steering",
|
||||
"van_suspension_F": "van_IFS",
|
||||
"van_suspension_R": "van_axle_R",
|
||||
"van_swaybar_F": "van_swaybar_F",
|
||||
"van_swaybar_R": "",
|
||||
"van_taillight_L": "van_taillight_L",
|
||||
"van_taillight_R": "van_taillight_R",
|
||||
"van_taillightguard_L": "",
|
||||
"van_taillightguard_R": "",
|
||||
"van_transfer_case": "van_transfer_case_RWD",
|
||||
"van_transmission": "van_transmission_4A",
|
||||
"van_tubs": "van_tubs",
|
||||
"van_valance_F": "van_valance_F_late",
|
||||
"van_wheeldata_F": "van_wheeldata_F",
|
||||
"van_wheeldata_R": "van_wheeldata_R",
|
||||
"van_windshield": "van_windshield",
|
||||
"wheel_F_6": "steelwheel_02b_16x7_F",
|
||||
"wheel_R_6": "steelwheel_02b_16x7_R"
|
||||
},
|
||||
"vars": {}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
</details>
|
||||
|
||||
##### `onVehicleDeleted`
|
||||
|
||||
Arguments: `player_id: number`, `vehicle_id: number`
|
||||
|
||||
Reference in New Issue
Block a user