mc-missile

在Minecraft中用制导导弹炸飞你的朋友。

装备

mc_missile

在 Minecraft 1.21.4 中用制导导弹炸飞你的朋友。

这是一个仅服务端的 Fabric Minecraft 模组。 它允许所有玩家编写制导导弹程序,并从弩或发射器发射它们。 关于此模组能做什么,请参阅 Minecraft 中的制导导弹。

应用结构

这是一个特殊的 Minecraft 模组,通过 gRPC 连接外部进程。

架构总览图

每位玩家编写一个制导服务器应用。 这些制导服务器可以托管在与 Minecraft 服务器同一主机上的 Docker 容器中。 每当发射导弹时,Minecraft 会连接到玩家的制导服务器,并每 tick 发送导弹状态(例如位置、速度)。 制导服务器可以在每次收到导弹状态后向导弹发送控制输入。

开发导弹制导

你可以用任何你喜欢的语言实现制导服务器。 它必须做两件事:

  • 读取 PORT 环境变量。
  • 在该端口上暴露一个 gRPC 服务器,遵循 src/main/proto/guidance.proto 中定义的协议。 这个 guidance.proto 文件包含有关该协议具体细节的更多文档。 Christopher Besch 的 Minecraft 中的制导导弹文章详细描述了制导系统能做什么以及如何实现。

制导服务器模板

目前有以下模板可帮助你立即上手:

其他人的制导代码

有一些开源制导服务器可供你参考:

飞行动力学

与玩家一样,导弹是 Minecraft 中的一个实体。 导弹具有

  • 位置 $p = \begin{pmatrix} p_1 \ p_2 \ p_3 \end{pmatrix} \in \mathbb{R}^3$(其中 $p_2$ 为高度),

  • 速度 $v \in \mathbb{R}^3$,

  • 俯仰角 $\theta \in [-90, 90]$ 和

  • 偏航角 $\psi \in [-180, 180]$。

    这些角度以度为单位,且没有滚转角。 此外,它们是 Minecraft F3 菜单中显示的角度的相反数。 这是因为出于某些原因,弹射物的朝向是翻转的: $\theta=90$ 为向上,$\theta=-90$ 为向下,$\psi \in {-180, 180}$ 为北,$\psi = 90$ 为东,$\psi = 0$ 为南,$\psi = -90$ 为西。

Minecraft 每 tick(每秒 20 次)更新导弹状态。 第 $t \in \mathbb{N}_0$ tick 的更新分为三个阶段:

  1. 接收控制输入: 导弹唯一的输入方式是一个不切实际地强大的控制力矩陀螺仪。 因此玩家的制导代码会生成请求的俯仰角变化量 $\theta_{in}$ 和偏航角变化量 $\psi_{in}$。 它无法直接控制导弹的位置、速度或推力——只能控制旋转。

  2. 更新导弹状态: 陀螺仪很强大,但并非过于强大。 当控制输入过大(大于由弹体定义的 $M_r$)时,会按线性比例缩小:

    \begin{aligned}
    l &= \sqrt{\theta_{in}^2 + \psi_{in}^2} \\
    \begin{pmatrix} \theta_{in} \\ \psi_{in} \end{pmatrix} 
      &\rightarrow \max{\left\{\frac{M_r}{l}, 1\right\}}
       \begin{pmatrix} \theta_{in} \\ \psi_{in} \end{pmatrix}.
    \end{aligned}
    

    随后,Minecraft 会应用调整后的控制输入加上一些随机噪声。

    \begin{aligned}
    \theta &\rightarrow \theta + \theta_{in} + N_r \\
    \psi   &\rightarrow \psi + \psi_{in} + N_r \\
    \end{aligned}
    

    每个 $N_r$ 是取决于导弹所用弹体的正态分布噪声。 因此你对导弹旋转没有完美控制,总会有一些方差。

    现在可以从旋转向量 $r \in \mathbb{R}^3$、当前推力 $T(t) \in [0, \infty)$ 和重力 $g = \begin{pmatrix} 0 \ -|g| \ 0 \end{pmatrix} \in \mathbb{R}^3$ 计算加速度 $a \in \mathbb{R}^3$。

    \begin{aligned}
    r & =
    \begin{pmatrix}
        \sin(\psi) \cos(\theta) \\
        \sin(\theta) \\
        \cos(\psi) \cos(\theta)
    \end{pmatrix} \\
    a & = \begin{pmatrix} a_1 \\ a_2 \\ a_3 \end{pmatrix} \\
      & = \left(T(t) + N_T \right) \cdot r + g
    \end{aligned}
    

    $N_T$ 是正态分布噪声,与推力函数 $T$ 一样由火箭发动机定义。

    最后,使用弹体定义的阻力 $d \in [0, 1)$ 更新速度和位置。

    \begin{aligned}
    v &\rightarrow (1 - d) \cdot (v + a) \\
    p &\rightarrow p + v
    \end{aligned}
    
  3. 现在导弹状态已更新,Minecraft 将该状态发送给玩家的制导代码。 所有这些值也包含一些方差——取决于导弹的惯性测量单元。 制导服务器有略少于 50ms 的时间来发送下一个 tick 的旋转变化量。

在第一个 tick($t=0$)中,导弹还没有制导输入,因此以发射者的速度和旋转直线飞行。 此处不施加任何方差。

免责声明: 如你所见,Minecraft 导弹的飞行动力学与真实导弹毫无关系。 例如,完全没有模拟任何空气动力学方面。 我们所做的一切只是在真空中神奇地旋转一块石头。 因此,本文所解释的制导代码只能应用于 Minecraft 这个玩具世界,别无其他。 不过,这仍然会很有趣!

制作你的第一枚导弹

这是一个仅服务端的模组,因此你无需在 Minecraft 客户端安装任何模组。 因此,此模组不会带来新物品。 所有导弹在发射前都是普通的烟花火箭物品。 有两件特殊的事情将导弹与普通 Minecraft 烟花区分开来:

  • 物品的名称和
  • 用于制作导弹的材料。

导弹命名

在 Minecraft 中,你可以用铁砧更改物品名称。 要将普通烟花火箭转换为导弹,你需要给烟花火箭一个特殊名称。

  <- 要使用的制导服务器 ID
     <- 传递给制导服务器的一些字符串
m/69/test_name

这允许 Minecraft 模组识别应使用哪个制导服务器。 此外,每个制导服务器可以实现多个不同的导弹。

你仍然需要满足下面章节中的材料要求才能制作出可用的导弹。

导弹预算

你的导弹制作时至少需要一个烟花之星。 制作导弹的方法有很多。 mc_missile 模组会计算你用于制作烟花物品的材料。 它为每种材料赋予一个价值并将这些价值相加。 这就是导弹的预算,可用于改善导弹的特性,参见导弹组件章节。

注意: 当你制作烟花火箭时,一个合成配方会产出三个烟花火箭。 如果你在这样的配方中投入一颗钻石,你将获得三个烟花火箭,每个具有钻石价值的 1/3。

示例: 一个简单的烟花之星可以用一份火药和一份染料制作。 由此你可以制作最便宜的导弹: 那个烟花之星、一份火药和一张纸,你将获得三枚预算为 99€ 的导弹。

以下是所有可能材料的价值。

==== 材料价值 ====
  PAPER =                            90€
  GUNPOWDER =                        90€
  DYE =                              27€
  BLAZE_POWDER =                     900€
  COAL =                             180€
  GOLD_NUGGET =                      90€
  HEAD =                             90000€
  FEATHER =                          180€
  DIAMOND =                          9000€
  GLOWSTONE_DUST =                   90€
  最低可能导弹预算 =                  99€
  最高可能导弹预算 =                  231543€
==== 材料价值 ====

导弹组件

导弹由组件构成,每个组件都有价格标签和对导弹的影响。 参见 guidance.proto 了解它们的效果。

以下是组件的价格:

==== 硬件组件成本 ====
  == 弹头成本 ==
    BLANK =                          0€
    TNT_M =                          450€
    TNT_L =                          9000€
    TNT_XL =                         90000€
    INCENDIARY_M =                   900€
    INCENDIARY_L =                   18000€
    INCENDIARY_XL =                  180000€
    NEUTRON_BOMB_S =                 450€
    NEUTRON_BOMB_L =                 900€
    TUNGSTEN_PENETRATOR_S =          180€
    TUNGSTEN_PENETRATOR_M =          450€
    TUNGSTEN_PENETRATOR_L =          900€
    BUNKER_BUSTER_M =                18000€
    BUNKER_BUSTER_L =                27000€
    BUNKER_BUSTER_XL =               180000€
  == 弹头成本 ==
  == 弹体成本 ==
    SPACE_SHUTTLE =                  450000€
    BRICK =  0€
    DEFAULT_AIRFRAME =               180€
    PERFECT_AIRFRAME =               1800€
  == 弹体成本 ==
  == 发动机成本 ==
    NO_MOTOR =                       0€
    SIMPLE_S =                       900€
    SIMPLE_M =                       1800€
    SIMPLE_L =                       2700€
    SIMPLE_XL =                      90000€
    BOOST_S =                        450€
    BOOST_M =                        900€
    TWO_STAGE_M =                    450€
    TWO_STAGE_L =                    900€
    RANDOM_S =                       450€
    RANDOM_L =                       900€
    CHANGING_S =                     450€
    CHANGING_M =                     900€
    CHANGING_L =                     1350€
  == 发动机成本 ==
  == 电池成本 ==
    NO_BATTERY =                     0€
    LI_ION_XS =                      450€
    LI_ION_S =                       900€
    LI_ION_M =                       1350€
    LI_ION_L =                       2700€
    LI_ION_XL =                      5400€
    LI_ION_XXL =                     9000€
    NUCLEAR =                        90000€
  == 电池成本 ==
  == 导引头成本 ==
    NO_SEEKER =                      0€
    IR_SEEKER_WIDE_S =               9000€
    IR_SEEKER_WIDE_L =               18000€
    IR_SEEKER_WIDE_INACCURATE_S =    6000€
    IR_SEEKER_WIDE_INACCURATE_L =    12000€
    IR_SEEKER_SNIPER_S =             6000€
    IR_SEEKER_SNIPER_L =             12000€
    IR_SEEKER_SNIPER_INACCURATE_S =  2000€
    IR_SEEKER_SNIPER_INACCURATE_L =  4000€
    IR_SEEKER_360_S =                12000€
    IR_SEEKER_360_L =                24000€
    IR_SEEKER_360_INACCURATE_S =     6000€
    IR_SEEKER_360_INACCURATE_L =     12000€
    LASER_DISTANCE_SEEKER =          3000€
  == 导引头成本 ==
  == 惯性系统成本 ==
    BLIND =                          0€
    BAD_IMU =                        180€
    DEFAULT_IMU =                    1260€
    ACCURATE_IMU =                   2700€
    PERFECT_IMU =                    9000€
  == 惯性系统成本 ==
  最便宜的可能导弹 =                0€
  最昂贵的可能导弹 =                843000€
==== 硬件组件成本 ====

所有组件的价格总和必须小于或等于导弹的预算。

模组安装

此模组设计用于 Docker 部署。 请查看 example_deployment 及其 docker-compose.yml。

模组开发

开发环境

  • 安装 Docker。
  • 在此目录中使用以下命令创建开发容器:sudo docker run --net host -ti --name mc_missile_java -v ./:/home/gradle/mc_missile -p 25565:25565 --entrypoint /bin/bash gradle
  • 离开该 shell 后,使用以下命令再次启动容器:sudo docker start mc_missile_java
  • 现在你可以使用以下命令进入它:sudo docker exec -ti mc_missile_java /bin/bash

反编译 Minecraft

  • 在 Docker 容器内的 mc_missile 目录中运行以下命令。
  • ./gradlew genSources
  • jar xf ../.gradle/loom-cache/minecraftMaven/net/minecraft/minecraft-merged-abba00472f/1.21.4-net.fabricmc.yarn.1_21_4.1.21.4+build.8-v2/minecraft-merged-abba00472f-1.21.4-net.fabricmc.yarn.1_21_4.1.21.4+build.8-v2-sources.jar com /net
  • jar xf ../.gradle/loom-cache/minecraftMaven/net/minecraft/minecraft-merged-abba00472f/1.21.4-net.fabricmc.yarn.1_21_4.1.21.4+build.8-v2/minecraft-merged-abba00472f-1.21.4-net.fabricmc.yarn.1_21_4.1.21.4+build.8-v2.jar assets/ data /

Gradle

  • 在 Docker 容器内的 mc_missile 目录中运行以下命令。
  • ./gradlew validateAccessWidener
  • cp ./env.sh.example ./env.sh 并输入你想要的配置
  • ./gradlew runServer

部署

  • cp ./env.sh.example ./env.sh 并输入你的 modrinth token(只需执行一次)
  • source ./env.sh
  • ./gradlew modrinth
  • 你还可以在 ./build/libs/mc_missile-1.0.0.jar 中找到最终 jar

格式化

  • 下载 google-java-format
  • 运行 find ./src -name '*.java' -type f -print0 | xargs -0 java -jar ~/dwn/google-java-format-1.26.0-all-deps.jar --aosp -r