基本约定和术语

开始用 Fabric 写模组前，应当先了解以后的教程页面中使用的一些关键术语和短语，这很重要。最好也了解诸如包结构和 modid 命名之类的基本约定。尽早了解这些内容将有助于你更好地理解教程，并使你在需要时能提出更好的问题。

在整个 wiki 中，我们经常会提到模组 ID 或代码中的 modid。 模组 ID 代表模组的标识符（Mod Identifier），是一个字符串，应该唯一地标识你的模组。模组 ID 通常与同名的标识符命名空间相关联，因此遵循与之相同的限制。模组 ID 只能由小写字母 a-z，数字 0-9 和符号 _- 组成。例如，Minecraft 使用 minecraft 命名空间。此外，Mod ID 必须至少包含两个字符。

模组 ID 通常是模组名称的紧凑版本，使其简短但可识别并防止命名冲突。按照惯例，名为 “My Project” 的项目可以称为 myproject、my_project 或者 my-project。注册物品和方块（或其他任何东西）时，应该使用此模组 ID 作为 ID 的命名空间。

一些入门教程将使用占位符模组 ID 并在占位符命名空间下注册物品和方块，你可以将其视为入门模板。Fabric Wiki 统一使用 tutorial 作为命名空间。尽管保持使用占位符对测试影响不大，但请记住发布项目之前要更改它。

标签是方块、物品、流体等的组。例如，方块标签 minecraft:saplings 包含游戏里面的所有树苗。在 Minecraft 中，所有有注册表的东西的类型都有标签。

Minecraft 使用标签决定许多东西，例如，有标签 minecraft:mineable/pickaxe 的方块可以被镐快速挖掘。Fabric API 也提供了一些常规标签。关于标签的更多信息，请见 tags 和 Minecraft Wiki 的“标签”页面.

Fabric Loader 使用 fabric.mod.json 来检测和加载你的模组。一个模组通常包含至少一个初始化器类，这个类应该实现了 ModInitializer、ClientModInitializer 和 DedicatedServerModInitializer 这三个接口中的一个。这三个接口都在 net.fabricmc.api 包内。在 Fabric Wiki 教程中，我们通常使用 ExampleMod 作为模组初始化器，就像 Fabric Example Mod 做的那样。

如果要修改或者添加初始化器，需要找到 fabric.mod.json 里的 entrypoints 字段，然后跟据实际情况修改。main 块用于 Mod Initializers，client 块用于 Client Mod Initializers，而 server 块用于 Server Mod Initializers。

{
  [...]
  "entrypoints": {
    "main": [
      "net.fabricmc.ExampleMod"
    ],
    "client": [
      "net.fabricmc.ExampleClientMod"
    ]
  }
  [...]
}

为了实现 ModInitializer、ClientModInitializer 或 DedicatedServerModInitializer，你必须实现 onInitialize()（或者对于 Client 是 onInitializeClient()，对于 Server 是 onInitializeServer()）函数，然后在里面写上你的代码。

入口点的更多信息，请看 entrypoint。

根据 Oracle 的 Java 文档，它们以小写形式编写，以避免与类或接口的名称冲突。这些名称使用域名反写作为前缀。前往这个链接阅读更多：https://docs.oracle.com/javase/tutorial/java/package/namingpkgs.html。