ZeroDev Sound 文档
FiveM 车载音响脚本:低音炮和低音音箱
ZeroDev Sound 添加了玩家装进自己车里的车载音响:箱体里的低音炮、功放、车门音箱、主机和 LED 灯,在改装间里逐件安装。装配的内容会跟着车走,车外的人听到的主要是低音,就像在真实的街道上一样。本指南介绍如何在 FiveM 服务器上设置它。

你需要什么
- oxmysql。ZeroDev Sound 会在首次启动时创建自己的表。无需导入 SQL。
- 一个框架:ESX Legacy、QBCore、Qbox,或者没有(standalone)。启动时会自动识别。
- 一个背包系统用于音箱物品,也可以没有。ox_inventory、qb-inventory、qs-inventory 等会在启动时自动识别。
- 可选:ox_target 或 qb-target(否则玩家会看到按键提示),以及 Pulse Phone,用于在手机的车机屏幕上控制车载音响。
如何设置车载音响
- 把
zerodev-sound文件夹放进你的resources文件夹,并保持文件夹名不变。 - 把
ensure zerodev-sound添加到server.cfg中,放在 oxmysql、你的框架和你的背包之后。 - 使用 ox_inventory、qs-inventory 或 qb-inventory 时,添加
add_filesystem_permission zerodev-sound write ox_inventory(换成你的背包的资源名),这样脚本就可以替你写入它的物品。 - 重启整个服务器。如果控制台提示已写入物品,请再重启一次。
- 以驾驶员身份开进 Benny's 的车载音响工位,按 E。安装界面会在你的车上打开。
玩家如何装配
玩家可以从现成的套装开始(Daily thump、Competition、Trunk wall、Sound quality、Clean and hidden),也可以逐件挑选:8 英寸到 21 英寸的低音炮、箱体、功放、车门音箱、高音喇叭、电容、第二块电池、LED 灯带和主机。每个部件都拖到车上的位置,并可选择表面处理。Test system 会在付款前播放装配好的效果,Install 只对车上新增的部件收费。

装配的内容绑定车牌保存,无论经过哪个车库、扣押场还是重生,都会跟着车回来。你的车库脚本无需任何修改。
大家能听到什么
- 每辆车本来就有对应其级别的原厂音响:四喇叭、高级或旗舰系统。装上的音箱会替换离它们最近的原厂音箱,低音炮则在其基础上叠加。
- 在车外,听到的主要是低音。打开车门、车窗和后备箱会让更多声音传出去。
- 后备箱盖和后备箱面板会随低音震动。低音炮如果被推到远超功放承受的程度可能会烧毁,烧毁的低音炮会一直保持烧焦状态,直到更换。
- 音响(默认按 K)有音量、低音炮电平、前后衰减和左右平衡。

服务器所有者可以修改的设置
所有设置都在游戏内的 /soundadmin 中。相同的值也在 config/config.lua 里:
| 你想做的 | 设置 |
|---|---|
| 移动改装间或添加改装间 | Config.Install.bays(每个都有 label、coords、radius、blip) |
| 在任何地方都能就车安装 | Config.Install.anywhere = true |
| 哪些车辆可以改装 | Config.Install.vehicles:'owned'(默认)或 'any' |
| 仅技师可安装 | Config.Install.anyone = false 以及 Config.Install.jobs 中的职业 |
| 免费车辆部件 | Config.Install.chargeParts = false |
| 安静时段 | Config.QuietHours = { enabled = true, from = 23, to = 7, maxVolume = 0.35 } |
音乐
音乐来自你添加到资源中的音频文件和 GTA 自带的广播电台。玩家不能输入链接。只添加你拥有或有权使用的音频。
常见问题
重启或进出车库后,玩家的车载音响还在吗?
会。安装内容绑定车牌保存,车每次回来它也会回来。
车外的人能听到低音炮吗?
能。主要是低音会穿过车身;打开车门、车窗和后备箱会让更多音乐传出去。
能和我的车库脚本一起用吗?
无需修改任何东西。已拥有的车辆从你的框架的表中读取(ESX 是 owned_vehicles,QBCore 和 Qbox 是 player_vehicles),车牌按大写并去掉空格后匹配。
按你的框架进行设置
ESX · QBCore · Qbox · 完整安装指南 · 开发者 API
在你自己的服务器上试用
ZeroDev Sound 一次性 $45 或 $20/月,可在你自己的服务器上免费试用 7 天。查看 ZeroDev Sound