PlateWatch 中文操作指南
=======================
版本 5.4.1 | 汉化版 | t3.elitemod.top | 优质网汉化

【重要说明】
本汉化版将游戏内界面文字保留为英文（GTA V 游戏引擎内置字体不包含中文字形，
游戏内直接渲染中文会显示为乱码/方块，这是所有 LSPDFR 插件共有的引擎限制）。
汉化内容包括：
  - 加载完成后游戏通知（在末尾附加了 t3.elitemod.top | 优质网汉化 标识）
  - 本操作指南
配置文件 PlateWatch.ini 仍为英文键名，请配合本指南使用。


一、安装
=======
1. 将 PlateWatch.dll 放入：
     Grand Theft Auto V\Plugins\LSPDFR
2. 将 PlateWatch 文件夹整体放入：
     Grand Theft Auto V\Plugins\LSPDFR
3. 最终目录结构应为：

Grand Theft Auto V
└── Plugins
    └── LSPDFR
        ├── PlateWatch.dll
        └── PlateWatch
            ├── PlateWatch.ini
            ├── PlateReaderUI.png
            ├── PlateReaderUI2.png
            ├── PlateTexture.png
            ├── Hotlist.txt
            ├── IgnoreList.txt
            ├── Plates\        （车牌纹理，6 张 png）
            ├── Sounds\        （MDT_01~08 音效）
            └── Logs\          （CSV 命中日志）

4. 通过 RAGE Plugin Hook 启动 GTA V，进入 LSPDFR 上班即可。


二、默认按键（可在菜单或 INI 中修改）
==================================
  F7   打开 PlateWatch 设置菜单
  F8   开启/关闭 ALPR 系统
  F9   确认并关闭当前 ALPR 命中提示
  F10  进入/退出 UI 编辑模式

注意：你当前游戏内的 PlateWatch.ini 使用的是以下按键：
  MenuKey=F9        （打开菜单）
  ToggleKey=,       （切换 ALPR）
  AcknowledgeKey=F11（确认命中）
  EditKey=F12       （UI 编辑）

如需改回默认，把 [Controls] 段的 MenuKey 改成 F7、ToggleKey 改成 F8、
AcknowledgeKey 改成 F9、EditKey 改成 F10 即可。


三、设置菜单操作
===============
打开菜单后（默认 F7 / 你的是 F9）：
  上/下方向键   移动选中项
  左/右方向键   切换当前项的值
  回车          应用选项 / 开始按键捕获
  ESC          关闭菜单 / 取消按键捕获

菜单显示在屏幕右侧，共 22 个设置项。


四、修改游戏内按键
=================
1. 打开 PlateWatch 菜单
2. 选中要改的按键项（菜单键 / ALPR开关 / 确认键 / UI编辑键）
3. 按回车
4. 松开旧按键
5. 按下新按键
6. 按 ESC 取消

说明：
  - 菜单键和 ALPR 开关键支持修饰键：None（无）/ Control / Shift / Alt
  - 重复绑定的按键会被拒绝
  - 方向键、回车、ESC、Win 键、纯修饰键不能绑定
  - 新按键自动保存到 PlateWatch.ini


五、UI 编辑模式（拖动/缩放界面）
==============================
按 F10（或你的 EditKey=F12）进入 UI 编辑模式：
  - 鼠标悬停在车牌读取器或 ALPR 命中窗口上
  - 按住左键拖动 = 移动面板
  - 按住左键 + 滚动滚轮 = 缩放面板
  - 再次按 F10/F12 保存并退出

读取器和命中窗口分别独立调整。


六、PlateWatch.ini 配置详解
===========================
配置文件位于：Grand Theft Auto V\Plugins\LSPDFR\PlateWatch\PlateWatch.ini

; 注释以分号开头。修改后保存，插件会自动重新加载设置。
; 用记事本打开，注意保持英文半角符号，不要用中文全角符号。

----------------------------------------------------------
[UI] 界面外观
----------------------------------------------------------
TextureStyle=DUAL DISPLAY
  读取器外观样式：
    HARDWARE     = 单屏硬件式（使用 PlateReaderUI.png）
    DUAL DISPLAY = 双屏式（使用 PlateReaderUI2.png）
  （也显示为菜单里的"UI TEXTURE"项）
HardwareTexture=PlateReaderUI.png
  硬件式读取器使用的纹理图片文件名
DisplayTexture=PlateReaderUI2.png
  双屏式读取器使用的纹理图片文件名
  （更换或编辑图片后，在菜单里选"RELOAD ACTIVE TEXTURE"重新加载）

----------------------------------------------------------
[Display] 读取器位置与大小
----------------------------------------------------------
X=320.99      读取器左上角屏幕 X 坐标
Y=179.20      读取器左上角屏幕 Y 坐标
Scale=1.22    读取器缩放比例（1.0=原始大小）

----------------------------------------------------------
[HitPanel] 命中窗口位置与大小
----------------------------------------------------------
X=709.44      命中窗口左上角 X 坐标
Y=742.25      命中窗口左上角 Y 坐标
Scale=0.97    命中窗口缩放比例
DurationSeconds=12.00
  命中窗口显示时长（秒），到时自动关闭，也可按确认键提前关闭

----------------------------------------------------------
[ALPR] 系统开关
----------------------------------------------------------
Enabled=True
  是否启用 ALPR 系统（True/False）
ReaderVisible=True
  是否显示车牌读取器界面（True/False）
HitAlerts=True
  是否启用命中提示（命中后弹窗+响铃，True/False）
LockIndicator=True
  是否在命中时锁定显示（True/False）
PoliceVehiclesOnly=True
  是否只扫描警用车辆（True/False；False 则扫描所有车辆）
ScanDistance=50.00
  扫描距离（米）。数值越大扫描越远，但会更多误报，建议 40~60

----------------------------------------------------------
[Advanced] 高级设置
----------------------------------------------------------
ScanMode=BOTH
  扫描模式：
    BOTH  = 前后都扫
    FRONT = 只扫前方
    REAR  = 只扫后方
HitHistory=True
  是否记录最近命中历史（True/False）
PersistentLogging=True
  是否把命中记录写入 CSV 日志文件（True/False）
AutoEnableOnDuty=True
  上班时是否自动开启 ALPR（True/False）
FlagRepeatSeconds=45.00
  重复警报间隔（秒）。同一辆车在附近时，防抖时间，避免不停重复响铃

----------------------------------------------------------
[Audio] 音效
----------------------------------------------------------
DetectionSound=MDT_01
  命中提示音，可选：
    Off, MDT_01~MDT_08（对应 Sounds 文件夹里的 wav 文件）
  （在菜单里"ALERT SOUND"项也可切换）
Volume=75
  警报音量，0~100

----------------------------------------------------------
[Controls] 按键
----------------------------------------------------------
MenuModifier=None
  菜单键的修饰键（None/Control/Shift/Alt）
MenuKey=F9
  打开菜单的按键
ToggleModifier=None
  ALPR 开关的修饰键
ToggleKey=,
  ALPR 开关按键
AcknowledgeKey=F11
  确认/关闭当前命中的按键
EditKey=F12
  进入/退出 UI 编辑模式的按键
----------------------------------------------------------


七、热名单（Hotlist）
====================
文件：Grand Theft Auto V\Plugins\LSPDFR\PlateWatch\Hotlist.txt

格式：车牌号|原因
一行一个，例如：
  46EEK572|FELONY VEHICLE BOLO
  82JBD294|WANTED VEHICLE - ARMED SUSPECT
  68FBM911|VEHICLE CONNECTED TO ROBBERY

作用：扫描到热名单里的车牌时，会触发命中提示并显示"MANUAL HOTLIST MATCH"。
原因文本会显示在命中窗口、历史、CSV 日志和通知里。
自定义原因建议用英文（原因会被游戏内字体渲染，中文会乱码）。
修改后保存，在菜单里选"RELOAD HOTLISTS"重新加载。


八、忽略名单（IgnoreList）
========================
文件：Grand Theft Auto V\Plugins\LSPDFR\PlateWatch\IgnoreList.txt

一行一个车牌号，例如：
  12ABC345
  68FBM911

被忽略的车牌不会：锁定、弹命中窗口、响铃、进历史、进 CSV 日志。
保存后同样在菜单里"RELOAD HOTLISTS"重新加载（会连同忽略名单一起加载）。


九、车牌纹理与自定义
====================
PlateWatch 会真实渲染 GTA V 的车牌纹理。自带纹理在：
  Plugins\LSPDFR\PlateWatch\Plates\
  BlueOnWhite1.png / BlueOnWhite2.png / BlueOnWhite3.png
  YellowOnBlack.png / YellowOnBlue.png / NorthYankton.png

自定义纹理：把图片放入 Plates 文件夹即可。
（原版不支持通过 INI 指定自定义车牌纹理文件名，需替换同名文件或改代码。）

更换读取器 UI 纹理：
  1. 替换 Plugins\LSPDFR\PlateWatch\PlateReaderUI.png
     （或 PlateReaderUI2.png）
  2. 在菜单选 "RELOAD ACTIVE TEXTURE" 重新加载
  或修改 ini 的 [UI] 段后保存，插件会自动重载。


十、CSV 命中日志
================
文件：Plugins\LSPDFR\PlateWatch\Logs\ALPR_Hits.csv
需 [Advanced] PersistentLogging=True。

每条记录包含：UTC 时间戳、车牌号、扫描方向（FRONT/REAR）、
严重度（ADVISORY/WARNING/HIGH/CRITICAL）、车型、车主、
违规详情、数据来源（CDF=公共数据框架 / PlateWatch=本地模拟）。

用 Excel 打开时建议用 UTF-8 编码。


十一、违规类型与严重度
======================
可报告的违规：
  STOLEN VEHICLE          被盗车辆
  REGISTRATION EXPIRED    车辆登记过期
  REGISTRATION REVOKED    车辆登记吊销
  UNREGISTERED VEHICLE    未注册车辆
  INSURANCE EXPIRED       保险过期
  INSURANCE REVOKED       保险吊销
  NO INSURANCE            无保险
  SCRATCHED VIN           VIN 被刮花
  MANUAL HOTLIST MATCH    手动热名单匹配
  自定义 BOLO 原因

严重度分级：
  ADVISORY  提示（低优先级自定义/信息类警报）
  WARNING   警告（登记过期、保险过期）
  HIGH      高危（登记吊销、保险吊销、未注册、无保险）
  CRITICAL  严重（被盗、刮VIN、BOLO/逮捕令热名单匹配）

多违规会同时显示在同一命中窗口。


十二、音效替换
==============
自带的 8 个 MDT 音效在：
  Plugins\LSPDFR\PlateWatch\Sounds\MDT_01.wav ~ MDT_08.wav

替换方法：用同名 wav 覆盖即可，用标准 PCM 格式 WAV。
（也可以在 Sounds 文件夹里放自定义 wav，文件名对应 ini 里的 DetectionSound）


十三、常见问题
==============
1. 出现两个读取器/两个菜单
   -> Plugins\LSPDFR 里有多份 PlateWatch 旧 DLL，只保留一个，重启游戏。

2. 纹理显示不对
   -> 菜单里切换 UI TEXTURE，或修改 [UI] TextureStyle。

3. 纹理缺失
   -> 确认 PlateReaderUI.png 和 PlateReaderUI2.png 在 PlateWatch 文件夹内。

4. 车牌对不齐
   -> 确认选对了纹理；不要用自行排版的图片。

5. MDT 音效重复响
   -> 调大 FlagRepeatSeconds；删除重复 DLL；重启游戏。

6. 音效太吵
   -> 调小 [Audio] Volume（0~100）。

7. 没声音
   -> DetectionSound 别设成 Off；Volume 大于 0；确认 wav 存在；用标准 PCM wav。

8. 按键改不动
   -> 选中按键项按回车；先松开旧键再按新键；
      不能绑定方向键/回车/ESC/纯修饰键。

9. CSV 日志不出现
   -> PersistentLogging=True；确认 Logs 文件夹存在；触发一次有效命中。

10. 游戏内中文是乱码/方块
    -> 正常现象。GTA V 引擎内置字体不含中文字形，游戏内渲染中文必然乱码。
       本汉化版因此将游戏内界面文字保留为英文，仅在加载通知中附加汉化标识。
       日志与控制台信息由 LSPDFR 控制台渲染，中文不受影响。


十四、报错反馈信息
==================
反馈问题时请附带：
  - RAGEPluginHook.log
  - LSPDFR 版本号
  - GTA V 游戏版本
  - PlateWatch.ini
  - 截图或视频
  - 相关时的 Hotlist.txt / IgnoreList.txt
  - Plugins\LSPDFR 目录下的 DLL 列表


免责声明
========
PlateWatch 是社区为 GTA V LSPDFR 制作的非官方模组，与 Rockstar Games、
Take-Two Interactive、LSPDFR、FiveM、Motorola 及任何真实执法机构无关。
本中文操作指南由 t3.elitemod.top | 优质网汉化 制作。
