Differences

This shows you the differences between two versions of the page.

--- zh_cn:tutorial:terms [2019/12/18 10:30] – [Mod ID] lightcolour
+++ zh_cn:tutorial:terms [2024/08/25 12:10] (current) – solidblock
@@ Line 1: / Line 1: @@
-====== 惯用词和术语 ======
+====== 基本约定和术语 ======
-在开始用fabric写mod之前，重要的是要了解以后的教程页面中使用的一些关键术语和短语。 了解诸如包结构和modid命名之类的基本约定也很好。 尽早了解这些内容将有助于您更好地理解教程，并在需要时提出更好的问题。
+开始用 Fabric 写模组前，应当先了解以后的教程页面中使用的一些关键术语和短语，这很重要。最好也了解诸如包结构和 modid 命名之类的基本约定。尽早了解这些内容将有助于你更好地理解教程，并使你在需要时能提出更好的问题。
-==== Mod ID ====
+===== 模组 ID =====
-在整个文档中，我们通常会引用Mod ID或代码中的modid。 Mod ID代表''Mod Identifier''，它是一个字符串，应该唯一地标识您的mod。 Mod ID通常与同名的标识符名称空间相关联，因此遵循相同的限制。 Mod ID只能由小写字母''a-z'，数字“ 0-9”和符号''_-''组成。 例如，Minecraft使用''minecraft''命名空间。 此外，模块ID必须至少包含两个字符。
-mod ID通常是mod名称的紧凑版本，使其简短但可识别并防止命名冲突。 按照惯例，名为''My Project--''的项目可以称为'' myproject''，''my_project''，或者在某些情况下也可以使用''my-project''，但是modid中的破折号可能会有些痛苦 有时要处理[需要引用]。 此mod将使用此mod ID作为注册表名称空间来注册项目和阻止.
+在整个 wiki 中，我们经常会提到模组 ID 或代码中的 modid。 模组 ID 代表模组的标识符（Mod Identifier），是一个字符串，应该唯一地标识你的模组。模组 ID 通常与同名的标识符命名空间相关联，因此遵循与之相同的限制。模组 ID 只能由小写字母 ''a-z''，数字 ''0-9'' 和符号 ''_-'' 组成。例如，Minecraft 使用 ''minecraft'' 命名空间。此外，Mod ID 必须至少包含两个字符。
-一些入门教程将使用占位符mod ID并在占位符命名空间下注册 物品 和 方块，您可以将其视为入门模板-尽管保持不变对测试来说并不危险，请记住要进行更改 发布您的项目。
+模组 ID 通常是模组名称的紧凑版本，使其简短但可识别并防止命名冲突。按照惯例，名为 “My Project” 的项目可以称为 ''myproject''、''my_project'' 或者 ''my-project''。注册物品和方块（或其他任何东西）时，应该使用此模组 ID 作为 ID 的命名空间。
-==== 标签====
+一些入门教程将使用占位符模组 ID 并在占位符命名空间下注册物品和方块，你可以将其视为入门模板。Fabric Wiki 统一使用 ''tutorial'' 作为命名空间。尽管保持使用占位符对测试影响不大，但请记住发布项目之前要更改它。
-Draft. Edit it.（草案）
+===== 标签 =====
-Convention namespace for tags is ''c''.
+**标签**是方块、物品、流体等的组。例如，方块标签 ''minecraft:saplings'' 包含游戏里面的所有树苗。在 Minecraft 中，所有有注册表的东西的类型都有标签。
-==== Maven组和软件包名称 ====
+Minecraft 使用标签决定许多东西，例如，有标签 ''minecraft:mineable/pickaxe'' 的方块可以被镐快速挖掘。Fabric API 也提供了一些常规标签。关于标签的更多信息，请见 [[tags|tags]] 和 [[https://zh.minecraft.wiki/标签|Minecraft Wiki 的“标签”页面]].
-根据Oracle的Java文档，它们以小写形式编写，以避免与类或接口的名称冲突。 域名的反字用来启动名称(比如 aaa.com 反过来 com.aaa 就是包名)。 阅读更多[[https://docs.oracle.com/javase/tutorial/java/package/namingpkgs.html]].
+==== 入口点和初始化器 ====
+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。
+<code java>
+{
+  [...]
+  "entrypoints": {
+    "main": [
+      "net.fabricmc.ExampleMod"
+    ],
+    "client": [
+      "net.fabricmc.ExampleClientMod"
+    ]
+  }
+  [...]
+}
+</code>
+为了实现 ''ModInitializer''、''ClientModInitializer'' 或 ''DedicatedServerModInitializer''，你必须实现 ''onInitialize()''（或者对于 Client 是 ''onInitializeClient()''，对于 Server 是 ''onInitializeServer()''）函数，然后在里面写上你的代码。
+入口点的更多信息，请看 [[zh_cn:documentation:entrypoint]]。
+==== Maven Group 和 Package 的名称 ====
+根据 Oracle 的 Java 文档，它们以小写形式编写，以避免与类或接口的名称冲突。这些名称使用域名反写作为前缀。前往这个链接阅读更多：[[https://docs.oracle.com/javase/tutorial/java/package/namingpkgs.html]]。