This is a multiplayer mod for Hogwarts Legacy. Publicly available so anyone can tinker around!
Players spawn and see each other in a shared world, with synchronized appearance, spellcasting, and broom flight. On top of that sits a JavaScript scripting layer (server + client resources) so you can build gamemodes — chat, commands, persistent state, weather/time control, NPCs, doors — without touching C++. See Scripting below.
NOTE: This repository can NOT be compiled standalone and requires a special configuration provided by the framework itself. Follow the instructions on the MafiaHub Framework repository to learn how to use this project.
We're always looking for new contributors, so if you have any ideas or suggestions, please let us know and we'll see what we can do to make it better. You can either reach us at our Discord server MafiaHub / HogwartsMP, or by raising an issue on our repository.
If you're interested in development, please read our Contribution Guidelines.
Please check the open issues since we document everything there.
We use CMake to build our projects, so you can use any of the supported build systems. We support Windows, Linux, and MacOS operating systems at the moment. You can follow the following instructions to learn how to use this repository here
Server gameplay logic is written in JavaScript as resources. If you want to write a gamemode (events, chat commands, persistent state, weather, NPCs), see the script author's guide at resources/README.md. No C++ required.
The mod has grown from a reverse-engineering playground into a working multiplayer sandbox. Players connect, spawn, and see each other in a shared world.
Foundations
- DirectX 12 hooks for ImGui rendering
- Game structures reversing (world, players, components, containers) under the SDK namespace
- Reflection-based game interface (call
UFunctions / read-write properties by name — survives game patches) - Fast game load + save/tutorial bypass (hands-free boot into a session)
- Debug UI + hooks
- Battle-tested networking (native MafiaNet replication) with player entity replication
Multiplayer gameplay
- Remote player spawning — players render each other as full characters
- Full appearance synchronization — custom character look including outfit/robe material swatches (CCC/CCD wire format)
- Spellcasting synchronization (cast pose, VFX, aim pitch, Lumos)
- Broomstick flight synchronization (mount state + dead reckoning)
- Weather / time / season management (networked and script-exposed)
- Server-authored door / lock unlocking
- NPC spawning + disposition / combat
- World props / interactables (E-key interaction)
- World boundaries removal
Scripting & UI
- Node.js scripting-enabled dedicated server (JavaScript resources — see Scripting)
- Client-side JavaScript scripting host (sandboxed V8, in-game)
- CEF web UI rendering on D3D12 (HTML/CSS/JS panels driven from script)
- Persistent per-player + global storage; cross-resource event bus
In progress / not yet covered
- Shared / co-op story progression (research stage)
- Positional (spatial) voice
The code is licensed under the MafiaHub OSS license.
The 5th clause exists to ensure that the work can focus primarily on this repository, as we provide an access to the multiplayer mod. This is important to ensure that the mod is not used for other purposes, such as the creation of other derivative projects, that would diverge from the original work. This approach guarantees that the changes are directly made to the original work itself, having a healthy ecosystem in mind.