网硕互联帮助中心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：
# 更新系统
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. 创建服务器目录和用户
# 创建专用用户
sudo useradd -m -s /bin/bash mcpaper
sudo su – mcpaper
# 创建服务器目录
mkdir ~/paper-server && cd ~/paper-server
3. 安装 screen（用于后台运行）
sudo apt install -y screen wget curl
安装步骤
1. 下载 Paper 核心
访问 PaperMC 官网 获取最新版本，或使用 API 直接下载：
# 下载 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 并首次启动
# 首次启动生成配置文件
java -jar paper.jar nogui
# 同意许可协议
sed -i 's/eula=false/eula=true/' eula.txt
# 确认修改
cat eula.txt
3. 创建启动脚本
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 目录
mkdir -p ~/paper-server/plugins
核心配置
server.properties 配置
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，关键配置项：
# 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（基础管理插件）
# 下载 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（地图编辑）
# 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（方块日志与回滚）
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（权限管理插件）
# 下载 LuckPerms（Bukkit 版）
wget "https://download.luckperms.net/1549/bukkit/loader/LuckPerms-Bukkit-5.4.141.jar" \\
-O ~/paper-server/plugins/LuckPerms.jar
LuckPerms 配置示例：
# 服务器内执行（给默认组赋予基础权限）
/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
定时备份脚本
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 开机自启
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
服务管理命令
# 查看服务状态
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 社区。
评论前必须登录！
注册