一、前言

在 FiveM 角色扮演、漂移、竞速服务器中，玩家载具改装长期局限于改色、轮毂、外观套件三大基础项。想要给车身定制专属图案、个性涂鸦、战队标识，传统方式要么依赖固定车模资源，要么需要专业建模师二次改模，流程繁琐、门槛极高，服主和玩家都难以实现自由个性化表达。

为解决这一痛点，Ny Vehicle Steaming 载具贴纸涂鸦系统应运而生，把载具自定义贴纸做成「走进改装厂即可一键操作」的轻量化体验，无需建模、无需复杂开发，支持贴纸放置、编辑、存储、全局同步，完美适配 OneSync 环境，是 FiveM 服主必备的载具拓展资源。

二、资源简介

Ny Vehicle Steaming 是适配 GTA5/FiveM 的专业载具贴花涂鸦系统，核心实现车身自由放置、编辑、删除贴纸，所有贴纸数据持久化写入数据库并与载具唯一绑定，OneSync 环境下全玩家同步展示效果。

开发者：FiveM 认证开发者 - 难言等级：FiveM 百事通 LV3、初级技术员定位：一站式载具 DIY 贴纸解决方案，兼容主流框架、多数据库、自定义权限与经济系统。

三、多种打开入口，适配全服玩法配置

脚本提供四种灵活开启菜单的方式，服主可在配置文件自由开关组合使用：

1. 聊天命令：默认 /stickers 指令打开，可在配置中直接关闭，仅保留线下服务点入口。
    
2. 固定服务点 HubSpot：自定义 Vector4 坐标设立改装服务区，玩家坐驾驶位进入交互范围，按 E 即可打开菜单，支持自定义交互按键，兼容游戏内按键屏蔽规则。
    
3. 地面 DrawMarker 标记：可自由开关标记显示，支持自定义标记类型、缩放大小、配色透明度、绘制距离、Z 轴旋转；自带地面 Z 坐标探测开关，适配室内、桥下等特殊场景。
    
4. 客户端事件触发：开启事件监听后，可通过其他资源触发 Ny-Vehicle-steaming:openMenu 事件，无缝对接商城、改装店、NPC 交互等自定义玩法。

四、贴纸内容 & 经济多维度配置

1. 贴纸目录管理

在Config.Stickers中可按分类批量维护贴纸资源，单张贴纸支持自定义：名称、展示标签、售卖价格、是否开启镜像功能等，后期新增贴纸无需修改核心逻辑。

2. 双语界面支持

配置项Config.Language可切换 中文 / 英文 双语模式；菜单界面、编辑器提示、成功 / 错误文案全部统一收纳在Config.Text，整服汉化、自定义文案一键修改，极其便捷。

3. 经济系统适配

支持为每张贴纸单独定价，检测玩家资金不足、无使用权限时，自动弹出自定义提示文案，完美融入服务器经济体系。

五、NUI 可视化菜单 + 专业游戏内编辑

1. 网页 UI 交互

采用ui_page网页端菜单设计，实现贴纸分类浏览、添加、编辑入口，解决原生菜单无法展示缩略图、分类杂乱的痛点，界面直观易上手。

2. 专业摄像机编辑模式

• 内置脚本环绕摄像机，可配置绕车角度、观察视距、仰角上下限、FOV 视野、瞄准点高度等参数；
• WASD控制机位水平面平移，支持自定义平移速度、最大偏移量、灵敏度区间；
• 依托射线检测 + 载具实体判定，限定距离内精准加载贴纸预览，贴合车身曲面。

3. 全自定义编辑操作

所有键位均可自行配置，核心操作：

• 确认放置、取消编辑、删除贴纸；
• 滚轮缩放贴纸、方向键旋转角度；
• Shift 精细微调、Caps Lock 锁定贴纸跟随视角；
• Ctrl 一键开启镜像（仅支持镜像的贴纸生效）；左侧 NUI 面板配套滑条与功能按钮，键盘 + 面板双操作互补，新手也能快速上手。

4. 尺度 & 数量限制

在Config.EditorOptions可严格管控：单车最大贴纸数量、贴纸最小 / 最大缩放比例、玩家离车最大操作距离、射线探测与菜单载具距离；同时标注游戏原生渲染上限，方便服主控制服务器性能负载。

六、权限 & 框架全面兼容

1. 主流框架适配

Config.Framework原生支持 ESX / QBCore / 其他自定义框架，可自由配置共享对象事件、通知事件、核心资源名称等适配参数。

2. 数据库表兼容

可自定义owned_vehicles/player_vehicles等车辆数据表名及车主关联字段，无缝对接 ESX、QBCore 通用数据表结构。

3. 精细化权限控制

• 支持全员可用、仅车主可用、指定职业可用三种基础模式；
• 可开启白名单限制，按职业名 + 职业等级管控功能；
• 开放自定义权限接口，可拓展脚本编写IsPlayerAllowedScript实现专属白名单。

七、数据存储 & 性能依赖

1. 多数据库驱动：原生支持 oxmysql /mysql-async/ghmattimysql，留空即可切换无库独立运行模式。
2. 流式资源加载：fxmanifest 声明 OneSync 与 assetpacks 依赖，贴纸资源流式加载，不卡顿、不占用额外带宽。
3. 调试与版本管理：内置错误调试、日志打印开关，方便服主排错；资源内自带版本号，便于后续更新迭代与版本对照。

八、演示内容

点击下方蓝色字样查看该插件演示视频  ↓  ↓  ↓

点我查看演示视频 ！！！

-- if you see some errors enable this option
Config.ErrorDebug = false

-- classic debug
Config.EnableDebug = false

Config.Language = 'ZH' -- [ 'ZH' / 'EN' ] 界面语言；贴纸等文案见本文件 Config.Text 与 Config.Stickers
-- oxmysql：server.cfg 中须先于本资源 ensure oxmysql（无需在 fxmanifest 里引用 MySQL.lua）
-- mysql-async：须在 fxmanifest 的 server_scripts 最上方添加 '@mysql-async/lib/MySQL.lua'
Config.Database = 'oxmysql' --[ 'mysql-async' / 'oxmysql' / 'ghmattimysql' ] 留空为无数据库独立模式
Config.Framework = 'esx' --[ 'esx' / 'qbcore' / 'other' ] Choose your framework (leave empty for standalone)

Config.FrameworkTriggers = {
    notify = 'esx:showNotification', -- [ ESX = 'esx:showNotification'    QBCore = 'QBCore:Notify' ] Set the notification event, if left blank, default will be used
    object = 'esx:getSharedObject', --[ ESX = 'esx:getSharedObject'    QBCore = 'QBCore:GetObject' ] Set the shared object event, if left blank, default will be used (deprecated for QBCore)
    resourceName = 'es_extended', -- [ ESX = 'es_extended'    QBCore = 'qb-core' ] Set the resource name, if left blank, automatic detection will be performed
}

Config.FrameworkSQLTables = {
    table = 'owned_vehicles', --[ ESX = 'owned_vehicles'    QBCore = 'player_vehicles' ] Set the name of the table where you store player vehicles, if left blank, default will be used
    identifier = 'owner', --[ ESX = 'owner'    QBCore = 'citizenid' ] Set the identifier used in that table, if left blank, default will be used
}

Config.Accessibility = {
    event = false, -- 为 true 时触发客户端事件 Ny-Vehicle-steaming:openMenu（由本地再向服务端 Ny-Vehicle-steaming:requestMenu 请求）

    restricted = false, -- Enable to restrict the whole script for certain players (IsPlayerAllowedScript function in framework/your_framework.lua)

    anyone = true, -- Everyone can use place and edit stickers
    owner = false, -- Only the owner of the vehicle can place and edit stickers
    jobs = false, -- Only players with certain job can place and edit stickers
}

--- /stickers 命令是否注册（event=true 时本项无效，仍靠事件打开）
Config.CommandOpen = {
    allow = true, -- false：不注册 /stickers，仅能通过 Config.HubSpot 坐标点或其它资源调用
}

--- 固定服务点：车辆开进范围且玩家为驾驶员时按 E 打开贴纸 UI（与 /stickers 射线逻辑无关）
Config.HubSpot = {
    enabled = true, -- false：整段点位逻辑不运行
    useFixedPoint = true, -- false：不检测坐标点（仅关点位，不影响命令/event）
    --- vector4：x, y, z, w；w 为地面标记绕 Z 旋转（度），与车头无关仅作展示
    coords = vector4(780.6710, -1891.4196, 28.1474, 237.6606),
    range = 4.5, -- 米：载具中心到点的距离（三维）；与下方 marker 视觉范围大致一致即可
    --- 尝试多个键位（部分服/脚本会 Disable 某一 pad）
    interactControls = { 51, 38 }, -- 51 INPUT_CONTEXT，38 INPUT_PICKUP（常也是 E）
    interactControl = 51, -- 兼容旧配置：若未写 interactControls 则只用此项
    drawMarker = true, -- false：不绘制地面光圈
    --- 玩家距服务点多远内仍绘制（米）；车内时用「玩家与载具中更近点」到服务点距离
    markerDrawRange = 28.0, -- 米：超过此距离不绘制光圈（原先 70 过大）
    --- DrawMarker：type 1 = 竖直圆柱（GTA 枚举）；淡白色、较小范围
    marker = {
        type = 1,
        scale = { x = 4.2, y = 4.2, z = 1.35 },
        color = { r = 245, g = 245, b = 248, a = 110 },
        bobUpAndDown = false,
        faceCamera = false,
        zOffset = 0.0,
        useGroundZ = false, -- true：探测地面 Z（桥下/室内可能不准）；false：用配置 coords 的 z
    },
}

-- Related to settings above
Config.AllowedJobs = {
    -- Example:
    mechanic = true,

    -- OR if you want it limited to a certain grade. The example below means players with the job mechanic that is above the grade 2 can use it.
    -- mechanic = 2, 
}

Config.EditorOptions = {
    loadDistance = 50.0, -- 屏幕射线投射车身距离（米）；过短会导致放置模式看不见贴纸
    menuOpenMaxDistance = 12.0, -- 打开菜单：射线未命中时在此距离（米）内取最近载具；设为 0 则仅射线（准星必须打到车）
    maxDistance = 10.0, -- The maximum distance the player can go away from the vehicle when in editor mode
    maxStickers = 6, -- The maximum amount of stickers on a single vehicle, please do note that there cannot be more than 56 stickers rendered at the same time
    maxScale = 6.0, -- The maximum scale of the sticker in editor
    minScale = 0.1, -- The minimum scale of the sticker in editor
    --- 放置模式脚本摄像机（俯视绕车）
    editorCamRadiusMin = 4.0,
    editorCamRadiusMax = 22.0,
    editorCamRadiusStart = 12.0,
    editorCamOrbitStart = 0.0,
    --- 仰角（相对水平面，度）：数值越大越俯视；与水平夹角，非 FOV
    editorCamElevMin = 0.0, -- 0°：机位与载具原点同高，纯水平绕车（侧视）
    editorCamElevMax = 89.0,
    editorCamElevStart = 38.0,
    --- WASD 平移机位（水平面内沿视线方向 / 左右平移，不改变绕车角）
    editorCamPanSpeed = 0.09,
    editorCamPanMax = 14.0,
    --- 左侧「平移灵敏度」滑条：倍数，乘 editorCamPanSpeed
    editorCamPanSensMin = 0.1,
    editorCamPanSensMax = 2.5,
    editorCamPanSensStart = 0.45,
    editorCamFov = 54.0,
    editorCamAimZ = 0.35, -- 与 editor.lua PointCamAt 抬高一致；射线瞄准点
}

九、总结

Ny Vehicle Steaming 打破了 FiveM 传统载具改装的门槛限制，零建模基础、低配置消耗、全框架兼容、高度可定制，无论是 RP 角色扮演服、漂移竞速服还是娱乐私服，都能快速接入，给玩家带来真正的载具 DIY 涂鸦自由。