mirror of
https://github.com/Pumpkin-MC/Pumpkin-Website.git
synced 2025-08-15 05:05:05 +00:00
74 lines
2.8 KiB
Markdown
74 lines
2.8 KiB
Markdown
### 为 Pumpkin 做贡献
|
||
|
||
我们感谢您对 Pumpkin 贡献的兴趣！本文档概述了提交错误报告、功能建议和代码更改的指南。
|
||
|
||
### 入门
|
||
|
||
最简单的入门方式是在[我们的 Discord 服务器](https://discord.gg/wT8XjrjKkf)上寻求帮助。
|
||
|
||
### 如何贡献
|
||
|
||
您可以通过以下几种方式为 Pumpkin 做贡献：
|
||
|
||
#### 报告错误
|
||
|
||
如果您遇到错误，请先在 issue tracker 上搜索现有问题。
|
||
|
||
如果找不到重复的 issue，请创建一个新 issue。
|
||
|
||
遵循模板并提供清晰的错误描述，包括重现步骤（如果可能）。
|
||
屏幕截图、日志或代码片段也会有所帮助。
|
||
|
||
#### 建议功能
|
||
|
||
您对如何改进 Pumpkin 有想法吗？通过在问题跟踪器上打开一个问题来分享您的想法。
|
||
|
||
详细描述所提议的功能，包括其好处和潜在的实现考虑。
|
||
|
||
#### 贡献代码
|
||
|
||
要开始为 Pumpkin 贡献代码，请在 GitHub 上 fork 仓库
|
||
|
||
1. 首先，如果您还没有 GitHub 账户，请创建一个
|
||
|
||
2. 前往 Pumpkin 的官方 [GitHub 组织](https://github.com/Pumpkin-MC) 并按下 fork 按钮
|
||
|
||
> 创建复刻意味着您现在拥有 Pumpkin 源代码的自己的副本（这并不意味着您拥有版权）。
|
||
|
||
现在您有了可以编辑的副本，您需要一些工具。
|
||
|
||
3. 为您的操作系统安装 [git](https://git-scm.com/downloads)
|
||
|
||
- 要开始使用 git，请访问 [Git 入门](https://docs.github.com/en/get-started/getting-started-with-git)
|
||
|
||
- 可选：如果您想要一个与 GitHub 交互的图形工具，安装 [GitHub-Desktop](https://desktop.github.com/download/)
|
||
|
||
> 如果您不习惯命令行，GitHub Desktop 可能更容易使用，但并不适合所有人
|
||
|
||
- 要开始使用 GitHub Desktop，请访问 [GitHub Desktop 入门](https://docs.github.com/en/desktop/overview/getting-started-with-github-desktop)
|
||
|
||
- 如果您想贡献代码，请在 [rust-lang.org](https://www.rust-lang.org/) 安装 Rust。
|
||
|
||
- 如果您想为文档做贡献，请安装 [NodeJS](https://nodejs.org/en)
|
||
|
||
### 反编译 Minecraft 代码
|
||
|
||
在 Pumpkin 工作时，我们严重依赖官方 Minecraft 客户端并利用现有的服务器逻辑。我们经常参考 Minecraft 的官方代码。
|
||
反编译 Minecraft 最简单的方法是使用 Fabric Yarn。在运行以下命令之前，请确保已安装 Gradle：
|
||
|
||
```
|
||
git clone https://github.com/FabricMC/yarn.git
|
||
cd yarn
|
||
./gradlew decompileVineflower
|
||
```
|
||
|
||
反编译后，您可以在 `build/namedSrc` 目录中找到源代码。
|
||
|
||
### 其他信息
|
||
|
||
我们鼓励您对现有 issue 和拉取请求发表评论，分享您的想法并提供反馈。
|
||
|
||
如果您需要帮助，请随时在问题跟踪器中提问或联系项目维护者。
|
||
|
||
在提交大型贡献之前，请考虑打开一个问题或讨论，或者在我们的 Discord 上与我们交流以讨论您的方法。
|