# spigot插件伺服器建立教學

本篇指南將帶領你一步步建立一個專業的 Minecraft Spigot 插件伺服器，並透過內網穿透技術與 Geyser 插件，讓 Java 版與基岩版（Android、IOS）的玩家能夠跨平台一同冒險

## 一、環境準備

### 安裝OpenJDK 21

依照電腦系統與CPU架構選擇適當的[OpenJDK 21](https://learn.microsoft.com/zh-tw/java/openjdk/download#openjdk-21)版本
:::warning
注意！！！
請不要安裝最新的OpenJDK 25
請在OpenJDK 21的區塊進行挑選安裝檔
官方建議的最佳版本仍是 Java 21
使用 OpenJDK 25 可能導致相容性風險、編譯限制、報錯或要求降級
:::


| 安裝 | 完成 |
|:-----:|:------:|
|  |  |

## 二、獲取伺服器核心
### 1.下載BuildTools建置工具

至[Jenkins](https://hub.spigotmc.org/jenkins/job/BuildTools/)下載最新版本的`BuildTools.exe`或`BuildTools.jar`

### 2.執行BuildTools建置工具

:::info
由於版權法律限制，Spigot 官方不直接提供 spigot.jar 下載，玩家必須使用 BuildTools 在本地編譯。
:::

在下載完成後執行`BuildTools.exe`或`BuildTools.jar`
選擇要架設的伺服器版本或選擇**latest**
按下右下角的橘色**Compile**按鈕開始編譯
:::info
編譯過程會下載數萬個程式碼檔案並進行封裝，根據電腦 CPU 效能與網速，約需 5~15 分鐘。請耐心等待，直到跳出 Success! 字樣。
:::
編譯完成後，資料夾內會出現一個 spigot-1.xx.x.jar 的檔案，這就是你的伺服器核心

## 三、Geyser & Floodgate 插件下載

:::info
如果沒有基岩版玩家可以跳過此教學區塊
:::

1. [Geyser](https://geysermc.org/download?project=geyser)：負責將基岩版的封包轉換為 Java 版能理解的語言
2. [Floodgate](https://geysermc.org/download?project=floodgate)：允許基岩版玩家不需要購買 Java 版正版帳號，即可安全地進入伺服器

| Geyser | Floodgate |
|:--------:|:---------:|
|||

:::warning
注意！！！
請確保下載的是 Spigot/Paper 版本。如果你下載成 Velocity 或 BungeeCord 版本，伺服器將無法讀取。
:::

## 四、開放外網連線：Playit內網穿透

### 1.Playit下載

:::info
因為大多數人的家中或宿舍網路沒有實體公網 IP，透過內網穿透軟體可以建立一條「隧道」，繞過路由器的封鎖，直接讓外網存取你的伺服器。
:::

先到[Playit.gg](https://playit.gg/login/create)官網註冊帳號
註冊完成後到[下載頁面](https://playit.gg/download/windows)點選上面的橘色按鈕下載軟體並安裝

| 安裝 | 完成 |
|:-----:|:------:|
|||

### 2.Playit通道申請

1. 在開始選單找到Playit並執行軟體
2. 按住Ctrl並點選視窗中的網址
3. 跳轉至瀏覽器後等待倒數並點選**Continue**按鈕接著點選**Add Agent**按鈕
4. 最後點選右下角的**Create Tunnel**按鈕

:::warning
注意！！！
請不要讓瀏覽器將網頁翻譯成中文或其他語言
否則可能導致無限倒數
:::

| | |
|:-----:|:------:|
|||

:::info
在建立 Tunnel 時，Java 版要選 **Minecraft Java**，基岩版選 **Minecraft Bedrock**
:::
| Java | 基岩 |
|:-----:|:------:|
|||

點擊**Add Tunnel**後等待幾秒
下拉到下方區塊即可看到分配到的IP與連接埠(Port)


:::info
以圖片格式為例
在Java版可以輸入`virtual-oriental.gl.at.ply.gg`或是`31.ip.gl.ply.gg:19000`都可以
但在基岩版只能輸入`31.ip.gl.ply.gg`並在下方填入連接埠(Port)`19000`
:::warning
注意！！！
如果需要同時讓Java版與基岩版玩家進入需要分別註冊兩條通道
無法僅依靠變更連接埠或共用ip
:::

## 五、伺服器建立與啟動

1. 在文件或其他地方建立一個新資料夾（例如：Minecraft_Server）
2. 將BuildTools編譯出來的伺服器核心檔案放入資料夾
3. 雙擊執行核心啟動伺服器
4. 接下來資料夾中會出現一些檔案
5. 伺服器會因為沒有同意Mojang的使用者規範自動暫停

### 1.eula修改

1. 接著找到**eula.txt**並用記事本等文字編輯軟體打開
2. 將原始文字的`eula=false`改成`eula=true`並儲存，表示同意 Mojang 的使用者規範

#By changing the setting below to TRUE you are indicating your agreement to our EULA (https://aka.ms/MinecraftEULA).
#Mon Feb 09 19:14:32 CST 2026
eula=true

### 2.安裝插件

1. 再次執行伺服器核心檔案啟動第二次伺服器
2. 等待右側訊息欄輸出`Done (xx.xxxs)! For help, type "help"`
3. 在右下角輸入**stop**並按下**Enter**關閉伺服器
4. 將**Geyser**與**Floodgate**插件放入**plugins**資料夾
5. 重新啟動伺服器，現在你的伺服器已經支援 Java 與基岩版玩家一同遊玩了！

:::success
## 恭喜你！
你的 Spigot 插件伺服器已經完全架設完成。現在你可以自由地在 plugins 資料夾中加入各種有趣的插件，與你的朋友們在同一個世界中盡情探索！
:::