命令与权限
EmakiCooking 的主命令是 /ecooking，别名为 /ec。管理员主要用它重载工位配置、检查手持物/目标方块来源、重建工位索引和查看运行调试信息。
命令列表
| 命令 | 权限 | 说明 |
|---|---|---|
/ec help | emakicooking.use | 显示帮助。 |
/ec reload | emakicooking.reload 或 emakicooking.admin | 重载主配置、语言、工位、配方、GUI 与物品调整。 |
/ec inspect hand | emakicooking.inspect、emakicooking.use 或 emakicooking.admin | 检查手持物来源和烹饪匹配情况。 |
/ec inspect block | emakicooking.inspect、emakicooking.use 或 emakicooking.admin | 检查准星 6 格内目标方块的工位类型、方块状态、TileState、PDC/YAML 后端和索引状态。 |
/ec station reindex | emakicooking.admin | 重建工位坐标索引，扫描 legacy YAML 与当前已加载区块中的 PDC 工位。 |
/ec debug | emakicooking.debug 或 emakicooking.admin | 输出运行时调试信息。 |
营养命令
/ec nutrition 用于查询和管理玩家营养值。营养玩法说明见 营养系统。
| 命令 | 权限 | 说明 |
|---|---|---|
/ec nutrition get [玩家] [类型] | emakicooking.nutrition.use、emakicooking.nutrition.admin 或 emakicooking.admin | 查询营养值。不带类型列出全部类型的 值 / 上限；带类型返回单类型当前值。玩家可省略（默认查自己，控制台必须指定）。 |
/ec nutrition set <玩家> <类型> <数值> | emakicooking.nutrition.admin 或 emakicooking.admin | 设置指定玩家某营养类型的值。 |
/ec nutrition add <玩家> <类型> <数值> | emakicooking.nutrition.admin 或 emakicooking.admin | 增加指定玩家某营养类型的值。 |
/ec nutrition remove <玩家> <类型> <数值> | emakicooking.nutrition.admin 或 emakicooking.admin | 减少指定玩家某营养类型的值。 |
set、add、remove需要四段参数齐全，目标玩家必须在线，数值写入后按类型min~max截断。- 营养系统未启用时，营养命令会提示已禁用。
基础权限
| 权限 | 默认 | 说明 |
|---|---|---|
emakicooking.use | true | 基础使用权限。 |
emakicooking.reload | op | 重载配置。 |
emakicooking.inspect | op | 检查物品或工位。 |
emakicooking.admin | op | 管理员权限。 |
emakicooking.debug | op | 调试权限。 |
工位权限
| 权限 | 默认 | 说明 |
|---|---|---|
emakicooking.station.chopping_board.use | true | 使用砧板。 |
emakicooking.station.chopping_board.cut | true | 执行砧板切割。 |
emakicooking.station.wok.use | true | 使用炒锅。 |
emakicooking.station.wok.stir | true | 翻炒。 |
emakicooking.station.wok.serve | true | 出锅。 |
emakicooking.station.grinder.use | true | 使用研磨机。 |
emakicooking.station.steamer.use | true | 使用蒸锅。 |
emakicooking.station.steamer.fuel | true | 为蒸锅添加燃料。 |
emakicooking.station.steamer.moisture | true | 为蒸锅添加水分或湿度材料。 |
emakicooking.station.oven.use | true | 使用烤炉。 |
emakicooking.station.oven.fuel | true | 为烤炉添加燃料。 |
emakicooking.station.juicer.use | true | 使用榨汁机。 |
emakicooking.station.juicer.press | true | 执行压榨。 |
emakicooking.station.juicer.collect | true | 盛取榨汁结果。 |
emakicooking.station.fermentation_barrel.use | true | 使用发酵桶。 |
emakicooking.station.fermentation_barrel.start | true | 开始发酵。 |
emakicooking.station.fermentation_barrel.collect | true | 收取发酵结果。 |
当前权限采用
emakicooking.station.*形式。旧配置中如果存在简写权限，应迁移到上表格式。
营养权限
| 权限 | 默认 | 说明 |
|---|---|---|
emakicooking.nutrition.use | true | 查询自己的营养值（/ec nutrition get）。 |
emakicooking.nutrition.admin | op | 设置、增加、减少任意玩家营养值。 |
emakicooking.admin可覆盖全部营养操作。
先用哪个命令
| 场景 | 先执行 | 目的 |
|---|---|---|
| 改了工位、配方、GUI 或语言 | /ec reload | 重载 Cooking 运行配置。 |
| 材料、燃料或容器不匹配 | /ec inspect hand | 查看手持物被识别成什么物品来源。 |
| 工位方块、PDC 后端或索引异常 | /ec inspect block | 查看目标方块是否为 TileState、当前后端、PDC/YAML 状态和索引记录。 |
| 迁移旧 YAML、换方块或重启后工位缺失 | /ec station reindex | 重建 data/stations/index/<world>.idx 坐标索引。 |
| 工位监听或展示异常 | /ec debug | 查看运行时状态和调试输出。 |
常见操作
检查手持物来源
text
/ec inspect hand用于确认手持物是否能被识别为配方输入、容器、燃料、工具或工位方块。排查自定义物品来源时优先使用该命令。
检查目标工位方块
text
/ec inspect block用于查看准星 6 格内目标方块的工位类型、物品来源、block_state、tile_state、storage_backend、pdc_state、indexed、index_backend 和 legacy_yaml。大量工位服务器可用它确认锚点是否走 BLOCK_PDC，从而减少独立 YAML 文件 IO。
重建工位坐标索引
text
/ec station reindex用于扫描旧 YAML 状态和当前已加载区块中的 PDC 工位，重建 data/stations/index/<world>.idx。迁移旧数据、替换方块实体或发现 ChunkLoad 后工位未恢复时优先执行。
重载烹饪配置
text
/ec reload重载后建议检查控制台输出。如果新增了工位方块、GUI 或配方目录，建议在测试服先验证状态保存与交互流程。
调试运行状态
text
/ec debug适合排查工位监听、展示实体、配方匹配、持久化状态等问题。正式服长期排查时，建议配合控制台日志使用，避免玩家端信息过多。
排查建议
- 工位无法使用：检查方块来源、工位权限和交互方式是否匹配。
- 工位状态或后端不确定：对准目标方块执行
/ec inspect block，确认tile_state、storage_backend、pdc_state、indexed和legacy_yaml。 - 重启或区块加载后工位未恢复：先执行
/ec station reindex重建索引，再观察控制台是否出现lost_block_entity_replaced或 mismatch 报告。 - 材料无法放入：检查
input_rules.only_recipe_items、配方目录和物品来源。 - 榨汁机无法盛取：检查流体容量是否达到容器
serving_ml，并确认玩家拥有emakicooking.station.juicer.collect。 - 发酵桶无法开始：检查输入是否匹配配方、是否需要封存、玩家是否拥有
start权限。 - 烤炉不推进：检查火力是否处于配方要求区间，燃料是否生效。