Luban Schema Design

Designs Luban schema (beans, enums, polymorphism, collections, groups). Use when modeling config structures, inheritance, nested beans, or choosing Excel vs XML schema.

focus-creative-games Updated

File contents

Luban: Schema 设计

原则

  • 程序维护 Schema;策划填 Data。
  • 复杂 GamePlay(技能/行为树)优先 OOP 继承/多态,而不是塞字符串。
  • 客户端敏感字段用 s group,不要泄漏到 c

选型

需求 建议
扁平行表 Excel + read_schema_from_file
多模块/复用 bean XML Defines/*.xml__beans__
多态配置 抽象 bean + 子类;Excel 填类型名/别名
一对多嵌套 list,Bean / 多行 / sep 紧凑格式

类型要点

  • 容器:list,T / map,K,V元素不可写 list,int?
  • 可空:T?;多态非空必须给具体子类
  • 引用:int#ref=module.TbX
  • 字段名建议 snake_case,生成时按语言转风格

检查清单

  1. 主键与 mode(map/list/one)是否匹配
  2. group 是否覆盖 client/server 需求
  3. 多态子类是否都已定义且可区分
  4. -c schema-json 或 MCP GetSchema 复核结构

参考

  • 类型系统、XML Schema、多态、分组 targets

focus-creative-games/luban/tree/main/ai/skills/luban-schema-design commit 23ab5817f8

Frequently asked questions

npx skillmds@latest add focus-creative-games/luban-schema-design