Switch play path to CyberpunkMP cloud server

README.md

@@ -1,6 +1,12 @@
 # RedSync
 
-Multiplayer framework for **Cyberpunk 2077** (v2.31). Rebrand of the Cyberverse rewrite — client plugin, redscript layer, and a .NET game server with a C++ networking core.
+> **Direction change:** RedSync is pivoting to a **[CyberpunkMP](https://github.com/tiltedphoques/CyberpunkMP) plugin**
+> (SDK-only). Core multiplayer sync (puppets, movement, animation, appearance, vehicles) is owned by CyberpunkMP.
+> See [`cyberpunkmp-plugin/`](cyberpunkmp-plugin/) for the plugin scaffold and migration map.
+>
+> The standalone RedSync UDP server / RED4ext sync stack in this repo is **legacy** and not the path for full player anim.
+
+Multiplayer-related tooling for **Cyberpunk 2077** (v2.31). Originally a rebrand of the Cyberverse rewrite (client plugin, redscript layer, .NET game server). New work targets the CyberpunkMP plugin model.
 
 > [!NOTE]
 > Active development. A self-contained tester package lives in [`release/`](release/) with auto-detect installers. See [Quick start](#quick-start-for-testers).

cyberpunkmp-plugin/.gitignore

@@ -0,0 +1,6 @@
+**/bin/
+**/obj/
+local-plugins/
+**/admins.json
+**/redsync.json
+!RedSyncSystem/redsync.json

cyberpunkmp-plugin/MIGRATION.md

@@ -0,0 +1,49 @@
+# Migration map: RedSync host → CyberpunkMP plugin
+
+## Product decision
+
+| Before | After |
+|--------|--------|
+| RedSync = full multiplayer stack | CyberpunkMP = multiplayer stack |
+| RedSync.Server + RED4ext netcode | Abandoned as competing host |
+| Jackie/Judy + teleport puppets | CMP puppets / anim / appearance |
+| Custom UDP protocol 0x7/0x8 | CMP protobuf + RPC |
+
+## Feature-by-feature
+
+| RedSync piece | Action |
+|---------------|--------|
+| `shared/protocol`, native GNS, `NetworkGameSystem` sync | **Drop** — CMP replaces |
+| Player anim flags / TPP research | **Drop** — CMP core |
+| `server/Managed` GameServer | **Freeze** — reference only |
+| `server/Managed/Plugins` (.NET host we added) | **Superseded** by CMP plugin loader |
+| Admin (`admins.json`, F7, kick/ban) | **Port** into `RedSyncSystem` + CMP admin/web if useful |
+| Discord webhook | **Port** into `RedSyncSystem` |
+| Spawn anchor | **Evaluate** — port only if CMP lacks equivalent |
+| Tester `release/` RedSync client | **Retargeted** — `Setup-CyberpunkMP.bat` / `CyberpunkMP - Play.bat` + `CONNECT-CMP.txt` |
+| Redscript combat / nametags | **Keep ideas**; reimplement only as CMP client plugins via RPC |
+
+## Plugin conventions (CMP)
+
+From CMP’s loader:
+
+- Directory: `plugins/<Name>System/`
+- DLL: `<Name>System.dll`
+- Entry type: `<Name>System.Plugin`
+- Static ctor runs at load; wire `Server.PlayerSystem` / `Server.World` events there
+- RPC: redscript `ServerRpc` / `ClientRpc` + generated C# (`SdkGenerator`); implement `*_Impl` partials
+- Optional: `IWebApiHook` + `assets/` for admin UI widgets
+
+## Suggested delivery order
+
+1. **Scaffold loads** — `RedSyncSystem` logs on load; `plugins` list shows it (CMP admin).
+2. **Join/leave Discord (or console) announce** — uses `PlayerJoinEvent` / `PlayerLeftEvent`.
+3. **Admin helpers** — thin RPCs for kick/say if CMP API exposes enough.
+4. **Client redscript** — only for UX that CMP doesn’t ship.
+5. **Retire** standalone RedSync server docs from the “how to play” path.
+
+## Explicit non-goals
+
+- Do not vendor CyberpunkMP native client, archives, or animation controllers.
+- Do not reintroduce a second netcode stack beside CMP.
+- Do not ship CMP binaries inside this repo.

cyberpunkmp-plugin/README.md

@@ -0,0 +1,83 @@
+# RedSync → CyberpunkMP plugin pivot
+
+RedSync is **no longer developing a competing multiplayer host**.
+Player sync (movement, animation, appearance, vehicles) is handled by
+**[CyberpunkMP](https://github.com/tiltedphoques/CyberpunkMP)**.
+
+This folder is the start of RedSync as a **CyberpunkMP plugin** that uses only
+their published **.NET SDK** + **redscript RPC** surfaces.
+
+## License (read this)
+
+CyberpunkMP’s license allows plugins that:
+
+- use the provided SDK / interfaces
+- do **not** modify CyberpunkMP source
+- do **not** redistribute CyberpunkMP itself
+
+Example plugins under `code/scripting/EmoteSystem`, `JobSystem`, and
+`code/assets/redscript/Plugins` are MIT. Study those patterns; do **not** copy
+CMP core (animation controllers, archives, native client).
+
+## What CMP already owns (do not rebuild)
+
+| Area | Owner |
+|------|--------|
+| Connection / world | CyberpunkMP |
+| Remote puppets + appearance | CyberpunkMP |
+| Movement + basic animation | CyberpunkMP |
+| Vehicles | CyberpunkMP |
+| RPC transport | CyberpunkMP |
+
+## What RedSync plugin can add
+
+| Feature | Notes |
+|---------|--------|
+| Discord join/leave / server log webhook | Port from RedSync `DiscordWebhookTarget` |
+| Admin allowlist extras | Kick/ban/announce UX on top of CMP |
+| Spawn-anchor style conveniences | If still useful alongside CMP |
+| RP / economy / jobs-style gameplay | Same shape as CMP `JobSystem` |
+| Custom F10-style UI | Client redscript + `ServerRpc` / `ClientRpc` |
+
+## Layout
+
+```
+cyberpunkmp-plugin/
+  README.md                 ← this file
+  MIGRATION.md              ← feature migration map
+  RedSyncSystem/            ← server plugin (loads as plugins/RedSyncSystem/)
+  client-redscript/         ← optional client RPC / UI scripts for CMP
+```
+
+## Build / install (against a CMP server tree)
+
+1. Build or download a CyberpunkMP server that includes `CyberpunkSdk`.
+2. Set `CYBERPUNKMP_SDK` to the folder containing `CyberpunkSdk.dll`
+   (or leave unset to compile against local **SdkStubs** for CI only — do not
+   deploy stub `CyberpunkSdk.dll` into a live CMP server).
+3. Build:
+
+```bash
+dotnet build cyberpunkmp-plugin/RedSyncSystem -c Release
+```
+
+4. Install **only** the plugin assembly:
+
+```text
+<cmp-server>/plugins/RedSyncSystem/RedSyncSystem.dll
+```
+
+Loader rules (from CMP): folder name `RedSyncSystem`, assembly
+`RedSyncSystem.dll`, type `RedSyncSystem.Plugin`, static constructor runs on load.
+
+5. Optional: set `REDSYNC_DISCORD_WEBHOOK` on the CMP server process for join/leave announces.
+
+## Local build (this machine)
+
+```bash
+./cyberpunkmp-plugin/build-local.sh
+dotnet run --project cyberpunkmp-plugin/RedSyncSystem.Smoke -c Release
+```
+
+Stages `cyberpunkmp-plugin/local-plugins/RedSyncSystem/` (DLL + `redsync.json`).
+Copy that folder into a CyberpunkMP server’s `plugins/` directory to load it.

cyberpunkmp-plugin/RedSyncSystem.Smoke/Program.cs

@@ -0,0 +1,20 @@
+using CyberpunkSdk;
+using RedSyncSystem;
+
+internal static class Program
+{
+    private static void Main()
+    {
+        Console.WriteLine("RedSyncSystem local smoke test");
+        _ = Plugin.Instance;
+        Console.WriteLine($"Config: {PluginConfig.ConfigPath}");
+
+        StubPlayerSystem.Instance.SimulateJoin(1, "LocalTester");
+        StubPlayerSystem.Instance.SimulateLeave(1);
+        StubWorld.Instance.SimulateTick(0.1f);
+
+        Plugin.Instance.Admins.Add("LocalTester");
+        Console.WriteLine($"IsAdmin(LocalTester)={Plugin.Instance.IsAdmin("LocalTester")}");
+        Console.WriteLine("Smoke test OK");
+    }
+}

cyberpunkmp-plugin/RedSyncSystem.Smoke/Program.csproj

@@ -0,0 +1,13 @@
+<Project Sdk="Microsoft.NET.Sdk">
+  <PropertyGroup>
+    <OutputType>Exe</OutputType>
+    <TargetFramework>net8.0</TargetFramework>
+    <ImplicitUsings>enable</ImplicitUsings>
+    <Nullable>enable</Nullable>
+    <LangVersion>12</LangVersion>
+  </PropertyGroup>
+  <ItemGroup>
+    <ProjectReference Include="..\RedSyncSystem\RedSyncSystem.csproj" />
+    <ProjectReference Include="..\SdkStubs\CyberpunkSdk.Stubs.csproj" />
+  </ItemGroup>
+</Project>

cyberpunkmp-plugin/RedSyncSystem/AdminAllowlist.cs

@@ -0,0 +1,131 @@
+using System.Text.Json;
+
+namespace RedSyncSystem;
+
+/// <summary>
+/// Optional RedSync-side admin allowlist (usernames). CMP may have its own admin;
+/// this list is for RedSync plugin features only.
+/// </summary>
+public sealed class AdminAllowlist
+{
+    private readonly object _lock = new();
+    private readonly string _path;
+    private readonly LoggerProxy _log;
+    private HashSet<string> _admins = new(StringComparer.OrdinalIgnoreCase);
+
+    private static readonly JsonSerializerOptions JsonOptions = new()
+    {
+        WriteIndented = true,
+        PropertyNameCaseInsensitive = true
+    };
+
+    public AdminAllowlist(string pluginDirectory, IEnumerable<string>? seed, LoggerProxy log)
+    {
+        _log = log;
+        _path = Path.Combine(pluginDirectory, "admins.json");
+        Load(seed);
+    }
+
+    public bool IsAdmin(string? name)
+    {
+        if (string.IsNullOrWhiteSpace(name))
+        {
+            return false;
+        }
+
+        lock (_lock)
+        {
+            return _admins.Contains(name.Trim());
+        }
+    }
+
+    public bool Add(string name)
+    {
+        name = name.Trim();
+        if (string.IsNullOrWhiteSpace(name))
+        {
+            return false;
+        }
+
+        lock (_lock)
+        {
+            if (!_admins.Add(name))
+            {
+                return false;
+            }
+
+            SaveLocked();
+            return true;
+        }
+    }
+
+    public bool Remove(string name)
+    {
+        name = name.Trim();
+        lock (_lock)
+        {
+            if (!_admins.Remove(name))
+            {
+                return false;
+            }
+
+            SaveLocked();
+            return true;
+        }
+    }
+
+    public IReadOnlyList<string> List()
+    {
+        lock (_lock)
+        {
+            return _admins.OrderBy(x => x, StringComparer.OrdinalIgnoreCase).ToList();
+        }
+    }
+
+    private void Load(IEnumerable<string>? seed)
+    {
+        lock (_lock)
+        {
+            _admins = new HashSet<string>(StringComparer.OrdinalIgnoreCase);
+            if (File.Exists(_path))
+            {
+                try
+                {
+                    var names = JsonSerializer.Deserialize<List<string>>(File.ReadAllText(_path), JsonOptions)
+                                ?? [];
+                    foreach (var n in names)
+                    {
+                        if (!string.IsNullOrWhiteSpace(n))
+                        {
+                            _admins.Add(n.Trim());
+                        }
+                    }
+                }
+                catch (Exception ex)
+                {
+                    _log.Warn($"admins.json load failed: {ex.Message}");
+                }
+            }
+
+            if (seed != null)
+            {
+                foreach (var n in seed)
+                {
+                    if (!string.IsNullOrWhiteSpace(n))
+                    {
+                        _admins.Add(n.Trim());
+                    }
+                }
+            }
+
+            SaveLocked();
+            _log.Info($"Admin allowlist: {_admins.Count} name(s) ({_path})");
+        }
+    }
+
+    private void SaveLocked()
+    {
+        var list = _admins.OrderBy(x => x, StringComparer.OrdinalIgnoreCase).ToList();
+        File.WriteAllText(_path, JsonSerializer.Serialize(list, JsonOptions));
+    }
+}