Windrose Server Whitelist

# BuildWhitelist

UE4SS mod required.

https://www.nexusmods.com/windrose/mods/43?tab=description

A UE4SS Lua mod for a Windrose dedicated server that restricts joining to a whitelist of player names.

## How it works

- Hooks `R5MovementComponent::ServerSaveMoveInput` (post-hook)

- Gets the R5MovementComponent → Pawn → Controller → PlayerState chain via `ctx:get()`

- Calls `ps:GetPlayerName():ToString()` to get the player's display name

- Compares against `whitelist.json`

- Non-whitelisted players are kicked immediately using `KickPlayer` + object destruction

## Installation

1. Place the `Windrose Server Whitelist` folder in `R5/Binaries/Win64/ue4ss/Mods/`

2. Edit `whitelist.json` — add the exact Steam display names of allowed players

3. Restart the server

## Whitelist format

["PlayerName1", "PlayerName2"]

Names are case-sensitive and must match the Steam display name exactly.

| File | Purpose |

|------|---------|

| `scripts/main.lua` | Mod logic |

| `whitelist.json` | List of allowed player names |

| `enabled.txt` | UE4SS mod enable flag |

## Technical notes

- `GetPlayerName()` returns an `FString` userdata — requires `:ToString()` to convert to Lua string (not `tostring()`)

- `FUniqueNetIdRepl. UniqueId` cannot be converted to a readable Steam ID string in this UE4SS/game version

- `ServerSaveMoveInput` post-hook with `ctx:get()` is the only reliable way to reach the real PlayerState

- Login-stage hooks (`PreLogin`, `PostLogin`, etc.) are not hookable (not `UFUNCTION()`)