车辆维修系统插件介绍
🚗 车辆维修系统插件
FiveM 车辆自动维修解决方案
📋 插件简介
这是一个专为 FiveM 服务器设计的车辆维修系统插件。玩家可以将车辆开到指定的维修点进行自动维修，无需人工干预，大幅提升游戏体验和服务器效率。
⚡ 自动维修
车辆开到维修点后自动检测并完成维修，无需手动操作
🎯 智能检测
基于距离和车辆类型的智能检测系统，只允许指定车辆维修
🎨 可视化界面
彩色检查点指示器，直观的UI提示和进度条显示
🔧 高度可配置
所有参数都可在配置文件中轻松调整，无需修改代码
🚀 高性能优化
经过性能优化的代码，减少服务器负担，提升流畅度
🛡️ 安全可靠
包含防作弊机制和完善的错误处理
⚙️ 配置文件 (config.lua)
以下是完整的配置文件内容，所有参数都可以根据需要进行调整：
Config = {}
--Config.Debug = true
--Config.Checkpoints = 5
-- 维修点位置配置
Config.ReviveVehicm = {
['1'] = vec3(449.51, -973.47, 25.71),
['2'] = vec3(439.86, -974.91, 25.71)
}
-- 允许维修的车辆列表
Config.Car = {
"npolexp",
"NPOLCHAR",
"npolchal",
"NPOLVIC",
"esc21pd",
"t20"
}
-- 维修时间（秒）
Config.Time = 5
-- 车辆维修系统配置
Config.CheckpointSize = 3.0 -- 检查点大小
Config.MaxDisplayDistance = 10.0 -- 最大显示距离（米）
Config.VehicleApproachDistance = 3.0 -- 车辆接近检查点的最小距离
Config.ZoneSize = vec3(6.0, 3.0, 3.0) -- 维修区域大小
Config.CheckpointHeight = 1.0 -- 检查点高度
Config.RepairHealth = 1000.0 -- 维修后车辆血量
Config.RepairDirtLevel = 0.0 -- 维修后车辆污垢等级
Config.MarkerColors = {
default = {r = 255, g = 255, b = 255, a = 100}, -- 白色 - 默认状态
allowed = {r = 0, g = 255, b = 0, a = 150}, -- 绿色 - 允许维修
denied = {r = 255, g = 0, b = 0, a = 150}, -- 红色 - 不允许维修
repairing = {r = 0, g = 100, b = 255, a = 200} -- 蓝色 - 维修中
}
--Config.Debug = true
--Config.Checkpoints = 5
-- 维修点位置配置
Config.ReviveVehicm = {
['1'] = vec3(449.51, -973.47, 25.71),
['2'] = vec3(439.86, -974.91, 25.71)
}
-- 允许维修的车辆列表
Config.Car = {
"npolexp",
"NPOLCHAR",
"npolchal",
"NPOLVIC",
"esc21pd",
"t20"
}
-- 维修时间（秒）
Config.Time = 5
-- 车辆维修系统配置
Config.CheckpointSize = 3.0 -- 检查点大小
Config.MaxDisplayDistance = 10.0 -- 最大显示距离（米）
Config.VehicleApproachDistance = 3.0 -- 车辆接近检查点的最小距离
Config.ZoneSize = vec3(6.0, 3.0, 3.0) -- 维修区域大小
Config.CheckpointHeight = 1.0 -- 检查点高度
Config.RepairHealth = 1000.0 -- 维修后车辆血量
Config.RepairDirtLevel = 0.0 -- 维修后车辆污垢等级
Config.MarkerColors = {
default = {r = 255, g = 255, b = 255, a = 100}, -- 白色 - 默认状态
allowed = {r = 0, g = 255, b = 0, a = 150}, -- 绿色 - 允许维修
denied = {r = 255, g = 0, b = 0, a = 150}, -- 红色 - 不允许维修
repairing = {r = 0, g = 100, b = 255, a = 200} -- 蓝色 - 维修中
}
🔧 配置说明
基本配置
| 配置项 | 类型 | 默认值 | 说明 |
|---|---|---|---|
ReviveVehicm | table | 坐标数组 | 维修点的位置坐标，支持多个维修点 |
Car | array | 车辆名称数组 | 允许进行维修的车辆型号列表 |
Time | number | 5 | 维修过程所需的时间（秒） |
显示配置
| 配置项 | 类型 | 默认值 | 说明 |
|---|---|---|---|
CheckpointSize | number | 3.0 | 检查点标记的大小 |
MaxDisplayDistance | number | 10.0 | 检查点最大显示距离（米） |
VehicleApproachDistance | number | 3.0 | 车辆触发维修的最小距离 |
ZoneSize | vec3 | vec3(6.0, 3.0, 3.0) | 维修区域的触发范围大小 |
CheckpointHeight | number | 1.0 | 检查点的高度偏移 |
维修配置
| 配置项 | 类型 | 默认值 | 说明 |
|---|---|---|---|
RepairHealth | number | 1000.0 | 维修后车辆的血量值 |
RepairDirtLevel | number | 0.0 | 维修后车辆的污垢等级 |
颜色配置
MarkerColors 对象包含四个状态的颜色配置：
- default - 默认状态（白色半透明）
- allowed - 允许维修（绿色）
- denied - 不允许维修（红色）
- repairing - 维修中（蓝色）
💡 配置提示： 修改配置文件后需要重启资源或重载脚本才能生效。建议在测试环境中先调整参数，再应用到生产环境。
🚀 使用方法
- 将插件文件放入服务器的
resources目录 - 根据需要修改
config.lua中的配置 - 在
server.cfg中添加ensure shouzijun_vehicle_repair - 重启服务器或重载资源
- 玩家驾驶允许的车辆开到维修点，按 E 键开始维修
⚠️ 注意事项：
- 确保服务器已安装必要的依赖库（如 ox_lib）
- 检查车辆名称是否与服务器中实际使用的车辆模型一致
- 维修点坐标需要根据地图实际情况调整