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 21+ required) with your preferred arguments and configuration.
Requirements:
- Java 21
- Git (configured with name/email)
Common build commands:
./gradlew applyAllPatches # Applies all patches to construct the Canvas source
./gradlew createMojmapPublisherJar # Creates the publication jar used by our Jenkins CI
./gradlew runDevServer # 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.
