From 7699b307c8dd8eb3b86ced8a6268081313bc8c12 Mon Sep 17 00:00:00 2001 From: Muhammad Tamir Date: Thu, 19 Jun 2025 21:18:28 +0700 Subject: [PATCH] README.md --- README.md | 45 +++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 45 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..3a7c922 --- /dev/null +++ b/README.md @@ -0,0 +1,45 @@ +

+ YueMi Logo +

+ +

+ + Discord + +

+ +--- + +**Git Craft** is a secure in-game Git command interface for Minecraft (Paper API 1.21.4+), built for developers and server administrators. It allows players to manage Git repositories directly from the game using `/git` commands with stored encrypted credentials. + +--- + +## 💡 Features + +- Perform Git actions from in-game: `init`, `add`, `commit`, `push`, `pull`, `fetch`, `remote`, and more. +- Secure credential storage using **H2 encrypted database** (`CIPHER=AES`). +- Salted token obfuscation for added protection. +- Configurable warning system to prevent unsafe usage of public Git hosting. +- Asynchronous command handling to avoid server lag. + +--- + +## 🛡️ Security Warning + +By default, GitCraft **blocks** adding public Git hosting (e.g., GitHub, GitLab) as remote origins. +To override this, set `disable-unsafe-warning: true` in `plugins/GitCraft/config.yml`. + +We **strongly recommend** using a **self-hosted Git platform** such as: +- [Gitea](https://gitea.io/) +- [Forgejo](https://forgejo.org/) +- [GitBucket](https://gitbucket.github.io/) + +--- + +## ⚙️ Configuration + +**`plugins/GitCraft/config.yml`**: + +```yaml +# WARNING: Disabling this allows users to push to public Git hosts (GitHub, GitLab, etc.) +disable-unsafe-warning: false