GitCraft

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:

• PaperMC 1.21.4
• Java 21
• Works with both local and self-hosted Git servers (e.g., Gitea, Forgejo)

---

🔧 Features

• In-game Git commands: init, add, commit, push, pull, etc.
• Secure credential storage using H2 database + AES encryption
• Per-user Git commits using in-game name & custom email
• Warns users when using public Git hosts (GitHub, GitLab)
• Repository path selector via flags
• Optional permission restrictions for each command
• Help command: /git help

---

⚙️ Configuration

disable-unsafe-warning: false

When disable-unsafe-warning is false, you cannot add public Git hosts (e.g., github.com, gitlab.com).
You're encouraged to use self-hosted Git solutions like:

• Gitea
• Forgejo
• SourceHut

---

📜 Commands Overview

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

---

🔐 Permissions

Control access to Git commands via permissions (default: OP only):

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

Use a permission plugin like LuckPerms to grant access to non-op users.