C++ Core Reference

Professional reference for MCX internals: architecture, core systems, extension points and implementation workflow.

Core Architecture

• server.* : orchestrates runtime loop, bridges, modules and script runtime.
• event_bus.* + events.hpp : normalized event model and dispatch.
• action_applier.* + actions.hpp : converts high-level actions to backend operations.
• scene_manager.* : game-mode transitions and scene-local behavior.
• player_registry.* : connected-player state lifecycle.

Module API

#include <mcx/imodule.hpp>

class MyModule : public mcx::IModule {
public:
    void OnEvent(const mcx::Event& event, mcx::ActionList& actions) override {
        // inspect event + push actions
    }
};

Runtime Components

• Schedulers: scheduler.*, thread_scheduler.*, async_worker.*
• Commands: command_parser.*, command_registry.*
• Networking: network_bridge.*, websocket_server.*, rcon.*, http_client.*
• Gameplay: economy_manager.*, permissions.*, teleport_manager.*, kit_manager.*
• Ops: backup_manager.*, update_checker.*, config_loader.*, config_validator.*

Build & Contribution Workflow

git clone https://github.com/alanparesys/MCX.git
cd MCX
cmake -S . -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build --parallel
./build/mcx --demo

Quality Checklist

• Header in include/mcx/ for any new public component.
• Unit/smoke test update in tests/.
• Documented behavior in docs pages (Lua + C++ views).
• No breaking API changes without changelog + migration note.