创建:逻辑

创建:逻辑

用于Create自动化的安全脚本语言,替代红石。

游戏机制

使用自己的编程语言创建一个自动化系统,名为“Metal”。 放置一台计算机,右键点击,输入代码,按保存,Shift+右键点击以切换运行。

编码: 声明 2 个系统(System 就像函数),“INIT”和“TICK”,如下所示:

SYSTEM(INIT): START;

此处为初始化代码

END_SYSTEM;

SYSTEM(TICK): START;

此处为 tick(循环)代码

END_SYSTEM;

API: 有一些函数可用于 Metal。

内置函数:

MAKE_VAR(VAR_TYPE,$name,start_value); - 创建一个全局变量(全局变量必须以 '$' 开头,仅在 INIT 中)

MAKE_ITEM_VAR($name,item_id); - 通过 Minecraft 物品数字 id 创建一个 INT 变量(仅在 INIT 中)

SET($name,value); - 为变量设置新值

ADD/SUB/MUL/DIV($name,value); - 对变量进行运算

WAIT(ms); - 延迟脚本(仅在 TICK 中)

CONTINUE(); - 返回到当前 System 的开头(仅在 TICK 中)

RERUN(); - 返回到当前脚本的主 System(仅在 TICK 中),自 0.0.7 起已移除

EXIT_STACK(); - 退出整个 System 调用栈并返回到栈起始点。自 0.0.7 起已移除

RETURN(); - 退出 1 层 System 调用栈,自 0.0.7 起实际上可以向 SYSTEM 调用返回值

ABORT(); - 强制终止当前脚本(不会关闭计算机)

CALL_SYSTEM(name, args...); - 调用 System(最大栈大小为 16),不能调用 System 入口点(INIT、TICK),args 仅在 0.0.3+ 模组版本中可用,自 0.0.7 起可以返回值

IF(condition): START; - 基础 IF 运算符(结束为 “END_IF;”)

ELSE(): START; - 基础 ELSE 运算符(位于 IF 和 END_IF 之间),自 0.0.7 起可以不带 “()” 调用

BIND_ARGS_TO_SYSTEM(name, args...); 仅在 INIT 中,args 必须形如 “#var:INT”,为 System 调用(CALL_SYSTEM)设置参数,仅在 0.0.3+ 模组版本中可用

MAKE_LOCAL_VAR(VAR_TYPE,#name,start_value); - 创建一个局部变量(局部变量必须以 '#' 开头)仅在 0.0.3+ 模组版本中可用

ACCEPT_INVOKES(); - 允许集成调用非保留系统,仅在 INIT 中,适用于 0.0.4+ 模组版本

PRINT(args...); - INFO 输出(白色)仅在 0.0.6+ 模组版本中可用

WARN(args...); - WARN 输出(黄色)仅在 0.0.6+ 模组版本中可用

ERROR(args...); - ERROR 输出(红色)仅在 0.0.6+ 模组版本中可用

EVALUATE(str); - 计算表达式,自 0.0.7 起添加

EVAL(code); - 像新的 SYSTEM 一样执行代码,自 0.0.7 起添加

FUNC((args),{ body }); - 创建一个 MetalFunction,可以通过 .invoke(args) 调用,自 0.0.7 起添加

CAUSE_HARD_ERROR(message); - 停止脚本,将栈和信息记录到控制台。自 0.0.7 起添加

WHILE(condition, { body }); 当条件为真时运行,自 0.0.7 起添加

FOR(#i,start,end, { body }); 从 #i = start 运行到 end - 1,自 0.0.7 起添加

LIST(TYPE); - 创建一个 MetalList,元素上限为 1024,自 0.0.7 起添加

SET_CATCH_MODE(); 仅在 INIT 中,现在部分错误不会停止脚本,只会记录 “Error catched!”,自 0.0.7 起添加。

SENDER($name,"item1", "item2"); - 仅在 INIT 中,创建一个发送模式的 RedstoneLinker(MetalObject),优于旧的功能方法(CONNECT_LINK_SENDER),自 0.0.7 起添加。

RECEIVER($name,"item1", "item2"); - 仅在 INIT 中,创建一个接收模式的 RedstoneLinker(MetalObject),优于旧的功能方法(CONNECT_LINK_RECEIVER),自 0.0.7 起添加。

MAKE_PROCESS(SYSTEM_NAME); - 创建第二个 tick 入口点,只能调用一次。仅在 INIT 中。自 0.0.7 起添加。

内置函数结束

Java 函数(在 Metal 外部注册):

CONNECT_LINK_SENDER(id,item1,item2); - 创建一个发送器连接(对于最后两个参数建议使用 MAKE_ITEM_VAR,id 是任意值,之前未使用过),仅在 INIT 中。注意:自 0.0.7 起请改用 SENDER($sender,item1name,item2name)。

CONNECT_LINK_RECEIVER(id,item1,item2); - 创建一个接收器连接(对于最后两个参数使用 MAKE_ITEM_VAR 变量)仅在 INIT 中。注意:自 0.0.7 起请改用 RECEIVER($receiver,item1name,item2name)。

SEND_LINK(id,power); - 向 Create Redstone Link 发送能量(与 CONNECT_LINK_SENDER 中使用的 id 配合使用)。注意:自 0.0.7 起请改用 $sender.send(power)。

RECEIVE_LINK(id); - 从 Create Redstone Link 接收能量(与 CONNECT_LINK_RECEIVER 中使用的 id 配合使用)。注意:自 0.0.7 起请改用 $receiver.receive()。

RANDOM(min,max); - 返回 min 到 max 之间的随机 INT

RAND(); - 返回 0.0 - 1.0 之间的随机 DOUBLE

SIN(value); - 返回值的 sin(使用弧度)

COS(value); - 返回值的 cos(使用弧度)

TAN(value); - 返回值的 tan(使用弧度)

SQRT(value); - 返回值的平方根

DTR(value); - 角度转弧度

RTD(value); - 弧度转角度

GET_PI(); - 返回 PI

MIN(args...); - 返回所有参数中的最小值

MAX(args...); - 返回所有参数中的最大值

CLAMP(value,min,max); - 返回限制在范围内的值

ABS(value); - 返回值的绝对值

POW(value,pow); - 返回值的幂运算

GET_OPS(); - 返回此脚本已完成的操作数 - 0.0.5+

Java 函数结束;

提示:

ADD、SUB 等仅用于修改值 例如:

ADD($x,1); = x += 1;

在括号中:

IF($x + 1 > $y): START;

代码

END_IF;

并且,“: START”不是必需的,但推荐使用,你也可以使用

SYSTEM(INIT); ...

IF(condition); ...

等。

当前变量类型:INT、DOUBLE、POWER、BOOL。自 0.0.7 起 - STRING、OBJECT。

TICK 入口点(System)在另一个线程中每秒运行 1000 次。

集成: 自 0.0.4 起,你可以从 Computer Craft 模组调用非保留系统,如下所示: Metal: SYSTEM(INIT): START; ACCEPT_INVOKES(); BIND_ARGS_TO_SYSTEM(SUM,#first:DOUBLE,#second:DOUBLE); END_SYSTEM; SYSTEM(SUM): START; RETURN(#first + #second); END_SYSTEM; SYSTEM(TICK): START;

END_SYSTEM;

CC Lua: local metal = peripheral.find("metal"); if metal then print(metal.callSystem("SUM",5,10)); -- 输出:15 else print("Cannot find Metal Computer"); end

自 0.0.5 起你可以使用 SYSTEM(NAME,args...): START; 代替 BIND_ARGS_TO_SYSTEM

示例:

SYSTEM(SET_POWER,#f:POWER,#s:POWER): START;

SEND_LINK(1,#f);

SEND_LINK(2,#s);

END_SYSTEM;

用 “**” 代替 “POW(val,pow);” “%” 运算符

自 0.0.6 起,在输出函数中你可以使用字面量,如下所示:

PRINT(~Hello World);

Hello World

或者,配合变量:

MAKE_VAR(INT,$test,150);

PRINT(~counter: ,$test);

counter: 150

对象:

MetalList: $list.add(value); $list.get(index); $list.getFirst(); $list.getLast(); $list.remove(index); $list.removeFirst(); $list.removeLast(); $list.clear(); $list.size(); $list.maxSize(); $list.hasIndex(index); $list.forEach(MetalFunction);

MetalFunction: $func.invoke(args); $func.getTypes();

RedstoneLinker: SENDER: $sender.send(power); $sender.toggle(active); RECEIVER: $receiver.receive(); $receiver.isActive();

自 0.0.8 起变量可以这样赋值:

TYPE $global_var = ...;

TYPE #local_var = ...;

变更:

var++;(自增)

var--;(自减)

var+=...;(加)

var-=...;(减)

var%=...;(取模)

var*=...;(乘)

var/=...;(除)

var**=...;(幂)

var=...;(设置)