---
# System prepended metadata

title: spigot插件伺服器建立教學

---

# 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 可能導致相容性風險、編譯限制、報錯或要求降級
:::

![OpenJDK下載頁面](https://hackmd.io/_uploads/Syuf6mvPZe.png)

|  安裝  |  完成  |
|:-----:|:------:|
| ![OpenJDK安裝](https://hackmd.io/_uploads/By-qp7vDbe.png) | ![OpenJDK完成](https://hackmd.io/_uploads/r1oeC7vPbe.png) |

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

至[Jenkins](https://hub.spigotmc.org/jenkins/job/BuildTools/)下載最新版本的`BuildTools.exe`或`BuildTools.jar`
![BuildTools下載頁面](https://hackmd.io/_uploads/Sk141NwDZg.png)

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

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

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

## 三、Geyser & Floodgate 插件下載

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

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

|  Geyser  | Floodgate |
|:--------:|:---------:|
|![Geyser下載頁面](https://hackmd.io/_uploads/ByqPLVvD-x.jpg)|![Floodgate下載頁面](https://hackmd.io/_uploads/H1-uUEDP-x.jpg)|

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

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

### 1.Playit下載

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

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

|  安裝  |  完成  |
|:-----:|:------:|
|![Playit安裝](https://hackmd.io/_uploads/BkyTKNDvWl.png)|![Playit完成](https://hackmd.io/_uploads/S13TtNPD-x.png)|

### 2.Playit通道申請

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

:::warning
注意！！！
請不要讓瀏覽器將網頁翻譯成中文或其他語言
否則可能導致無限倒數
:::
![Playit畫面](https://hackmd.io/_uploads/ryTO5VwwWe.png)

|    |    |
|:-----:|:------:|
|![Playit](https://hackmd.io/_uploads/SyRpjNvDbe.jpg)|![Playit](https://hackmd.io/_uploads/ryhj2Nwv-g.jpg)|

![image](https://hackmd.io/_uploads/SkngA4vPWl.png)
:::info
在建立 Tunnel 時，Java 版要選 **Minecraft Java**，基岩版選 **Minecraft Bedrock**
:::
| Java | 基岩 |
|:-----:|:------:|
|![Java](https://hackmd.io/_uploads/SJi4AVvPWx.png)|![基岩](https://hackmd.io/_uploads/rJkL0EDDZe.png)|

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

![Playit儀表板](https://hackmd.io/_uploads/r1j0AVPwWe.png)

:::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 的使用者規範

```txt
#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 資料夾中加入各種有趣的插件，與你的朋友們在同一個世界中盡情探索！
:::