SpigotMC-AutoBuild

Appearance

开始使用 ​

SpigotMC-AutoBuild 项目提供了多个版本的 Spigot 服务端构建文件，可以直接下载并启动。

📥 下载服务端文件 ​

  1. 访问 下载 页面。

  2. 选择所需的 Spigot 版本，下载对应的 spigot-<version>.jar 文件和 .sha256 校验文件。

  3. （可选）验证下载文件的完整性：

    bash
    sha256sum -c spigot-<version>.jar.sha256

如果输出显示 OK，则文件未被篡改。

☕ 安装合适的 Java 版本 ​

不同版本的 Spigot 对应不同的 Java 版本要求。请根据下表安装适用于你所选 Spigot 版本的 Java 版本：

Spigot 版本推荐 Java 版本
1.8.8Java 8
1.9.x – 1.12.2Java 8
1.13 – 1.13.2Java 8
1.14 – 1.15.2Java 8
1.16 – 1.16.5Java 8
1.17 – 1.17.1Java 16
1.18 – 1.18.2Java 17
1.19 – 1.19.4Java 17
1.20 – 1.20.4Java 17
1.20.5 – 1.20.6Java 21
1.21 – 1.21.1Java 21 – 22

请确保安装了对应版本的 Java，并配置好环境变量，以便在命令行中使用 java 命令。

🛠️ 启动服务端 ​

  1. 在服务器文件夹中，创建一个启动脚本：

    • Windows（创建 start.bat 文件）：

      bat
      @echo off
java -Xms2G -Xmx2G -jar spigot-<version>.jar nogui
pause

    • Linux/macOS（创建 start.sh 文件）：

      bash
      #!/bin/bash
java -Xms2G -Xmx2G -jar spigot-<version>.jar nogui

      然后赋予执行权限：

      bash
      chmod +x start.sh

  2. 首次启动服务器：

    bash
    java -Xms2G -Xmx2G -jar spigot-<version>.jar nogui

首次运行会生成 eula.txt 文件，并提示你同意 Minecraft EULA。

  1. 打开 eula.txt 文件，将 eula=false 修改为 eula=true，保存并关闭文件。

  2. 再次运行启动脚本，服务器将开始启动并生成必要的文件。

⚙️ 配置服务器 ​

  • 编辑 server.properties 文件，设置服务器名称、端口、最大玩家数等参数。

  • 将插件 .jar 文件放入 plugins 文件夹，以扩展服务器功能。

🧠 Java 内存分配参数指导 ​

为了确保服务器的稳定运行，合理分配 Java 堆内存非常重要。以下是一些建议：

  • 基础参数：
bash
  java -Xms2G -Xmx4G -jar spigot-<version>.jar nogui

其中，-Xms 表示初始堆内存大小，-Xmx 表示最大堆内存大小。根据服务器的实际需求和物理内存大小进行调整。

  • 高级参数（Aikar's Flags）：
bash
  java -Xms4G -Xmx4G -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 -XX:MaxTenuringThreshold=1 \
  -jar spigot-<version>.jar nogui

这些参数优化了垃圾回收器的行为，适用于大型服务器或需要高性能的场景。

请注意，分配的内存不应超过系统物理内存的一半，以避免系统不稳定。

🧩 常见问题解答 ​

Q: 启动时提示 Java 版本不兼容？

A: 请确保安装了适用于所选 Spigot 版本的 Java 版本。例如，Spigot 1.17 需要 Java 16，1.18 及以上版本推荐使用 Java 17。

Q: 如何关闭服务器？

A: 在服务器控制台中输入 stop 命令，然后按回车键，服务器将安全关闭。