介面導覽
讀完這一頁,你就能在 lip 的介面裡行動自如:知道螢幕上每個部分是什麼、哪個鍵做什麼,以及改動伺服器時會經過哪些步驟。本節其他頁面都以這一頁為基礎。
這些頁面裡的圖片是按 lip 實際顯示的內容繪製的。橙色的標記、編號和按鍵徽標是為了講解加上去的,不是 lip 的一部分。
啟動介面
在伺服器所在的資料夾裡開啟終端機(還沒有伺服器的話,就在準備放伺服器的空資料夾裡),直接執行 lip,後面什麼都不加:
liplip 會佔滿整個終端機視窗,並顯示「首頁」。啟動 lip 時所在的資料夾就是工作區:所有頁面操作的都是這個資料夾。
介面只用鍵盤操作,滑鼠不起作用。
螢幕上有什麼
- 頂部一行顯示 lip 的版本和工作區。
- 頂部一行的右端顯示這個工作區的伺服器是否在執行。伺服器沒有執行時,這裡是空的。
- 側邊欄列出九個頁面:首頁、伺服器、模組、取得模組、遊戲設定、模組設定、工作區、工具和設定。「伺服器」後面有綠色的
●,表示伺服器正在執行。 - 頁面是右邊的大方框,邊框上寫著頁面的名字。
- 底部一行列出此刻可用的按鍵,每個鍵後面有一個詞說明它的作用。你每動一下,它都會跟著變。拿不準的時候,看這一行。
焦點在哪裡
任何時候,接收按鍵的要麼是側邊欄,要麼是頁面。接收按鍵的那一部分擁有焦點。lip 啟動時,焦點在首頁裡。
按 Esc 把焦點從頁面移到側邊欄。在側邊欄裡,↑ 和 ↓ 在頁面之間移動,經過哪個頁面,右邊就立刻顯示哪個頁面。
- 焦點在側邊欄時,目前頁面對應的那一項是亮色。
- 在側邊欄按
Esc,lip 會詢問是否結束。
按 Enter 把焦點移進頁面。
- 焦點在頁面裡時,頁面的邊框和名字是亮色。
- 有一行處於高亮。
Enter和Space操作的就是這一行。 - 這時按
Esc回到側邊欄。
Esc 每次只退一步
Esc 總是後退一步,不會多退:
| 你在哪裡 | 按 Esc 回到 |
|---|---|
| 對話方塊或選單 | 它下面的內容。 |
| 頁面裡更深的一層,比如伺服器的輸入列 | 進入這一層之前所在的部分。 |
| 頁面 | 側邊欄。 |
| 側邊欄 | 是否結束 lip 的詢問。 |
所以連按幾次 Esc 一定能回到側邊欄,再按一次就是結束的詢問。途中不會丟東西:頁面裡有未儲存的變更時,lip 會先問你。
按鍵
同一個鍵在每個頁面上的作用都一樣。
| 按鍵 | 作用 |
|---|---|
↑ ↓ | 在清單或選單中移動。在側邊欄裡,顯示上一個或下一個頁面。 |
← → | 在側邊欄和頁面之間、在並排的區域或按鈕之間移動。變更寫成 ‹ 这样 › 的選項的值。 |
Enter | 開啟或執行高亮的內容。在清單的一行上,開啟這一行的操作選單。 |
Space | 在可以多選的清單裡勾選一行。開啟或關閉一個開關。 |
Esc | 後退一步。 |
Tab | 移到下一個區域:從側邊欄依次經過頁面的各個區域,再回到側邊欄。Shift+Tab 反向移動。 |
PgUp PgDn | 在清單或文字中上翻、下翻一屏。 |
Home End | 跳到第一行或最後一行。 |
Ctrl+C | 詢問是否結束 lip。在伺服器頁面上且伺服器正在執行時,改為停止伺服器。lip 正在執行變更時,取消這次變更。 |
沒有字母快速鍵。只有在文字框擁有焦點時(比如搜尋框),才需要輸入字母。其餘的一切都是方向鍵能走到的行或按鈕。
清單或文字比它的方框長時,右邊緣會出現 ▲ 和 ▼,底部一行也會列出用來捲動的按鍵:
- 擁有焦點的區域,標題是亮色。
▲和▼表示上方和下方還有內容。↑↓、PgUpPgDn、Home和End用來捲動。
行上的選單
在清單的一行上按 Enter,會開啟一個小選單,列出可以對這一行做的事。用 ↑ 和 ↓ 移動,按 Enter 選擇,按 Esc 關閉選單。
不可用的項會說明原因
現在做不了的事不會消失,而是變成灰色留在螢幕上。移到它上面,lip 會在選單下方說明原因。在它上面按 Enter 沒有反應。
對話方塊
對話方塊是在頁面上方開啟的方框。它開啟期間,所有按鍵都歸它。關閉之前,後面的頁面不會有反應。
對話方塊只有幾種,每一種在哪裡出現都是同樣的用法。
帶按鈕的詢問:← 和 → 選按鈕,Enter 按下。Esc 相當於按最後一個按鈕,而最後一個按鈕總是「什麼都不改」的那個。
選項清單:↑ 和 ↓ 移動,選項下方有一句話解釋高亮的那一項。Enter 選定,Esc 取消。
文字框:輸入內容,然後按 Enter。空文字框裡的灰色文字是示例,告訴你該填什麼,並不是已經填好的值。
lip 用不了你輸入的內容時,對話方塊不會關閉,並說明它需要什麼:
提示資訊:只有一個「關閉」按鈕。
長文字(比如模組的 README)在佔滿螢幕的視窗裡開啟。用方向鍵捲動,按 Esc 或 Enter 關閉。
先預覽再應用
凡是會改動伺服器的事,都不會立刻發生。安裝、更新、解除安裝模組,以及安裝伺服器,走的都是同一套流程。
1. 計劃
lip 先算出它要做什麼,並顯示出來。這就是計劃。以 Dry run: 開頭的行是將要做的改動。
- lip 將要做的事。此時還什麼都沒有改。
- 套用執行計劃。取消或
Esc保持原樣。
既然「取消」什麼都不改,想知道某個操作會做什麼,看一眼計劃再取消就行。
INFO
計劃裡的文字,以及命令輸出的其他內容,在介面的任何語言下都是英文。
有兩種計劃看起來不太一樣。
只有 lip 的記錄會變:遊戲和模組的檔案都不會變,變的只是 lip 記下的模組資訊。計劃的最後一行會說明這一點。應用或取消都可以,伺服器的表現不會有差別。
不會有任何變更:沒有可應用的內容,所以只有一個關閉按鈕。
2. 遊戲的授權合約
計劃裡要安裝遊戲本體時,lip 接著會顯示《Minecraft 終端使用者授權合約》和《Microsoft 隱私權政策》的連結。選接受繼續。選拒絕則停止,什麼都不會安裝。
3. 進度
lip 工作期間,會顯示正在下載什麼、正在做什麼。
按 Esc 或 Ctrl+C 取消。lip 會顯示「正在取消…」:
接著 lip 會復原已經做了的部分,資料夾恢復原樣,並告訴你:
INFO
你取消的變更不算失敗。它的對話方塊標題裡寫的是「已取消」,邊框和其他對話方塊一樣,不是出錯時的紅色邊框。
4. 結果
lip 做完之後,會顯示它做了什麼,最後一行是「✓ 完成。」。按 Enter 關閉。
出錯的時候
出錯不會讓 lip 結束。lip 會顯示一個紅色邊框的對話方塊,關閉之後可以繼續使用。
- 「錯誤:」後面是出了什麼問題。
- 「提示:」後面是你可以怎麼處理。不是每次出錯都有提示。
- 「完整報告:」後面是一個檔案的路徑,裡面記錄了全部細節。它在工作區的
.lip\logs資料夾裡。求助時請附上它。 - 關閉關閉對話方塊。
lip 在算計劃時出錯,什麼都不會改。在你選了「套用」之後出錯,已做的部分會像取消時一樣被復原。常見錯誤的含義見故障排除。
資料夾和檔案瀏覽器
lip 需要你指定資料夾或檔案時,會開啟一個瀏覽器,不必手動輸入路徑。
- 路徑欄顯示目前列出的是哪個資料夾的內容。
..是上一級資料夾。按Enter或←前往。- 裡面的資料夾,名字以
\結尾。按Enter或→開啟高亮的那個。 - 按鈕:在清單中按
Tab移到這裡。 Tab在路徑欄、清單和按鈕之間循環。
Esc 關閉瀏覽器,什麼都不選。
隱藏的資料夾和檔案,以及名字以點開頭的(比如 .lip),不會列出。lip 無權讀取的資料夾會用一行文字說明。
輸入路徑
你仍然可以輸入或貼上路徑。在清單中按 Shift+Tab 移到路徑欄,輸入路徑,再按 Enter,lip 就會前往那個資料夾。按 Esc 回到清單。
磁碟清單
磁碟根目錄再往上,是磁碟清單。先開啟其中一個磁碟才能繼續;這個清單本身不能被選取。
Linux 和 macOS 沒有磁碟,最上面一級是 /。
四種形式
根據 lip 要的東西不同,瀏覽器的樣子略有差別。
已存在的資料夾,比如在工作區頁面新增資料夾時。本節開頭的圖就是這種。選擇此資料夾選取目前顯示的資料夾。新增資料夾… 會詢問名稱,在目前資料夾裡建立它,並開啟它。
可以是新的資料夾,用於建立伺服器。樣子相同,但 新增資料夾… 暫時不會建立任何東西:等 lip 安裝伺服器時才會建立。
檔案或資料夾,在模組頁面從磁碟安裝模組時使用。清單裡還會顯示可以選擇的檔案,按鈕上方有一行說明檔案類型。在檔案上按 Enter 選取它;選擇此資料夾選取目前顯示的資料夾。
要寫入的檔案,在工具頁面使用。清單下方有一個文字框,裡面是檔案名稱。進入想要的資料夾,需要的話改一下檔案名稱,然後選儲存。
伺服器執行期間
工作區的伺服器執行期間,lip 不會改動它的模組和遊戲檔案。這樣,執行中的伺服器不會突然丟掉正在使用的檔案。
| 內容 | 伺服器執行期間 |
|---|---|
| 安裝、更新、解除安裝模組 | 不可用。 |
| 安裝伺服器、變更遊戲或載入器的版本 | 不可用。 |
遊戲設定頁面上的 server.properties、allowlist.json、permissions.json | 可以檢視,不能儲存。 |
| 模組設定頁面上各模組的設定檔 | 可以修改並儲存。 |
| 其他:瀏覽模組、工具、設定 | 照常使用。 |
不可用的內容以灰色留在螢幕上,原因是「請先停止伺服器。」:
- 頁面提示伺服器正在執行。
- 會改動模組的操作行變成灰色。
- 詳細資料區說明原因。
到伺服器頁面停止伺服器,做完變更,再重新啟動。
不管伺服器是誰啟動的,都是如此:這個介面、另一個終端機,還是 lip run 命令。
底部一行的消息
底部一行的右側有時會出現一條簡短的消息,告訴你某件事已經完成,或者為什麼沒有反應。它六秒後自己消失,不需要你回應。
成功的消息是綠色,警告是黃色,失敗是紅色,普通資訊是藍色。
小終端機
lip 需要至少 60 列、16 行的終端機。終端機更小時只顯示下面這一行,而且只有 Ctrl+C 可用,它會不經詢問直接結束:
把視窗拉大,lip 就恢復原樣。
終端機不足 80 列時,焦點在頁面裡的時候,側邊欄會縮成每個頁面一個符號,給頁面騰出地方:
按 Esc,側邊欄又會顯示頁面名稱:
終端機較窄時,底部一行可能放不下所有按鍵。Esc 和會執行操作的鍵(比如 Enter)一定會顯示;只用來移動的鍵最先被省略。
結束
在側邊欄按 Esc,或者在任何地方按 Ctrl+C(伺服器頁面上伺服器正在執行時除外)。lip 結束前會先詢問:
有伺服器在執行時,詢問裡還會說明伺服器會怎樣。通常伺服器會繼續執行:
你可以關掉終端機,以後再回到同一個資料夾執行 lip,就能重新看到這個伺服器。伺服器頁面對此有詳細說明,也講了伺服器會先停止的少見情況。
語言
介面有英文、簡體中文和繁體中文三種語言。一開始它跟隨系統的語言。想自己選的話,到設定頁面,在語言上按 Enter。螢幕會立刻切換。