Gooseboy

模组

· 作者 awildergoose

在 Minecraft 中运行游戏和应用程序!

0 本站下载 0 关注 更新于 5 个月前

最新 1.3.0 · 1.21.10 · Fabric

一键开服(送7天)

Gooseboy

Minecraft 内置的微型游戏主机

Available for Fabric Requires Fabric API Check out the gallery

此模组允许你在客户端安全地运行 WebAssembly 脚本,从而创建游戏、程序以及任何你心仪的内容。

注意:在 Gooseboy 中,脚本被称为 crate(容器)

特性

  • 在 Minecraft 内以极小的性能损耗运行游戏和应用
  • 使用 Rust 和标准库制作游戏与应用
  • 支持针对每个 crate 的权限控制与存储管理
  • 支持播放任意音频,无需重载游戏

权限

默认情况下,每个 crate 仅拥有对控制台和鼠标的最低限度权限。你可以通过打开 crate 的设置来更改其权限。 完整的权限列表如下:

  • CONSOLE:允许 crate 向控制台记录消息。
  • AUDIO:允许 crate 播放声音和/或音乐,支持任意音频格式。
  • INPUT_KEYBOARD:允许 crate 检测你是否按下了键盘按键。
  • INPUT_MOUSE:允许 crate 检测你是否使用了鼠标点击。
  • INPUT_MOUSE_POS:允许 crate 获取鼠标的位置,该位置已根据屏幕区域进行调整。
  • INPUT_GRAB_MOUSE:允许 crate 隐藏鼠标并将其锁定在屏幕中心。
  • STORAGE_READ:允许 crate 读取其自身的存储空间。
  • STORAGE_WRITE:允许 crate 写入其存储空间。
  • GPU:允许 crate 在框架内以 3D 模式渲染。

安全性

crate 通过 Java Chicory WASM 运行时环境执行。 出于安全考虑,crate 无法:

  • 访问或修改 Minecraft 的状态(例如其他玩家在游戏内的位置)
  • 访问或修改其他 crate 的存储空间
  • 访问或修改你的文件
  • 在世界中进行渲染
  • 在后台运行
  • 在游戏外读取你的键盘或鼠标输入
  • 使用互联网或与任何服务器通信
  • 运行 Java 代码

如果你发现了能绕过这些限制的 crate,请通过 GitHub 报告。

如何打开 crate 菜单

进入游戏后,按 M 键。(如果你喜欢,也可以在“控制”选项卡中更改此快捷键!)

在哪里寻找 crate

你可以在这里找到官方示例 crate。

如何添加 crate

你可以将 crate 移动到 crates 文件夹中。你可以在菜单中按下底部的“Open crates folder location”按钮来打开 crates 文件夹。

如何创建 crate

你可以使用任何编译为 WebAssembly 的语言来制作 crate(由于安全原因,不支持 WASI)。 推荐使用的语言是 Rust,因此标准库也是用 Rust 编写的。

一个示例 crate 如下所示:

#![no_main]

use gooseboy::framebuffer::{get_framebuffer_width, init_fb};
use gooseboy::text::{draw_text, get_text_width};
use gooseboy::{color::Color, framebuffer::clear_framebuffer};

// 每个 crate 都必须包含一个 main 函数,并确保使用
// gooseboy::main 进行装饰,否则 crate 将无法启动
#[gooseboy::main]
fn main() {
    // 初始化帧缓冲,如果你计划绘制到屏幕(这很可能),
    // 则必须在此处进行初始化
    init_fb();
}

// 这也是每个 crate 所必需的,gooseboy::update 也必须在此处声明,
// 该函数每秒运行 X 次,其中 X 等于你在选项中设置的最大帧率
#[gooseboy::update]
fn update(nano_time: i64) {
    // 清除屏幕,擦除之前存在的所有内容
    clear_framebuffer(Color::BLACK);

    // 初始化我们要绘制到屏幕上的字符串。你也可以在这里使用 Rust 的
    // String 类型,但需要注意的是在 draw_text 时需要克隆它
    let text = "Hello, world!";
    // 将时间从纳秒转换为秒
    let time_sec = nano_time as f64 / 1_000_000_000.0;
    // 获取右边缘的位置并减去文本宽度,以使文本适应屏幕
    // 如果文本超出帧缓冲区的末尾,你也可以使用 draw_text_wrapped 来自动换行
    let right_corner = (get_framebuffer_width() - get_text_width(text)) as f64;
    // 获取一个 X 坐标,使其利用正弦函数平滑地从左向右移动
    let x_pos = ((time_sec.sin() * 0.5 + 0.5) * (right_corner - 1.0)) as usize;

    // 最后,使用红色绘制文本(或使用 Color::new(r, g, b, a) 或 Color::new_opaque(r, g, b))
    draw_text(x_pos, 0, text, Color::RED);
}

贡献

想要帮助改进 Gooseboy?欢迎贡献!你可以在此处找到标准库 here,CLI 工具 here 以及 Java 模组 here!

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源