Differences

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

--- zh_cn:start [2019/12/19 05:36] – [MOD 开发者 (已翻译)] lightcolour
+++ zh_cn:start [2023/12/18 01:05] – [世界生成] solidblock
@@ Line 1: / Line 1: @@
-====== 欢迎使用Fabric Wiki! ======
+====== 欢迎来到 Fabric Wiki！======
-这是一个早期的在制品wiki，致力于记录Fabric项目的方法、工具和api。
+Fabric 是针对 Minecraft 1.14 及更高版本（含快照）的模块化模组制作工具链。
-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]]
-**请一定要看看[[http://fabricmc.net/discuss|我们的社区空间]], 并阅读我们的 [[rules|社区规则]]!**
+同时如果要为中文 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 翻译标准]]。
-  * [[faq:user|经常问的问题 (用户)]]
+**请一定要看看[[zh_cn:community:official_community_spaces|社区空间和规则]]**！
-  * [[faq:expert|经常问的问题 (专家)]] - 上面的补充，有更详细的答案
-该Wiki还提供以下语言版本 :
+  * [[zh_cn:faq:user|常见问题（用户）]]
-| {{:usa_flag.png?nolink&24|}} [[:start|英语]] |
+  * [[zh_cn:faq:expert|常见问题（专家）]] - 对前者细节的补充
-| {{:france_flag.png?nolink&24|}} [[fr:accueil|法语]] |
+===== 玩家教程 =====
+如果你是玩家、服务器管理员或整合包作者，你应该查看 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 =====
-如果是Fabric 玩家、务器管理员或modpack开发人员，则这些文章适用于您：
+====== 模组开发者教程 ======
-==== 教程 ====
+如果你想开始使用 Fabric 开始开发，请访问此 wiki 的 [[zh_cn:tutorial:start|模组开发者教程]]部分。
+==== 安装 ====
-  * [[zh_cn:install|安装 Fabric]]
+  * [[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]]
-----
+==== 基础 ====
-===== Modpack和启动器开发者 =====
+  * [[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|使用映射]]
-**请记住，我们建议使用MultiMC和MCUpdater进行modpack播放和分发。**但是，这并不妨碍我们尝试支持其他解决方案！
+==== 物品 ====
+  * [[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|添加模型谓词提供器]]
-==== 教程 ====
+==== 方块和方块实体 ====
-  * [[tutorial:mcupdater_modpacks|使用MCUpdater的Fabric modpacks]] (涵盖用法和创作)
+  * [[zh_cn:tutorial:blocks|添加方块]]
-  * [[tutorial:technic_modpacks|在Technic上发布Fabric Modpack]]
+  * [[zh_cn:tutorial:blockstate|赋予方块状态]]
-  * [[tutorial:atlauncher_modpacks|在ATLauncher上发布Fabric modpack]]
+    * [[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|添加自定义的作物]]
-==== 文档 ====
+==== 数据生成 ====
-  * [[documentation:modpack_related_endpoints|Modpack-related 端点]]
+这些页面会带你了解 [[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|命令示例]]
-----
+==== 事件 ====
-===== MOD 开发者 (已翻译)=====
+这些页面会带你了解 [[https://github.com/FabricMC/fabric|Fabric API]] 中包含的很多事件，以及如果创建自己的事件以供其他模组使用。
-如果您想开始使用Fabric进行开发，这里有一些您可能会感兴趣的文章。
+  * [[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:setup|建立开发环境]]
+==== 流体 ====
-  * [[https://wiki.vg/Debugging|启用log4j调试]]
+  * [[zh_cn:tutorial:fluids|创建一种流体]]
-  * [[zh_cn:tutorial:cursegradle|用CurseGradle发布]]
+==== 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|创建屏幕]]
-  * [[zh_cn:tutorial:introduction|Fabric编写入门]]
+==== Yarn ====
-  * 惯用词和术语
-    * [[zh_cn:tutorial:terms|惯用词和术语.]]
-    * [[zh_cn:tutorial:side|服务器和客户端术语.]]
-  * 开发工具
-    * [[zh_cn:documentation:libraries|第三方开发API]]
-    * [[zh_cn:tutorial:applychanges|应用更改而无需重新启动Minecraft(热重载)]]
-  * [[zh_cn:tutorial:lang|创建语言文件]]
-  * [[zh_cn:tutorial:mappings|使用映射]]
-  * [[zh_cn:tutorial:recipes|添加一个合成]]
-=== 物品和物品组 ===
+  * [[zh_cn:tutorial:migratemappings|更新 Java 代码库中的 Yarn 映射]]
+  * [[zh_cn:tutorial:updating_yarn|将 Yarn 升级到新的 Minecraft 版本]] - 仅供 Yarn 开发者，普通用户和模组开发者请**不要**阅读此文！
-  * [[zh_cn:tutorial:items|添加一个物品]]
+==== 贡献 Fabric ====
-  * [[zh_cn:tutorial:itemgroup|添加一个物品组]]
-  * [[zh_cn:tutorial:tooltip|添加一个物品提示]]
-=== Blocks and Block Entities===
-  * [[zh_cn:tutorial:blocks|添加一个方块]]
+  * [[zh_cn:tutorial:feature_procedure|Fabric 接受新功能的过程 - 或者说如何让 Fabric 接受（或拒绝）你的新功能]]
-  * [[zh_cn:tutorial:blockstate|方块状态]]
+  * [[zh_cn:tutorial:fablabs|FabLabs]] - 在提交 PR 之前起草新功能的试验场
-  * [[zh_cn:tutorial:blockentity|添加一个方块实体]]
+  * [[https://github.com/FabricMC|GitHub 上的 Fabric]]
-  * [[zh_cn:tutorial:inventory|将物品放入容器中]]
+  * [[https://github.com/FabricMC/yarn|Yarn 命名映射的代码库 + 贡献相关文档]]
-  * [[zh_cn:tutorial:colorprovider|动态更改方块或物品的颜色]]
-  * [[zh_cn:tutorial:blockappearance|操纵方块的外观]]
+旧的教程请在这里查找[[zh_ch:tutorial:archived_pages|存档的页面]]。
-  * [[zh_cn:tutorial:blockentityrenderers|渲染动态使用方块实体渲染器方块和物品]]
+====== 文档 ======
+如果你想知道 Fabric 工具链中的项目作用的方式，请访问 wiki 的 [[documentation:start|文档]] 部分。
+  * [[zh_cn:documentation:fabric_mod_json_spec|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]]
+==== 示例 ====
+  * [[https://github.com/FabricMC/fabric-example-mod|模组开发环境模板]]
+  * [[https://github.com/FabricMC/fabric/tree/master/fabric-testmods/java/net/fabricmc/fabric|Fabric API 测试模组]]（已过期） - 虽然不是教程，但应该还是能给你提供帮助
+----
+====== 贡献 wiki ======
+此 wiki 主要是由社区维护、面向社区的。如果你有兴趣为 wiki 作出贡献，请先检查以下页面：
+  * [[zh_cn:wiki:meta|Wiki Meta]] - wiki 贡献的起点
+  * [[zh_cn:wiki:agenda|Wiki 议题]] - 查看当前的议题，以及其他贡献者现在在做什么
+  * [[zh_cn:wiki:translation|中文翻译标准]] - 将英文内容翻译成中文时，建议遵循的标准