Downloads API - Server Software

Downloads API - Server Software Compatibility

Learn about supported server software types and how to choose the right plugin version for your server.

Overview

Statsly supports a wide range of Minecraft server software, organized into three main categories:

Normal Servers - Traditional Minecraft servers
Folia Servers - Regionized multithreading servers
Proxy Servers - Network proxy servers

Normal Servers

Traditional Minecraft servers that run on a single thread per world.

PaperMC

High-performance Minecraft server with optimizations and bug fixes.

Recommended for: Most server owners
Performance: Excellent
Compatibility: High
Download: /api/plugin-versions/download/latest/PaperMC

Spigot

Popular Minecraft server software with plugin support.

Recommended for: Standard servers
Performance: Good
Compatibility: High
Download: /api/plugin-versions/download/latest/Spigot

Bukkit

Original Minecraft server API implementation.

Recommended for: Legacy servers
Performance: Standard
Compatibility: High
Download: /api/plugin-versions/download/latest/Bukkit

Purpur

Paper fork with additional features and optimizations.

Recommended for: Advanced users
Performance: Excellent
Compatibility: High
Download: /api/plugin-versions/download/latest/Purpur

Quilt

Mod loader with server support.

Recommended for: Modded servers
Performance: Good
Compatibility: Moderate
Download: /api/plugin-versions/download/latest/Quilt

LeafMC

Paper fork optimized for performance.

Recommended for: Performance-focused servers
Performance: Excellent
Compatibility: High
Download: /api/plugin-versions/download/latest/LeafMC

Folia Servers

Servers with regionized multithreading for improved performance.

Folia

Paper fork with regionized multithreading.

Recommended for: Large servers with high player counts
Performance: Excellent (multithreaded)
Compatibility: High
Download: /api/plugin-versions/download/latest/Folia

Note: Folia servers require special plugin versions that support multithreading.

CanvasMC

Folia fork with additional optimizations.

Recommended for: Advanced Folia users
Performance: Excellent (multithreaded)
Compatibility: High
Download: /api/plugin-versions/download/latest/CanvasMC

Proxy Servers

Network proxy servers for connecting multiple backend servers.

BungeeCord

Popular proxy server for Minecraft networks.

Recommended for: Network setups
Performance: Good
Compatibility: High
Download: /api/plugin-versions/download/latest/BungeeCord

Waterfall

BungeeCord fork with performance improvements.

Recommended for: Performance-focused networks
Performance: Excellent
Compatibility: High
Download: /api/plugin-versions/download/latest/Waterfall

Velocity

Modern, high-performance proxy server.

Recommended for: Modern network setups
Performance: Excellent
Compatibility: High
Download: /api/plugin-versions/download/latest/Velocity

Java Version Compatibility

Plugin versions are also filtered by Java version:

Java 8

Status: Legacy support
Recommended: No (use Java 11+)
Use Case: Older servers that cannot upgrade

Java 11

Status: LTS version
Recommended: Yes (if Java 17+ unavailable)
Use Case: Servers running Java 11

Java 17

Status: Recommended LTS version
Recommended: Yes (best choice)
Use Case: Most modern servers

Java 21

Status: Latest LTS version
Recommended: Yes (if available)
Use Case: Servers running latest Java

Choosing the Right Version

Step 1: Identify Your Server Software

Check your server’s startup logs or configuration to identify the server software type.

Step 2: Check Your Java Version

Run java -version to check your Java version.

Step 3: Download the Appropriate Version

Use the Downloads API with your server software and Java version:

curl -O -J "https://api.statsly.org/api/plugin-versions/download/latest/PaperMC/17"

Version Compatibility

Cross-Compatibility

Some plugin versions support multiple server software types. Check the serverSoftware array in version metadata to see all supported types.

Version Matching

Plugin versions use wildcard matching for Minecraft versions:

1.20.x matches 1.20.1, 1.20.5, etc.
1.x matches 1.19, 1.20, 1.21, etc.
Exact versions like 1.20.1 match only that version

Migration Guide

Switching Server Software

If you’re switching server software:

Download the appropriate plugin version
Stop your server
Remove the old plugin
Install the new plugin version
Restart your server

Upgrading Java Version

If you’re upgrading Java:

Ensure your server software supports the new Java version
Download a plugin version compatible with the new Java version
Update your server’s Java installation
Restart your server

Troubleshooting

Plugin Not Loading

If the plugin doesn’t load:

Verify server software compatibility
Check Java version compatibility
Review server logs for errors
Try a different plugin version

Compatibility Issues

If you experience compatibility issues:

Check server software version
Verify Java version
Review plugin changelog
Contact support if needed

Support

For compatibility questions: