Skip to content

Paper开服教程


📦 一、环境准备

  1. 安装Java

    • 版本选择:根据Minecraft版本匹配Java版本:
      • 1.16.5及以前 → Java 8
      • 1.17.x → Java 16
      • 1.18+ → Java 17/18(推荐Java 17)
    • 下载地址
      • Java 17官方下载(当前主流版本)
      • 配置环境变量(Windows:JAVA_HOME指向安装路径,Path添加%JAVA_HOME%\bin)。
  2. 下载Paper服务端

    • 访问PaperMC官网,选择与客户端匹配的版本(如1.20.2)。

    • 或直链下载(示例):

      bash
      wget https://api.papermc.io/v2/projects/paper/versions/1.20.2/builds/280/downloads/paper-1.20.2-280.jar

⚙️ 二、服务端配置

  1. 创建启动脚本

    • Windows:新建start.bat文件,写入以下内容:

      batch
      @echo off
      java -Xmx4G -Xms2G -jar paper-1.20.2-280.jar nogui
      pause
      • -Xmx4G:最大内存4GB,-Xms2G:初始内存2GB(根据服务器配置调整)。
      • 文件名替换为实际下载的JAR文件名。
    • Linux:使用Screen会话后台运行:

      bash
      screen -S mc  # 创建会话
      java -Xmx4G -Xms2G -jar paper-1.20.2-280.jar nogui
      • 退出会话按Ctrl+A+D,重新进入用screen -r mc
  2. 首次启动与协议同意

    • 运行启动脚本,首次会生成文件后自动关闭。
    • 打开生成的eula.txt,将eula=false改为eula=true
  3. 关键配置(server.properties)
    用文本编辑器打开server.properties,修改以下参数:

    properties
    motd=My Paper Server  # 服务器描述
    online-mode=false     # 关闭正版验证(非正版玩家必改)
    difficulty=normal     # 游戏难度
    max-players=20        # 最大玩家数
    view-distance=10      # 视距(降低可提升性能)
    simulation-distance=8 # 模拟距离(优化性能)
    server-port=25565     # 端口号(默认)

🚀 三、启动与连接

  1. 运行服务器

    • 再次执行启动脚本(Windows双击start.bat,Linux在Screen会话中运行命令)。
    • 控制台显示Done (XXs)!表示启动成功。
  2. 本地连接

    • 客户端进入多人游戏 → 添加服务器 → 地址填localhost:25565
  3. 外网联机(端口映射)

    • 有公网IP:路由器映射TCP端口25565。
    • 无公网IP:使用内网穿透工具:
      • 棉花糖映射(Windows工具)。
      • NAT123(配置内网25565→外网端口)。
      • 雨云NAT服务器:管理面板创建端口映射。

🛠️ 四、进阶管理

  1. 插件安装

    • 下载插件(如AuthMe登录、EssentialsX基础功能)放入plugins文件夹,重启服务器生效。
  2. 常见问题

    • 启动失败:检查Java版本匹配性,确认eula.txt已修改。
    • 玩家无法加入
      • 关闭防火墙或放行25565端口。
      • 确认online-mode=false(非正版服)。
    • 性能优化:降低view-distancesimulation-distance,或添加性能插件(如ClearLag)。

文档服务由vitepress.dev提供.