Tech Stack and Build

Tech Stack & Build

Languages & Tools

Language / Tool	Usage
C++23	Full engine — all 20 static-library modules (-fno-rtti, -fno-exceptions; lpl-bci re-enables -fexceptions)
C17	Linux kernel module (lpl_kmod.c), network protocol
Vulkan	Vulkan rendering backend, ImGui integration (optional, --renderer)
CUDA	GPU physics kernels (PhysicsKernel.cu) — optional (--cuda), automatic CPU fallback
xmake	Build system — orchestrates all modules as static libraries

Prerequisites

• Linux with kernel headers (for the kernel module)
• xmake ≥ 2.9.0
• GCC 13+ or Clang 17+ (C++23 support)
• Vulkan SDK (vulkan-headers, vulkan-loader, vulkan-hpp)
• ImGui (auto-fetched by xmake with GLFW + Vulkan backends)
• NVIDIA CUDA Toolkit (optional — automatic CPU fallback)
• BCI dependencies (eigen, liblsl, brainflow) are auto-fetched by xmake from the official xmake-repo; brainflow is optional

Repository Layout

LplPlugin/
├── xmake.lua             # Root orchestrator (project settings, module includes)
├── core/                 # Platform abstraction, types, assertions
│   ├── include/lpl/core/ # Public headers
│   ├── src/              # Implementation
│   └── xmake.lua         # Module build config (lpl-core)
├── math/                 # Vec3, Quat, Fixed32, CORDIC, BoundaryBox
├── memory/               # PinnedAllocator, pool allocators
├── container/            # FlatAtomicsHashMap, Morton encoding
├── concurrency/          # ThreadPool, SpinLock
├── gpu/                  # CUDA lifecycle, physics kernels (inline stubs w/o nvcc)
├── ecs/                  # EntityRegistry, Partition (SoA chunks)
├── physics/              # WorldPartition, collision, octree
├── net/                  # transport (kernel / socket), protocol, session, netcode
├── input/                # InputManager (keys, axes, neural)
├── platform/             # HW backends (clock/display/gpu-memory/input)
├── render/               # software + Vulkan renderer, ImGui (optional)
├── shaders/              # shader sources
├── image/                # 2D software imaging (Surface, Painter, Codec)
├── scene/                # scene graph (Scene, Transform2D)
├── audio/                # Spatial audio (stub)
├── haptic/               # Haptic feedback (stub)
├── bci/                  # OpenBCI driver, FFT, SignalMetrics, Riemannian, calibration
│   ├── include/lpl/bci/
│   ├── src/
│   └── tests/
├── serial/               # state serialization & deterministic replay
├── bench/                # benchmark harness (Harness, SystemInfo)
├── engine/               # Top-level facade (depends on ALL modules)
├── kernel/               # Linux kernel module (lpl_kmod.c)
├── apps/                 # Executables
│   ├── server/           # lpl-server (headless, authoritative)
│   ├── client/           # lpl-client (desktop / VR)
│   └── benchmark/        # lpl-benchmark (micro-benchmark suite)
└── samples/              # example code

Each module follows the pattern: <module>/include/lpl/<module>/ for public headers, <module>/src/ for implementations, with .inl files for inline function bodies.

Build Targets

Target	Command	Description
All	xmake build -j$(nproc)	Build all 20 modules + 3 executables
Server	xmake build lpl-server	Headless authoritative server
Client	xmake build lpl-client	Vulkan desktop client
Benchmark	xmake build lpl-benchmark	CPU benchmark (ECS, physics, containers)
Clean	xmake clean	Remove all build artifacts
Reconfigure	xmake f -c	Clean configuration and cache

Build Modes

xmake f -m debug      # Debug symbols, no optimization, LPL_DEBUG
xmake f -m release    # -O fastest, stripped, NDEBUG
xmake f -m profile    # Debug symbols + -O fastest, LPL_PROFILE

Build Options

Option	Description
--renderer=y/n	Enable/disable Vulkan renderer (useful for headless server)
--cuda=y/n	Enable/disable CUDA GPU physics kernels

Kernel Module Targets

xmake kmod-build      # Build the lpl_kmod.ko module
xmake kmod-install    # Load the module (insmod) and set /dev/lpl0 permissions
xmake kmod-uninstall  # Unload the module (rmmod)
xmake kmod-logs       # Show recent kernel logs
xmake kmod-clean      # Clean kernel build artifacts

Running

xmake run lpl-server
xmake run lpl-client
xmake run lpl-benchmark

Compiler Flags

Flag	Rationale
-fno-rtti	No runtime type information — smaller binary, faster dispatch
-fno-exceptions	No C++ exceptions — deterministic control flow, zero overhead
VULKAN_HPP_NO_EXCEPTIONS	Vulkan C++ bindings without exceptions
-std=c++23	Concepts, std::expected, consteval, structured bindings
-Werror -Wall -Wextra	Zero-tolerance for warnings

---

← Architecture | Next: Modules →