Git Craft | Use Git On Minecraft icon

Git Craft | Use Git On Minecraft v1.0.1

An Git Client In Minecraft Server

GitCraft is a fully functional in-game Git client built into your Minecraft server.
It allows server administrators to commit, push, pull, fetch, and manage Git repositories without ever leaving the game.

Compatible with:

  1. PaperMC 1.21.4
  2. Java 21
  3. Works with both local and self-hosted Git servers (Gitea, Forgejo, etc.)


Features

  1. In-game Git commands (init, add, commit, push, pull, etc.)
  2. Secure credential storage using H2 database and AES encryption
  3. ‍ Per-user Git commits using in-game name & custom email
  4. Warns users when using public Git hosts (GitHub, GitLab)
  5. Repository path selector via flags
  6. Optional permission restrictions for each command
  7. Help command: [ICODE]/git help[/ICODE]



Configuration

disable-unsafe-warning: false

If disable-unsafe-warning is false, you cannot add public Git hosts like github.com/gitlab.com. You're encouraged to use self-hosted Git solutions such as:

  1. Gitea
  2. Forgejo
  3. SourceHut



Commands Overview

/git init --path=
/git add  [--path=]
/git reset --hard| [--path=]
/git commit --message="Your message" [--path=]
/git remote --add|--set-url|--remove --url= [--path=]
/git push [--path=]
/git pull [--path=]
/git fetch [--path=]
/git login --username= --token=
/git whoami
/git logout
/git help


Permissions
You can control access to each Git command using permissions:

gitcraft.command.add:
    default: op
  gitcraft.command.commit:
    default: op
  gitcraft.command.reset:
    default: op
  gitcraft.command.init:
    default: op
  gitcraft.command.remote:
    default: op
  gitcraft.command.status:
    default: op
  gitcraft.command.help:
    default: op
  gitcraft.command.push:
    default: op
  gitcraft.command.fetch:
    default: op
  gitcraft.command.pull:
    default: op
  gitcraft.command.login:
    default: op
  gitcraft.command.whoami:
    default: op
  gitcraft.command.logout:
    default: op


Use permission plugins like Luckperms to grant specific players or roles access to these features.
All permissions default to OPs only. Grant access explicitly for non-op users.