Minecraft Fabric Mod · 1.21.11 / 26.2

在 Minecraft 里写代码

代码方块是一个游戏内可编程红石方块。每个方块绑定一段程序,每游戏刻(tick,20 次/秒)执行一次, 把计算结果以红石信号从 6 个面输出,并读取相邻方块朝它发出的信号作为输入。

  • 0–F红石强度
  • 20Hz每刻执行
  • ~1s自动热重载
  • 2MC 版本
代码方块贴图

为什么是它

把红石变成一台小电脑

不是命令方块,不是 cumbersome 的函数,而是真正能跑循环、分支与运算的可编程方块。

游戏内可编程红石

每个方块 6 个面都能读 / 写红石信号。写计算逻辑,接红石线,立刻驱动整片电路——加法器、比较器、计数器都能做。

零依赖 DSL

.codescript 写类 C 小语法,记事本就能编辑,不需要编译器。

Java 实时编译

想写完整的类?放一个 .java,游戏内调用 javac 实时编译(需 JDK 启动 MC)。

定时热重载

保存文件后约 1 秒自动检测到变动并重载;右键方块也能强制刷新并查看运行状态。

双版本支持

同时维护 1.21.11(yarn 映射)与 26.2(开发构建)两条 Fabric 构建线,进游戏都不崩。

双标签页归位

创造模式里,代码方块同时出现在「红石」标签页与「管理员 / 命令方块」标签页,和命令方块怼一起。

三步上手

拿方块 → 写程序 → 接红石

  1. 01

    拿到方块

    创造模式 → 物品栏「红石」标签页(或管理员标签页)→ 找到「代码方块」,放到世界里。

  2. 02

    写程序

    右键方块,聊天栏显示它的 id(10 位十六进制)。到程序目录新建 CB_<id>.codescript 写逻辑。

  3. 03

    接红石

    方块 6 面自动发出红石。把红石源接它的输入面、红石线接它的输出面,保存即热重载运行。

DSL 速览

几行就能跑的代码片段

通道 0=下 1=上 2=北 3=南 4=西 5=东;cin(c) 读、cout(c,v) 写,强度自动限制在 0–15。

下载

挑一个顺手的镜像

滚动鼠标滚轮,方块会逐一切到下一个下载源。主源为 Gitee 镜像,官网同时自托管 1.21.11 / 26.2 两个版本与 ECJ 附加模组。下载源由版本清单自动生成,无需改页面。

提示:把 jar 丢进对应实例的 mods/ 文件夹即可。想用 .java 实时编译但不想改 JDK 启动 MC,装下方的 ECJ 附加模组 即可(JRE 环境也能编译);否则直接用 .codescript

可选附加模组

ecj 编译环境(给 JRE 用户)

官方启动器默认用 JRE 跑 MC,没有 javac,游戏内编译 .java 会失败。装这个独立小 mod(内置 Eclipse JDT Core / ecj 编译器)后,JRE 环境下主模组会自动调用它编译 Java——无需把 MC 改成 JDK 启动,也无需自己预编译 .class。可装可不装。

CodeBlock ECJ Compiler

companion mod
  • 作用:JRE 环境下提供完整 Java 编译能力
  • 依赖:需先装主模组 CodeBlock Mod
  • 版本:随主模组支持 1.21.11 / 26.2

已发布 v0.1.0:jar 已构建并上传,JRE 用户把它丢进 mods/ 即可在游戏内编译 Java,无需安装完整 JDK。

历史版本

回退到旧版

新版若有问题(比如出了 bug),可在这里切回之前的版本。当前为 v1,后续版本会依次追加,旧版 jar 会一直保留。