跳到正文
本頁目錄

給服務器安裝模組

學完這篇教程,你的服務器會運行兩個模組:讓服務器跑得更快的 LeviOptimize,以及運行腳本插件的 LegacyScriptEngine。你會在 LeviMC 模組目錄裡找模組,用 lip(界面或命令)安裝它們,確認 LeviLamina 加載了它們,並學會更新和移除模組。

你需要準備

  • 一個用 lip 裝好的、帶 LeviLamina 的服務器:見開你的第一個服務器或用命令行開服。本教程使用文件夾 D:\servers\survival。
  • 服務器處於停止狀態。服務器運行期間,lip 的界面不會改動它的文件夾;而且運行中的服務器反正要到下次啟動才會加載新模組。
  • 網絡連接。模組來自 GitHub。

在 Docker 裡運行的服務器改用變量 PACKAGES 安裝模組:見在 Docker 中運行服務器。模組的名字是一樣的。

1. 在目錄裡找模組

  1. 打開 LeviMC 模組,搜索 LeviOptimize。

  2. 打開它的頁面。看運行端:給服務器用的模組必須包含服務端。再看遊戲版本:其中必須有你的服務器的版本。

  3. 點安裝。對話框裡可以選擇變體和版本,並在“在服務端目錄中用 lip 運行:”下面給出命令,例如:

    shell
    lip install github.com/LiteLDev/LeviOptimize@1.8.1

    去掉末尾的 @<版本>,lip 會自己選出與你的服務器相配的最新版本。

安裝並不需要打開網站:lip 的「獲取模組」頁面顯示的就是同一個目錄。下面兩種方式任選其一。

2. 安裝模組

在界面裡安裝

  1. 在服務器的文件夾裡啟動 lip(cd D:\servers\survival,然後 lip)。在「主頁」上選中安裝模組,按 Enter,打開「獲取模組」頁面。
  2. 按 ↑ 直到進入搜索,輸入 optim,按 Enter。LeviOptimize 已被選中。
  3. 按 Enter,再在**安裝…**上按一次 Enter。
  4. lip 只列出與你的遊戲和 LeviLamina 相配的版本。保持選中最新版本,按 Enter。
  5. lip 給出計劃,例如 Dry run: would install LeviOptimize 1.8.1。如果這個模組還需要別的模組,它們也會列出來。在應用上按 Enter。
  6. 你應該看到 ✓ 完成。,回到列表後,LeviOptimize 前面多了一個 ✓。

安裝之後的獲取模組頁面:LeviOptimize 這一行以對勾開頭。

用命令安裝

在服務器的文件夾裡運行:

shell
lip install LeviOptimize

LeviOptimize 這樣的短名字表示 github.com/LiteLDev/LeviOptimize;其他作者的模組要用它頁面上的完整地址。lip 會把模組和它依賴的一切裝進 mods/。你應該看到:

text
✓ Packages installed successfully.

現在 lip list 會在 User-Requested 下列出 github.com/LiteLDev/LeviOptimize。

3. 安裝 LegacyScriptEngine

LegacyScriptEngine(LSE)運行用腳本語言寫的插件。它有四個變體,每種語言一個;按你的插件所用的語言安裝:

變體 語言
#lua Lua
#quickjs JavaScript(QuickJS)
#nodejs JavaScript(Node.js)
#python Python
  1. 安裝一個變體,例如 Lua:

    命令
    lip install LegacyScriptEngine#lua

    LegacyScriptEngine 的版本。變體標籤頁是 lua、quickjs、nodejs 和 python。

    lip 還會裝上 LSE 需要的 LegacyRemoteCall、LegacyMoney 和 iListenAttentively。

  2. 需要多個引擎的話,用同樣的方式逐個安裝變體。

Python 引擎需要 Python

安裝 #python 之前,先在服務器所在的機器上安裝 Python:LSE 0.16.2 及以後的版本需要 Python 3.12.10。

插件放在服務器的 plugins/ 文件夾裡。下次啟動時,LSE 會遷移它們,併為每個插件生成 LeviLamina 模組清單;再重啟一次服務器,插件就會被加載。

4. 確認模組已加載

  1. 啟動服務器:在「主頁」上選啟動服務器,或者運行 lip run。
  2. 在輸出裡找帶 [LeviLamina] 的幾行。你應該看到每個模組一行 Loaded,例如 Loaded LeviOptimize v1.8.1,還有一行數量,例如 5 mod(s) loaded(依賴也算模組)。
  3. 按 Ctrl+C 停止服務器。

如果某個模組不在其中,輸出裡會說明原因。126、127 等錯誤碼的含義見 LeviLamina 問題排除。

5. 更新和移除模組

先停止服務器,然後:

要做的事 命令 在界面裡
更新你裝的所有模組 lip update 「模組」頁面:操作行全部更新
更新一個模組 lip update LeviOptimize 「模組」頁面:在模組上按 Enter,選更新
移除一個模組 lip uninstall LeviOptimize 「模組」頁面:在模組上按 Enter,選卸載
看看命令會做什麼 加上 --dry-run 每次改動都會先給出計劃

不再被需要的依賴,lip 會自動移除。lip update 從不改動遊戲和 LeviLamina;要把服務器換到新的遊戲版本,見工作區或 lip setup。

你現在有了什麼

  • 一個裝有 LeviOptimize 和 LegacyScriptEngine 的服務器,它們需要的依賴都在 mods/ 裡。
  • 一套找模組、確認是否相配、安裝、更新和移除模組的方法。

下一步