立即試用（Minecraft 測試伺服器）

「立即試用」會啟動一台裝好你專案的真正 Minecraft 伺服器，專門給你一個人用。你用自己的遊戲加入，測試插件、腳本或資料包，時間到了伺服器就會自動消失。

#可以試用什麼

Fabric 和 Forge 模組、Folia 和 BungeeCord 專案目前還無法在測試伺服器上試用。

插件和 Skript 專案也可以交給 Codexe 的測試玩家檢查，就在同一個視窗的測試分頁：請參閱測試玩家的測試。

#啟動測試伺服器

測試伺服器可以從工具列的立即試用按鈕、AI 最後一則回覆下方的立即在 Minecraft 裡免費試玩，以及下載視窗（啟動測試伺服器）開啟，所以你可以在下載前先試用專案。如果今天的測試伺服器次數已經用完，它會告訴你，並顯示次數更多的方案。

1. 開啟專案。如果是插件，請先按編譯：伺服器會安裝編譯好的 jar。
2. 按在 Minecraft 裡試玩：它在聊天中最後一則回覆的下方（立即在 Minecraft 裡免費試玩）、工具列中編譯的旁邊，以及建置後下載 JAR 的旁邊。它在所有方案上都免費，還沒下載過的專案也能用：這是在 Free 方案上不用下載就能使用專案的方式。
3. 輸入你的 Minecraft 名稱，然後按啟動測試伺服器。這個名稱會以管理員（OP）身分加進你的伺服器存取權限名單，只有名單上的名稱才能加入。
4. 伺服器開機時，按鈕會顯示正在啟動伺服器…，通常要 20 到 40 秒。等它顯示伺服器在線和剩餘時間時，位址就會出現：你的時間從這時才開始計算。
5. 在 Minecraft 中：依序選擇多人遊戲、直接連線，然後貼上位址，例如 swift-otter-27.codexe.eu。不需要連接埠。如果對話框顯示的是帶連接埠的數字位址，請照原樣貼上。

不管伺服器執行哪個版本，你都可以用 1.8 到 26.3 之間任何 Minecraft Java 版加入：每台測試伺服器都裝有 ViaVersion、ViaBackwards 和 ViaRewind。

#世界

大多數專案都在沒有結構的超平坦世界中試用：它啟動很快，而且對於開箱、指令、選單或禮包來說，地形並不重要。

當專案需要真正的地形時，Codexe 會改用全新的一般世界啟動伺服器，裡面有生態域、山脈、洞穴，以及村莊和掠奪者前哨站等結構。你不需要特別要求：Codexe 會讀取專案自行決定。例如，改變世界生成的資料包（更高的山、新的生態域），或是在雪峰或掠奪者前哨站上起作用的插件，會拿到一般世界；開箱插件則維持超平坦。資料包會在世界生成前安裝，所以你看到的就是它生成的地形。生成世界會讓第一次啟動稍微久一點，主控台會說明為什麼選了一般世界。

#你的插件需要的插件

如果你的插件在 plugin.yml（depend 和 softdepend）或 paper-plugin.yml 中列出了其他插件，例如 LuckPerms、Vault、PlaceholderAPI、WorldEdit、WorldGuard 或 ProtocolLib，測試伺服器會幫你安裝它們，版本對應伺服器的 Minecraft 版本，連同它們各自需要的東西一起裝好。它們來自 Modrinth 和 Hangar。

主控台會顯示裝了什麼。付費插件（MythicMobs、ItemsAdder、Nexo...）無法自動安裝：主控台會說明這一點，需要付費插件的插件在測試伺服器上不會啟用。

#給你插件用的資料庫

如果你的插件把資料存在 MySQL，測試伺服器會給它一個專屬的 MySQL 資料庫。只要插件的 config.yml 寫著 storage-type: mysql，並有常見的 mysql: 區段（host、port、database、username、password），這就會自動進行：測試伺服器建立資料庫，把它的位址和新密碼寫進那個區段，然後啟動伺服器。完成時主控台會告訴你。

• 用 Codexe 做的插件預設使用 SQLite，這是一個不需要任何設定的檔案。想用 MySQL 的話，請在聊天中提出，插件就會以 storage-type: mysql 撰寫。
• 只有你自己的插件會拿到資料庫。為它安裝的插件（LuckPerms 和上面提到的其他插件）在測試伺服器上維持各自預設的儲存方式。
• 測試伺服器停止時，資料庫會和其他所有東西一起刪除。它最多可以容納 200 MB：超過的話伺服器會停止。

#各方案的限制

分鐘數從伺服器就緒的那一刻開始計算，不是從你按下「啟動」時開始。每個帳號同一時間只能執行一台測試伺服器。所有測試伺服器都忙碌時，請過幾分鐘再試。

#伺服器存取權限

伺服器存取權限（在帳號選單中，或執行中伺服器的玩家分頁）是可以加入你測試伺服器的人員名單。名稱的數量就是上表中方案的一台測試伺服器的人數。

• 新增 Minecraft 名稱。Codexe 會向 Mojang 查詢，顯示它是不是正版帳號以及它的頭像；沒有 Mojang 帳號的名稱會以離線玩家的身分加入，這種名稱的拼寫必須完全正確。
• 管理員（OP） 會讓該玩家在伺服器上擁有 /op。你可以隨時開啟或關閉。
• 移除會把名稱從名單上拿掉。

變更會在幾秒內同步到已經在執行的伺服器，包括移除正在線上的人；否則會套用到你下一次啟動的伺服器。名單也會顯示目前誰在線上，以及每個人上次加入的時間。

#主控台、日誌與效能

執行中伺服器的面板還有三個分頁：

• 主控台會像伺服器主控台一樣，把 Minecraft 指令送到伺服器，並顯示回應。它只是 Minecraft 主控台：停止或重新載入伺服器的指令，以及變更管理員（OP）或白名單的指令都會被拒絕（這些請使用伺服器存取權限）。每 10 秒最多 10 個指令。
• 日誌會即時顯示伺服器日誌，警告和錯誤會醒目標示，伺服器停止後還會保留日誌的最後一段。匯出日誌會把這次工作階段的日誌存成 .log 檔案，每一行都附有時間和等級，方便除錯或分享給幫你的人。
• 效能會顯示伺服器的 CPU、記憶體、TPS、線上玩家和磁碟用量，每 10 秒取樣一次。

#伺服器什麼時候會自動停止

除了時間到了之外，測試伺服器在下列情況也會停止：

• 當你離開 Codexe 時。專案頁面會告訴伺服器你還在。如果那個頁面大約一分鐘沒有開著（你關掉分頁、登出或斷線），伺服器就會停止。登出會讓它立刻停止。
• 當沒有人在玩時。連續 15 分鐘沒有人在線上，伺服器就會停止。

停止的原因會顯示在面板中：被你停止、時間到了、你離開了 Codexe、沒有人在線上，或伺服器錯誤。

如果你還沒下載專案，測試伺服器停止時下載視窗會再次開啟，讓你可以下載專案或選擇方案。這時它不會再顯示啟動另一台測試伺服器的按鈕。

#你在遊戲中時

• 你透過伺服器存取權限放進來的朋友，會以訪客身分在你的伺服器上受到歡迎，並被告知只有你可以修改專案。
• 你加入時，聊天室會出現一則 [Codexe] 訊息，說明這是測試伺服器、還剩多少時間，以及關閉時上面的一切都會刪除。
• 結束前 5 分鐘、3 分鐘、1 分鐘和 10 秒，聊天室會出現提醒。
• AI 看不到伺服器上發生的事。要修改專案，請照常在專案聊天中描述修改。
• 史萊姆不會自然生成，這樣牠們就不會在你測試時礙事。其他生物都會照常生成，用生怪蛋、生怪磚或指令產生的史萊姆仍然會出現。

#更新專案

如果測試伺服器執行期間你又編譯了一次（或修改了 Skript 檔案或資料包），對話框會顯示這台伺服器執行的是舊的建置，並提供用最新的建置重新啟動。新的伺服器會使用最新的建置，計時也會重新開始。

#會保留什麼

伺服器本身：什麼都不保留。當測試伺服器因為上述任何原因停止，或你用較新的建置重新啟動它時，伺服器和上面的一切都會刪除：世界、建築、設定變更，以及你插件的資料庫。它無法再次開啟。

Codexe 會為你和客服保留每次工作階段的簡短紀錄：開始與停止的時間和原因、Minecraft 版本、加入的玩家、從主控台送出的指令、日誌的最後一段，以及效能取樣。保留哪些內容、保留多久，請見隱私權政策第 4.8 節及其保存期限表。

#隔離與安全

• 每台測試伺服器都在隔離的環境中執行，有各自的記憶體、CPU 和時間限制，而且無法連上網際網路。呼叫網頁 API、外部資料庫或 Mojang 的程式碼，在測試伺服器上連不到它們。它唯一能連的資料庫是為你插件建立的那個，其他測試伺服器都無法開啟。
• 伺服器以離線模式執行，所以不會向 Mojang 核對玩家名稱：伺服器執行期間，任何同時知道位址和你伺服器存取權限名單上某個名稱的人都可以加入。不要把位址分享給你不想讓他進來的人。
• 主控台只能操作 Minecraft：沒有 shell、無法存取檔案，也無法在背後的機器上執行指令。
• 測試伺服器執行期間會保留什麼、保留多久，請見隱私權政策第 4.8 節。相關規則請見條款第 15.6 至 15.10 節。

#疑難排解