# EUP XML Refit —— LSPDFR 配置编辑器（内置 AI Dispatch）
旧版是https://mod.3dmgame.com/mod/256436，因为源码丢了，所以重构了

> 📖 用户指南与功能说明：<https://eupxml.tzl644.cn/>

## 简介
**EUP XML Refit** 是一款专为 **LSPDFR**（GTA5 警察模组）打造的配置文件可视化编辑器，**内置 AI Dispatch 智能助手**。
告别手写 XML 的繁琐与易错，通过直观的表单界面或直接对 AI 说话，即可完成警局、服装、备份单位、装备、随机检查等全部配置。支持 LSPDFR 原版、Ultimate Backup、Policing Redefined 三大配置体系，共 17 种配置文件。

## 功能特性

### 🤖 AI Dispatch —— 对话式配置编辑（核心亮点）
- **像聊天一样改配置**：输入 *"把 LSPD 巡逻车换成 police3"*、*"给 NooseSWAT 每人加一件防弹衣"*，AI 自动定位并修改对应 XML 节点
- **不懂 XML 也能改**：AI 理解 LSPDFR / Ultimate Backup / Policing Redefined 全部文件结构与属性规则
- **智能检查与修复**：配置写错、属性值非法、槽位冲突，AI 直接指出并给出修复方案
- **批量生成**：一句话生成整套机构、服装变体、装备表或备份单位，再手动微调
- **跨文件操作**：同时管理多个配置文件时，AI 能正确区分目标文件并精确修改

### 🗂️ 全面支持三大 Mod 配置体系（17 种配置类型）
| 配置体系 | 支持文件 |
|----------|----------|
| **LSPDFR 原版（7 种）** | outfits.xml / agency.xml / regions.xml / backup.xml / inventory.xml / stations.xml / duty_selection.xml |
| **Ultimate Backup（3 种）** | CustomRegions.xml / DefaultRegions.xml / SpecialUnits.xml |
| **Policing Redefined（7 种）** | CustomRegions.xml / DefaultRegions.xml / SpecialUnits.xml / Loadouts.xml / PatDownItems.xml / Questions.xml / CustomUnitNames.xml |

### 📝 可视化表单编辑
- 所有配置项均为表单界面：下拉选模型、勾选旗标、数字直接填
- 服装组件按槽位分组展示（帽子、上衣、裤子、鞋…一目了然）
- 实时预览、即时保存，所见即所得

### 📂 项目管理与多文件同时编辑
- 项目级文件清单：所有配置文件集中管理，不再满硬盘找文件
- 多文件同时打开：随意切换，互不干扰
- **修改状态跟踪**：未保存的修改高亮标记，防止误关丢配置
- 文件重命名、新建、删除无需离开编辑器

### 🔄 EUP wardrobe.ini 一键转换
- 粘贴 `[M-xxx]` / `[F-xxx]` 服装块，自动解析为可视化变体
- 无需手工换算 drawable:texture，转完直接微调

### 💾 自动备份 / 一键回滚
- 每次修改自动生成备份，任何误操作随时回退
- 放心折腾：改坏了恢复，恢复完再改

### 🧠 原文保真与智能校验
- **原文保真**：不认识的节点、非法的属性值，原样保留不静默丢弃
- **智能校验**：非法属性值、缺失必填字段、同名槽位冲突，实时标红提示
- 双向安全：既能及时发现错误，又绝不擅自删除你已有的数据

### 🌍 10 种语言界面切换
- 中文（简体）、中文（繁体）、英文、日文、韩文、法文、德文、西班牙文、葡萄牙文、俄文
- 一键切换，无需重启，配置内容与界面语言互不影响

## 快速上手
1. 打开官网阅读用户指南：<https://eupxml.tzl644.cn/>
2. 打开编辑器，选择或新建项目（支持直接读取游戏目录配置）
3. 直接向 AI Dispatch 提需求，或手动在表单中编辑
4. 保存后进游戏验证

## 更新日志
### v0.1.0
- 首个公开发布版本

## 注意事项
- 修改前请备份原配置文件（工具也会自动备份）
- 若修改后游戏内不生效，请检查 MOD 版本兼容性

## 重要声明
- **本软件与 Rockstar Games、Take-Two Interactive 及其关联公司无任何隶属关系或背书关系**
- Grand Theft Auto V、GTA V 是 Rockstar Games 的注册商标；LSPDFR 由 G17 Media 开发；EUP 由 EUP 团队开发；Ultimate Backup 与 Policing Redefined 均为其各自作者的独立作品。**本软件与上述任何开发者/团队均无关联，亦未获其认可**
- 本软件为免费工具，仅供学习交流使用，**禁止商业用途与倒卖**
- 使用本软件前请务必备份原始配置文件；因使用本软件导致的存档损坏、游戏崩溃或其他任何损失，作者概不承担
- 请支持正版游戏

ScriptHookVDotNet 是一款适用于《Grand Theft Auto V》的 ASI 插件，基于 Alexander Blade 的 C++ ScriptHook 开发。它允许你在游戏内运行使用任意 .NET 语言编写的脚本，为模组开发提供了更便捷的途径。
系统要求
C++ Script Hook V（由 Alexander Blade 开发）
.NET Framework ≥ 4.8
Visual C++ Redistributable for Visual Studio 2019 x64
安装步骤
下载对应版本的压缩包，并解压。
将除 README.txt 和 Docs 文件夹外的所有文件复制到游戏根目录（即与 GTA5.exe 同级的文件夹）。
Docs 文件夹中的 XML 文件是供脚本开发者参考的 API 文档，无需复制到游戏目录。
更新时注意事项：必须同时更新以下所有文件，切勿单独替换，否则可能导致问题：
ScriptHookVDotNet.asi
ScriptHookVDotNet2.dll
ScriptHookVDotNet3.dll
开发者贡献指南
需要 Visual Studio 2019 或更高版本 打开项目文件。
将 Script Hook V SDK 解压至项目根目录下的 /sdk 文件夹。
欢迎通过 GitHub Pull Requests 提交贡献。

这个模组提升了 GTA V 中警笛的各项限制：
每辆车警笛数量：从 20 个增加到 32 个（支持 siren1 到 siren32，全部独立工作）。
警笛玻璃（siren_glass）限制也提升到 32。
警笛设置 ID 最大值从 255 提升到 65535，避免 ID 冲突。
可拥有无限多种独特警笛灯光模式（比如 400 辆车各有不同模式也没问题）。
安装
把 ASI 文件放到游戏根目录。
使用
新增灯光用 siren21~siren32，并在 carcols.meta 里添加对应设置。注意每辆车总骨骼数仍限 128 个。
ID 注意
不要用 0、255、65535 这三个保留值。
RPH 用户
兼容最新 RPH 1.98 或更高，旧版兼容 DLL 需删除。
FiveM 用户
服务器开启 ASI 支持，玩家把 ASI 放到 FiveM 的 plugins 文件夹即可。

让增强版script类脚本生效的前置插件

一个修改版本，适用于 GTA5 Legacy 和 Enhanced 版本。
正如原版 Legacy 的作者“Unknown Modder”所说，此版本仅修复由大量 rpf 文件引起的问题，如果您遇到其他问题，仍然需要 良好的游戏配置和https://htovo.com/files/file/129/

安装方法很简单，只需将 PackfileLimitAdjusterEnhanced.asi 和 PackfileLimitAdjusterEnhanced.ini 拖入您的游戏目录即可。

默认情况下，游戏可加载的 rpf 文件数量已调整为 13000，但您可以在 PackfileLimitAdjusterEnhanced.ini 中进一步增加此值。
更新日志

v1.1增加了对豪宅 DLC 的支持，因为在增强版中找不到某些图案。

v1.0初始版本

Script Hook V 是一款允许在自定义 *.asi 插件中使用 GTA V 原生脚本函数的库。请注意该功能不适用于 GTA Online，当玩家进入多人游戏时，脚本钩子会禁用自定义脚本。
本发行版同时包含最新版 Asi Loader
安装说明
将 ScriptHookV.dll 复制到游戏主文件夹（即 GTA5.exe 所在位置）。
加载asi插件需安装asi加载器，可单独下载或使用本发行版附带的最新版（dinput8.dll）。

ScriptHookVDotNet Nightly（SHVDN Nightly）
是 GTA5 最核心的 NET脚本运行前置 ，为基于 ScriptHookV 的.NET 模组提供运行环境，俗称 “每日构建版 / 开发版”ScriptHookVDotNet。
一.核心意义
作用：让 GTA5 能直接运行用 C#/VB.NET/F# 写的脚本模组（.dll）。
关系：必须搭配原版 ScriptHookV，是其.NET 扩展层ScriptHookVDotNet。
版本区别：
Stable（稳定版）：正式发布，更新慢、兼容性强。
Nightly（开发版）：每日自动编译，包含最新功能与 bug 修复，优先支持新版 GTA5（如 v1.0.3788+），但可能有小问题。
二.关键特点
✅ 全 API 支持：提供比原生 C++ 更友好的托管 API，支持人物、载具、战斗、UI 等全功能开发ScriptHookVDotNet。
✅ 高兼容性：Nightly 版是新版 GTA5 必备（v3.6.0+），稳定版(非Nightly版本)常跟不上游戏更新。
✅ 实时重载：默认按 Insert 键 快速重载脚本，开发 / 调试极方便。
✅ 现代生态：支持 LemonUI、RAGEPluginHook、LSPDFR 等主流模组，是绝大多数复杂 AI / 保镖 / 菜单类模组的必备前置ScriptHookVDotNet。
三.必备依赖
ScriptHookV（最新版）
.NET Framework 4.8（Win10/11 通常自带）
VC++ 2019 x64 运行库
四.特别提醒
适用场景：装高级保镖、AI 同伴、自定义菜单等.NET 模组,或者特别指示需要用到Nightly版本时，优先选 Nightly 版。
稳定性：比稳定版新，但可能有未发现的小 bug；追求稳定用 SHVDN普通版(Stable[稳定版])，追新 / 玩新模组用 NightlyScriptHookVDotNet（非Nightly版)

LemonUI 是一个用于在侠盗猎车手 V 中创建 UI 系统的框架，与 SHVDN2、SHVDN3 和 FiveM 兼容，它允许您创建具有类似 NativeUI 样式的 UI 元素，或者您也可以通过与分辨率无关的 Text、Rectangles 和 Textures 类从头开始创建自己的 UI 系统。
它是作为 NativeUI 的替代品而创建的，因为它太复杂而无法开发和维护，LemonUI 保留了 NativeUI 中可用的大部分UI 元素。
安装
警告：你不需要安装所有文件。你只需要安装你打算用的框架的那些。比如，如果你想安装SHVDN模组,就不需要安装RPH版本。
FiveM 使用FiveM时无需安装任何文件。当你连接到服务器时，需要它的资源会自动提供一份 LemonUI
使用RageMP时不需要安装任何文件。当你连接到服务器时，需要它的资源在编译代码时会自动提供一份 LemonUI 副本。——————————————————————————————————————————————————————————-—————————
RagePluginHook
将压缩文件内RPH文件夹中的所有文件复制到你GTA V安装目录的根目录____________________________________________________________________________________________________________________
ScriptHookVDotNet 2 和 ScriptHookVDotNet 3
将压缩文件内SHVDN2和/或SHVDN3文件夹中的所有文件复制到你的脚本目录。
注意:夜间版(测试版)与普通版存在本质区别,安装错误插件将不会生效！

安装教程
将 Albo1125.Common.dll 复制到你的《Grand Theft Auto V》游戏文件夹（与 RAGEPluginHook.exe 所在位置相同），并替换旧文件。

适用于 GTA5 Legacy 和 Enhanced 版本。
安装方法很简单，只需将 HeapAdjuster.asi 和 HeapAdjuster.ini 拖入游戏目录即可。

注意：
除非你使用这个模组进行开发，或者使用需要这个的模组，否则这个模组本身什么也做不了！
开源 1.0 来了！
1.0 修复了之前的所有问题，例如非致命武器无法被 LSPDFR 跟踪。现在应该跟踪所有损坏。
DamageTracker框架
DamageTrackerFramework 是一个 RPH 插件，它充当框架，当 Peds 和玩家受到伤害时，它会向其他插件提供事件。以前，您必须检查 Ped 是否损坏的方式非常低效且不准确，并且通常会导致重大性能损失。
DamageTrackerFramework 试图通过直接从游戏内存中获取数据并将其传递给其他插件来解决这个问题，从而实现准确、可靠和高性能的伤害跟踪，与通常从 20fps 到 60fps 下降的其他技术相比，损失可以忽略不计 ~0-1fps，同时准确性或可靠性较低。
要求
RagePluginHook
安装
将DamageTrackerLib.dll安装到 GTA V 目录。
将DamageTrackerFramework.dll安装到插件文件夹中。
DamageTrackerFramework 必须使用 RagePluginHook 启动。
问题
- 不会跟踪毒气手榴弹造成的伤害。

RAGENativeUI 是 RAGEPluginHook 的库，可帮助您快速轻松地构建类似 Rockstar 的菜单和 UI。
安装
RAGENativeUI.dll 复制到 GTAV 主目录。