盒状轮廓 API

用服务端命令控制客户端调整的框线轮廓

这是一个我另一个模组 client-tweaks 的 API。

它允许服务器通过 client-tweaks 向同时安装了两个模组的玩家召唤持续一 tick 的方框轮廓。

用法

命令

/boxoutline 0.0 0.0 0.0 1.0 1.0 1.0 red

这会在从 0 0 0 到 1 1 1 的范围内绘制一个持续单 tick 的方框。请注意,与 client tweaks 不同,box outlines api 的坐标使用小数。

Java 代码

首先将此模组的源代码发布到你的本地 maven

# clone the repo
git clone git@github.com:Spit365/box-outlines-api-1.21.6.git
# publish to maven
cd box-outlines-api-1.21.6
./gradlew publishToMavenLocal

然后在你的模组中包含 Box Outlines Api

build.gradle:

repositories {
  mavenLocal()
}

dependencies {
  modImplementation("net.spit365:box-outlines-api:1.0.0")
}

fabric.mod.json:

"depends": {
  "client-tweaks": "*"
}

最后,你可以在你的模组中使用以下方法:

import net.spit365.boa.BoxOutline;
import net.minecraft.util.math.Box;
import java.util.Collection;

BoxOutline.add(Box box, int color /* argb */)
BoxOutline.addAll(Collection<Box> box, int color /* argb */)
 

其行为方式相同,首先指定一个方框,然后指定一个十六进制格式的颜色(0xFFFF0000 -> 红色,完全不透明)。同样,这只会持续单个 tick,因此若要持续渲染,请将其放入 tick 回调中。

构建

要从零开始构建此模组,首先克隆此模组和 client-tweaks 的仓库。然后,在 client-tweaks 目录中运行

./gradlew publishToMavenLocal

这会将其发布到你的本地 maven。然后在 box outlines api 目录中运行

./gradlew build

为什么构建前需要这个额外步骤?Box Outlines Api 在编译时需要 client-tweaks 的源代码可用。我没有设置一个托管 client-tweaks 的全局 maven,所以你需要本地执行此操作。

其他

安装此模组吧,如果你觉得上述任何功能有趣的话。

如果你不知道如何安装模组 / fabric loader / 任何其他与 fabric 模组开发相关的内容,请访问官方 fabric wiki 中的这个精彩页面。

如果你有任何问题、愿望等,请前往 github 上的源代码并提交 issue。