Magic World (Voxel MMO ECS)

Dự án Unity/DOTS cho thế giới voxel quy mô lớn theo kiến trúc: deterministic world, delta streaming, GPU culling, automation graph, magic/status system, và data-driven modding.

Mục tiêu kỹ thuật chính

• World scale lớn: Chunk 2D grid + deterministic seed.
• Late-join chính xác: chỉ stream delta thay đổi từ server.
• Hiệu năng render cực cao: Compute Shader culling + DrawMeshInstancedIndirect.
• Logic đa luồng: ECS/Burst cho gameplay cốt lõi.
• Máy móc & ma thuật mở rộng: graph automation + bitmask trạng thái 128/256-bit.

Kiến trúc repository (cơ bản)

Assets/_Project/
  Client/        # Logic chỉ chạy phía client (input, camera, UI, VFX local)
  Server/        # Logic authority server (AoI, delta cache, tick sync)
  Shared/        # Contract chung client-server (component, RPC schema, constants)

docs/
  ARCHITECTURE.md # Blueprint và thứ tự triển khai

build/
  client/         # Output build client
  server/         # Output build dedicated server
  client-server/  # Output build host/local integration

Quy ước tách lớp

• Client: không quyết định state authoritative.
• Server: nguồn sự thật (source of truth), quyết định state cuối cùng.
• Shared: mọi kiểu dữ liệu đồng bộ 2 phía phải nằm ở đây.

Bitmask trạng thái (Tensura)

• v1: StateBitmask128 (uint4) cho trạng thái game gốc.
• v2: StateBitmask256 (2 x uint4) cho mở rộng mod.
• Dùng bitmask để lọc nhanh trong hệ thống ECS; giữ chi tiết thời lượng/cường độ trong dynamic buffer.

Build targets

• client: build người chơi.
• server: dedicated server headless.
• client-server: local host/testing mode.

TODO: bổ sung script build tự động trong Assets/_Project/Server hoặc Editor tooling để CI/CD.