給服務器安裝模組
學完這篇教程,你的服務器會運行兩個模組:讓服務器跑得更快的 LeviOptimize,以及運行腳本插件的 LegacyScriptEngine。你會在 LeviMC 模組目錄裡找模組,用 lip(界面或命令)安裝它們,確認 LeviLamina 加載了它們,並學會更新和移除模組。
你需要準備
- 一個用
lip裝好的、帶 LeviLamina 的服務器:見開你的第一個服務器或用命令行開服。本教程使用文件夾D:\servers\survival。 - 服務器處於停止狀態。服務器運行期間,
lip的界面不會改動它的文件夾;而且運行中的服務器反正要到下次啟動才會加載新模組。 - 網絡連接。模組來自 GitHub。
在 Docker 裡運行的服務器改用變量 PACKAGES 安裝模組:見在 Docker 中運行服務器。模組的名字是一樣的。
1. 在目錄裡找模組
-
打開 LeviMC 模組,搜索
LeviOptimize。 -
打開它的頁面。看運行端:給服務器用的模組必須包含服務端。再看遊戲版本:其中必須有你的服務器的版本。
-
點安裝。對話框裡可以選擇變體和版本,並在“在服務端目錄中用 lip 運行:”下面給出命令,例如:
shelllip install github.com/LiteLDev/LeviOptimize@1.8.1去掉末尾的
@<版本>,lip會自己選出與你的服務器相配的最新版本。
安裝並不需要打開網站:lip 的「獲取模組」頁面顯示的就是同一個目錄。下面兩種方式任選其一。
2. 安裝模組
在界面裡安裝
- 在服務器的文件夾裡啟動
lip(cd D:\servers\survival,然後lip)。在「主頁」上選中安裝模組,按Enter,打開「獲取模組」頁面。 - 按
↑直到進入搜索,輸入optim,按Enter。LeviOptimize 已被選中。 - 按
Enter,再在**安裝…**上按一次Enter。 lip只列出與你的遊戲和 LeviLamina 相配的版本。保持選中最新版本,按Enter。lip給出計劃,例如Dry run: would install LeviOptimize 1.8.1。如果這個模組還需要別的模組,它們也會列出來。在應用上按Enter。- 你應該看到 ✓ 完成。,回到列表後,LeviOptimize 前面多了一個 ✓。
用命令安裝
在服務器的文件夾裡運行:
lip install LeviOptimizeLeviOptimize 這樣的短名字表示 github.com/LiteLDev/LeviOptimize;其他作者的模組要用它頁面上的完整地址。lip 會把模組和它依賴的一切裝進 mods/。你應該看到:
✓ 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 |
-
安裝一個變體,例如 Lua:
命令lip install LegacyScriptEngine#lua界面获取模组 → 搜索 "LegacyScriptEngine" → Enter → 安装… → 用 ← 和 → 选择变体 → Enter → 应用lip還會裝上 LSE 需要的 LegacyRemoteCall、LegacyMoney 和 iListenAttentively。 -
需要多個引擎的話,用同樣的方式逐個安裝變體。
Python 引擎需要 Python
安裝 #python 之前,先在服務器所在的機器上安裝 Python:LSE 0.16.2 及以後的版本需要 Python 3.12.10。
插件放在服務器的 plugins/ 文件夾裡。下次啟動時,LSE 會遷移它們,併為每個插件生成 LeviLamina 模組清單;再重啟一次服務器,插件就會被加載。
4. 確認模組已加載
- 啟動服務器:在「主頁」上選啟動服務器,或者運行
lip run。 - 在輸出裡找帶
[LeviLamina]的幾行。你應該看到每個模組一行Loaded,例如Loaded LeviOptimize v1.8.1,還有一行數量,例如5 mod(s) loaded(依賴也算模組)。 - 按
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/裡。 - 一套找模組、確認是否相配、安裝、更新和移除模組的方法。
下一步
- 為剛裝好的引擎寫一個插件:你的第一個腳本插件。
- 讓其他玩家連進來:讓朋友連上你的服務器。
- 修改模組的設置:模組配置。
- 在
lip裡搜索、排序和篩選目錄:獲取模組。管理已安裝的模組:模組。 - 指定包的各種寫法(版本、分支、ZIP 文件、文件夾):管理包。
- 腳本引擎和它們支持的語言:LegacyScriptEngine。
- 給遊戲客戶端而不是服務器裝模組:在 Windows 上玩模組。