Git Craft

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

```yaml 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

```bash /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):

```yaml 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.