MCGit

MCGit

在Minecraft中使用Git/GitHub为你的建筑添加版本控制。你的基地被炸了?只需/git revert

管理

MCGit

MCGit Logo

需要 MC 26.1 Fabric、fabric-api 和 fabric-language-kotlin

MCGit 是一个 Minecraft 模组,为你的 Minecraft 世界带来类似 Git 的版本控制功能。它允许你跟踪方块和实体的变化、提交这些变化,并管理世界的不同版本。

  • 如果你炸毁了你的基地,或者做了一些看起来不太好的改动,你可以直接使用 /git revert。
  • 如果你做了一个看起来不错的改动,就提交它:/git commit <msg>
  • 你可以备份你的建筑,并使用诸如 GitHub 这样的免费托管服务来分享它。
  • 你永远不会丢失你的进度,每个已提交的建筑版本都会被保存。
  • 你可以“复刻”他人的建筑,并在对方允许的情况下按自己的喜好进行修改。
  • 他人的建筑可以直接克隆到你的世界中。
  • 非常轻量且易于使用。
  • 不需要外部工具: 你不需要在 Minecraft 之外安装 Git 或任何其他软件。MCGit 内置了 JGit——一个纯 Java 实现的 Git,用于在内部处理所有 Git 操作。

命令

标记为 @ 的命令需要 setblock 权限。
[..] 表示可选参数。

注意:出现诸如“Couldn't set block”之类的错误是完全正常的。这仅仅意味着 MCGit 尝试将一个方块改为它本身。这是无害的。

注意2:如果你没有启用 /git autoadd 和 /git autorm,你需要使用 /git add 和 /git rm 手动将方块添加到暂存区或从暂存区移除。
为避免混淆,现在默认启用此功能,但仅在创造模式下。

  • /git init <name> 初始化一个新的 MCGit 仓库。
  • /git activate <name> 切换到指定的仓库。
  • /git add <coords> 将指定坐标的一个方块添加到暂存区。
  • /git add <coords> <coords> [|hollow|outline] 将一个长方体区域内的方块添加到暂存区
  • @/git rm <coords> [coords] [|hollow|outline] 从暂存区移除方块/实体并还原它们。注意:在世界中更改方块/实体需要通过执行命令来完成,因为这是一个客户端模组。
  • /git unstage ... 不会还原,仅从暂存区移除。
  • /git commit [-m] "message" 使用一条消息提交暂存的更改。-m 标志不起作用。
  • @/git revert [commit-hash] 与 /git reset 相同,但也会更改世界。可以省略提交哈希以还原到最新提交(HEAD)。
  • /git reset [commit-hash] 重置到指定的提交哈希或最新提交。这不会还原实际世界。这是 /git add 的逆操作
  • /git status 显示仓库的当前状态,包括已暂存的更改、未暂存的更改,但不包括未跟踪的方块/实体。
  • /git commitList 列出当前分支中的所有提交。
  • /git repoList 列出所有可用的仓库。
  • /git autoadd [toggle|on|off] 启用或禁用自动将更改添加到暂存区。要快速切换,请在副手使用附魔红色羊毛来使此命令表现为切换(因此,如果副手持有它,则自动添加为关闭,否则为开启)。
  • /git autorm [toggle|on|off] 启用或禁用自动从暂存区移除已删除的方块/实体。要快速切换,请在副手使用附魔红色羊毛来使此命令表现为切换(因此,如果副手持有它,则 autorm 为关闭,否则为开启)。
  • @/git clone <name> <url/local> 从指定 URL 克隆远程仓库到具有给定名称的新本地仓库。 URL 可以是本地仓库名称(如 myrepo),或者 GitHub 的 author/repo(如 octocat/Hello-World),或者指向 git 仓库的完整 URL(如 https://github.com/octocat/Hello-World.git)。
  • /git clonesoft <name> <url> 与 /git clone 相同,但不将其放入世界
  • @/git put <local> 与 /git clone 相同,但不保存为新仓库。
  • /git remote add [remote=origin] <url> 添加一个具有指定名称和 URL 的新远程仓库。
  • @/git pull [remote=origin] [branch=main] [default|ff-only|rebase|no-rebase] 从指定的远程仓库和分支获取更改并合并到当前分支。default 与 ff-only 相同,但为了自动补全的用户友好性而包含。
  • /git fetch [remote=origin] [branch=main] [default|ff-only|rebase|no-rebase] 与 /git pull 相同
  • /git push [force|noforce] [remote=origin] [branch=main] 将已提交的更改推送到指定的远程仓库和分支。
  • /git auth <username> [password] 存储用于访问远程仓库的身份验证凭据。如果省略密码,则仅存储用户名。 注意 凭据以明文形式未加密存储。
  • /git branch <name> 切换到具有给定名称的分支,如果不存在则创建它。