# Winds-Studio/Leaf

A Paper fork focused on finding the balance between performance, vanilla mechanics, and stability

Repository: https://github.com/Winds-Studio/Leaf
Canonical: https://ross.abutalabs.com/products/winds-studio-leaf
Homepage: https://www.leafmc.one
Language: Java
License: NOASSERTION
License Family: other
Topics: minecraft, paper, mirai, keyi, gale, minecraft-server-software, java, minecraft-performance
Last push: 2026-09-02T15:33:24+00:00

## Health v2 (maintenance only)
Score: 100/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 100, release rhythm 100, longevity 100
- inputs: {"age_days": 1553, "days_push": 0, "days_rel": 1, "gap_med": 26, "n_releases_24m": 12}
- flags: no_license
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1072, forks 204 (observed 2026-09-03T02:15:08.558528+00:00)

## What it is
Leaf is a high-performance fork of the Paper Minecraft server software, balancing performance optimizations, vanilla mechanics, and stability. It adds async pathfinding, mob spawning, and entity tracking, a linear region file format, extensive YAML configuration with hot reload, and full Spigot/Paper plugin compatibility.

## Use cases
- run a high-performance Minecraft server with less lag
- host a large Minecraft network under heavy player load
- replace Paper with a faster drop-in server that keeps plugins working
- reduce Minecraft server disk usage with linear region files
- tune server performance with fine-grained YAML config and hot reload
- allow non-ASCII characters in Minecraft usernames
- track server errors in detail with integrated Sentry

## When to choose
- you run a Paper/Spigot server and want better performance without losing plugin compatibility
- you operate a large-scale or high-load Minecraft network
- you want configurable optimizations while preserving vanilla gameplay behavior
- you want async entity operations and modern dependency updates

## When to avoid
- you need a vanilla or Forge/Fabric modded server with mod support
- you require strict upstream Paper behavior or official Paper support
- you are unwilling to take backups when switching server software
- you need a license-guaranteed fork (license is non-standard)

## Facets
- artifact type: application
- maturity: active
- function: game-engine, developer-tools, configuration-management, monitoring
- domain: gaming-tools, performance, self-hosted
- platform: jvm, windows, self-hosted
- tags: minecraft-server, paper-fork, server-software, performance-optimization, spigot-plugins, vanilla-mechanics, minecraft, linux, macos

## Member repositories
- Winds-Studio/Leaf (main) score 100

## Provenance
- Observed fields: from GitHub, fetched 2026-09-03T02:15:08.558528+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T06:55:47.552993+00:00, confidence not recorded.
  - readme: https://github.com/Winds-Studio/Leaf (fetched 2026-09-03T02:15:08.558528+00:00, sha c4e79133fca0)
  - homepage: https://www.leafmc.one (fetched 2026-08-29T12:57:38.463370+00:00, sha 7843562525ab)
  - site_page: https://www.leafmc.one/en/docs/getting-started (fetched 2026-08-29T12:57:38.472491+00:00, sha 094c1c5b6671)
  - site_page: https://www.leafmc.one/en/docs/config/leaf-global (fetched 2026-08-29T12:57:38.474230+00:00, sha 28e6d97dde0a)
  - site_page: https://www.leafmc.one/en/docs/dev/api (fetched 2026-08-29T12:57:38.476192+00:00, sha 24d51c258dd7)
- Data as of 2026-08-30T08:39:29.467469+00:00.