Minecraft Paper 服务器插件管理教程：高性能核心与主流插件配置指南

Paper 是目前最受欢迎的 Minecraft Java 版服务端核心之一，在原版 Spigot 基础上进行了大量性能优化，支持更高的 TPS（服务器每秒刻数）和更丰富的插件生态。本教程将带你完成 Paper 服务器的安装部署，并配置 EssentialsX、WorldEdit、CoreProtect、LuckPerms 等核心插件。

服务器配置

Paper 服务器对于 20 人以内的小型社区，2 核 4GB 内存就能流畅运行。推荐选择雨云服务器-rainyun.com 的 2 核 4GB 机型 ，注册填优惠码 2026off 领 5 折优惠券，该配置可稳定支撑 20 人以内同时在线，性价比极高。

推荐规格：

CPU：2 核
内存：4GB RAM
硬盘：SSD 30GB+
系统：Ubuntu 22.04 LTS
带宽：3Mbps+

前置准备

1. 安装 Java 21

Paper 1.20+ 需要 Java 21：

bash 复制代码

# 更新系统
sudo apt update && sudo apt upgrade -y

# 安装 Java 21
sudo apt install -y openjdk-21-jre-headless

# 验证版本
java -version
# openjdk version "21.0.3" 2024-04-16

2. 创建服务器目录和用户

bash 复制代码

# 创建专用用户
sudo useradd -m -s /bin/bash mcpaper
sudo su - mcpaper

# 创建服务器目录
mkdir ~/paper-server && cd ~/paper-server

3. 安装 screen（用于后台运行）

bash 复制代码

sudo apt install -y screen wget curl

安装步骤

1. 下载 Paper 核心

访问 PaperMC 官网获取最新版本，或使用 API 直接下载：

bash 复制代码

# 下载 Paper 1.21.1 最新构建
PAPER_VERSION="1.21.1"
BUILD=$(curl -s "https://api.papermc.io/v2/projects/paper/versions/${PAPER_VERSION}/builds" | python3 -c "import sys,json; builds=json.load(sys.stdin)['builds']; print(builds[-1]['build'])")
wget "https://api.papermc.io/v2/projects/paper/versions/${PAPER_VERSION}/builds/${BUILD}/downloads/paper-${PAPER_VERSION}-${BUILD}.jar" -O paper.jar

echo "Paper 下载完成，构建版本：$BUILD"

2. 同意 EULA 并首次启动

bash 复制代码

# 首次启动生成配置文件
java -jar paper.jar nogui

# 同意许可协议
sed -i 's/eula=false/eula=true/' eula.txt

# 确认修改
cat eula.txt

3. 创建启动脚本

bash 复制代码

cat > ~/paper-server/start.sh << 'EOF'
#!/bin/bash
# Paper 服务器启动脚本（2核4GB机型优化配置）
java \
  -Xms2G \
  -Xmx3G \
  -XX:+UseG1GC \
  -XX:+ParallelRefProcEnabled \
  -XX:MaxGCPauseMillis=200 \
  -XX:+UnlockExperimentalVMOptions \
  -XX:+DisableExplicitGC \
  -XX:+AlwaysPreTouch \
  -XX:G1NewSizePercent=30 \
  -XX:G1MaxNewSizePercent=40 \
  -XX:G1HeapRegionSize=8M \
  -XX:G1ReservePercent=20 \
  -XX:G1HeapWastePercent=5 \
  -XX:G1MixedGCCountTarget=4 \
  -XX:InitiatingHeapOccupancyPercent=15 \
  -XX:G1MixedGCLiveThresholdPercent=90 \
  -XX:G1RSetUpdatingPauseTimePercent=5 \
  -XX:SurvivorRatio=32 \
  -XX:+PerfDisableSharedMem \
  -Dpaper.playerconnection.keepalive=60 \
  -jar paper.jar nogui
EOF

chmod +x ~/paper-server/start.sh

4. 创建 plugins 目录

bash 复制代码

mkdir -p ~/paper-server/plugins

核心配置

server.properties 配置

bash 复制代码

cat > ~/paper-server/server.properties << 'EOF'
# 基础配置
server-port=25565
gamemode=survival
difficulty=normal
max-players=20
online-mode=true

# 视距（2核4GB建议 8~10，避免过高造成卡顿）
view-distance=10
simulation-distance=8

# 安全配置
enforce-secure-profile=true
prevent-proxy-connections=false

# 允许飞行（权限插件控制时建议开启）
allow-flight=true

# 世界设置
level-name=world
spawn-protection=16
max-tick-time=60000
EOF

Paper 性能配置（paper-global.yml）

Paper 首次运行后会生成 config/paper-global.yml，关键配置项：

yaml 复制代码

# config/paper-global.yml 关键段
chunk-loading-basic:
  autoconfig-send-distance: true
  player-max-concurrent-loads: 4.0
  server-max-concurrent-loads: 4.0

misc:
  max-joins-per-tick: 3

watchdog:
  early-warning-delay: 10000
  early-warning-every: 5000

进阶功能

安装 EssentialsX（基础管理插件）

bash 复制代码

# 下载 EssentialsX（从 GitHub Releases 获取最新版）
wget "https://github.com/EssentialsX/Essentials/releases/latest/download/EssentialsX-2.21.0.jar" \
  -O ~/paper-server/plugins/EssentialsX.jar

# 同时安装 EssentialsXChat（聊天格式扩展）
wget "https://github.com/EssentialsX/Essentials/releases/latest/download/EssentialsXChat-2.21.0.jar" \
  -O ~/paper-server/plugins/EssentialsXChat.jar

EssentialsX 常用命令：

/essentials reload --- 重载配置
/home、/sethome、/warp --- 传送系统
/eco give <玩家> <金额> --- 经济系统
/mute、/kick、/ban --- 管理工具

安装 WorldEdit（地图编辑）

bash 复制代码

# WorldEdit for Paper（需使用 Paper 专用版本）
wget "https://modrinth.com/plugin/worldedit/version/latest/download" \
  -O ~/paper-server/plugins/WorldEdit.jar

常用 WorldEdit 命令：

复制代码

//wand          --- 获取选区工具（斧头）
//set stone     --- 将选区填充为石头
//copy          --- 复制选区
//paste         --- 粘贴选区
//undo          --- 撤销上一次操作

安装 CoreProtect（方块日志与回滚）

bash 复制代码

wget "https://github.com/PlayPro/CoreProtect/releases/latest/download/CoreProtect.jar" \
  -O ~/paper-server/plugins/CoreProtect.jar

CoreProtect 核心命令：

复制代码

/co inspect     --- 进入检查模式（右键方块查看操作记录）
/co rollback u:玩家名 t:1h  --- 回滚指定玩家 1 小时内的操作
/co lookup u:玩家名 t:24h  --- 查看 24 小时内的操作日志
/co purge t:30d            --- 清理 30 天前的日志

安装 LuckPerms（权限管理插件）

bash 复制代码

# 下载 LuckPerms（Bukkit 版）
wget "https://download.luckperms.net/1549/bukkit/loader/LuckPerms-Bukkit-5.4.141.jar" \
  -O ~/paper-server/plugins/LuckPerms.jar

LuckPerms 配置示例：

bash 复制代码

# 服务器内执行（给默认组赋予基础权限）
/lp group default permission set essentials.home true
/lp group default permission set essentials.sethome true
/lp group default permission set essentials.spawn true

# 创建管理员组并赋权
/lp creategroup admin
/lp group admin permission set * true
/lp user 玩家名 parent add admin

定时备份脚本

bash 复制代码

cat > ~/backup-paper.sh << 'EOF'
#!/bin/bash
BACKUP_DIR="/home/mcpaper/backups"
SERVER_DIR="/home/mcpaper/paper-server"
DATE=$(date +%Y%m%d_%H%M%S)

mkdir -p $BACKUP_DIR

# 备份世界存档和插件配置
tar -czf $BACKUP_DIR/paper_backup_$DATE.tar.gz \
  $SERVER_DIR/world \
  $SERVER_DIR/world_nether \
  $SERVER_DIR/world_the_end \
  $SERVER_DIR/plugins

# 清理 7 天前的旧备份
find $BACKUP_DIR -name "paper_backup_*.tar.gz" -mtime +7 -delete

echo "[$(date)] 备份完成：paper_backup_$DATE.tar.gz"
EOF

chmod +x ~/backup-paper.sh

# 每天凌晨 4 点自动备份
(crontab -l 2>/dev/null; echo "0 4 * * * /home/mcpaper/backup-paper.sh >> /home/mcpaper/backup.log 2>&1") | crontab -

日常维护

配置 systemd 开机自启

bash 复制代码

sudo tee /etc/systemd/system/mcpaper.service << 'EOF'
[Unit]
Description=Minecraft Paper Server
After=network.target

[Service]
User=mcpaper
WorkingDirectory=/home/mcpaper/paper-server
ExecStart=/home/mcpaper/paper-server/start.sh
Restart=on-failure
RestartSec=10

[Install]
WantedBy=multi-user.target
EOF

sudo systemctl daemon-reload
sudo systemctl enable mcpaper
sudo systemctl start mcpaper

服务管理命令

bash 复制代码

# 查看服务状态
sudo systemctl status mcpaper

# 查看实时日志
journalctl -u mcpaper -f

# 重启服务器
sudo systemctl restart mcpaper

# 停止服务器
sudo systemctl stop mcpaper

常见问题

Q：插件安装后不生效，日志提示 "Could not load plugin" 错误？

A：检查插件的 Paper 兼容版本，部分 Spigot 插件与 Paper 存在兼容问题。优先下载插件的 Paper 专用版本。

Q：LuckPerms 权限设置后玩家仍无法使用命令？

A：确认已执行 /lp sync 同步权限数据，并检查 essentials.txt 权限节点名称是否正确（区分大小写）。

Q：服务器 TPS 长期低于 18，出现明显卡顿？

A：可以使用 /tps 查看当前 TPS，并通过 Spark 插件（性能分析器）定位卡顿原因。常见原因包括过多实体、区块加载过慢或某个插件存在性能问题。

Q：WorldEdit 大范围操作时服务器崩溃？

A：在 WorldEdit 的 config.yml 中降低 max-blocks-per-session 值（建议 500000 以内），并开启 use-inventory-when-possible。

Q：CoreProtect 数据库越来越大怎么办？

A：定期执行 /co purge t:30d 清理 30 天前的日志，或在 config.yml 中设置自动清理间隔。

Paper 服务器凭借其出色的性能优化和丰富的插件生态，是搭建 Minecraft 生存、RPG 等多种玩法服务器的首选方案。如果你需要一台稳定可靠的云服务器来运行 Paper 服务端，雨云服务器-rainyun.com 的 2 核 4GB 机型完全够用，注册填写优惠码 2026off 可获得 5 折优惠券，让你以更低成本运营一个属于自己的 Minecraft 社区。