译者注:本文档的部分/全部翻译来自 MCBBS,由于 MCBBS 当前(2022.8)正在进行系统维护,暂无法联系原译者“Tony🐴”,因此这是未授权的转载。
最基本也是最首要的,如果你是 Lua 新人,你应该熟悉 Lua 参考手册(英文)。你会在这里找到大部分基本 Lua 功能和例子,以及大量标准库功能。
(译者注:中文读者可参见菜鸟教程的 Lua 教程。)
OC 尽力去模拟大部分和系统互动的标准库,也就是 I/O 库。有少许不同,你可以在这里查看:与标准库的差异(英文)。最值得注意的是,几乎整个 debug 库都是不可用的,load
只接受文本源文件,不接受二进制或预编译的 Lua 程序(这是由于安全原因)
下列标准库文件可以在全局环境下使用,它们不需要预加载到你的脚本中也能正常运行。
print
不是一个库,但是是一个常用的输出方法。print("hello world")
下列是为了方便而提供的非标准库。
请注意,在使用所有非标准库之前,你需要 require
它们,非标准库即所有没有在Lua基本参考手册中列出的标准库。举例来说,你不应该仅仅使用 local rs = component.redstone
,你需要先通过 require 声明调用此API,就像这样:
local component = require("component") local rs = component.redstone -- 你当然可以更改变量名称: local mycomp = require("component") local rs = mycomp.redstone
以下列出的 API 都是这样(甚至 sides 和 colors 也是如此)。
除了Lua提供的标准库外,OC 提供了两个内建的库。它们当中的一些功能可能无法使用,视您的配置(HTTP)或情况(计算机上无法调用机器人上的库)而定,但是它们仍然存在。
File*
原文如此 API 缓冲区实现。