跳到正文
本頁目錄

取得模組

取得模組頁面就是裝在 lip 裡的 levimc.org 模組清單。讀完這一頁,你就能通過搜尋、排序和篩選找到模組,瞭解它,並安裝與伺服器相配的版本。

如果你還不熟悉按鍵和螢幕上的各個部分,請先讀介面導覽。

頁面

取得模組頁面。編號標出搜尋、排序、篩選三行,模組清單,以及高亮模組的詳細資料。

  1. 搜尋、排序和篩選決定列出哪些模組、按什麼順序列出。
  2. 模組清單。頁面開啟時焦點在這裡。
  3. 高亮模組的詳細資料。

在第一個模組上按 ↑,依次移到篩選、排序和搜尋。從那裡按 ↓,或者在搜尋框裡按 Enter,回到清單。Tab 也在這些部分之間循環。

lip 管理的是伺服器,所以清單裡是能在伺服器上執行的模組。每次開啟 lip 時,清單都從 levimc.org 重新讀取,不會儲存到磁碟上。

清單

已有模組的伺服器裡的模組清單。編號標出對勾、名稱和作者、下載次數、星號、日期和數量。

  1. ✓ 表示這個模組已安裝在目前工作區。
  2. 模組的名稱,點號後面是作者。
  3. ↓ 是模組被下載的次數。186k 大約是 18.6 萬。
  4. ★ 是它在 GitHub 上的星號數。
  5. 最近一次更新的日期。
  6. 清單上方的一行顯示目前列出了多少個模組。

沒有下載次數或星號的模組,對應的一列是空的。終端機較窄時,先省略日期,再省略下載次數。

詳細資料

在清單裡移動時,詳細資料會跟著變。它先顯示模組的簡介,然後是:

行顯示
作者發佈模組的人。
下載次數、星號確切的數字。
ID模組儲存庫的地址,也就是它在模組頁面上的名字。
最新版本最新的版本;模組有變體時,# 後面是變體。
平臺模組支援的系統。
遊戲它支援的遊戲版本。
標籤模組的類型。
授權條款模組的授權條款。
相依模組需要什麼,以及可接受的版本範圍。lip 會替你裝好。
更新日期最近一次更新的日期。

詳細資料比它的方框長時,右邊緣會有 ▼。按 Tab 把焦點交給詳細資料,然後捲動。

詳細資料區擁有焦點並已捲動。右邊緣的標記表示上下還有內容。

  1. 詳細資料擁有焦點時,它的標題是亮色。
  2. ▲ 和 ▼ 表示上方和下方還有內容。
  3. 用來捲動的按鍵。

按 Esc 回到清單。

終端機寬度在 106 列左右或更寬時,詳細資料顯示在清單右側,一次能看到更多行:

寬終端機裡的取得模組頁面。詳細資料顯示在清單右側。

搜尋

按 ↑ 直到搜尋高亮,然後輸入。每輸入一個字,清單就跟著變。

搜尋框裡輸入了「legacy」。清單裡是符合的三個模組。

搜尋會查找每個模組的名稱、作者、簡介、標籤和授權條款。輸入多個詞時,模組必須同時符合所有詞。

搜尋也認得介面的語言。標籤是按你的語言顯示的,你可以照著顯示的樣子去搜:在中文介面裡,輸入「經濟」能找到帶有「經濟」標籤的模組,輸入 economy 也一樣。

搜尋框裡是「經濟」。清單裡有一個模組,它的詳細資料裡顯示「經濟」標籤。

按 Enter 移到找到的模組上。想重新看到所有模組,把輸入的內容刪掉。

沒有符合的模組時,清單會說明:

搜尋框裡是「dynmap」。清單寫著「沒有符合的模組。」

排序

按 ↑ 直到排序高亮。← 和 → 變更順序。

排序方式是「熱度」。一個星號少、下載多的模組排在星號更多的模組前面。

排序方式模組的順序
相關性按 levimc.org 的順序。搜尋時,最符合的排在最前。
熱度最受歡迎的排在最前。
最近更新最近更新的排在最前。
最新發佈最近發佈的排在最前。

熱度是 lip 根據模組的星號和下載次數一起算出來的數值,算法和 levimc.org 相同。兩者各佔一半,並且都是和清單裡的其他模組相比較得出的。所以這個順序既不是星號的順序,也不是下載次數的順序:圖中星號 61、下載次數 17.1 萬的模組,排在星號 152、下載次數 6.4 萬的模組前面。

篩選

篩選把清單縮小到帶有(或不帶有)某個特徵的模組。

  1. 按 ↑ 直到篩選高亮,然後按 Enter。

    「篩選」一行處於高亮,它的值是「無」。

  2. 篩選面板開啟。各個分類一開始是收起的。

    篩選面板:「清除篩選」,然後是遊戲版本、標籤、授權條款和相依於四個分類,每個後面有一個數字。

    1. 清除篩選去掉所有篩選條件。
    2. 各個分類。數字是這個分類裡有多少個選項。
    3. 篩選後剩下多少個模組。面板後面的清單會立刻跟著變。
  3. 在分類上按 Enter 展開或收起,在選項上按 Space 選取。

    「標籤」分類已展開。一個標籤標著 [+],另一個標著 [-],面板底部寫著「排除」和「3 個模組」。

    1. [+] 包含:只列出帶有這個選項的模組。
    2. [-] 排除:帶有這個選項的模組不列出。
    3. 用文字表示的高亮選項的狀態。
  4. 按 Esc 關閉面板。「篩選」一行會顯示有多少個條件生效。

    「篩選」一行寫著「已選 1 項」,清單裡有兩個模組。

Space 在幾種狀態之間輪換:未選、包含,以及(分類允許的話)排除。

分類篩選依據包含排除
遊戲版本模組支援的遊戲版本。可以不可以
標籤模組的類型。常用標籤排在前面,按你的語言顯示。可以可以
授權條款授權條款的類別:寬鬆授權、弱 Copyleft、Copyleft、其他、無授權條款。可以不可以
相依於模組需要的東西,比如某個庫。可以可以

選項右邊的數字是帶有它的模組數量。

「授權條款」和「相依於」兩個分類已展開。「LegacyRemoteCall」被包含,剩下兩個模組。

  1. 「授權條款」裡是授權條款的類別,不是具體的授權條款。
  2. 只列出需要 LegacyRemoteCall 的模組。
  3. 還剩兩個模組。

篩選條件會一直保留,直到你清除它們或結束 lip。它們和搜尋同時起作用。

模組的選單

在模組上按 Enter 開啟它的選單。

一個模組的選單:安裝…、README、在瀏覽器中開啟。

操作作用
安裝…詢問版本,然後安裝模組。
README顯示作者為模組寫的說明。
在瀏覽器中開啟在你的網頁瀏覽器裡開啟模組在 levimc.org 上的頁面。

README

README 在佔滿螢幕的視窗裡開啟。用方向鍵、PgUp 和 PgDn 捲動。按 Esc 或 Enter 關閉。

一個模組的 README,顯示在佔滿螢幕的視窗裡。

README 按作者寫的原樣顯示為純文字。沒有 README 的模組會顯示「沒有 README。」

在瀏覽器中開啟

模組的選單,「在瀏覽器中開啟」處於高亮。

lip 會請系統開啟這個頁面。在沒有桌面環境的伺服器上可能什麼都不會發生,這時就靠 README 來了解模組。模組沒有頁面時,這個操作是灰色的,並說明「此模組沒有頁面。」

安裝模組

安裝一定要先選版本。lip 只列出與伺服器相配的版本,所以你不會選到不相配的。

  1. 高亮要裝的模組,按 Enter,選安裝…。

  2. 選擇版本。相配的最新版本已經高亮,通常直接按 Enter 就行。

    LegacyMoney 的版本:0.16.1 和 0.16.0,然後是「自訂…」。最後一行顯示將要安裝的模組和版本。

    1. 相配的版本,從新到舊,每個後面是發佈日期。
    2. 按 Enter 後 lip 會安裝的內容。
  3. 看一下計劃。裡面列出這個模組,以及它需要的其他模組。

    計劃:「would install LegacyRemoteCall 0.13.0」和「would install LegacyMoney 0.16.1」。

    1. LegacyMoney 需要的模組,lip 會一併安裝。
    2. 套用安裝這兩個模組。取消什麼都不裝。
  4. 選套用。lip 做完後會顯示它做了什麼。

    結果:兩行以「Installing」開頭的文字,然後是「✓ 完成。」

  5. 按 Enter。這個模組在清單裡有了 ✓,一併裝上的模組也有。

    安裝之後的清單。LegacyMoney 和 LegacyRemoteCall 前面有對勾。

模組會在伺服器下次啟動時載入。計劃、進度以及出錯時會怎樣,見先預覽再應用。

選擇版本

變體

有些模組有多個變體:同一個模組針對不同用途的組建。它們是對話方塊頂部的標籤頁。← 和 → 切換變體,下面的版本也跟著變。

LegacyScriptEngine 的版本。標籤頁是 lua、quickjs、nodejs 和 python,選取的是 quickjs。

  1. 各個變體。選取的那個在方括號裡。
  2. 所選變體中與伺服器相配的版本。
  3. lip 將安裝的內容:模組、# 加變體、@ 加版本。

該選哪個變體,要看模組的 README。只有一個變體的模組沒有標籤頁。

變體多到一行放不下時,這一行會隨著你的移動左右捲動。兩端的 ‹ 和 › 表示那一側還有。

一個有十個變體的模組。標籤頁一行只顯示其中一部分,左端有「‹」,右端有「›」。

  1. 左邊還有變體。
  2. 目前選取的變體。
  3. 右邊還有變體。

只列出相配的版本

清單裡只有與工作區的遊戲和 LeviLamina 相配的版本。需要另一個 LeviLamina 的舊版本或新版本不會出現,哪怕 levimc.org 上列著它。

所選變體沒有任何相配的版本時,會有一行說明是什麼把它們排除了:

LeviLamina 為 26.40.1 的伺服器裡,LeviOptimize 的版本對話方塊。有一行寫著「沒有適用於 LeviLamina 26.40.1 的版本。」,只剩「自訂…」一行。

  1. 沒有版本與之相配的 LeviLamina(或遊戲)。
  2. 自訂… 仍然可用。

這時有三條路:換一個變體,換一個模組,或者到工作區頁面變更伺服器的遊戲和 LeviLamina 版本。

自訂…

最後一行自訂… 讓你自己指定要安裝什麼。想裝某個分支、標籤或提交時用它,比如試用一個還沒發佈的修復。

「自訂版本」對話方塊。標籤是模組名加「@」,灰色的「branch:main」是示例。

輸入 @ 後面的部分:一個版本號(比如 1.8.0),或者 branch:main、tag: 加標籤名、rev: 加提交。按 Enter 檢視計劃。按 Esc 回到版本清單。

lip 不會事先檢查你指定的內容是否與伺服器相配。不相配的話,計劃會失敗並說明原因,什麼都不會改。

在沒有伺服器的資料夾裡

在哪裡都可以瀏覽模組。但安裝需要伺服器,因為版本必須與遊戲相配。在沒有伺服器的資料夾裡,安裝… 會先請你建立伺服器:

對話方塊寫著「此資料夾還沒有伺服器,請先建立。」,按鈕是「建立伺服器…」和「取消」。

建立伺服器… 會啟動工作區頁面的建立伺服器嚮導。

伺服器執行期間

工作區的伺服器執行期間不能安裝任何東西。安裝… 是灰色的,選單會說明原因。「README」和「在瀏覽器中開啟」照常可用。

伺服器執行期間一個模組的選單。「安裝…」是灰色,有一行寫著「請先停止伺服器。」

請先到伺服器頁面停止伺服器。

讀不到清單時

lip 無法從 levimc.org 讀取清單時,頁面不顯示模組,而是說明情況。

取得模組頁面寫著「無法讀取模組目錄。」,接著是原因,還有一個「重試」按鈕。

  1. 無法讀取清單。
  2. 原因(lip 的原話)。
  3. 重試重新讀取清單。

檢查網路連線,然後按 Enter。設定頁面的 GitHub 代理伺服器不會用於 levimc.org,所以在這裡幫不上忙。

知道模組名字的話,仍然可以安裝:用模組頁面的從來源安裝…。