papermc/folia

Fork of Paper which adds regionised multithreading to the dedicated server.

View on GitHub ↗Jump to charts ↓Open shareable report

Summary Information

Updated 51 minutes ago
Type:Server / PlatformCategory(s):Games, Mods & EmulatorsMedia, Graphics & Games
Added to GitGenius on September 15th, 2026
Created on February 20th, 2023
Open Issues & Pull Requests: 77 (+0)
GitHub issues: Enabled
Number of forks: 620
Total Stargazers: 4,369 (+0)
Total Subscribers: 93 (+0)

Repository Insights (GitGenius)

Median issue/PR response: 8.3 hours
Mean response time: 30.8 days
90th percentile: 80.1 days
Tracked items: 212

Most active contributors

Sign in to see contributor activity.

How this project is maintained

About 19% of issues opened in the past year have never received a reply. 100% of open issues come from outside the core team, so the backlog reflects real-world use rather than internal planning. Work labelled "type: feature" is answered fastest, typically in about an hour, while "resolution: invalid" waits about 7 days. 67% of issues opened in the past year have been closed, leaving a working backlog. Three people close 66% of everything that gets resolved.

Charts & Analytics

Fetching additional details & charts...

Issue Activity (beta)

Open issues: 47
New in 7 days: 2
Closed in 7 days: 0
Avg open age: 450 days
Stale 30+ days: 43
Stale 90+ days: 37

Recent activity

Opened in 7 days: 2
Closed in 7 days: 0
Comments in 7 days: 1
Events in 7 days: 3

Top labels

  • status: needs triage (130)
  • type: bug (127)
  • type: feature (24)
  • resolution: invalid (20)
  • resolution: won't fix (10)
  • resolution: duplicate (9)
  • version: 1.20.4 (9)
  • version: 1.20.2 (6)

Most active issues this week

Detailed Description

Folia is a Minecraft server software that adds regionalized multithreading to a Paper-based dedicated server.

Minecraft servers traditionally process all game logic on a single thread, creating a bottleneck that limits performance as server complexity grows. Folia addresses this by dividing the game world into regions and processing each region on its own thread, allowing multiple regions to execute simultaneously. This regionalized approach means that entities and chunks within a region stay together on the same thread, avoiding the synchronization overhead that would come from splitting individual chunks across threads. The tool maintains compatibility with the Paper API while enabling servers to utilize multiple CPU cores more effectively.

Server administrators running large or heavily-modded Minecraft servers should consider Folia if they are experiencing single-threaded performance limitations. The project suits servers with geographically distributed player bases or high entity counts, where spreading load across regions can meaningfully improve tick rates. Administrators should be aware that some plugins designed for single-threaded Paper may require updates to work correctly with Folia's multithreaded environment, particularly those that make assumptions about thread safety or timing. The tool is positioned as an alternative to Paper for scenarios where CPU performance is the primary constraint.

The project shows active development with regular commits addressing both new features and bug fixes. Work spans across multiple areas including region management, threading infrastructure, and API compatibility. The codebase receives ongoing refinement to handle edge cases in multithreaded execution and to maintain stability across diverse server configurations.