高级计算机

高级计算机

又一个适用于Minecraft的电脑模组,具有状态持久化功能,基于完全自定义的跨平台原版Java LUA 5.4运行时构建。

技术

Advanced Computers

这是又一个 Minecraft 电脑模组,包含一个自定义构建的 LUA 运行时,名为 JLuaVm,因此也具备持久化电脑状态的能力,可跨区块卸载乃至服务器关闭保持状态,这意味着它们在这些事件中不会被强制重启。这与 OpenComputers-1.12 的行为类似,不过我们使用的是完全自定义的 lua 运行时。 本项目当然受到 OpenComputers(适用于 Minecraft 1.12)和原版 ComputerCraft 模组的启发。

模组本身以及我们的 Lua 运行时位于我们的 Github 组织下:https://github.com/MidnightMages

这是 BETA 版本

大部分内容已经完成,我们认为模组状态相当不错,但仍可能存在 bug。如果你发现了 bug,请提交 issue。

特性

向 Minecraft 添加可编程电脑,以及屏幕、外设线缆、真实互联网访问、红石和物品栏接口外设等等,所有这些都可以通过 Lua 5.4 进行交互。

致服务器管理员: 就资源占用而言,我们仅为每台电脑设置一个 lua 执行环境,而不是一整个虚拟机,这意味着这些电脑的内存和磁盘空间需求非常低。

基于电脑等级实现的 CPU 时间限制已实现。磁盘使用也受到限制,但内存使用目前尚未限制。

快速上手

所有 API 都在我们的 wiki 上有文档,地址为 https://wiki.ac.ghxx.dev/,其中还包含一篇入门指南 https://wiki.ac.ghxx.dev/Introduction。

内置的操作系统(Advanced OS)附带基本命令,如 ls、rm,甚至还有一个受 GNU nano 启发的文本编辑器 nano。此外还有 pasteTextToFile,它会监听粘贴的文本(通过鼠标中键粘贴),然后将其写入指定文件。例如 pasteToFile someFile.lua。

你还可以使用 lua 代码 vm.listUdKeys(components:getFirst("computer")) 以编程方式找出 userdata 对象包含哪些字段(在你当前的模组版本中)。'userdata' 是一种特殊的 Lua 类型,代表一个 Java 对象。所有组件都以 userdata 对象表示。

结合查看现有的 uefi.lua 和操作系统(两者都位于 src/main/resources/assets/advancedcomputers/lua/*),希望能为你提供一个不错的起点。

你还可以在全局变量 _HOST 中找到当前的模组和 Minecraft 版本。例如 AdvancedComputers 0.1.2-alpha; Minecraft 1.20.1。

计划中的内容:

  • 让操作系统更可用(包括重写内核),因为目前它非常非常简陋(尽管包含 ls 和 lua 程序)(已完成)
  • 在 https://wiki.ac.ghxx.dev/ 上制作一个 wiki,列出并描述所有 API 函数(已完成)
  • 在游戏内电脑之间发送网络数据包(带有智能数据包处理,以避免编写自定义游戏内 IP 协议)(已完成)
  • 限制磁盘空间并(已完成)
  • 与更多 Minecraft 方块交互(已完成)
  • 添加软性电脑内存限制
  • 完成添加 Lua 标准库中缺失的所有内容(最显著的是模式匹配中的一些边缘情况特性,即 string.gsub 及相关函数中的边缘情况,尽管它们大多可用)
  • 添加更多有趣的东西,比如服务器等。

目标 Minecraft 版本

目前目标为 Minecraft 1.20.1(forge),但我们确实计划在未来更新到更新的版本。

许可证与署名

欢迎将本模组包含在任何整合包中,无需署名。 如果你将本模组用作整合包的一部分,能在 Discord 上给我们发条消息会很好,因为我们很好奇,但这不是必须的。

就非整合包使用而言,不要在任何地方重新上传模组构建。

如 LICENSE 文件所述,本模组以 MIT 许可证发布。 例外是字体,位于 git 仓库的 /assetSources/font 中。对于这些字体,适用该文件夹中关联的许可证。

欢迎将 JLuaVm 用于其他 Minecraft 模组,因为它同样以 MIT 许可证授权。