From a57dc731aa223e97eeba13f53a70d498b89c9f79 Mon Sep 17 00:00:00 2001 From: Ace06_10010 Date: Sat, 30 May 2026 12:00:33 +0000 Subject: [PATCH] Translate latest-server-reference.md via GitLocalize --- .../server/latest-server-reference.md | 417 +++++++++++++++++- 1 file changed, 413 insertions(+), 4 deletions(-) diff --git a/docs/zh/scripting/server/latest-server-reference.md b/docs/zh/scripting/server/latest-server-reference.md index 2b4d367f..ed0758e2 100644 --- a/docs/zh/scripting/server/latest-server-reference.md +++ b/docs/zh/scripting/server/latest-server-reference.md @@ -243,7 +243,7 @@ print(mytimer:GetCurrent()) -- print how much time elapsed #### `MP.GetServerVersion() -> number,number,number` -以主要、次要、补丁格式返回当前服务器版本。例如，v3.0.0版本将返回` 3,0,0 `。 +以主要、次要、补丁格式返回当前服务器版本。例如，v3.0.0版本将返回`3,0,0`。 范例: @@ -336,7 +336,7 @@ print(Results) - `IsDone() -> boolean` 会告知您所有处理程序是否已完成。还可以通过检查它的`MP.Sleep`-来等待变为True - `GetResults() -> table` 返回一个未注释且未命名的表，其中包含所有处理程序的所有返回值，这是一个数组 - 一定要用`Obj:Function()` 语法 (`:`, 不要 `.`). +一定要用`Obj:Function()` 语法 (`:`, 不要 `.`). 范例: @@ -1221,13 +1221,422 @@ MP.RegisterEvent("onPlayerAuth", "myPlayerAuthorizer") 参数: `player_id: number`, `vehicle_id: number`, `data: string` 可取消: YES -当玩家生成一辆新车辆时触发。参数 `data`包含该车辆的配置，以及位置和旋转等信息，格式为 JSON 字符串。 +当玩家生成一辆新车辆时触发。请注意，车辆切换/替换则会触发 [`onVehicleEdited`](#onvehicleedited)。
`data` 参数包含该车辆的配置以及位置/旋转数据，并以 JSON 字符串形式提供。 + +
+
+ +data 值示例 + +该数据字符串以一个唯一的车辆标识符开头，其格式为玩家 ID、一个连字符，以及车辆 ID。随后是一个 JSON 对象，其中包含车辆的配置信息以及位置数据。 + +``` +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 +} +``` + + + ##### `onVehicleEdited` 参数: `player_id: number`, `vehicle_id: number`, `data: string` 可取消: YES -当玩家编辑并应用其车辆修改时触发。参数 `data` 包含车辆更新后的配置，格式为 JSON 字符串， 但 **不**包含位置或旋转数据。你可以使用 [MP.GetPositionRaw](#mpgetpositionrawpid-number-vid-number-tablestring) 来获取位置和旋转数据。 +当玩家编辑或替换其车辆时触发。`data` 参数包含车辆更新后的配置，并以 JSON 字符串形式提供，但 **不** 包含位置或旋转数据。
你可以使用 [MP.GetPositionRaw](#mpgetpositionrawpid-number-vid-number-tablestring) 来获取位置与旋转数据。 + +
+
+ +data 值示例 + +该数据字符串以一个唯一的车辆标识符开头，其格式为玩家 ID、一个连字符，以及车辆 ID。随后是一个 JSON 对象，其中包含车辆配置信息。 + +``` +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": {} + } +} +``` + + + ##### `onVehicleDeleted`