这一讲我们将达成两个目标：

• 制造一个作为用电器的机器方块，且当实体生物站在该方块上时耗费能量为实体回血。
• 使电池在右键方块时可以将自己的能量转移到特定方块，按住 Shift 右键则反过来。

添加方块

我们先编写一个最最基础的方块类，并为其指定材料、硬度、和爆炸抗性，同时为对应的物品指定创造模式物品栏：

@Mod.EventBusSubscriber(bus = Mod.EventBusSubscriber.Bus.MOD)
public class FEDemoMachineBlock extends Block  
{
    public static final String NAME = "fedemo:machine"

虽然夹杂着众多争议，但 Forge 最终仍然决定在 1.10.2 加入官方的能量系统，并一直将其延续到现在。该系统参考了 CoFH 团队的众多设计，因此和在此前已经拥有鼎鼎大名的 Redstone Flux 能量系统有着众多的相似之处。

在本系列教程中，各位读者将走入 Forge 能量系统所带来的奇妙世界。由于本文将使用 Minecraft 1.14.4 和 Forge 28.2.4 进行讲解，因此如果读者想要顺畅阅读本教程，

本文作者 zzzz，使用 CC-BY-ND 4.0 协议授权，亦即：

• [👍] 你可以在署名本人的同时使用任何形式转载分发本文章。
• [👎] 你不能在转载分发本文章的同时修改本文章。
• [👍] 你可以在商业目的下使用本文章。

1 引言

这篇文章算是“教程的教程”。本人也算是写过几年教程的人了，因此在写教程这一块也积累了一些东西，现在拿出来分享给大家。本人并不是什么名师大家，也没有读过什么教育学的书籍，因此一定程度的闭门造车在所难免，不过本人还是希望能够通过这篇文章，给所有想要写或者已经在写教程，尤其是系列性技术类教程的人一些帮助。

2 为什么要有教程

对于一篇特定的教程而言，它可不可以没有呢？当然可以。难道说教程的作者在编写该教程之前，人们就没有办法学到相应的知识了吗？但是，

权限上下文系统（英文名称 Permission Context），是一个在服务端插件开发的部分领域，有着不可或缺的重要作用的系统，但一直以来未得到广大开发者甚至服务端维护者的重视。不过，权限上下文系统已经在很多地方得到了支持。

• Sponge API 的权限系统自带权限上下文系统的支持。
• LuckPerms API 自带权限上下文系统的支持，并支持你听说过的几乎所有插件服务端。

一方面，考虑到本人只会写 Sponge 插件，因此后续内容将基于 Sponge API。另一方面，考虑到今年已经是 9102 年的第二年，不太可能还有人不在自己的服务端中添加并使用 LuckPerms，因此，本文内容主要使用 LuckPerms

Coroutine（协程）是编程语言的一种机制，该机制允许开发者编写出和过程式写法相同的代码，并在编译时得到一系列相互调用的子过程，从而使不同的子过程可以在不同的场合执行。

Coroutine 的最常见用途是编写异步代码，而 Minecraft 中恰恰存在大量需要使用异步代码的场合：比方说我们有时需要将某段代码延迟到一个或多个 tick 后执行，有时需要将某段代码延迟到下一次事件触发时执行，等等。

目前很多主流的编程语言都提供了相对官方的 Coroutine 支持，如 C#、Python、JavaScript，等等。虽然 Java 官方至今仍然没有支持 Coroutine，但 JVM 上流行的两大编程语言 Scala