Canvas 26.3

CanvasMC 是 Folia 的一个分支，引入了大量区域线程（region threading）修复以提升稳定性，同时也为专用服务器加入了各种性能增强。

bStats Graph Data

为什么选择 Canvas？
### 更高的服务器稳定性
SpottedLeaf 创作了 Folia，他的代码无疑非常出色，但 Folia 中仍存在大量未解决的 Bug 和问题。Canvas 内置了超过 80 项区域线程修复，试图解决这些问题，并计划将其补丁上游至 Folia。在撰写本文时，其中一些补丁已经在开放的 PR 中进入上游流程。
### 大量优化
Canvas 不仅专注于尝试完善并稳定区域线程。Canvas 还包含大量性能增强，帮助确保你的服务器不仅稳定，而且在高玩家数量下依然流畅快速。
### 丰富的配置
Canvas 提供了大量自定义和性能选项，你可以按自己的喜好进行调整。Canvas 提供的默认配置以 原版兼容性优先、性能其次为目标。
### 更快的更新
虽然 Canvas 是 Folia 的分支，但 Canvas 从 Paper 上游跟进，这意味着我们可以自行更新区域线程补丁，而无需先依赖 Folia 更新。这使我们甚至能够在 Folia 开始更新之前就更新到更新的 Minecraft 版本。
### Spark 区域性能分析
Canvas 包含一个修改版的 Spark 分析器，允许你使用 Spark 对特定区域进行性能分析，而不是像 LeafPile 中提供的 Folia 分析器那样分析整个服务器。
### 知识渊博的团队
我们的开发团队由技术娴熟的开发者组成，投入了数百小时的个人时间和精力，致力于 Canvas 以及我们组织下的其他项目。
Canvas 从哪些项目上游跟进？

Canvas 在上游来源方面是一个有点特别的分支。是的，从技术上讲我们是 Folia 的分支，因为我们的补丁确实基于 Folia。然而，我们将 Folia 补丁打包进我们自己的仓库，使我们能够从 Paper 上游跟进，这让我们在某种程度上像是 Folia 分支和 Paper 分支的混合体。我们不确定从技术角度该如何归类，所以干脆自称 Folia 分支，因为这样更容易理解。

从源码构建

要求：
Java 25
Git（已配置用户名/邮箱）

常用构建命令：

./gradlew applyAllPatches # 应用所有补丁以构建 Canvas 源码
./gradlew createPaperclipJar # 创建 paperclip jar
./gradlew runDevServer # 在本地启动开发服务器
文档与资源
官方文档：https://docs.canvasmc.io
社区与支持：加入 Canvas Discord
问题追踪 / 贡献：使用此 GitHub 仓库来报告 Bug、提出功能建议以及提交 Pull Request

贡献

我们欢迎多种形式的贡献：
代码（Bug 修复、功能开发）
文档改进
测试与 Bug 报告
社区帮助与支持
捐款以帮助支持开发者

更多详情请参阅 Canvas 贡献指南。

兼容性与注意事项
Canvas 是 Folia 的分支，并非 Purpur、Paper 或其他非 Folia 分支的即插即用替代品。它主要面向已经使用 Folia 或基于 Folia 的分支的环境。如果你需要从 Folia 或其他非 Folia 分支迁移方面的帮助，请在我们的 Discord 中联系，我们很乐意提供帮助。
本项目严格遵守 Folia 的线程与安全规则，不允许绕过这些规则。虽然是的，这只是最低要求，但我们这么说也是为了表明我们的意图：我们希望尽量不允许在服务器中执行潜在不安全的操作，例如通过一个未标记为支持 Folia 的插件。如果你出于自己的用途需要这样做，建议你寻找另一个 Folia 分支，或者自行 fork 本仓库并做出你需要的更改。

许可证与致谢

Canvas 的许可证继承自其上游项目来源。因此，Canvas 在 GNU General Public License V3 下授权，除非补丁本身另有说明，否则 CanvasMC 团队编写的补丁也同样适用此许可证。

Canvas 包含受其他 Minecraft 项目（例如 Lithium、Leaf、Luminol 等）启发或衍生而来的补丁，以及我们自己的补丁集。Canvas 在我们仓库的 /canvas-server/src/main/resources/META-INF/licenses/ 目录中提供了来自这些来源的完整许可证集合。

Canvas 也致力于在我们的软件中展示我们的贡献者。从我们 Discord 上的 “Contributor” 角色，到在我们的版本命令中按姓名提及，我们 CanvasMC 始终努力展示我们的社区和贡献者，因为坦白说，没有他们，Canvas 就不会是今天的样子。

捐款

你可以通过此处捐款来支持 Canvas 的工作。