Fabric | The home of the Fabric mod development toolchain.
Fabric | The home of the Fabric mod development toolchain.
Fabric
Download
Blog
Develop
Discuss
Wiki
Fabric Loader
Fabric is a modular, lightweight mod loader for Minecraft
Download
Play
The Fabric Loader download above is the bare minimum. Combine it with Fabric API to get all the important extra APIs mods use. It has to be put into the mods folder like any other mod.
Download Fabric API
Develop
Fabric gives you powerful tools to change the game however you like. Use the online template generator to get started creating a mod. You can also use the example mod repository or CLI tools.
Develop a mod
Explore
Extensive documentation is available in the Fabric wiki for both developers and players. Get additional help from the Fabric Discord server, or ask a question on the GitHub Discussion forums.
Visit the wiki
Core Toolchain Projects
Fabric Loader A flexible platform-independent mod loader designed for Minecraft and other games and applications.
Yarn Yarn is a set of open Minecraft mappings, free for everyone to use under the Creative Commons Zero license.
Fabric Loom A Gradle plugin enabling developers to easily develop and debug mods.
Fabric Language Kotlin This is a mod that enables usage of the Kotlin programming language for Fabric mods.
Intermediary Intermediary contains match information between different versions of Minecraft, enabling cross version mods.
Tiny Remapper A tiny, efficient tool for remapping JAR files.
Mapping IO A library for reading, manipulating and writing mapping files, with support a wide range fo formats.
Latest Blog Posts
Fabric for Minecraft 1.20.3 & 1.20.4
It’s only been two months since we published the last article on Minecraft updates, but here we are. Minecraft 1.20.3 is to be released in the near future with some changes affecting mod makers.
As usual, we ask players to be patient, and give mod developers time to update to this new version. Given the r...
Continue reading
Fabric for Minecraft 1.20.2
Minecraft 1.20.2 will be released in the near future, again with some changes that impact many mods.
As usual, we ask players to be patient, and give mod developers time to update to this new version.
Here is a list of all major modder-facing changes in this version. Note that all code references are usi...
Continue reading
The contents of this website, unless otherwise indicated, are licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License.
NOT AN OFFICIAL MINECRAFT PRODUCT. NOT APPROVED BY OR ASSOCIATED WITH MOJANG.
Installation for Minecraft Launcher | Fabric
Installation for Minecraft Launcher | Fabric
Fabric
Download
Blog
Develop
Discuss
Wiki
Installation for Minecraft Launcher
You need Javascript to show the download options
Make sure to follow the
installation instructions!
Most mods will also require you to install
Fabric API
into the mods folder.
Other installation options:
Minecraft Launcher
Minecraft Server
MultiMC
CurseForge
GDLauncher
ATLauncher
(Modpack Dev)
MCUpdater
(Modpack Dev)
Technic
(Modpack Dev)
portablemc
(Command Line)
Metadata API
(Launcher Dev)
The contents of this website, unless otherwise indicated, are licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License.
NOT AN OFFICIAL MINECRAFT PRODUCT. NOT APPROVED BY OR ASSOCIATED WITH MOJANG.
欢迎来到 Fabric Wiki！ [Fabric Wiki]
欢迎来到 Fabric Wiki！ [Fabric Wiki]
skip to content
Fabric Wiki
User Tools
RegisterLog In
Site Tools
Search
ToolsShow pagesourceOld revisionsBacklinksRecent ChangesMedia ManagerSitemapRegisterLog In>
Recent ChangesMedia ManagerSitemap
Trace: • 欢迎来到 Fabric Wiki！
zh_cn:start
Table of Contents
欢迎来到 Fabric Wiki！
玩家教程
模组开发者教程
安装
基础
物品
方块和方块实体
数据生成
世界生成
命令
事件
实体
流体
Mixin 和 ASM
杂项
Yarn
贡献 Fabric
文档
示例
贡献 wiki
欢迎来到 Fabric Wiki！
Fabric 是针对 Minecraft 1.14 及更高版本（含快照）的模块化模组制作工具链。
wiki 中的一些页面可能过时了或者还在撰写中。
该 wiki 还提供以下语言版本 :
English（英文）
Français（法语）
Deutsch（德语）
한국어（韩语）
Русский（俄语）
日本語（日语）
Español
同时如果要为中文 wiki 做贡献的话，请一定要看看中文 Fabric Wiki 翻译标准。
请一定要看看社区空间和规则！
常见问题（用户）
常见问题（专家） - 对前者细节的补充
玩家教程
如果你是玩家、服务器管理员或整合包作者，你应该查看 wiki 的玩家教程部分。
安装 Fabric Loader
更新 Fabric Loader
安装 Java
故障排除
模组开发者教程
如果你想开始使用 Fabric 开始开发，请访问此 wiki 的 模组开发者教程部分。
安装
开始（建立开发环境）
使用 Minotaur 在 Modrinth 上发布模组
使用 CurseGradle 发布模组
使用 MC-Publish 将模组发布到 Curseforge、Modrinth 和 Github
基础
Minecraft 模组开发基础
使用 Fabric 开发模组的介绍
阅读 Minecraft 代码
约定和术语
基本的约定和术语
服务器和客户端术语
注册
注册表介绍
标准注册表
开发工具
第三方模组库
应用更改而无需重新启动 Minecraft
创建语言文件
使用映射
物品
物品文档
演练：添加物品
为你的物品添加物品组
为你的物品添加物品提示
添加合成配方
添加盔甲
添加工具
添加盾牌
添加自定义附魔
添加模型谓词提供器
方块和方块实体
添加方块
赋予方块状态
制作带朝向的方块
让方块可含水
添加方块实体
让方块可以储存物品
动态更改方块或物品的颜色
操纵方块的外观
动态渲染方块与物品
使用自定义模型动态渲染方块和物品
使用方块实体渲染器动态渲染方块和物品
创建一个容器方块
使用扩展的 ScreenHandler 同步数据
使用 PropertyDelegate 同步整型数据
添加自定义的作物
数据生成
这些页面会带你了解 Fabric Data Generation API，可以通过数据生成器产生 JSON 文件。
开始了解数据生成
进度生成
战利品表生成
模型生成
标签生成
配方生成
语言文件生成
世界生成
维度概念
生成自定义矿石
添加地物
添加树木（高级）
添加结构地物（第三方教程）
添加生物群系（原版教程）
添加生物群系（旧版本）
自定义区块生成器（草稿）
添加世界预设
添加维度（原版教程）
创建自定义传送门
命令
创建命令
命令异常
命令建议
命令重定向
命令参数类型
命令示例
事件
这些页面会带你了解 Fabric API 中包含的很多事件，以及如果创建自己的事件以供其他模组使用。
监听事件
创建自定义的事件
将物品添加到已存在的战利品表
事件索引（草稿）
实体
添加实体
添加自定义刷怪蛋
创建自定义弹射物
流体
创建一种流体
Mixin 和 ASM
本页会带你了解如何使用 SpongePowered 的 Mixin 库，这是非常复杂的话题，建议您从头到尾阅读这些页面。
介绍
Mixin 注册
注入
访问器和调用器
重定向器
方法重定向器
小提示
示例
热交换 Mixin
导出 Mixin 类
访问加宽器
反射
接口注入
杂项
配方类型介绍
添加配方类型（草稿）
添加烹饪配方类型
添加切制配方类型
挖掘等级
全局世界数据
持久状态
主要成分
视线投射
自定义按键绑定
网络通信
药水效果
添加粒子
播放声音
自定义游戏规则
自定义数据/资源包资源
标签约定
一些有用的教程
添加玩家统计
开发模组的小技巧
DataFixer
流体、物品和能量转移
创建屏幕
Yarn
更新 Java 代码库中的 Yarn 映射
将 Yarn 升级到新的 Minecraft 版本 - 仅供 Yarn 开发者，普通用户和模组开发者请不要阅读此文！
贡献 Fabric
Fabric 接受新功能的过程 - 或者说如何让 Fabric 接受（或拒绝）你的新功能
FabLabs - 在提交 PR 之前起草新功能的试验场
GitHub 上的 Fabric
Yarn 命名映射的代码库 + 贡献相关文档
旧的教程请在这里查找存档的页面。
文档
如果你想知道 Fabric 工具链中的项目作用的方式，请访问 wiki 的 文档 部分。
fabric.mod.json 的规定
入口点
Mixin 库的 Wiki（英文）
Fabric 中的渲染（草稿）
构建 Fabric 的流水线（草稿）
Fabric Loader
Fabric Loom
示例
模组开发环境模板
Fabric API 测试模组（已过期） - 虽然不是教程，但应该还是能给你提供帮助
贡献 wiki
此 wiki 主要是由社区维护、面向社区的。如果你有兴趣为 wiki 作出贡献，请先检查以下页面：
Wiki Meta - wiki 贡献的起点
Wiki 议题 - 查看当前的议题，以及其他贡献者现在在做什么
中文翻译标准 - 将英文内容翻译成中文时，建议遵循的标准
zh_cn/start.txt · Last modified: 2024/01/02 10:40 by 39.173.107.171
Page Tools
Show pagesourceOld revisionsBacklinksBack to top
Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Noncommercial-Share Alike 4.0 International
use | Fabric
use | Fabric
Fabric
Download
Blog
Develop
Discuss
Wiki
use
The contents of this website, unless otherwise indicated, are licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License.
NOT AN OFFICIAL MINECRAFT PRODUCT. NOT APPROVED BY OR ASSOCIATED WITH MOJANG.
安装 Fabric [Fabric Wiki]
安装 Fabric [Fabric Wiki]
skip to content
Fabric Wiki
User Tools
RegisterLog In
Site Tools
Search
ToolsShow pagesourceOld revisionsBacklinksRecent ChangesMedia ManagerSitemapRegisterLog In>
Recent ChangesMedia ManagerSitemap
Trace: • 安装 Fabric
zh_cn:install
Table of Contents
安装 Fabric
常规安装
通过 PCL2、HMCL 和 BakaXL 启动器
通过 MultiMC 启动器
通过官方启动器 (Minecraft Launcher)
安装服务端（快速）
安装服务端（手动）
命令行安装
可用命令行参数
可用命令
安装 Fabric
常规安装
译者注：由于网络原因，推荐中国大陆地区玩家使用 PCL2、HMCL 和 BakaXL 三种启动器之一，以加速游戏下载和启动。
通过 PCL2、HMCL 和 BakaXL 启动器
PCL2 (Plain Craft Launcher 2)
译者注：在中国大陆，PCL2 启动器下载速度最快。
注：官方正式版下载链接：爱发电。
点击页面顶部的“下载”按钮；
选择 Minecraft 版本；
在“安装预览”对话框中，单击“Fabric”项，在下拉框中选择 Fabric 版本（推荐最新稳定版）；
单击“Fabric API”项，在下拉框中选择 Fabric API 版本；
点击右上角“开始安装”按钮。
可能会出现“版本隔离提示”。
如您只打算安装一个 Minecraft 版本，则可单击“继续”按钮；
否则，您应单击“取消下载”按钮，前往页面顶部“设置”，在“启动选项”组中配置“版本隔离”选项。如您不确定，则可选择“隔离所有版本”。随后回到“下载”页面，单击“开始安装”按钮。
下载应当随后开始。可点击右下角“下载”图标查看进度。
下载成功后，点击页面顶部“启动”按钮，配置账户信息：
如您有 Minecraft 正版账户，则可单击“微软”选项，并按指引添加您的微软账户；
否则，单击“离线”选项，任意输入您的游戏用户名（注意不要为空且勿包含特殊字符）。
单击窗口底部的“启动游戏”按钮即可。
HMCL (Hello Minecraft! Launcher)
注：官方下载链接：HMCL 官网。
（教程待补充）
BakaXL
注：官方下载链接：BakaXL 官网。
（教程待补充）
通过 MultiMC 启动器
注：MultiMC 是 Minecraft 的一种模组友好型启动器，建议配合 Fabric 使用，可以在此处下载。
创建一个新的游戏实例；
右键实例或在窗口右侧，点击“编辑实例”。
在“配置”窗口的“版本”选项卡上，单击“安装 Fabric”，在对话框中选择一个 Fabric 加载器版本，然后单击“确定”将其添加到实例中。
通常建议使用最新的可用加载器版本。
如果加载器与游戏版本冲突，启动器将提示您，因此请随意选择加载器版本！
点击确定。您的 Fabric 实例已准备就绪，可随时添加模组！
有关更详细的说明，请访问以下指南：
对于 Windows：使用 MultiMC（Windows）安装 Fabric；
对于 macOS：使用 MultiMC（macOS）安装 Fabric。
通过官方启动器 (Minecraft Launcher)
译者注：在中国大陆，由于缓慢的下载速度，不建议使用官方启动器。
从下载页面下载 Fabric 安装程序。
打开安装程序。在窗口中，您需要配置映射和加载程序版本（根据 MultiMC section 的建议）和安装位置（默认位置应在大多数平台上工作）。
注意：您需要启用快照功能，以使 Fabric 安装程序显示 Minecraft 快照的映射选项。
点击安装。将在启动器的菜单中创建一个新的游戏版本和配置文件，您现在可以使用它来启动 Fabric。
有关更详细的说明，请访问本指南：使用 Minecraft 启动器（Windows）安装 Fabric。
安装服务端（快速）
新版服务端安装使用单个 JAR 文件作为启动器。该启动器首先下载任何缺少的 Fabric 加载器或 Minecraft 文件，然后继续运行游戏服务端。没有安装界面，并且在首页上选择的所需版本已经附带在此 JAR 文件中。
访问服务端下载页并选择所需的版本，然后使用可执行服务器（.jar）按钮生成并下载 Fabric 服务端启动器 JAR 文件；
将 Fabric 服务端启动器 JAR 文件放入任意目录，位于本地或远程服务器上；
使用 java -Xmx2G -jar
使用 Minecraft 特定的服务器主机，管理面板或启动脚本，Fabric 启动器 JAR 文件可以替换原版服务端 JAR。它们可以以相同的方式调用，并且二者行为类似。
安装服务端（手动）
注意：Minecraft 1.17 需要 Java 16，Minecraft 1.18 需要 Java 17。大多数下载中都不包含 Java。您可以使用 java -version 命令检查您的 Java 版本。您可从第三方获得 Java 17，例如 Adoptium 或 Azul Zulu。
注意：最新 Fabric 加载器为 0.4.4 以上。 旧版本使用不同的技术。安装程序需要 0.4.0 以上！
从 Minecraft 服务端下载页下载按钮下的手动安装链接下载 Fabric 安装程序，或从 针对官方启动器的 Fabric 下载页下载，就像安装客户端一样。
打开安装程序。在窗口顶部点击“Server”选项卡。
在窗口中配置映射、加载器版本以及安装位置。
注意：您需要启用快照功能，以使 Fabric 安装程序显示 Minecraft 快照的映射选项。
点击“Install”。在输出目录中，将创建 fabric-server-launch.jar。它依赖原版服务端 JAR 文件 server.jar，通常在 Mojang 的版本公告博客文章中找到。安装程序将在首次启动时生成属性文件，您可以在其中更改路径。
注意：如果您正在升级现有服务端，如果安装程序没有为您删除，请记得删除 .fabric 文件夹，否则您将遇到类加载（classloading）错误。
上传到远程主机时，确保上传 fabric-server-launcher.jar、server.properties、server.jar 文件和 libraries 文件夹及其所有内容。
有关更详细的说明，请访问：
对于 Windows：安装 Fabric 服务端
对于 Linux：无 GUI 安装 Fabric 服务端
命令行安装
Fabric 安装程序支持通过命令行安装客户端和服务端。这可以用来自动化安装。安装程序提供许多可用于静默安装的命令。
可用命令行参数
-snapshot 允许使用 Minecraft 快照版本。
-dir 用于选择安装目录。默认为当前工作目录。
-mcversion 用于选择 Minecraft 版本。默认为最新稳定版。
-loader 用于选择加载器版本，默认为最新版本。
-downloadMinecraft 用于自动下载 Minecraft 服务端 JAR。
-noprofile 跳过创建客户端配置文件。
-mavenurl （高级）安装时使用自定义 Maven URL。
-metaurl （高级）使用自定义 meta server URL。
可用命令
help 输出所有可用的命令以及最新的映射和加载程序版本。该命令忽略参数。例如：java -jar fabric-installer.jar help
server 用于为 Fabric 服务端创建所需的文件。接受所有参数，且所有参数可选。例如：java -jar fabric-installer.jar server
client 用于为 Fabric 客户端创建所需的文件。接受所有参数，-dir 参数必须提供。例如：java -jar fabric-installer.jar client -dir "~/Games/.minecraft"
zh_cn/install.txt · Last modified: 2023/01/26 07:36 by jeffreyg1228
Page Tools
Show pagesourceOld revisionsBacklinksBack to top
Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Noncommercial-Share Alike 4.0 International
Develop | Fabric
Develop | Fabric
Fabric
Download
Blog
Develop
Discuss
Wiki
Develop
This page contains a range of resources to help you create a new mod or maintain an existing mod.
Getting started
If you would like to create a new mod please see the wiki.
Use the online template mod generator.
An up-to date template mod can be found on github.
Install the Fabric command line tools.
If you need some extra help we have a number of mod development channels on our Discord.
Latest Versions
You need Javascript to show the latest Versions
Online documentation
You need Javascript to show the documentation links
The contents of this website, unless otherwise indicated, are licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License.
NOT AN OFFICIAL MINECRAFT PRODUCT. NOT APPROVED BY OR ASSOCIATED WITH MOJANG.
入门 — hyperledger-fabricdocs master 文档
入门 — hyperledger-fabricdocs master 文档
hyperledger-fabricdocs
latest
我们是谁
介绍
Hyperledger Fabric v2.0 更新说明
发行说明
关键概念
入门
准备阶段
使用Fabric的测试网络
Hyperledger Fabric 智能合约（链码） API
Hyperledge Fabric 应用程序 SDK
Hyperledger Fabric CA
开发应用
教程
部署一个生产网络
操作指南
升级到最新版本
命令参考
架构参考
常见问题
欢迎贡献！
术语表
版本发布
仍有问题？
状态
hyperledger-fabricdocs
入门
Edit on GitHub
入门¶
在我们开始之前，如果您还没有这样做，您可能希望检查您是否已经在将要开发区块链应用程序或运行 Hyperledger Fabric 的平台上安装了所有 准备阶段 。
安装必备组件后，即可下载并安装 HyperLedger Fabric。在我们为Fabric 二进制文件开发真正的安装程序的同时，我们提供了一个脚本，可以将
在你下载完 Fabric 示例以及 Docker 镜像到你本机之后，您就可以跟着 使用Fabric的测试网络 教程开始使用 Fabric 了。
Hyperledger Fabric 智能合约（链码） API¶
Hyperledger Fabric 提供了不同编程语言的 API 来支持开发智能合约（链码）。智能合约 API 可以使用 Go、Node.js 和 Java：
Go 合约 API 。
Node.js 合约 API and Node.js 合约 API 文档 。
Java 合约 API and Java 合约 API 文档 。
Hyperledge Fabric 应用程序 SDK¶
Hyperledger Fabric 提供了许多 SDK 来支持各种编程语言开发应用程序。SDK 有支持 Node.js 和 Java 语言的：
Node.js SDK and Node.js SDK 文档 。
Java SDK and Java SDK 文档 。
此外，还有两个尚未正式发布的 SDK（Python 和 Go），但它们仍可供下载和测试：
Python SDK.
Go SDK.
目前，Node.js、Java 和 Go 支持 Hyperledge Fabric 1.4 提供的新的应用程序编程模型。
Hyperledger Fabric CA¶
Hyperledger Fabric 提供一个可选的 证书授权服务 ，您可以选择使用该服务生成证书和密钥材料，以配置和管理区块链网络中的身份。然而，任何可以生成 ECDSA 证书的 CA 都是可以使用的。
Next
Previous
© Copyright Hyperledger 2020.
This work is licensed under a Creative Commons Attribution 4.0 International License
Revision b9b6b2b6.
Built with Sphinx using a theme provided by Read the Docs.
Read the Docs
v: latest
Versions
latest
release-2.5
fabric-ca-release1.4
Downloads
html
On Read the Docs
Project Home
Builds
Just a moment...
a moment...Enable JavaScript and cookies to contiFabric 编写的介绍 [Fabric Wiki]
Fabric 编写的介绍 [Fabric Wiki]
skip to content
Fabric Wiki
User Tools
RegisterLog In
Site Tools
Search
ToolsShow pagesourceOld revisionsBacklinksRecent ChangesMedia ManagerSitemapRegisterLog In>
Recent ChangesMedia ManagerSitemap
Trace: • Fabric 编写的介绍
Sidebar
← 返回首页
Fabric 教程
关于教程的信息
安装
开始（建立开发环境）
启用 log4j 调试信息（英文）
使用 Minotaur 在 Modrinth 上发布模组
使用 CurseGradle 发布模组
使用 MC-Publish 将模组发布到 CurseForge、Modrinth 和 GitHub
基础
Minecraft 模组编写基础
使用 Fabric 开发模组的介绍
阅读 Minecraft 代码
约定和术语
基本的约定和术语
服务器和客户端术语
注册
注册表介绍
标准注册表
开发工具
第三方模组库
应用更改而无需重新启动 Minecraft
创建语言文件
使用映射
物品
添加物品
为你的物品创建物品组
为你的物品添加物品提示
添加合成配方
添加盔甲
添加工具
添加盾牌
添加自定义附魔
添加模型谓词提供器
方块和方块实体
添加方块
赋予方块状态
制作带朝向的方块
让方块可含水
添加方块实体
让方块可以储存物品
动态更改方块或物品的颜色
操纵方块的外观
动态渲染方块与物品
使用自定义模型动态渲染方块和物品
使用方块实体渲染器动态渲染方块和物品
创建容器方块
使用扩展的 ScreenHandler 同步自定义数据
使用 PropertyDelegate 同步整型数据
添加自定义的作物
数据生成
开始了解数据生成
进度生成
战利品表生成
模型生成
标签生成
配方生成
语言文件生成
世界生成
维度概念
生成自定义矿石
添加地物
添加树木（高级）
添加结构地物（第三方教程）
添加生物群系（原版教程）
添加生物群系（旧版本）
自定义区块生成器（草稿）
添加世界预设
添加维度（原版教程）
创建自定义传送门
命令
创建命令
命令异常
命令建议
命令重定向
命令参数类型
命令示例
事件
监听事件
创建自定义的事件
将物品添加到已存在的战利品表
事件索引（草稿）
实体
添加实体
添加自定义刷怪蛋
创建自定义弹射物
流体
创建一种流体
Mixin 和 ASM
介绍
Mixin 注册
注入
访问器和调用器
重定向器
方法重定向器
小提示
示例
热交换 Mixin
导出 Mixin 类
访问加宽器
反射
接口注入
杂项
配方类型介绍
添加配方类型（草稿）
添加烹饪配方类型
添加切制配方类型
挖掘等级
全局世界数据
持久状态
主要成分
视线投射
自定义按键绑定
网络通信
药水效果
添加粒子
播放声音
自定义游戏规则
自定义数据/资源包资源
标签约定
一些有用的教程
添加玩家统计
开发模组的小技巧
DataFixer
流体、物品和能量转移
创建屏幕
Yarn
更新 Java 代码库中的 Yarn 映射
将 Yarn 升级到新的 Minecraft 版本
贡献 Fabric
Fabric 接受新功能的过程 - 或者说如何让 Fabric 接受（或拒绝）你的新功能
FabLabs - 在提交 PR 之前起草新功能的试验场
GitHub 上的 Fabric
Yarn 命名映射的代码库 + 贡献相关文档
zh_cn:tutorial:introduction
Table of Contents
Fabric 编写的介绍
Minecraft 自带 API
Fabric API
第三方 API
Mixin
添加接口
回调注入
重定向注入
覆写
Fabric 编写的介绍
这是对制作 Fabric 模组时可以使用的一些常用技术的快速介绍。
要为 Minecraft 制作模组，通常必须以非标准的方式与 Minecraft 的代码进行交互。
尽管 Minecraft 变得越来越灵活，可以适应变化，但它并不是天生就可以进行修改的。
与其他改装 API 不同，Fabric Loader 不会覆盖 Minecraft 的类文件以添加更多功能。
而是使用Mixin 库注入代码。
但是，大多数时候您不会直接使用此库。
Mixins 可能很脆弱，有时会引起冲突。
因此，Fabric API 已经为您实现了一些常用功能。
如果核心 Fabric API 中不存在它，那么通常它将存在于第三方库中。
在几乎每种情况下，与自己实现 mixin 相比，最好使用 Fabric API 或第三方库。
但是有时候，您不需要任何这些。
尽管 Minecraft 并非专为改装而设计，但它仍然包含许多功能，您无需进行任何其他更改即可访问它们。
本文将按优先顺序介绍影响 Minecraft 的所有方法。
Minecraft 自带 API
如果 Minecraft 已经允许您执行某些操作，请不要重新造轮子。一个很好的例子是“net.minecraft.util.registry.Registry”类，它使您无需修改 Minecraft 的代码即可添加方块、物品等。
Minecraft 还将 JSON 数据文件用于各种数据驱动功能。您可以将 JSON 文件添加到您的模组中，Fabric API 会注入这些文件。例如，方块模型和战利品表是通过 JSON 文件实现的。
Fabric API
安装在客户端中的 Fabric 本身分为两个部分。
Fabric Loader：用于加载您的本身并调用您的入口点。
Fabric API：这是一个可选的库，提供一些常用的接口。
故意将 API 保持相对较小，以使 Fabric 可以更快地移植到新的 Minecraft 版本。
您可以通过查看其 GitHub 上的源代码来了解 Fabric API 中包含的内容。
Fabric API 包含许多常见的事件挂钩，以及用于联网和渲染之类的通用实用程序。
第三方 API
由于 Fabric API 为方便维护，体量较小且覆盖范围较小，因此存在第三方 API 来填补空白。
Mixin 允许任何第三方库以与核心 Fabric API 相同的方式修改 Minecraft 的代码。
您应尽可能使用这些而不是编写自己的 mixin，以最大程度地减少发生冲突的可能性。
您可以在此 wiki 上找到第三方库的不完整列表。
Mixin
最后，您可以使用 mixin。
Mixin 功能强大，可让您更改 Minecraft 自己的代码。
某些 mixin 可能会冲突，但是若能负责任地使用，这些是为模组添加特性的关键。
Mixin 有多种，按优先顺序排列：
添加接口
回调注入
重定向注入
覆写
此列表不一定完整，只是快速概述。
添加接口
这可能是使用 mixin 的最安全方法之一。
新的接口实现可以添加到任何 Minecraft 类中。
然后，可以通过将类强制转换为接口来访问该接口。
这不会改变类的任何内容，只会增加新的内容，因此极不可能发生冲突。
需要注意的是，您插入的函数签名（名称+类型）必须是唯一的。 因此，如果您使用常见的参数类型，请确保指定独特的名称。
回调注入
回调注入器 @Inject 使您可以向现有方法以及该方法中的特定方法调用添加回调挂钩。
它们还使您可以拦截和更改方法的返回值，并尽早返回。
回调注入可以堆叠，因此不太可能引起模组之间的冲突。
重定向注入
通过 @Redirect，您可以使用自己的代码在目标方法内包装方法调用或变量访问。
使用这些功能时需要谨慎，目标调用或访问只能在所有模组之间重定向一次。
如果两个模组重定向相同的值，将导致冲突。
优先考虑回调注入。
覆写
避免使用覆写，因为替换了一个方法，删除了所有现有代码，并与该方法上的任何其他类型的 mixin 发生冲突。
覆写极有可能不仅与其他模组冲突，而且与 Minecraft 本身的更改冲突。
您极有可能不需要覆盖来完成您想做的事情，请使用其他方法。
zh_cn/tutorial/introduction.txt · Last modified: 2023/01/15 01:39 by solidblock
Page Tools
Show pagesourceOld revisionsBacklinksBack to top
Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Noncommercial-Share Alike 4.0 International
欢迎访问 Fabric 中文文档 — Fabric 文档
欢迎访问 Fabric 中文文档 — Fabric 文档
欢迎访问 Fabric 中文文档¶
本站覆盖了 Fabric 的用法和 API 文档，包括变更历史和维护信息等 Fabric 基本信息见 Fabric 官方网站 。
入门教程¶
对于新用户，以及/或想大概了解 Fabric 基本功能的同学，请访问 概览 & 教程 。本文档的其它部分将假设你至少已经大概熟悉其中的内容。
使用文档¶
下面的列表包含了 Fabric （非 API 部分）文档的主要章节。这些内容对 概览 & 教程 中提到的概念进行了扩展，同时还覆盖了一些高级主题。
环境字典 env
运行环境即设置
环境即状态共享
其他考虑
环境变量完整列表
Execution model
Execution strategy
Defining tasks
Defining host lists
Intelligently executing tasks with execute
Failure handling
Connections
Password management
Leveraging native SSH config files
fab 选项和参数
基本应用
直接执行远程命令
命令行参数
Per-task arguments
配置文件
Fabfile 文件的结构和使用
指定 fabfile
引用 Fabric
定义任务并导入 callable 任务
与远程程序集成
合并 stdout 和 stderr
伪终端
两者结合
作为库使用
连接服务器
断开连接
最后注意
输出管理
输出等级
隐藏和／或显示输出级别
并行执行
它是如何运转的
如何使用
bubble 大小
行级输出 vs 比特级输出
SSH 行为
未知主机
已知主机但更换了密钥
定义任务
新式任务
传统任务
API 文档¶
Fabric 维护了两套根据代码中 docstring 自动生成的 API 文档（它们都十分详尽）。
核心 API¶
核心 API 是指构成 Fabric 基础构建块的函数、类和方法（例如 run 和 sudo ）。而其他部分（下文的“扩展 API”和用户的 fabfile）都是在这些核心 API 的基础之上构建的。
提供彩色输出的函数
上下文管理器
装饰器
文档助手
网络
业务（Operation）
任务
实用工具
扩展 API¶
Fabric 的 扩展包 包括常用而有用的工具（通常是从用户的 fabfile 中合并进来的），可用于用户 I/O、修改远程文件等任务中。核心 API 倾向于保持小巧、不随意变更，扩展包则会随着更多的用户案例被解决并添加进来，而不断成长进化（同时尽量保持向后兼容）。
终端输出工具
与 Django 集成
文件和目录管理
项目工具
参与 & 测试¶
我们欢迎高级用户 & 开发者提交并帮助修复 bug，或者帮助开发新功能。
Fabric
Pythonic remote execution
Navigation
概览 & 教程
环境字典 env
Execution model
fab 选项和参数
Fabfile 文件的结构和使用
与远程程序集成
作为库使用
输出管理
并行执行
SSH 行为
定义任务
提供彩色输出的函数
上下文管理器
装饰器
文档助手
网络
业务（Operation）
任务
实用工具
终端输出工具
与 Django 集成
文件和目录管理
项目工具
运行 Fabric 的测试
Main website
快速搜索
输入相关的术语，模块，类或者函数名称进行搜索
Donate
Consider supporting the authors on Gratipay:
©2016 Jeff Forcier.
|
Powered by Sphinx 1.3.5
& Alabaster 0.7.7
|
Page source