跳到正文
本页目录

界面导览

读完这一页,你就能在 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、简体中文、繁體中文。

接下来