Fabric Wiki

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== 欢迎来到 Fabric Wiki！======

Fabric 是针对 Minecraft 1.14 及更高版本（含快照）的模块化模组制作工具链。

wiki 中的一些页面可能过时了或者还在撰写中。

该 wiki 还提供以下语言版本 :
  * {{:united-states.png?nolink&32|}} [[:start|English（英文）]]
  * {{:france.png?nolink&32|}} [[fr:accueil|Français（法语）]]
  * {{:germany.png?nolink&32|}} [[de:start|Deutsch（德语）]]
  * {{:south-korea.png?nolink&32|}} [[ko_kr:start|한국어（韩语）]]
  * {{:russia.png?nolink&32|}} [[ru:start|Русский（俄语）]]
  * {{:japan.png?nolink&32|}} [[ja:start|日本語（日语）]]
  * {{:es.png?nolink&32|}} [[es:start|Español（西班牙语）]]

同时如果要为中文 wiki 做贡献的话，请一定要看看[[https://fabricmc.cn/2021/07/25/%E4%B8%AD%E6%96%87FabricWiki%E7%BF%BB%E8%AF%91%E6%A0%87%E5%87%86/|中文 Fabric Wiki 翻译标准]]。

**请一定要看看[[zh_cn:community:official_community_spaces|社区空间和规则]]**！

  * [[zh_cn:faq:user|常见问题（用户）]]
  * [[zh_cn:faq:expert|常见问题（专家）]] - 对前者细节的补充

====== 玩家教程 ======

如果你是玩家、服务器管理员或整合包作者，你应该查看 wiki 的[[zh_cn:player:tutorials:start|玩家教程]]部分。

  * [[zh_cn:player:tutorials:start#安装 Fabric Loader|安装 Fabric Loader]]
  * [[zh_cn:player:tutorials:start#更新 Fabric Loader|更新 Fabric Loader]]
  * [[zh_cn:player:tutorials:start#安装 Java|安装 Java]]
  * [[zh_cn:player:tutorials:start#故障排除|故障排除]]

----

====== 模组开发者教程 ======

如果你想开始使用 Fabric 开始开发，请访问此 wiki 的 [[zh_cn:tutorial:start|模组开发者教程]]部分。
==== 安装 ====

  * [[zh_cn:tutorial:setup|开始（建立开发环境）]]
  * [[zh_cn:tutorial:minotaur|使用 Minotaur 在 Modrinth 上发布模组]]
  * [[zh_cn:tutorial:cursegradle|使用 CurseGradle 发布模组]]
  * [[zh_cn:tutorial:publishing_mods_using_github_actions|使用 MC-Publish 将模组发布到 Curseforge、Modrinth 和 Github]]

==== 基础 ====

  * [[zh_cn:tutorial:primer|Minecraft 模组开发基础]]
  * [[zh_cn:tutorial:introduction|使用 Fabric 开发模组的介绍]]
  * [[zh_cn:tutorial:reading_mc_code|阅读 Minecraft 代码]]
  * 约定和术语
    * [[zh_cn:tutorial:terms|基本的约定和术语]]
    * [[zh_cn:tutorial:side|服务器和客户端术语]]
  * 注册
    * [[zh_cn:tutorial:registry|注册表介绍]]
    * [[zh_cn:tutorial:registry_types|标准注册表]]
  * 开发工具
    * [[zh_cn:tutorial:libraries|第三方模组库]]
    * [[zh_cn:tutorial:applychanges|应用更改而无需重新启动 Minecraft]]
  * [[zh_cn:tutorial:lang|创建语言文件]]
  * [[zh_cn:tutorial:mappings|使用映射]]

==== 物品 ====
  * [[zh_cn:tutorial:items_docs|物品文档]]
  * [[zh_cn:tutorial:items|演练：添加物品]]
    * [[zh_cn:tutorial:itemgroup|为你的物品添加物品组]]
    * [[zh_cn:tutorial:tooltip|为你的物品添加物品提示]]
  * [[zh_cn:tutorial:recipes|添加合成配方]]
  * [[zh_cn:tutorial:armor|添加盔甲]]
  * [[zh_cn:tutorial:tools|添加工具]]
  * [[zh_cn:tutorial:shield|添加盾牌]]
  * [[zh_cn:tutorial:enchantments|添加自定义附魔]]
  * [[zh_cn:tutorial:model_predicate_providers|添加模型谓词提供器]]

==== 方块和方块实体 ====

  * [[zh_cn:tutorial:blocks|添加方块]]
  * [[zh_cn:tutorial:blockstate|赋予方块状态]]
    * [[zh_cn:tutorial:directionalblock|制作带朝向的方块]]
    * [[zh_cn:tutorial:waterloggable|让方块可含水]]
  * [[zh_cn:tutorial:blockentity|添加方块实体]]
  * [[zh_cn:tutorial:inventory|让方块可以储存物品]]
  * [[zh_cn:tutorial:colorprovider|动态更改方块或物品的颜色]]
  * [[zh_cn:tutorial:blockappearance|操纵方块的外观]]
  * [[zh_cn:tutorial:dynamic_block_rendering|动态渲染方块与物品]]
    * [[zh_cn:tutorial:custom_model|使用自定义模型动态渲染方块和物品]]
    * [[zh_cn:tutorial:blockentityrenderers|使用方块实体渲染器动态渲染方块和物品]]
  * [[zh_cn:tutorial:screenhandler|创建一个容器方块]]
    * [[zh_cn:tutorial:extendedscreenhandler|使用扩展的 ScreenHandler 同步数据]]
    * [[zh_cn:tutorial:propertydelegates|使用 PropertyDelegate 同步整型数据]]
  * [[zh_cn:tutorial:crops|添加自定义的作物]]

==== 数据生成 ====

这些页面会带你了解 [[https://github.com/FabricMC/fabric/tree/HEAD/fabric-data-generation-api-v1|Fabric Data Generation API]]，可以通过数据生成器产生 JSON 文件。

  * [[zh_cn:tutorial:datagen_setup|开始了解数据生成]]
  * [[zh_cn:tutorial:datagen_advancements|进度生成]]
  * [[zh_cn:tutorial:datagen_loot|战利品表生成]]
  * [[zh_cn:tutorial:datagen_model|模型生成]]
  * [[zh_cn:tutorial:datagen_tags|标签生成]]
  * [[zh_cn:tutorial:datagen_recipe|配方生成]]
  * [[zh_cn:tutorial:datagen_language|语言文件生成]]

==== 世界生成 ====
  * [[zh_cn:tutorial:dimensionconcepts|维度概念]]
  * [[zh_cn:tutorial:ores|生成自定义矿石]]
  * [[zh_cn:tutorial:features|添加地物]]
  * [[zh_cn:tutorial:trees|添加树木（高级）]]
  * [[https://misode.github.io/guides/adding-custom-structures/|添加结构地物]]（第三方教程）
  * [[https://zh.minecraft.wiki/w/自定义生物群系|添加生物群系]]（原版教程）
    * [[zh_cn:tutorial:biomes|添加生物群系（旧版本）]]
  * [[zh_cn:tutorial:chunkgenerator|自定义区块生成器（草稿）]]
  * [[zh_cn:tutorial:workd_presets|添加世界预设]]
  * [[https://zh.minecraft.wiki/w/自定义维度|添加维度]]（原版教程）
    * [[zh_cn:tutorial:custom_portals|创建自定义传送门]]
==== 命令 ====
  * [[zh_cn:tutorial:commands|创建命令]]
  * [[zh_cn:tutorial:command_exceptions|命令异常]]
  * [[zh_cn:tutorial:command_suggestions|命令建议]]
  * [[zh_cn:tutorial:command_redirects|命令重定向]]
  * [[zh_cn:tutorial:command_argument_types|命令参数类型]]
  * [[zh_cn:tutorial:command_examples|命令示例]]

==== 事件 ====
这些页面会带你了解 [[https://github.com/FabricMC/fabric|Fabric API]] 中包含的很多事件，以及如果创建自己的事件以供其他模组使用。

  * [[zh_cn:tutorial:callbacks|监听事件]]
  * [[zh_cn:tutorial:events|创建自定义的事件]]
  * [[zh_cn:tutorial:adding_to_loot_tables|将物品添加到已存在的战利品表]]
  * [[zh_cn:tutorial:event_index|事件索引（草稿）]]

==== 实体 ====
  * [[zh_cn:tutorial:entity|添加实体]]
  * [[zh_cn:tutorial:spawn_egg|添加自定义刷怪蛋]]
  * [[zh_cn:tutorial:projectiles|创建自定义弹射物]]

==== 流体 ====
  * [[zh_cn:tutorial:fluids|创建一种流体]]

==== Mixin 和 ASM ====
本页会带你了解如何使用 [[https://github.com/SpongePowered/Mixin|SpongePowered 的 Mixin 库]]，这是非常复杂的话题，建议您从头到尾阅读这些页面。
  * [[zh_cn:tutorial:mixin_introduction|介绍]]
  * [[zh_cn:tutorial:mixin_registration|Mixin 注册]]
  * [[zh_cn:tutorial:mixin_injects|注入]]
  * [[zh_cn:tutorial:mixin_accessors|访问器和调用器]]
  * [[zh_cn:tutorial:mixin_redirectors|重定向器]]
    * [[zh_cn:tutorial:mixin_redirectors_methods|方法重定向器]]
  * [[zh_cn:tutorial:mixin_tips|小提示]]
  * [[zh_cn:tutorial:mixin_examples|示例]]
  * [[zh_cn:tutorial:mixin_hotswaps|热交换 Mixin]]
  * [[zh_cn:tutorial:mixin_export|导出 Mixin 类]]
  * [[zh_cn:tutorial:accesswideners|访问加宽器]]
  * [[zh_cn:tutorial:reflection|反射]]
  * [[zh_cn:tutorial:interface_injection|接口注入]] 

==== 杂项 ====
  * [[zh_cn:tutorial:recipe_types_introduction|配方类型介绍]]
    * [[zh_cn:tutorial:recipe_type|添加配方类型（草稿）]]
    * [[zh_cn:tutorial:cooking_recipe_type|添加烹饪配方类型]]
    * [[zh_cn:tutorial:cutting_recipe_type|添加切制配方类型]]
  * [[zh_cn:tutorial:mining_levels|挖掘等级]]
  * [[zh_cn:tutorial:global_data|全局世界数据]]
    * [[zh_cn:tutorial:persistent_states|持久状态]]
    * [[zh_cn:tutorial:cardinal_components|主要成分]]
  * [[zh_cn:tutorial:pixel_raycast|视线投射]]
  * [[zh_cn:tutorial:keybinds|自定义按键绑定]]
  * [[zh_cn:tutorial:networking|网络通信]]
  * [[zh_cn:tutorial:status_effects|药水效果]]
  * [[zh_cn:tutorial:particles|添加粒子]]
  * [[zh_cn:tutorial:sounds|播放声音]]
  * [[zh_cn:tutorial:gamerule|自定义游戏规则]]
  * [[zh_cn:tutorial:custom_resources|自定义数据/资源包资源]]
  * [[zh_cn:tutorial:tags|标签约定]]
  * [[zh_cn:tutorial:list_of_useful_gists|一些有用的教程]]
  * [[zh_cn:tutorial:stats|添加玩家统计]]
  * [[zh_cn:tutorial:modding_tips|开发模组的小技巧]]
  * [[zh_cn:tutorial:datafixer|DataFixer]]
  * [[zh_cn:tutorial:transfer-api|流体、物品和能量转移]]
  * [[zh_cn:tutorial:screen|创建屏幕]]

==== Yarn ====

  * [[zh_cn:tutorial:migratemappings|更新 Java 代码库中的 Yarn 映射]]
  * [[zh_cn:tutorial:updating_yarn|将 Yarn 升级到新的 Minecraft 版本]] - 仅供 Yarn 开发者，普通用户和模组开发者请**不要**阅读此文！

==== 贡献 Fabric ====

  * [[zh_cn:tutorial:feature_procedure|Fabric 接受新功能的过程 - 或者说如何让 Fabric 接受（或拒绝）你的新功能]]
  * [[zh_cn:tutorial:fablabs|FabLabs]] - 在提交 PR 之前起草新功能的试验场
  * [[https://github.com/FabricMC|GitHub 上的 Fabric]]
  * [[https://github.com/FabricMC/yarn|Yarn 命名映射的代码库 + 贡献相关文档]]

旧的教程请在这里查找[[zh_ch:tutorial:archived_pages|存档的页面]]。

====== 文档 ======

如果你想知道 Fabric 工具链中的项目作用的方式，请访问 wiki 的 [[documentation:start|文档]] 部分。

  * [[zh_cn:documentation:fabric_mod_json|fabric.mod.json 的规定]]
  * [[zh_cn:documentation:entrypoint|入口点]]
  * [[http://github.com/SpongePowered/Mixin/wiki|Mixin 库的 Wiki]]（英文）
  * [[zh_cn:documentation:rendering|Fabric 中的渲染（草稿）]]
  * [[zh_cn:documentation:build_pipelines|构建 Fabric 的流水线（草稿）]]
  * [[zh_cn:documentation:fabric_loader|Fabric Loader]]
  * [[zh_cn:documentation:fabric_loom|Fabric Loom]]

----
====== 贡献 wiki ======

此 wiki 主要是由社区维护、面向社区的。如果你有兴趣为 wiki 作出贡献，请先检查以下页面：

  * [[zh_cn:wiki:meta|Wiki Meta]] - wiki 贡献的起点
  * [[zh_cn:wiki:agenda|Wiki 议题]] - 查看当前的议题，以及其他贡献者现在在做什么
  * [[zh_cn:wiki:translation|中文翻译标准]] - 将英文内容翻译成中文时，建议遵循的标准