# 写在开头的话

您好，欢迎阅读Minecraft 1.12源码阅读笔记，在这个Wiki中，我将从阅读Minecraft源码的准备讲起，然后阐述我是如何学习阅读Minecraft源码的，以这个为出发点，我归纳了八个源码阅读原则，最后，我将解析Minecraft 1.12中的每一个类。

这无疑是个大工程，Minecraft源码的类有上千个，想搞懂每一个类的每一个属性，每一个方法，并且梳理好它们之间的关系需要花不少时间和精力，如果您发现这里的内容乏善可陈，您可以使用[给未来写封信 - 时光邮局](https://www.coolapk.com/apk/com.kongzue.tofuture)这个安卓app来定个几年时间提醒，过几年在来阅读，如果您想要和我一起完成这个Wiki，请通过我的邮箱:<wangtingzheng@outlook.com>与我交流。

除此之外，需要提醒您的是，由于本Wiki的图像都存放在这个Wiki的仓库里，所以在国内的网络环境下，图片很可能加载不出来，如果您想在线阅读的话，建议您准备一个SSR，具体的软件和服务商的推荐，可以查看[阅读前一些准备](https://wangtingzheng.gitbook.io/minecraft-source-code-wiki/yue-du-qian-yi-xie-zhun-bei)页面里查阅我们推荐的SSR工具。

下面是一些你在阅读具体的文档前，所必须阅读的一些说明文档：

* 环境准备
  * [阅读前一些准备](https://wangtingzheng.gitbook.io/minecraft-source-code-wiki/yue-du-qian-yi-xie-zhun-bei)
  * [编译自己的源码](https://wangtingzheng.gitbook.io/minecraft-source-code-wiki/bian-yi-zi-ji-de-yuan-ma)
* 阅读原则
  * [学习如何学习](https://wangtingzheng.gitbook.io/minecraft-source-code-wiki/xue-xi-ru-he-xue-xi)
  * [阅读源码八原则](https://wangtingzheng.gitbook.io/minecraft-source-code-wiki/yue-du-yuan-ma-ba-yuan-ze)
* 多人合作
  * [编写本Wiki](https://wangtingzheng.gitbook.io/minecraft-source-code-wiki/ke-qian-yu-xi/duo-ren-he-zuo/bian-xie-ben-wiki)

具体的类的wiki，你可以通过左边的导航栏进行查看。


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://wangtingzheng.gitbook.io/minecraft-source-code-wiki/master.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.