項目架構

LeviLamina/
├── src/              # 通用 + 服务端代码
├── src-client/       # 客户端专用代码
├── src-server/       # 服务端专用代码
├── src-test/         # 测试代码
├── docs/             # 文档
├── scripts/          # 构建和工具脚本
├── builder/          # 头文件生成脚本
└── bin/              # 构建输出

src/
├── ll/
│   ├── api/          # 公共 API（255 个头文件）
│   │   ├── base/     # 基础类型
│   │   ├── command/  # 命令系统
│   │   ├── event/    # 事件系统
│   │   ├── form/     # UI 表单
│   │   ├── mod/      # 模组管理
│   │   ├── service/  # 服务注册表
│   │   └── ...       # 其他模块
│   └── core/         # 内部实现（34 个文件）
│       ├── mod/      # 模组加载
│       ├── command/  # 内置命令
│       ├── form/     # 表单处理器
│       └── tweak/    # 游戏调整
└── mc/               # Bedrock 头文件（反编译）
    ├── server/
    ├── world/
    ├── network/
    └── ...

src-client/
├── ll/
│   ├── api/
│   │   ├── input/
│   │   │   ├── KeyRegistry.h  # 输入绑定
│   │   │   └── KeyHandle.h
│   │   └── event/
│   │       ├── input/         # 输入事件
│   │       ├── render/        # 渲染事件
│   │       └── client/        # 客户端生命周期
│   └── core/
│       └── (8 个文件)          # 客户端实现
└── mc/
    └── client/                # 客户端专用头文件

src-server/
├── ll/
│   ├── api/
│   │   ├── event/server/      # 服务端事件
│   │   └── service/           # 服务端服务
│   └── core/
│       └── (10 个文件)         # 服务端实现
└── mc/
    └── server/                # 服务端专用头文件

┌─────────────────────────────────────────┐
│         模组代码（用户）                 │
└─────────────────┬───────────────────────┘
                  │ 使用
┌─────────────────▼───────────────────────┐
│        ll/api（公共 API）               │
│  ┌──────────┐  ┌──────────┐  ┌────────┐│
│  │  命令    │  │  事件    │  │  表单  ││
│  └──────────┘  └──────────┘  └────────┘│
│  ┌──────────┐  ┌──────────┐  ┌────────┐│
│  │  模组    │  │  服务    │  │  内存  ││
│  └──────────┘  └──────────┘  └────────┘│
└─────────────────┬───────────────────────┘
                  │ 实现
┌─────────────────▼───────────────────────┐
│        ll/core（实现层）                │
│  ┌──────────────┐  ┌──────────────────┐ │
│  │ ModRegistrar │  │ NativeModManager │ │
│  └──────────────┘  └──────────────────┘ │
│  ┌──────────────┐  ┌──────────────────┐ │
│  │ CrashLogger  │  │   内置命令       │ │
│  └──────────────┘  └──────────────────┘ │
└─────────────────┬───────────────────────┘
                  │ 使用
┌─────────────────▼───────────────────────┐
│      mc/（Bedrock 引擎头文件）          │
│  ┌──────────┐  ┌──────────┐  ┌────────┐│
│  │  Player  │  │  Level   │  │ Packet ││
│  └──────────┘  └──────────┘  └────────┘│
│  ┌──────────┐  ┌──────────┐  ┌────────┐│
│  │ Command  │  │ Server   │  │ Network││
│  └──────────┘  └──────────┘  └────────┘│
└─────────────────────────────────────────┘

-- xmake.lua
option("target_type")
    set_default("server")
    set_values("server", "client")