跳到正文
本頁目錄

介面導覽

讀完這一頁,你就能在 lip 的介面裡行動自如:知道螢幕上每個部分是什麼、哪個鍵做什麼,以及改動伺服器時會經過哪些步驟。本節其他頁面都以這一頁為基礎。

這些頁面裡的圖片是按 lip 實際顯示的內容繪製的。橙色的標記、編號和按鍵徽標是為了講解加上去的,不是 lip 的一部分。

啟動介面

在伺服器所在的資料夾裡開啟終端機(還沒有伺服器的話,就在準備放伺服器的空資料夾裡),直接執行 lip,後面什麼都不加:

shell
lip

lip 會佔滿整個終端機視窗,並顯示「首頁」。啟動 lip 時所在的資料夾就是工作區:所有頁面操作的都是這個資料夾。

空資料夾裡的 lip 首頁。第一步「建立伺服器」處於高亮,底部一行列出目前可用的按鍵。

介面只用鍵盤操作,滑鼠不起作用。

TIP

lip 後面跟一個詞(比如 lip install)是一條命令:做完一件事就結束。命令的用法見用命令執行伺服器和參考。

螢幕上有什麼

伺服器正在執行時的首頁,五個部分各有編號:頂部一行、伺服器狀態、側邊欄、頁面和底部一行。

  1. 頂部一行顯示 lip 的版本和工作區。
  2. 頂部一行的右端顯示這個工作區的伺服器是否在執行。伺服器沒有執行時,這裡是空的。
  3. 側邊欄列出九個頁面:首頁、伺服器、模組、取得模組、遊戲設定、模組設定、工作區、工具和設定。「伺服器」後面有綠色的 ●,表示伺服器正在執行。
  4. 頁面是右邊的大方框,邊框上寫著頁面的名字。
  5. 底部一行列出此刻可用的按鍵,每個鍵後面有一個詞說明它的作用。你每動一下,它都會跟著變。拿不準的時候,看這一行。

焦點在哪裡

任何時候,接收按鍵的要麼是側邊欄,要麼是頁面。接收按鍵的那一部分擁有焦點。lip 啟動時,焦點在首頁裡。

按 Esc 把焦點從頁面移到側邊欄。在側邊欄裡,↑ 和 ↓ 在頁面之間移動,經過哪個頁面,右邊就立刻顯示哪個頁面。

焦點在側邊欄。「模組」一項是亮色,右側顯示模組頁面,底部一行寫著「Esc 結束」。

  1. 焦點在側邊欄時,目前頁面對應的那一項是亮色。
  2. 在側邊欄按 Esc,lip 會詢問是否結束。

按 Enter 把焦點移進頁面。

焦點在模組頁面裡。頁面邊框是亮色,清單中有一行高亮,底部一行寫著「Esc 返回」。

  1. 焦點在頁面裡時,頁面的邊框和名字是亮色。
  2. 有一行處於高亮。Enter 和 Space 操作的就是這一行。
  3. 這時按 Esc 回到側邊欄。

Esc 每次只退一步

Esc 總是後退一步,不會多退:

你在哪裡按 Esc 回到
對話方塊或選單它下面的內容。
頁面裡更深的一層,比如伺服器的輸入列進入這一層之前所在的部分。
頁面側邊欄。
側邊欄是否結束 lip 的詢問。

所以連按幾次 Esc 一定能回到側邊欄,再按一次就是結束的詢問。途中不會丟東西:頁面裡有未儲存的變更時,lip 會先問你。

按鍵

同一個鍵在每個頁面上的作用都一樣。

按鍵作用
↑ ↓在清單或選單中移動。在側邊欄裡,顯示上一個或下一個頁面。
← →在側邊欄和頁面之間、在並排的區域或按鈕之間移動。變更寫成 ‹ 这样 › 的選項的值。
Enter開啟或執行高亮的內容。在清單的一行上,開啟這一行的操作選單。
Space在可以多選的清單裡勾選一行。開啟或關閉一個開關。
Esc後退一步。
Tab移到下一個區域:從側邊欄依次經過頁面的各個區域,再回到側邊欄。Shift+Tab 反向移動。
PgUp PgDn在清單或文字中上翻、下翻一屏。
Home End跳到第一行或最後一行。
Ctrl+C詢問是否結束 lip。在伺服器頁面上且伺服器正在執行時,改為停止伺服器。lip 正在執行變更時,取消這次變更。

沒有字母快速鍵。只有在文字框擁有焦點時(比如搜尋框),才需要輸入字母。其餘的一切都是方向鍵能走到的行或按鈕。

清單或文字比它的方框長時,右邊緣會出現 ▲ 和 ▼,底部一行也會列出用來捲動的按鍵:

取得模組頁面上,模組的詳細資料區擁有焦點。右邊緣的標記表示上下還有內容,底部一行列出捲動用的按鍵。

  1. 擁有焦點的區域,標題是亮色。
  2. ▲ 和 ▼ 表示上方和下方還有內容。
  3. ↑ ↓、PgUp PgDn、Home 和 End 用來捲動。

行上的選單

在清單的一行上按 Enter,會開啟一個小選單,列出可以對這一行做的事。用 ↑ 和 ↓ 移動,按 Enter 選擇,按 Esc 關閉選單。

模組頁面上一個模組的選單:詳細資料、更新、更新到指定版本…、解除安裝。

不可用的項會說明原因

現在做不了的事不會消失,而是變成灰色留在螢幕上。移到它上面,lip 會在選單下方說明原因。在它上面按 Enter 沒有反應。

一個從網址安裝的模組的選單。「更新到指定版本…」是灰色,下方一行寫著「只有來自儲存庫的模組才有版本可選。」

對話方塊

對話方塊是在頁面上方開啟的方框。它開啟期間,所有按鍵都歸它。關閉之前,後面的頁面不會有反應。

對話方塊只有幾種,每一種在哪裡出現都是同樣的用法。

帶按鈕的詢問:← 和 → 選按鈕,Enter 按下。Esc 相當於按最後一個按鈕,而最後一個按鈕總是「什麼都不改」的那個。

詢問「要結束 lip 嗎?」,按鈕是「結束」和「取消」。

選項清單:↑ 和 ↓ 移動,選項下方有一句話解釋高亮的那一項。Enter 選定,Esc 取消。

有兩個選項的清單:「瀏覽…」和「輸入來源…」,下方是關於高亮選項的一句話。

文字框:輸入內容,然後按 Enter。空文字框裡的灰色文字是示例,告訴你該填什麼,並不是已經填好的值。

標籤為「來源」的文字框,裡面是使用者輸入的儲存庫名。

lip 用不了你輸入的內容時,對話方塊不會關閉,並說明它需要什麼:

文字框裡是「tag:」,下方一行寫著「請填寫版本號、branch:<名稱>、tag:<名稱> 或 rev:<提交>。」

提示資訊:只有一個「關閉」按鈕。

提示資訊:「模組目錄中沒有這個模組的資訊。」,帶一個「關閉」按鈕。

長文字(比如模組的 README)在佔滿螢幕的視窗裡開啟。用方向鍵捲動,按 Esc 或 Enter 關閉。

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

先預覽再應用

凡是會改動伺服器的事,都不會立刻發生。安裝、更新、解除安裝模組,以及安裝伺服器,走的都是同一套流程。

1. 計劃

lip 先算出它要做什麼,並顯示出來。這就是計劃。以 Dry run: 開頭的行是將要做的改動。

解除安裝的計劃:兩行以「Dry run: would uninstall」開頭的文字,以及「套用」和「取消」按鈕。

  1. lip 將要做的事。此時還什麼都沒有改。
  2. 套用執行計劃。取消或 Esc 保持原樣。

既然「取消」什麼都不改,想知道某個操作會做什麼,看一眼計劃再取消就行。

INFO

計劃裡的文字,以及命令輸出的其他內容,在介面的任何語言下都是英文。

有兩種計劃看起來不太一樣。

只有 lip 的記錄會變:遊戲和模組的檔案都不會變,變的只是 lip 記下的模組資訊。計劃的最後一行會說明這一點。應用或取消都可以,伺服器的表現不會有差別。

計劃的最後一行寫著「只會更新 lip 的安裝紀錄。」,按鈕是「套用」和「取消」。

不會有任何變更:沒有可應用的內容,所以只有一個關閉按鈕。

計劃寫著「不會有任何變更。」,只有一個「關閉」按鈕。

2. 遊戲的授權合約

計劃裡要安裝遊戲本體時,lip 接著會顯示《Minecraft 終端使用者授權合約》和《Microsoft 隱私權政策》的連結。選接受繼續。選拒絕則停止,什麼都不會安裝。

「Minecraft EULA」對話方塊,有兩個連結,按鈕是「接受」和「拒絕」。

3. 進度

lip 工作期間,會顯示正在下載什麼、正在做什麼。

安裝伺服器的進度:一項下載已完成,另一項進行到 62%。

按 Esc 或 Ctrl+C 取消。lip 會顯示「正在取消…」:

按下 Esc 之後的進度對話方塊:有一行寫著「正在取消…」。

接著 lip 會復原已經做了的部分,資料夾恢復原樣,並告訴你:

標題是「安裝伺服器 · 已取消」的對話方塊,寫著「已取消,變更已復原。」,帶一個「關閉」按鈕。

INFO

你取消的變更不算失敗。它的對話方塊標題裡寫的是「已取消」,邊框和其他對話方塊一樣,不是出錯時的紅色邊框。

4. 結果

lip 做完之後,會顯示它做了什麼,最後一行是「✓ 完成。」。按 Enter 關閉。

安裝伺服器的結果:lip 做過的事,然後是「✓ 完成。」和「確定」按鈕。

出錯的時候

出錯不會讓 lip 結束。lip 會顯示一個紅色邊框的對話方塊,關閉之後可以繼續使用。

出錯對話方塊,裡面有錯誤資訊、提示和完整報告的路徑。

  1. 「錯誤:」後面是出了什麼問題。
  2. 「提示:」後面是你可以怎麼處理。不是每次出錯都有提示。
  3. 「完整報告:」後面是一個檔案的路徑,裡面記錄了全部細節。它在工作區的 .lip\logs 資料夾裡。求助時請附上它。
  4. 關閉關閉對話方塊。

lip 在算計劃時出錯,什麼都不會改。在你選了「套用」之後出錯,已做的部分會像取消時一樣被復原。常見錯誤的含義見故障排除。

資料夾和檔案瀏覽器

lip 需要你指定資料夾或檔案時,會開啟一個瀏覽器,不必手動輸入路徑。

資料夾瀏覽器,路徑欄、「..」一行、資料夾、按鈕和底部一行各有編號。

  1. 路徑欄顯示目前列出的是哪個資料夾的內容。
  2. .. 是上一級資料夾。按 Enter 或 ← 前往。
  3. 裡面的資料夾,名字以 \ 結尾。按 Enter 或 → 開啟高亮的那個。
  4. 按鈕:在清單中按 Tab 移到這裡。
  5. Tab 在路徑欄、清單和按鈕之間循環。

Esc 關閉瀏覽器,什麼都不選。

隱藏的資料夾和檔案,以及名字以點開頭的(比如 .lip),不會列出。lip 無權讀取的資料夾會用一行文字說明。

輸入路徑

你仍然可以輸入或貼上路徑。在清單中按 Shift+Tab 移到路徑欄,輸入路徑,再按 Enter,lip 就會前往那個資料夾。按 Esc 回到清單。

路徑欄擁有焦點,裡面是輸入的路徑。底部一行寫著「Enter 前往」。

磁碟清單

磁碟根目錄再往上,是磁碟清單。先開啟其中一個磁碟才能繼續;這個清單本身不能被選取。

「本機」下的磁碟清單:C:\ 和 D:\。有一行寫著「請先開啟其中一項。」

Linux 和 macOS 沒有磁碟,最上面一級是 /。

四種形式

根據 lip 要的東西不同,瀏覽器的樣子略有差別。

已存在的資料夾,比如在工作區頁面新增資料夾時。本節開頭的圖就是這種。選擇此資料夾選取目前顯示的資料夾。新增資料夾… 會詢問名稱,在目前資料夾裡建立它,並開啟它。

可以是新的資料夾,用於建立伺服器。樣子相同,但 新增資料夾… 暫時不會建立任何東西:等 lip 安裝伺服器時才會建立。

建立伺服器時的資料夾瀏覽器,按鈕是「選擇此資料夾」「新增資料夾…」和「取消」。

「新增資料夾」對話方塊,文字框裡已輸入名稱。

檔案或資料夾,在模組頁面從磁碟安裝模組時使用。清單裡還會顯示可以選擇的檔案,按鈕上方有一行說明檔案類型。在檔案上按 Enter 選取它;選擇此資料夾選取目前顯示的資料夾。

瀏覽器裡有一個資料夾和兩個 .zip 檔案。有一行寫著「檔案:.zip」,按鈕是「選擇此資料夾」和「取消」。

要寫入的檔案,在工具頁面使用。清單下方有一個文字框,裡面是檔案名稱。進入想要的資料夾,需要的話改一下檔案名稱,然後選儲存。

瀏覽器下方有「檔案名稱」文字框,內容是「package.zip」,按鈕是「儲存」「新增資料夾…」和「取消」。

伺服器執行期間

工作區的伺服器執行期間,lip 不會改動它的模組和遊戲檔案。這樣,執行中的伺服器不會突然丟掉正在使用的檔案。

內容伺服器執行期間
安裝、更新、解除安裝模組不可用。
安裝伺服器、變更遊戲或載入器的版本不可用。
遊戲設定頁面上的 server.properties、allowlist.json、permissions.json可以檢視,不能儲存。
模組設定頁面上各模組的設定檔可以修改並儲存。
其他:瀏覽模組、工具、設定照常使用。

不可用的內容以灰色留在螢幕上,原因是「請先停止伺服器。」:

伺服器執行期間的模組頁面。頂部有一行黃色文字,兩個操作行是灰色,詳細資料區寫著「請先停止伺服器。」

  1. 頁面提示伺服器正在執行。
  2. 會改動模組的操作行變成灰色。
  3. 詳細資料區說明原因。

伺服器執行期間一個模組的選單。「更新」是灰色,選單下方一行寫著「請先停止伺服器。」

到伺服器頁面停止伺服器,做完變更,再重新啟動。

不管伺服器是誰啟動的,都是如此:這個介面、另一個終端機,還是 lip run 命令。

底部一行的消息

底部一行的右側有時會出現一條簡短的消息,告訴你某件事已經完成,或者為什麼沒有反應。它六秒後自己消失,不需要你回應。

首頁。底部一行的右側是消息「請先建立伺服器。」

成功的消息是綠色,警告是黃色,失敗是紅色,普通資訊是藍色。

小終端機

lip 需要至少 60 列、16 行的終端機。終端機更小時只顯示下面這一行,而且只有 Ctrl+C 可用,它會不經詢問直接結束:

過小的終端機,只顯示一行:「請將終端機放大到 60×16。按 Ctrl+C 結束。」

把視窗拉大,lip 就恢復原樣。

終端機不足 80 列時,焦點在頁面裡的時候,側邊欄會縮成每個頁面一個符號,給頁面騰出地方:

60 列的終端機。側邊欄裡每個頁面只顯示一個符號。

按 Esc,側邊欄又會顯示頁面名稱:

同一個終端機,焦點在側邊欄,側邊欄顯示頁面名稱。

終端機較窄時,底部一行可能放不下所有按鍵。Esc 和會執行操作的鍵(比如 Enter)一定會顯示;只用來移動的鍵最先被省略。

結束

在側邊欄按 Esc,或者在任何地方按 Ctrl+C(伺服器頁面上伺服器正在執行時除外)。lip 結束前會先詢問:

詢問「要結束 lip 嗎?」,按鈕是「結束」和「取消」。

有伺服器在執行時,詢問裡還會說明伺服器會怎樣。通常伺服器會繼續執行:

詢問「要結束 lip 嗎?」,第二行是「執行中的伺服器會繼續執行。」

你可以關掉終端機,以後再回到同一個資料夾執行 lip,就能重新看到這個伺服器。伺服器頁面對此有詳細說明,也講了伺服器會先停止的少見情況。

語言

介面有英文、簡體中文和繁體中文三種語言。一開始它跟隨系統的語言。想自己選的話,到設定頁面,在語言上按 Enter。螢幕會立刻切換。

「語言」設定:跟隨系統、English、簡體中文、繁體中文。

接下來