kouleen/paper repository overview

⁠🚀 kouleen/paper - High Performance Minecraft Server Image

⁠Introduction

kouleen/paper is a high-performance Paper Minecraft server image built on Alpine Linux + OpenJDK. Optimized for Minecraft: Java Edition servers, it supports plugins, high concurrency, and low lag, ready to use right out of the box. Ideal for survival, minigame, and plugin-based servers.

⁠Core Features

✅ Vanilla Paper Core – Unmodified, stable, compatible with most plugins
✅ Ultra Lightweight – Small image size, fast startup, low resource usage
✅ Performance Optimized – Built-in tuned JVM flags for smooth gameplay
✅ Auto EULA Accept – No manual configuration required to start
✅ Data Persistence – Worlds, configs, and plugins preserved across restarts
✅ Correct Timezone – Defaults to Asia/Shanghai (Beijing Time)
✅ Long-Term Support – Regular updates to latest Paper builds

⁠Default Port

• 25565: Default Minecraft server port

⁠Quick Start (Recommended One-Command Deployment)

docker run -d \
  --name mc-server \
  --restart always \
  -p 25565:25565 \
  -v paper-volumes:/app \
  kouleen/paper:tagname

⁠Full Mount (Worlds + Plugins + Configs)

docker run -d \
  --name mc-server \
  --restart always \
  -p 25565:25565 \
  -v paper-volumes:/app \
  -v ./mc-plugins:/app/plugins \
  kouleen/paper:tagname

⁠Container Directory Structure

/app              # Server root directory
/app/world        # Main world folder
/app/plugins      # Plugins directory
/app/server.properties  # Main server configuration

⁠Common Management Commands

# Attach to server console
docker attach mc-server

# Detach console (without stopping server)
Ctrl + P + Q

# View real-time logs
docker logs -f mc-server

# Restart server
docker restart mc-server

# Stop / remove container
docker stop mc-server
docker rm -f mc-server

⁠Use Cases

• Minecraft Java Edition survival / creative servers
• Minigame networks & community servers
• Private or public cloud-hosted servers
• Compatible with popular plugins: Essentials, LuckPerms, ViaVersion, CoreProtect, etc.

⁠FAQ

⁠Q1: Why is the first startup slow?

The server automatically downloads the official Paper core on first run. Subsequent starts are instant.

⁠Q2: Will my world data be lost?

No. Mount the /app directory to persist all data permanently, even if the container is deleted.

⁠Q3: Does it support Forge / Fabric / Mods?

No. This is a Paper plugin-only server. For modded servers, use dedicated mod images.

⁠Q4: Can players connect directly over the internet?

Yes. Simply expose port 25565 and connect using your server IP.

⁠Author Info

🐳 Docker Hub: kouleen⁠
📦 Image URL: kouleen/paper⁠

⁠💡 Enjoy smooth, lag-free performance! If you like this image, please leave a ⭐ Star!

⁠🚀 kouleen/paper - 高性能 Minecraft 服务端镜像

⁠镜像简介

kouleen/paper 是基于 **Alpine Linux + OpenJDK ** 构建的 Paper 高性能 Minecraft 服务端镜像。 专为《我的世界》Java版服务器优化，支持插件、高并发、低卡顿，开箱即用，适合生存服、小游戏服、模组服搭建。

⁠核心特性

✅ Paper 原版核心：无魔改、稳定、兼容绝大多数插件

✅ 超轻量：Alpine 底层，镜像体积小、启动快

✅ 性能优化：内置 JVM 优化参数，流畅不卡顿

✅ 自动运行：启动自动接受 EULA，无需手动配置

✅ 数据持久化：地图、配置、插件重启不丢失

✅ 时区正常：默认北京时间，日志时间准确

✅ 长期维护：持续更新 Paper 最新构建版本

⁠默认端口

• 25565：Minecraft 游戏主端口

⁠快速使用（推荐一键启动）

docker run -d \
  --name mc-server \
  --restart always \
  -p 25565:25565 \
  -v paper-volumes:/app \
  kouleen/paper:tagname

⁠完整挂载（地图+插件+配置）

docker run -d \
  --name mc-server \
  --restart always \
  -p 25565:25565 \
  -v paper-volumes:/app \
  -v ./mc-plugins:/app/plugins \
  kouleen/paper:tagname

⁠容器内目录结构

/app              # 服务端根目录
/app/world        # 地图存档
/app/plugins      # 插件目录
/app/server.properties  # 配置文件

⁠常用管理命令

# 进入控制台执行指令
docker attach mc-server

# 退出控制台（不关闭服务）
Ctrl + P + Q

# 查看日志
docker logs -f mc-server

# 重启服务器
docker restart mc-server

# 停止/删除
docker stop mc-server
docker rm -f mc-server

⁠适用场景

• Minecraft Java 版生存服、创造服
• 小游戏服务器、公会服务器
• 本地/云服务器开服
• 支持插件：Essentials、LuckPerms、ViaVersion、CoreProtect 等

⁠常见问题

⁠Q1：第一次启动为什么慢？

第一次会自动下载 Paper 核心，后续秒启动。

⁠Q2：地图数据会丢失吗？

挂载 /data 目录后永久保存，删容器都不会丢。

⁠Q3：支持 Forge / Fabric / Mod？

此为纯 Paper 插件服，Mod 服请使用对应镜像。

⁠Q4：公网可以直接进服吗？

开放 25565 端口后，使用服务器 IP 直接连接。

⁠作者信息

🐳 Docker Hub: kouleen⁠ 📦 镜像地址: kouleen/paper⁠

⁠💡 开服流畅不卡顿，好用欢迎点个 ⭐ Star！