GitPuller

GitPuller

用于数据包的游戏内 Git 管理工具。

工具

GitPuller

私有仓库

如果你想使用私有仓库,需要设置一个令牌。你可以在 GitHub 上此处轻松生成令牌。 确保选择 repo 范围。

关于如何设置令牌的更多信息,可以在 GitHub 帮助页面上找到。

模组会首先尝试使用环境中的令牌,然后是配置文件中的令牌。如果通过命令提供令牌,它将用于当前会话并覆盖其他方法。

环境令牌

你可以使用(系统)环境变量为所有会话设置令牌。

Unix/Linux/macOS:

export GITPULLER_TOKEN=<token>

Windows:

CMD:

set GITPULLER_TOKEN=<token>

Powershell:

$Env:GITPULLER_TOKEN = "<token>"

配置文件

你也可以在配置文件中设置令牌。

gitpuller.key=<token>

临时令牌

你可以在游戏中为当前会话设置令牌(服务器重启后将丢失)。

/git token <token>

命令用法

经典模式

# 检出到分支、提交、标签或引用
git checkout <pack name> <branch>

# 克隆新仓库到 world/datapacks 文件夹。<pack name> 是将要创建的文件夹名称。
git clone <pack name> <url>

# 获取当前仓库的信息
git info

# 获取所选包的变化。如果 HEAD 是该分支最后一个可用提交,但添加了新的提交,它将检出到最新的可用提交。
git pull <pack name>

# 使用临时令牌(不推荐)
git token <token>

MonoRepo 模式

MonoRepo 模式禁用 git clone 命令并更改其他命令的语法。有关 monorepo 的更多信息,请参阅 monorepo 部分。

# 检出到分支、提交、标签或引用
git checkout <branch>

# 获取当前仓库的信息
git info

# 获取变化。如果 HEAD 是该分支最后一个可用提交,但添加了新的提交,它将检出到最新的可用提交。
git pull

# 使用临时令牌(不推荐)
git token <token>

MonoRepo

从 1.1.0+ 版本开始,GitPuller 支持 monorepo 模式。

此模式将 /world/datapacks/ 文件夹视为单个仓库,而不是多个仓库的集合。这意味着 /git 命令现在只与 monorepo 交互,而不与各个仓库交互。一些命令的语法已更改以反映这一点,更多信息请参阅 命令部分。

要启用此模式,你需要在配置中通过远程仓库的 URL 设置 gitpuller.monorepo 选项。

gitpuller.monorepo=<url>

将此选项留空或从配置中删除该条目将禁用 monorepo 模式。

⚠️ 警告:在启用此模式之前,你的 /world/datapacks/ 文件夹必须为空。