Luban Add Table

Adds a new Luban config table (Excel + __tables__ registration + regenerate). Use when creating a new table, registering reward/item tables, or when the user asks to add a Luban table.

focus-creative-games Updated

File contents

Luban: 加一张表

规则

  • Schema 是契约:先登记表,再填数据。
  • Excel sheet 仅当 A1 以 ## 开头才被识别。
  • read_schema_from_file=true 时不要在 __beans__ 重复定义同名 bean。

步骤

  1. 在 dataDir(常为 Data)新建 xxx.xlsx/csv:
    • ##var:字段名
    • ##type:类型(如 int / string)
    • 可选 ##group:c/s
    • 其后为数据行
  2. 在 Data/__tables__.xlsx(或 XML schema)增加一行:
    • full_name:如 TbReward
    • value_type:如 Reward
    • read_schema_from_file:true(从表头推断字段)时常用
    • input:相对 dataDir 的文件名
    • index:主键字段(map 表)
  3. 运行项目 gen.bat / gen.sh,或:
dotnet Luban.dll --conf luban.conf -t all -d json -x outputDataDir=output
  1. 确认输出出现新表;若有 -c,确认生成了对应类型。

常见失败

现象 处理
新文件无输出 是否写入 __tables__
sheet 被忽略 A1 是否 ## 开头
bean 冲突 关闭重复的 __beans__ 定义

参考

  • 文档:加一张表、Excel 基础、Excel Schema
  • 需要查现有表时用 MCP ListTables / GetSchema

focus-creative-games/luban commit 92a603909c

Frequently asked questions

npx get-skill add focus-creative-games/luban-add-table