命令行minecraft mod manager
carrot-mc的Python项目详细描述
carrot是一个命令行界面,用于管理mc实例中的minecraft mods。
它使用一个api来索引curseforge上的所有mod和文件。
安装
来自PYPI
Carrot发布于pypi, 因此,最好的安装方法是通过pip进行安装:
pip install carrot-mc
这假设您在virtualenv环境中安装它。
如果要在Linux上全局安装,可能需要预先准备
上面的命令带有sudo
来源
您也可以直接从源代码下载并生成自己的副本:
git clone https://github.com/Misza13/carrot
cd carrot
python setup.py install
用法
重要提示:
- 所有命令都在当前目录下运行,并假定
当前位于minecraft实例的
mods/
目录中。 - mods是由它们的"key"来引用的,这个key就是它所使用的字符串
在curseForge URL中,例如
"修补程序的构造"
mod,它是
Tinkers构造的
要获得有关程序的一般帮助,只需键入
carrot
无需任何参数(或只需-h
或--help
)即可查看所有可用的命令。
要获得有关特定命令的帮助,请运行例如
carrot install -h
下面是一些命令的附加指针。
init
-初始化mod存储库
在使用之前,必须初始化mod存储库并选择 此实例的Minecraft版本,例如:
carrot init --mc_version 1.12.2
这将在当前目录中创建一个包含 有关已安装的mods的信息。
请注意,这将初始化与beta
通道对齐的存储库
在CurseForge。要使用不同的频道,请使用--channel
命令,例如:
carrot init --mc_version 1.12.2 --channel Release
通道决定了你想要接收的mod版本的稳定性。
beta
是一个很好的默认值,您可以在其他命令中手动覆盖它
使用相同的选项。
安装
-安装mod
如果您知道mod的确切键,请使用
carrot install jei
上面的示例将安装mod"just enough items",因为jei
是
它的确切密钥名。注意它将使用minecraft版本和频道
来自mods.json
的设置。可以覆盖频道:
carrot install jei --channel Release
如果没有与您键入的内容完全匹配的mod,例如
carrot install applied
您将看到已应用的顶级下载mod列表
在钥匙上(可能与应用能量2模块有关)。
请继续关注计划中的"胡萝卜搜索"命令 在mods的名称和描述中。
安装
拉取依赖项(如果有),例如
pip install carrot-mc
0
将安装修补程序的结构本身以及"mantle",即 库依赖项。
您还可以通过指定多个mod的键来同时安装它们:
pip install carrot-mc
1
在此模式下,如果键不精确,Carrot将不显示建议, 但是相反,它会简单地通知您找不到mod并安装 只有它能找到的。
如果发生冲突(例如,由于
更新或从不同渠道调出mods),carrot已经离开
未受影响的已安装文件(以确保已工作的文件不会中断);
但是,您可以使用--upgrade
和--degrade
标志覆盖此行为
(有关详细信息,请参见carrot install-h
)。如果
发生这种情况时,请注意其输出。
更新
-将mod(-s)更新到较新/较旧版本
最简单的形式:
pip install carrot-mc
2
Carrot将尝试更新当前安装的所有mods(连同他们的 依赖项)到其最新版本。
Carrot将使用与安装它的mod相同的通道,
除非另有说明,否则使用--channel
。这意味着,例如,
您的整个modpack设置为beta
频道,但安装了一个mod
显式地使用--channel alpha
,一个mod(以及它的依赖项)
将更新到最新的alpha
文件,但其余的mods将使用
默认值为beta
您只能请求一个mod(带依赖项)更新为:
pip install carrot-mc
3
此外,还可以使用--channel
选项强制目标通道,
这可能会导致mods在版本上同时上升和下降。
与安装类似,如果
您希望安装旧版本的mods。然而,与
在安装过程中,相当于--upgrade
的"始终打开"。
状态
-显示mod repository的状态
查看mod安装使用摘要:
pip install carrot-mc
4
这将显示以下信息:
- 安装的mod数
- 其中有多少是依赖关系
- 有多少个mod被禁用(遵循
。disabled
约定) - 列出其文件丢失(禁用或未禁用)的mods
- 列出其文件已损坏的mods(md5哈希与已发布的哈希不匹配)
列表
-显示已安装模块的列表
要查看已安装mods的完整列表,请使用:
pip install carrot-mc
5
这不仅会列出根据mods.json
安装的所有mod,而且还会
显示每个的状态:
- 文件是否存在或丢失,
- 无论它是否被禁用,
- MD5校验和是否正确。
启用
和禁用
-启用/禁用mods
要启用mod,请使用
pip install carrot-mc
6
可以同时指定许多mod键,例如:
pip install carrot-mc
7
同样地,
pip install carrot-mc
8
将禁用一个mod(如果指定了多个mod,则禁用多个mod)。
请注意,从现在起,依赖项和 主模式,必须手动切换。
启用/禁用模式
carrot不将mods的启用/禁用状态存储在mods.json
和
只查看文件名以确定状态。这边,应该是
与其他使用标准的mod管理器(如multimc)兼容
通过在mods的文件名后面附加。disabled
来禁用mods的约定。
当安装/更新mods时,carrot将保留状态,即禁用 更新后mod将保持禁用状态,您必须手动启用它。
Web图形用户界面
-启动Web用户界面
要启动基于Web的界面,只需键入:
pip install carrot-mc
9
carrot附带了一个内部web服务器,该服务器将使用此命令启动。
默认情况下(即,除非被--host
和--port
选项覆盖)。
它将监听http://localhost:8877/" rel="nofollow">http://localhost:8877/-只需将浏览器指向
地址:
在web gui中,您应该能够执行大多数可用的任务
完全从命令行。到目前为止,缺少的是:
更新
使用特定的频道安装
未来/计划功能
必须有1.0
搜索
(在cli中)- 卸载mods(删除未使用的依赖项)
- 修复损坏的mods(丢失/损坏的文件)
- 接受带有mods作为参数的目录,而不是始终使用current
- 将web gui的功能与cli对齐
1.0之后
- 在web gui中管理多个实例
- 复制/粘贴整组mod实例之间的s
- "最喜欢"的mods列表,便于创建modpack
- modpack管理-打包/解包以及配置、资源等。