Factory Manager 2

右键箱子 A → [factory/input]
右键箱子 B → [factory/input]
右键熔炉   → [factory/smelters]

every 20 ticks {
    move("input", "smelters", "minecraft:iron_ore", 64)
}

// 变量声明
var batchSize = 32
const maxTransfer = 64

// 赋值
batchSize += 8

// 条件判断
if count("input") > 0 {
    move("input", "output", "minecraft:diamond")
} else if count("input") == 0 {
    log("input is empty")
} else {
    log("unexpected state")
}

// 循环
var labels = ["chest_a", "chest_b", "chest_c"]
for lbl in labels {
    var cnt = count(lbl)
    log("%s has %d items", lbl, cnt)
}

// 逻辑运算 (支持短路求值)
if hasItem("input", "minecraft:iron_ingot") and freeSlots("output") > 0 {
    move("input", "output", "minecraft:iron_ingot")
}

list.size()        // list.size() 或 list.len()
str.upper()        // 转大写
str.contains("x")  // 包含检测
map.get("key")     // map 字段访问

// 定时触发 -- 每 20 ticks (1秒) 执行一次
every 20 ticks {
    move("input", "output")
}

// 定时触发 -- 每 5 秒执行一次
every 5 seconds {
    log("heartbeat")
}

// 红石脉冲触发
on redstone {
    move("chest", "dispenser", "minecraft:arrow", 64)
}

// 启动触发 -- 程序加载或重新编译时执行一次
on startup {
    log("Factory Manager online")
    var total = count("storage")
    log("storage has %d items", total)
}

// 按物品 ID 过滤
move("input", "output", filter { item == "minecraft:coal" })

// 按 NBT 过滤 (耐久低于 100 的物品)
move("input", "repair", filter { nbt.Damage < 100 })

// 多条件组合
take("input", filter { item == "minecraft:diamond_sword", nbt.Damage == 0 })

// 通配符匹配
move("input", "output", filter { item contains "minecraft:diamond" })

Program Disk (脚本源码 + 命名空间)
       |
       v
ManagerBlockEntity.setDisk()
       |
       v
ProgramBuilder.build() -- 词法分析 -> 语法分析 -> AST 构建
       |
       v
ProgramRunner
  |-- globalScope (var/const 跨 tick 持久化)
  |-- timers[]     (every N ticks/seconds)
  |-- events[]     (on redstone / on startup)
       |
       v (每 tick / 事件触发)
Interpreter.executeBlock()
  |-- Scope 链 (局部变量)
  |-- ExecutionContext (Level, namespace, 日志, PendingTransfer)
  |-- StdLib 内置函数调用
       |
       v
ResourceHandler -> NeoForge Capability (IItemHandler / IFluidHandler / IEnergyStorage)

src/main/
├── antlr/fm2/FM2Lang.g4                    # FM2Lang 脚本语言语法定义 (ANTLR4)
├── java/dev/factorymanager/fm2/
│   ├── FM2.java                             # Mod 入口点
│   ├── block/
│   │   ├── ManagerBlock.java                # 管理器方块
│   │   └── BufferBlock.java                 # 缓冲方块 (开发中)
│   ├── blockentity/
│   │   └── ManagerBlockEntity.java          # 管理器方块实体 (编译/执行/红石触发)
│   ├── item/
│   │   ├── LabelToolItem.java               # 标签工具
│   │   └── DiskItem.java                    # 程序磁盘
│   ├── namespace/
│   │   └── NamespaceManager.java            # 命名空间管理器 (SavedData)
│   ├── lang/
│   │   ├── ASTBuilder.java                  # ANTLR -> AST 转换
│   │   ├── ProgramBuilder.java              # 编译入口 (源码 -> ProgramNode)
│   │   ├── ast/
│   │   │   ├── Node.java                    # AST 基类
│   │   │   ├── NodeVisitor.java             # 访问者接口
│   │   │   ├── expr/                        # 表达式节点
│   │   │   └── stmt/                        # 语句节点 (if/for/every/on/var...)
│   │   ├── runtime/
│   │   │   ├── Interpreter.java             # 树遍历解释器
│   │   │   ├── ProgramRunner.java           # 触发器调度器
│   │   │   ├── ExecutionContext.java        # MC 执行上下文
│   │   │   ├── FM2Value.java                # 运行时值类型
│   │   │   ├── Scope.java                   # 作用域链
│   │   │   └── FM2RuntimeException.java     # 运行时异常
│   │   └── stdlib/
│   │       ├── StdLib.java                  # 内置函数注册表
│   │       └── BuiltinFunction.java         # 内置函数接口
│   ├── common/resource/
│   │   ├── ResourceHandler.java             # 通用资源接口 <CAP>
│   │   ├── ItemResourceHandler.java         # 物品处理器 (IItemHandler)
│   │   ├── FluidResourceHandler.java        # 流体处理器 (IFluidHandler)
│   │   ├── EnergyResourceHandler.java       # 能量处理器 (IEnergyStorage)
│   │   └── ResourceTransferHelper.java      # 通用搬运逻辑
│   └── registry/
│       ├── FM2Blocks.java                   # 方块注册
│       ├── FM2BlockEntities.java            # 方块实体注册
│       ├── FM2Items.java                    # 物品注册
│       ├── FM2CreativeTabs.java             # 创造模式标签页
│       └── FM2MenuTypes.java                # 菜单类型注册
└── resources/
    ├── META-INF/neoforge.mods.toml          # Mod 描述文件
    └── assets/fm2/lang/en_us.json           # 英文语言文件

./gradlew build