Skip to main content

​
Welcome to Paper

Paper is the most widely used, high-performance Minecraft server that aims to fix gameplay and mechanics inconsistencies. Built on top of Spigot and CraftBukkit, Paper provides an extensive plugin API and numerous performance optimizations that make it the preferred choice for server administrators and plugin developers.

Quick Start

Download and run Paper in minutes

Features

Explore Paper’s extensive feature set

Plugin Development

Build plugins with the Paper API

Comparison

See how Paper compares to alternatives

​
What Makes Paper Special?

Paper extends Spigot and CraftBukkit with hundreds of improvements, bug fixes, and optimizations that Mojang has not implemented in vanilla Minecraft.

​
Performance First

Paper includes extensive performance optimizations for:
  • Chunk loading and generation - Faster world loading and exploration
  • Entity processing - Optimized entity AI and pathfinding
  • Redstone mechanics - Improved redstone performance
  • Mob spawning - Efficient mob spawn algorithms
Paper requires Java 21 to run. Download it from Adoptium if you don’t have it installed.

​
Extensive Plugin API

Paper provides a comprehensive API that extends both Bukkit and Spigot:
  • Event System - Listen to and modify gameplay events
  • Adventure Components - Modern text and chat API
  • Entity AI Customization - Control mob behaviors
  • Registry Access - Work with Minecraft’s data-driven content
  • World Configuration - Per-world settings and customization

​
Getting Started

​
For Server Administrators

  1. Download Paper from the official downloads page
  2. Run the server using the Paperclip jar:
java -Xms4G -Xmx4G -jar paper.jar --nogui
  1. Configure your server by editing paper-global.yml and paper-world-defaults.yml
For detailed server administration guides, visit docs.papermc.io

​
For Plugin Developers

Add Paper to your project using Maven or Gradle: 
<repository>
    <id>papermc</id>
    <url>https://repo.papermc.io/repository/maven-public/</url>
</repository>

<dependency>
    <groupId>io.papermc.paper</groupId>
    <artifactId>paper-api</artifactId>
    <version>1.21.11-R0.1-SNAPSHOT</version>
    <scope>provided</scope>
</dependency>
Access the complete Paper API javadocs at papermc.io/javadocs

​
Key Features at a Glance

Event System

Listen to block, entity, player, world, and server events with fine-grained control

Adventure API

Modern text components, chat formatting, and messaging system

Entity AI

Customize mob goals, behaviors, and pathfinding

Registry System

Access game registries for biomes, items, enchantments, and more

Data Components

Work with Minecraft’s data-driven item and block components

World Config

Per-world configuration for spawn limits, mechanics, and optimizations

​
Community and Support

Paper is open source and community-driven. Contributions are welcome! See the Contributing Guide to get started.

​
Next Steps

Explore Features

Learn about Paper’s comprehensive feature set

Compare Options

See how Paper stacks up against other server software

Build docs developers (and LLMs) love

Get started for freeTalk to us