本 fork 基于 Canvas（Folia 下游），针对上游 Canvas 的两个问题进行了修改：
- 上游 Canvas 硬编码禁用命令方块；
- Paper/Folia 修改了大量原版机制（刷线机、TNT 复制、永久破坏等）。
上游 Canvas 在 6 处代码中通过 if(true) return false、return false 等方式硬编码禁用了命令方块。本 fork 在 feature patch 0003 中将这 6 处禁用改为受配置控制：
- 开关：
config/canvas-server.yml→vanilla-like-experience.command-blocks（默认true） - 开启时通过 ACE API 的
io.canvasmc.canvas.command.execution.AbstractCommandExecution.executeOnGlobal将命令方块执行路由到 global region 线程，可安全执行跨区域命令（如/tp、/give、/scoreboard） - 关闭时（
command-blocks: false）保持上游 Canvas 的禁用行为
默认 true（保留原版命令方块行为）。已验证：命令方块正常使用，跨区域 TP 无报错。
主开关：config/canvas-server.yml → vanilla-like-experience.enabled（默认 false）。开启后还原 Paper/Folia 修改过的原版机制（移植自 LuminolMC/Lophine 0048）：
| 机制 | 说明 |
|---|---|
| 刷线机（Tripwire hook） | 跳过放置校验，启用刷线机 |
| TNT & 沙子复制 | 通过活塞 desync 实现 |
| 永久破坏 | 可破坏基岩、末地传送门框架 |
| 无头活塞 | 允许形成 |
| 原版生物刷新 | 计入全部生物（count all mobs） |
| 实体碰撞 | 无上限 |
| 玩家挤压伤害 | 启用 |
| 幻翼 / 失眠原版行为 | 还原 |
| TNT 每 tick 上限 | 移除（无上限） |
| 漏斗 / 蜜蜂 / 物品合并 / 末地传送门传送 | 还原原版行为 |
当 enabled: false 时，Paper/Folia 的各项 per-mechanic 配置照常生效。
| 分支 | Canvas base | 说明 |
|---|---|---|
pre-merger/26.2 |
上游 Canvas pre-merger/26.2（26.2 pre-merge，较新） |
服务器实际运行的分支；命令执行包 io.canvasmc.canvas.command.execution |
main |
上游 Canvas main（stable main，较旧） |
跟踪上游 main；命令执行包 io.canvasmc.canvas.threadedregions.commands |
两个分支的 Canvas base 不同：
pre-merger/26.2是 26.2 的 pre-merge 线（含 Canvas 上游对命令执行包的重构），main是 stable main（还没收到该重构）。所以 0003 patch 在两个分支上用了不同的包路径，分别生成、都编译通过。部署用pre-merger/26.2。
基础 patch（canvas-server/minecraft-patches/base/，Canvas 上游维护，fork 不改）：
0001-Rebrand、0002-Remove-Vanilla-Profiler、0003-Remove-Dead-Old-Watchdog-Code、0004-Per-world-Canvas-configs / 0004-Fixup-Region-Threading、0005-Region-Threading、0006-Canvas-RegionizedWorldData、0007-Replace-Moonrise-Executor、0008-Purpur-Ender-Chest-6-Rows-Config
Feature patch（canvas-server/minecraft-patches/features/）：
| 补丁 | 来源 | 说明 |
|---|---|---|
0001-Purpur-Alternative-Keepalive |
Canvas 上游 | — |
0002-Disable-Criterion-Trigger-Config |
Canvas 上游 | — |
0003-Vanilla-like-experience |
本 fork（移植 + 原创） | 22 个 hunk：17 vanilla 机制移植自 LuminolMC/Lophine 的 0048-Add-Vanilla-like-experience-Config.patch（作者 Bacteriawa）；5 命令方块 gate 为本 fork 原创（用 Canvas ACE AbstractCommandExecution.executeOnGlobal 路由到 global region 线程） |
Canvas 自有源码改动（canvas-server/src/main/java/io/canvasmc/canvas/GlobalConfiguration.java，非 patch）：新增 VanillaLikeExperience 配置段（enabled + commandBlocks 字段）。
命令方块修复 + Vanilla-like Experience 都在 feature patch 0003-Vanilla-like-experience.patch（一个补丁），配置都在 config/canvas-server.yml 的 vanilla-like-experience 段（enabled 控原版机制，command-blocks 控命令方块）。基础 patch（0004/0005）保持上游 Canvas 原样（命令方块禁用），由 0003 重新启用并受配置控制。
合并上游 Canvas 后，本 fork 的 0003 可能需要重新适配：
- 17 个 vanilla 机制 hunk 依赖 Paper-config 代码行（如
allowPlayerCrammingDamage、maxEntityCollisions、allowPistonDuplication）。上游 Paper 重构这些行 → hunk context 变 → 应用失败，需重新生成。 - 5 个命令方块 gate hunk 依赖 Canvas 上游的禁用点（
if(true) return false等）。上游改禁用方式 → 需重新适配。 - 命令执行包路径（
command.execution/threadedregions.commands）若上游再重构，两个分支都要跟着改。 - 基础 patch + feature 0001/0002 随上游 merge 自动更新，无需手动处理。
编辑 config/canvas-server.yml，然后执行 /canvas reload 或重启服务器使其生效。
| 服务端 | 兼容性 | 说明 |
|---|---|---|
| Canvas 26.2 | ✅ 完全兼容 | 命令方块与 vanilla-like 均可用，本 fork 的目标环境 |
| 上游 Folia | 不适用 | 这是 Canvas fork，不是 Folia fork |
| Paper / Purpur / Spigot | 不适用 | 这是 Canvas fork，依赖 Folia 区域化线程 |
./gradlew applyAllPatches
./gradlew :canvas-server:createPaperclipJarJava 版本要求：Java 25
CanvasMC is a high performance fork of Folia aiming to provide a stable and consistent region threading environment, alongside tons of optimizations and performance features for large scale servers.
- Canvas provides a scheduler written by the team called the
AFFINITYscheduler, which contains configurable features that increase performance immensely.
- Canvas replaces a rewritten chunk system pool, providing further optimizations that help with scaling and single-threaded throughput
- Fine-tune aspects of your server with fully documented configuration options and performance settings.
- Canvas introduces a full Spark profiler that is fully compatible with region threading, replacing the limited Folia profiling engine.
- By fixing numerous Folia bugs and crashes, Canvas delivers a high-performance, stable, and reliable experience.
- Download the latest server JAR from the Downloads page on canvasmc.io.
- Launch using Java (Java 25+ required) with your preferred arguments and configuration.
Requirements:
- Java 25
- Git (configured with name/email)
Common build commands:
./gradlew applyAllPatches # Applies all patches to construct the Canvas source
./gradlew createPaperclipJar # Creates the paperclip jar
./gradlew runDev # Starts a development server locally- Official Documentation: https://docs.canvasmc.io
- Community & Support: Join the Canvas Discord
- Issue Tracker / Contributing: Use this GitHub repo for reporting bugs, proposing features, and submitting pull requests
- Donations / Sponsorship: Support development on Ko-fi
We welcome many forms of contributions:
- Code (bug fixes, features)
- Documentation improvements
- Testing & bug reporting
- Community help & support
- Donations to help support the developers
See the Canvas Contributing Guide for more detail.
- Canvas is a fork of Folia and is not a drop-in replacement for Purpur, Paper, or other non-Folia forks. It is intended primarily for environments already using Folia or Folia-based forks.
- The project adheres strictly to Folia’s threading and safety rules and does not permit bypassing them.
This project is licensed under the GNU General Public License v3.0 (GPL-3.0).
Canvas incorporates patches inspired by or derived from other high-performance projects (e.g. Lithium, Leaf), along with its own custom optimizations.