风玫瑰服务器白名单

# 构建白名单
需要UE4SS模组。
https://www.nexusmods.com/windrose/mods/43?tab=description

一个用于Windrose专用服务器的UE4SS Lua模组，仅允许白名单内的玩家名称加入。

## 使用方法

- 钩取 `R5MovementComponent::ServerSaveMoveInput`（后置钩取）
通过 `ctx:get()` 获取 R5移动组件 → 角色 → 控制器 → 玩家状态 的链条
调用 `ps:GetPlayerName():ToString()` 获取玩家的显示名称
- 与 `whitelist.json` 进行对比
- 非白名单玩家将立即被踢出（调用 `KickPlayer`）并销毁其对象

## 安装

1. 将 `Windrose Server Whitelist` 文件夹放入 `R5/Binaries/Win64/ue4ss/Mods/` 目录中
2. 编辑 `whitelist.json` 文件，添加允许玩家的 Steam 显示名称（需完全一致）
3. 重启服务器

## 白名单格式

```json { "Quest_Title": "旅途的起点", "Quest_Description": "听说那座废弃的矿坑最近有怪事发生，去看看吧。", "Dialogue_Greeting": "嘿，你也是来碰运气的？", "UI_Button_Start": "开始游戏", "UI_Setting_Volume": "音量", "System_SaveSuccess": "存档成功", "Item_HealthPotion": "生命药水", "Skill_Fireball": "火球术", "NPC_Trader": "行商", "Enemy_Goblin": "哥布林", "Tooltip_Equip": "装备", "Message_LevelUp": "等级提升！获得1点技能点。" } ```
["玩家名1", "玩家名2"]
好的，请提供您需要本地化的游戏文本。

名称区分大小写，必须与Steam显示名称完全一致。

## 文件

| 文件 | 用途 |
好的，请提供需要翻译的文本。
| `scripts/main.lua` | Mod 逻辑 |
```json { "文件名": "whitelist.json", "描述": "允许的玩家名称列表" } ```
| `enabled.txt` | UE4SS 模组启用标记 |

## 技术说明

`GetPlayerName()` 返回一个 `FString` 类型的用户数据，需使用 `:ToString()` 而非 `tostring()` 将其转换为 Lua 字符串。
`FUniqueNetIdRepl.UniqueId` 无法在当前 UE4SS/游戏版本中转换为可读的 Steam ID 字符串
使用 `ServerSaveMoveInput` 的后钩子与 `ctx:get()` 是获取真实玩家状态的唯一可靠方式。
- 登录流程钩子（如 `PreLogin`、`PostLogin` 等）不可挂载（非 `UFUNCTION()`）