Gitizen
安全地从 Git 更新 Denizen 脚本至 Minecraft 服务器。
Gitizen 加载仓库的指定分支,检查新脚本,并谨慎地替换 Denizen 的工作目录。如果 Denizen 检测到错误,它会自动回滚到之前的版本。
内容 / Contents
中文
功能
- 通过 HTTPS 与 GitHub 同步 Denizen 脚本。
- 支持私有和公共仓库。
- 支持多个配置文件,例如
production 和 staging。
- 每个配置文件拥有独立的分支和目录。
- 使用已安装的 Denizen 解析器检查
.dsc 文件。
- 通过暂存文件夹安全地替换目录。
- 如果 Denizen 在加载时检测到错误,自动回滚到上一个版本。
- 支持根据部署编号或 commit hash 手动回滚。
- 状态命令显示当前和远程的 commit。
- 部署历史和持续指标。
- Discord 和 Telegram 通知。
- 交互式消息:悬停提示、复制 hash 和 GitHub 链接。
- 防止同一配置文件的两个操作同时运行。
- 检测在工作目录中手动更改的文件。
Git checkout 存储在 plugins/Gitizen/repositories 中,而不是
plugins/Denizen/scripts 中。因此,Denizen 文件夹不包含 .git,仅用于活动脚本。
要求
- Paper 1.21.x。
- Java 21 或更高版本。
- 已安装并运行的 Denizen。
- 对 GitHub 的出站 HTTPS 访问。
- 对于通知——需要对 Discord 或 Telegram 的出站 HTTPS 访问。
Gitizen 依赖于 Denizen。如果缺少 Denizen,Paper 将不会加载 Gitizen。
安装
- 停止 Minecraft 服务器。
- 将
Gitizen-1.0.0.jar 复制到 plugins 文件夹。
- 确保
Denizen.jar 也位于 plugins 文件夹中。
- 启动服务器一次。
- 停止服务器并打开
plugins/Gitizen/config.yml。
- 指定仓库 URL 和所需分支。
- 如果是私有仓库,配置令牌(token)。
- 启动服务器并执行
/gitizen status。
- 首次部署请执行
/gitizen sync。
建议首次安装前备份
plugins/Denizen/scripts。在后续部署期间,Gitizen 会在完成检查之前自行保存当前的工作目录作为上一版本。
快速开始
公共仓库
最小配置:
default-profile: "production"
profiles:
production:
repo-url: "https://github.com/USER/REPOSITORY.git"
branch: "main"
repository-subdirectory: ""
target-directory: "scripts"
reload-denizen: true
username: "gitizen"
token-env: "GITIZEN_GITHUB_TOKEN"
token: ""
如果 .dsc 文件位于仓库内的 minecraft/denizen 文件夹中:
repository-subdirectory: "minecraft/denizen"
保存配置后:
/gitizen reload
/gitizen status production
/gitizen sync production
私有仓库
创建一个仅限访问所需仓库且具备“Contents: Read”权限的 GitHub fine-grained Personal Access Token。
首选方式是使用环境变量:
GITIZEN_GITHUB_TOKEN=github_pat_...
变量名称在以下位置指定:
token-env: "GITIZEN_GITHUB_TOKEN"
在游戏主机上,环境变量可能被称为“Environment variables”、“Startup variables”或“Secrets”。如果控制面板不支持它们,则可以将令牌直接写入配置文件中:
token-env: ""
token: "github_pat_..."
不要通过 Minecraft 命令传递 PAT。/gitizen setup 命令故意不接受令牌,以防止其出现在控制台日志中。
Production 和 Staging 配置文件
配置文件是保存的部署方案。它回答了五个问题:
- 从哪个 Git 仓库下载文件?
- 使用哪个分支?
- 从仓库内的哪个文件夹获取脚本?
- 将它们放入 Denizen 的哪个文件夹?
- 之后是否需要重新加载活动脚本?
production 和 staging 名称本身并不切换任何内容。它们是普通的配置文件名称,可以更改。行为由 branch、repository-subdirectory、target-directory 和 reload-denizen 的值决定。
在标准方案中,配置文件的使用方式如下:
| 配置文件 |
Git 分支 |
文件复制到哪里 |
Denizen 是否执行这些文件? |
production |
main |
plugins/Denizen/scripts |
是,在成功检查后立即执行 |
staging |
develop |
plugins/Denizen/scripts-staging |
否,这是一个单独的测试副本 |
两个配置文件的示例:
default-profile: "production"
profiles:
production:
repo-url: "https://github.com/USER/REPOSITORY.git"
branch: "main"
repository-subdirectory: "denizen"
target-directory: "scripts"
reload-denizen: true
username: "gitizen"
token-env: "GITIZEN_GITHUB_TOKEN"
token: ""
staging:
repo-url: "https://github.com/USER/REPOSITORY.git"
branch: "develop"
repository-subdirectory: "denizen"
target-directory: "scripts-staging"
reload-denizen: false
username: "gitizen"
token-env: "GITIZEN_GITHUB_TOKEN"
token: ""
当执行 sync production 时会发生什么
/gitizen sync production
Gitizen 将执行以下序列:
- Загрузит ветку
main из указанного repo-url.
- Возьмёт только содержимое папки
denizen из репозитория.
- Проверит найденные
.dsc parser-ом Denizen.
- Подготовит новую версию во временной папке.
- Заменит
plugins/Denizen/scripts.
- Перезагрузит Denizen, потому что указано
reload-denizen: true.
- При ошибке автоматически вернёт предыдущие скрипты.
После успешной команды изменения становятся активными на игровом сервере.
Что произойдёт при sync staging
/gitizen sync staging
Gitizen загрузит ветку develop, проверит файлы и положит их в
plugins/Denizen/scripts-staging. Рабочая папка plugins/Denizen/scripts при
этом не изменяется, а Denizen продолжает исполнять текущую production-версию.
Профиль staging полезен, чтобы:
- убедиться, что нужные файлы действительно загружаются из Git;
- заранее проверить структуру
.dsc;
- посмотреть подготовленную версию на сервере;
- не затронуть игроков во время подготовки релиза.
Важно: Gitizen не переносит staging в production автоматически. Обычный безопасный
процесс выглядит так:
- Разработчик отправляет изменения в ветку
develop.
- Администратор выполняет
/gitizen sync staging и проверяет результат.
- Изменения объединяются из
develop в main через GitHub.
- Администратор выполняет
/gitizen sync production.
Staging-проверка подтверждает, что файлы читаются parser-ом, но не проверяет их
поведение внутри игры: reload-denizen: false означает, что эти файлы не
подключаются к работающему Denizen.
Разница между source и target
Эти два параметра часто путают:
repository-subdirectory — откуда брать файлы внутри Git-репозитория;
target-directory — куда помещать файлы на Minecraft-сервере.
Для приведённого примера путь выглядит так:
GitHub: REPOSITORY/denizen/
│
├─ production → plugins/Denizen/scripts/
└─ staging → plugins/Denizen/scripts-staging/
target-directory задаётся относительно plugins/Denizen:
| Значение |
Полный путь на сервере |
scripts |
plugins/Denizen/scripts |
scripts-staging |
plugins/Denizen/scripts-staging |
test/server-one |
plugins/Denizen/test/server-one |
Указать ../ и выйти за пределы plugins/Denizen нельзя — Gitizen заблокирует
такую конфигурацию.
Что означает reload-denizen
true — после замены файлов Gitizen просит Denizen загрузить новую версию.
Используйте это для активного production-каталога.
false — файлы копируются и проверяются, но работающий Denizen их не загружает.
Используйте это для staging, архива или ручной проверки.
Если указано reload-denizen: true, Gitizen сверяет target-directory с реальной
активной папкой Denizen. При несовпадении deployment останавливается. Это защищает
от ситуации, когда команда сообщает об успехе, но Denizen продолжает использовать
другую папку.
Разные репозитории и токены
Профили не обязаны использовать один репозиторий. Например, production можно
загружать из закрытого основного репозитория, а staging — из отдельного тестового.
Для разных токенов укажите разные переменные окружения:
profiles:
production:
token-env: "GITIZEN_PRODUCTION_TOKEN"
staging:
token-env: "GITIZEN_STAGING_TOKEN"
default-profile: "production" означает, что команда /gitizen sync без имени
профиля равнозначна /gitizen sync production.
Профиль можно создать командой:
/gitizen setup production https://github.com/USER/REPOSITORY.git main
После изменения repository-subdirectory, каталога или секретов выполните
/gitizen reload.
Команды
| Команда |
Описание |
Право |
/gitizen help |
Показать доступные команды |
— |
/gitizen sync [profile] |
Проверить и развернуть выбранную ветку |
gitizen.sync |
/gitizen status [profile] |
Показать Git HEAD, remote HEAD и метрики |
gitizen.status |
/gitizen rollback [profile] <номер|hash> |
Вернуть предыдущую версию |
gitizen.rollback |
/gitizen logs [profile] [count] |
Показать последние commits |
gitizen.logs |
/gitizen list [profile] |
Показать все .dsc рекурсивно |
gitizen.list |
/gitizen profiles |
Показать настроенные профили |
gitizen.status |
/gitizen setup <profile> <url> [branch] |
Создать или изменить профиль |
gitizen.admin |
/gitizen reload |
Перечитать config.yml |
gitizen.admin |
Если профиль не указан, используется default-profile.
Право gitizen.admin включает все остальные права.
Что показывает status
/gitizen status production выводит:
- ветку профиля;
- HEAD внутреннего checkout;
- HEAD удалённой ветки;
- commit, который сейчас развёрнут;
- дату последнего успешного deployment;
- количество успешных и неуспешных операций;
- длительность и число файлов последней операции.
Если deployed commit отличается от remote HEAD, доступно обновление либо сейчас
активен rollback.
Rollback
Вернуть deployment, который был перед текущим:
/gitizen rollback 1
То же для конкретного профиля:
/gitizen rollback production 1
Откатиться на конкретный commit:
/gitizen rollback production a1b2c3d
Число означает позицию среди предыдущих успешных deployment:
1 — версия перед текущей;
2 — ещё одна версия назад.
История хранится в plugins/Gitizen/state.yml. Её размер задаётся параметром
deployment.max-history.
После ручного rollback команда /gitizen sync снова развернёт актуальный
origin/<branch>.
Автоматический rollback
Перед заменой рабочей папки Gitizen проверяет staging-файлы parser-ом Denizen.
После замены выполняется настоящий reload Denizen. Если Denizen сообщает об ошибке:
- Новая папка удаляется.
- Возвращается предыдущая папка.
- Возвращается предыдущий Git HEAD.
- Denizen повторно загружает восстановленные скрипты.
- Ошибка записывается в метрики и отправляется в настроенные уведомления.
Discord и Telegram
无需单独托管机器人或 Web 应用。Gitizen 直接从 Minecraft 服务器发送 HTTPS 请求。主机必须允许出站连接。
Discord
- 打开 Discord 服务器设置。
- 进入 Integrations → Webhooks。
- 创建一个 webhook 并复制 URL。
- 通过环境变量传递 URL:
GITIZEN_DISCORD_WEBHOOK=https://discord.com/api/webhooks/...
配置:
notifications:
discord:
webhook-url-env: "GITIZEN_DISCORD_WEBHOOK"
webhook-url: ""
如果无法使用环境变量,可以将 URL 写入 webhook-url。
Telegram
- 通过
@BotFather 创建机器人。
- 向你的机器人发送任意消息。
- 获取用户、群组或频道的 ID。
- 将机器人添加到所需的群组/频道并授予必要的权限。
- 配置变量:
GITIZEN_TELEGRAM_BOT_TOKEN=123456:ABC...
GITIZEN_TELEGRAM_CHAT_ID=-1001234567890
配置:
notifications:
telegram:
bot-token-env: "GITIZEN_TELEGRAM_BOT_TOKEN"
chat-id-env: "GITIZEN_TELEGRAM_CHAT_ID"
bot-token: ""
chat-id: ""
如果未收到通知,请检查 token、chat ID、机器人权限以及 Minecraft 主机对 api.telegram.org 的访问权限。
安全设置
security:
require-https: true
allowed-hosts:
- "github.com"
validation:
require-dsc-files: true
max-script-size-kb: 1024
deployment:
max-history: 20
max-changes-in-chat: 30
require-https 禁止未加密和 SSH URL。
allowed-hosts 限制 Gitizen 可以传输 Git 凭据的服务器。
require-dsc-files 禁止在没有 Denizen 脚本的情况下进行部署。
max-script-size-kb 限制单个被检查脚本的大小。
max-history 定义回滚深度。
max-changes-in-chat 限制 Minecraft 聊天中显示的变更行数。
对于 GitHub Enterprise,将其域名添加到 allowed-hosts 中。
Denizen 仓库实际上包含可执行的服务器逻辑。仅向受信任的开发人员授予写入权限,并使用只读 PAT。
常见问题
“在 origin 中找不到分支”
检查 branch 的确切名称、大小写以及该分支是否存在于仓库中。
“主机不在 security.allowed-hosts 中”
将 Git 服务器的域名添加到 security.allowed-hosts。如果使用私有 token,请勿添加未知域名。
GitHub 授权错误
请检查:
- URL 是否使用 HTTPS;
- PAT 是否已过期;
- PAT 是否具有所需仓库的 Contents: Read 权限;
- 如果使用 SSO,组织是否已批准该 token;
- 环境变量是否确实传递给了 Java 进程。
“target-directory 与 Denizen 活动目录不匹配”
对于配置了 reload-denizen: true 的配置文件,目录必须与实际使用的 Denizen 文件夹一致。通常是 plugins/Denizen/scripts,因此值应为 scripts。
部署在被激活前被拒绝
检查 Gitizen 的消息和控制台。可能的原因包括:空的 .dsc、YAML/Denizen 结构错误、文件过大、符号链接或缺少 .dsc。
通知未发送
确保主机允许以下服务的出站 HTTPS:
github.com;
discord.com;
api.telegram.org.
某些游戏面板需要单独授权外部连接。
旧版 config.yml
具有 repo-url、github-token 和 branch 键的旧版本配置会被读取为 production 配置文件。建议复制旧文件,删除它并重启服务器,然后将 URL、分支和 token 迁移到新结构中,以访问所有新设置。
服务文件
| 路径 |
用途 |
plugins/Gitizen/config.yml |
用户自定义设置 |
plugins/Gitizen/state.yml |
历史记录和指标 |
plugins/Gitizen/repositories/<profile> |
内部 Git checkout |
plugins/Denizen/scripts |
活动的 production 脚本 |
请勿手动编辑内部 checkout。对活动目录的更改将在下次 sync 时被检测到并替换。
English
Gitizen safely deploys Denizen scripts from Git repositories directly to a
Minecraft server. It fetches the configured branch, validates the candidate
scripts, swaps the Denizen directory, and restores the previous version
automatically when Denizen reports an error.
Features
- Public and private GitHub repositories over HTTPS.
- Multiple deployment profiles such as
production and staging.
- A separate repository, branch, source directory, and target for each profile.
- Preflight validation using the parser of the installed Denizen plugin.
- Staged directory replacement and automatic rollback.
- Manual rollback by deployment number or commit hash.
- Status command with repository, remote, deployment, and metrics information.
- Persistent deployment history.
- Discord and Telegram notifications.
- Adventure components with hover details, hash copying, and GitHub links.
- Per-profile operation lock and working-directory drift detection.
Git checkouts are stored under plugins/Gitizen/repositories. The active
plugins/Denizen/scripts directory is not used as a Git repository.
Requirements
- Paper 1.21.x.
- Java 21 or newer.
- Denizen installed and enabled.
- Outbound HTTPS access to GitHub.
- Outbound HTTPS access to Discord or Telegram when notifications are enabled.
Gitizen declares Denizen as a required dependency.
Installation
- Stop the Minecraft server.
- Copy
Gitizen-1.0.0.jar to the plugins directory.
- Make sure Denizen is installed.
- Start the server once.
- Stop it and open
plugins/Gitizen/config.yml.
- Configure the repository URL and branch.
- Configure a token if the repository is private.
- Start the server and run
/gitizen status.
- Run
/gitizen sync for the first deployment.
Create a manual backup of plugins/Denizen/scripts before the first installation.
Gitizen protects the previous directory during later deployments.
Quick start
最小化公开仓库配置:
default-profile: "production"
profiles:
production:
repo-url: "https://github.com/USER/REPOSITORY.git"
branch: "main"
repository-subdirectory: ""
target-directory: "scripts"
reload-denizen: true
username: "gitizen"
token-env: "GITIZEN_GITHUB_TOKEN"
token: ""
如果脚本存储在仓库的子目录中:
repository-subdirectory: "minecraft/denizen"
应用并部署:
/gitizen reload
/gitizen status production
/gitizen sync production
对于私有仓库,创建一个细粒度的 GitHub 个人访问令牌(Personal Access Token),权限要求如下:
Contents: 对所需仓库的读取访问权限。建议使用环境变量:
GITIZEN_GITHUB_TOKEN=github_pat_...
如果您的托管面板不支持环境变量:
token-env: ""
token: "github_pat_..."
不要通过 Minecraft 命令发送令牌。/gitizen setup 故意不接受机密信息。
生产与暂存配置文件
配置文件是一种保存好的部署配方。它回答了五个问题:
- 应该获取哪个 Git 仓库?
- 应该使用哪个分支?
- 仓库内的哪个目录包含脚本?
- 应该将脚本发送到 Denizen 的哪个目录?
- 之后是否重新加载活动的 Denizen 脚本?
production 和 staging 并非特殊关键字。它们只是普通的配置文件名称。其行为由 branch、repository-subdirectory、target-directory 和 reload-denizen 决定。
默认工作流程如下:
| 配置文件 |
Git 分支 |
目标位置 |
Denizen 是否执行? |
production |
main |
plugins/Denizen/scripts |
是,在成功验证后 |
staging |
develop |
plugins/Denizen/scripts-staging |
否,这是一个独立的测试副本 |
profiles:
production:
repo-url: "https://github.com/USER/REPOSITORY.git"
branch: `main`
repository-subdirectory: "denizen"
target-directory: "scripts"
reload-denizen: true
username: "gitizen"
token-env: "GITIZEN_GITHUB_TOKEN"
token: ""
staging:
repo-url: "https://github.com/USER/REPOSITORY.git"
branch: "develop"
repository-subdirectory: "denizen"
target-directory: "scripts-staging"
reload-denizen: false
username: "gitizen"
token-env: "GITIZEN_GITHUB_TOKEN"
token: ""
sync production 的作用
/gitizen sync production 获取 main 分支,读取仓库中的 denizen 目录,验证其 .dsc 文件,替换 plugins/Denizen/scripts,并重新加载 Denizen。如果重新加载报告错误,Gitizen 会自动恢复之前的目录。成功的生产部署将立即生效。
sync staging 的作用
/gitizen sync staging 获取 develop 分支,验证文件,并将它们写入 plugins/Denizen/scripts-staging。它不会修改 plugins/Denizen/scripts,Denizen 将继续运行当前的生产版本。
暂存环境用于检查下载的文件及其基本解析器兼容性,而不会影响玩家。它不会自动升级。典型的工作流程如下:
- 推送更改到
develop。
- 运行
/gitizen sync staging 并检查结果。
- 在 GitHub 上将
develop 合并到 main。
- 运行
/gitizen sync production。
由于暂存环境使用 reload-denizen: false,它不会测试实际的游戏内行为。
源目录和目标目录
repository-subdirectory 是 Git 仓库内部 的源目录。
target-directory 是 Minecraft 服务器 上的目标目录。
GitHub: REPOSITORY/denizen/
│
├─ production → plugins/Denizen/scripts/
└─ staging → plugins/Denizen/scripts-staging/
target-directory 相对于 plugins/Denizen。例如,scripts 意味着 plugins/Denizen/scripts。路径不能超出 Denizen 目录的范围。
reload-denizen
true 将已部署的文件加载到正在运行的 Denizen 实例中。请将其用于活动的生产目录。
false 仅复制并解析文件而不激活它们。请将其用于暂存或手动检查。
当重新加载启用时,Gitizen 会验证目标是否与 Denizen 的实际活动脚本目录匹配。如果不匹配,部署将被阻止,而不是报告虚假的成功。
配置文件可以使用不同的仓库、分支或凭据。如果需要单独的令牌,请为每个配置文件设置不同的 token-env 名称。
default-profile: "production" 使 /gitizen sync 等同于 /gitizen sync production。
在不暴露令牌的情况下创建或更新配置文件:
/gitizen setup production https://github.com/USER/REPOSITORY.git main
命令
| 命令 |
描述 |
权限 |
/gitizen help |
显示可用命令 |
— |
/gitizen sync [profile] |
验证并部署配置的分支 |
gitizen.sync |
/gitizen status [profile] |
显示 Git 状态和部署指标 |
gitizen.status |
/gitizen rollback [profile] <number|hash> |
恢复之前的部署 |
gitizen.rollback |
/gitizen logs [profile] [count] |
显示最近的提交记录 |
gitizen.logs |
/gitizen list [profile] |
递归列出 .dsc 文件 |
gitizen.list |
/gitizen profiles |
显示已配置的配置文件 |
gitizen.status |
/gitizen setup <profile> <url> [branch] |
创建或更新配置文件 |
gitizen.admin |
/gitizen reload |
重新加载 config.yml |
gitizen.admin |
当未指定配置文件时,将使用配置的 default-profile。
gitizen.admin 包含所有其他 Gitizen 权限。
回滚
恢复当前部署之前的状态:
/gitizen rollback 1
为特定配置文件恢复:
/gitizen rollback production 1
部署特定的提交:
/gitizen rollback production a1b2c3d
1 表示当前部署之前立即成功的一次部署;2
表示再往前一个版本。历史记录存储在
plugins/Gitizen/state.yml 中,并由 deployment.max-history 限制。
手动回滚后,/gitizen sync 会再次部署当前的远程分支。
对于自动回滚,Gitizen 首先验证暂存脚本,交换目录,
重新加载 Denizen,检查 Denizen 的错误标志,并在验证失败时恢复旧目录和 Git
HEAD。
Discord 和 Telegram
无需单独托管。Gitizen 直接从 Minecraft 服务器发送 HTTPS 请求。您的提供商必须允许出站连接。
Discord 环境变量:
GITIZEN_DISCORD_WEBHOOK=https://discord.com/api/webhooks/...
notifications:
discord:
webhook-url-env: "GITIZEN_DISCORD_WEBHOOK"
webhook-url: ""
Telegram 环境变量:
GITIZEN_TELEGRAM_BOT_TOKEN=123456:ABC...
GITIZEN_TELEGRAM_CHAT_ID=-1001234567890
notifications:
telegram:
bot-token-env: "GITIZEN_TELEGRAM_BOT_TOKEN"
chat-id-env: "GITIZEN_TELEGRAM_CHAT_ID"
bot-token: ""
chat-id: ""
对于 Telegram,使用 @BotFather 创建一个机器人,向其发送一条消息,确定
目标聊天 ID,并将机器人添加到所需的群组或频道中。
安全性
security:
require-https: true
allowed-hosts:
- "github.com"
validation:
require-dsc-files: true
max-script-size-kb: 1024
deployment:
max-history: 20
max-changes-in-chat: 30
- 保持启用 HTTPS 强制。
- 将
allowed-hosts 限制为受信任的 Git 服务器。
- 使用只读、仓库范围的令牌。
- 仅向受信任的开发人员授予仓库写入权限。
- 尽可能在托管环境变量中保存密钥。
使用 GitHub Enterprise 时,请显式添加主机名。
故障排除
在 origin 中找不到分支
检查确切的分支名称、大小写以及它是否在远程存在。
主机不在 security.allowed-hosts 中
将受信任的 Git 服务器主机名添加到 security.allowed-hosts。
GitHub 身份验证失败
验证 URL 是否使用 HTTPS,令牌是否未过期,是否具有 Contents: Read
权限,任何组织 SSO 要求是否已满足,并且环境变量是否到达了 Java 进程。
目标目录与 Denizen 的活动目录不匹配
具有 reload-denizen: true 的配置文件的配置文件必须指向 Denizen 的实际脚本文件夹。
对于默认的 Denizen 安装,请使用 target-directory: "scripts"。
激活前部署失败
检查 Gitizen 的消息和服务台控制台是否存在空的或无效的 .dsc、
文件过大、符号链接或缺少 Denizen 脚本。
通知未到达
确认凭据并确保托管提供商允许对 discord.com 或 api.telegram.org 的出站 HTTPS 访问。
迁移旧配置
旧的 repo-url、github-token 和 branch 键被读取为
production 配置文件。要使用所有新选项,请备份旧文件,重新生成
config.yml,并将仓库、分支和令牌复制到新的结构中。
数据文件
| 路径 |
用途 |
plugins/Gitizen/config.yml |
用户配置 |
plugins/Gitizen/state.yml |
部署历史和指标 |
plugins/Gitian/repositories/<profile> |
内部 Git 检出 |
plugins/Denizen/scripts |
活动的生产脚本 |
不要手动编辑内部检出。活动目标中的手动更改将在下次同步时被检测并替换。
从源代码构建
mvn clean verify
集成测试创建本地 Git 仓库并验证分支选择、
origin URL 更改、路径包含、更改检测和手动目标漂移。
许可证
MIT 许可证。版权所有 (c) 2026 Bloodulon。
Gitizen
Безопасное обновление Denizen-скриптов из Git прямо на Minecraft-сервере.
Gitizen загружает нужную ветку репозитория, проверяет новые скрипты, аккуратно
заменяет рабочий каталог Denizen и автоматически возвращает предыдущую версию,
если Denizen обнаруживает ошибку.
Contents / Содержание
Русский
Возможности
- Синхронизация Denizen-скриптов с GitHub по HTTPS.
- Работа с приватными и публичными репозиториями.
- Несколько профилей, например
production и staging.
- Отдельная ветка и каталог для каждого профиля.
- Проверка файлов
.dsc parser-ом установленного Denizen.
- Безопасная замена каталога через staging-папку.
- Автоматический возврат предыдущей версии при ошибке загрузки Denizen.
- Ручной rollback по номеру deployment или commit hash.
- Команда статуса с текущим и удалённым commit.
- История deployment и постоянные метрики.
- Discord и Telegram уведомления.
- Интерактивные сообщения: hover-подсказки, копирование hash и ссылки на GitHub.
- Защита от одновременного запуска двух операций одного профиля.
- Обнаружение файлов, вручную изменённых в рабочем каталоге.
Git checkout хранится в plugins/Gitizen/repositories, а не в
plugins/Denizen/scripts. Поэтому папка Denizen не содержит .git и используется
только для активных скриптов.
Требования
- Paper 1.21.x.
- Java 21 или новее.
- Установленный и запущенный Denizen.
- Исходящий HTTPS-доступ к GitHub.
- Для уведомлений — исходящий HTTPS-доступ к Discord или Telegram.
Gitizen зависит от Denizen. Если Denizen отсутствует, Paper не загрузит Gitizen.
Установка
- Остановите Minecraft-сервер.
- Скопируйте
Gitizen-1.0.0.jar в папку plugins.
- Убедитесь, что
Denizen.jar также находится в папке plugins.
- Запустите сервер один раз.
- Остановите сервер и откройте
plugins/Gitizen/config.yml.
- Укажите URL репозитория и нужную ветку.
- Если репозиторий приватный, настройте токен.
- Запустите сервер и выполните
/gitizen status.
- Для первого deployment выполните
/gitizen sync.
Перед первой установкой рекомендуется сохранить резервную копию
plugins/Denizen/scripts. Во время дальнейших deployment Gitizen самостоятельно
сохраняет предыдущий рабочий каталог до завершения проверки.
Быстрый старт
Публичный репозиторий
Минимальная конфигурация:
default-profile: "production"
profiles:
production:
repo-url: "https://github.com/USER/REPOSITORY.git"
branch: "main"
repository-subdirectory: ""
target-directory: "scripts"
reload-denizen: true
username: "gitizen"
token-env: "GITIZEN_GITHUB_TOKEN"
token: ""
Если .dsc находятся, например, в папке minecraft/denizen внутри репозитория:
repository-subdirectory: "minecraft/denizen"
После сохранения конфигурации:
/gitizen reload
/gitizen status production
/gitizen sync production
Приватный репозиторий
Создайте GitHub fine-grained Personal Access Token с доступом только к нужному
репозиторию и разрешением Contents: Read.
Предпочтительный вариант — переменная окружения:
GITIZEN_GITHUB_TOKEN=github_pat_...
Название переменной указывается в:
token-env: "GITIZEN_GITHUB_TOKEN"
На игровых хостингах переменные окружения могут называться «Environment variables»,
«Startup variables» или «Secrets». Если панель их не поддерживает, токен можно
записать непосредственно в конфиг:
token-env: ""
token: "github_pat_..."
Не передавайте PAT через Minecraft-команду. Команда /gitizen setup намеренно
не принимает токен, чтобы он не оказался в консольных логах.
Профили production и staging
Профиль — это сохранённый сценарий deployment. Он отвечает на пять вопросов:
- Из какого Git-репозитория загружать файлы?
- Какую ветку использовать?
- Из какой папки внутри репозитория брать скрипты?
- В какую папку Denizen их поместить?
- Нужно ли после этого перезагрузить активные скрипты?
Названия production и staging сами по себе ничего не переключают. Это обычные
имена профилей, которые можно изменить. Поведение определяется значениями
branch, repository-subdirectory, target-directory и reload-denizen.
В стандартной схеме профили используются так:
| Профиль |
Ветка Git |
Куда копируются файлы |
Denizen исполняет эти файлы? |
production |
main |
plugins/Denizen/scripts |
Да, сразу после успешной проверки |
staging |
develop |
plugins/Denizen/scripts-staging |
Нет, это отдельная тестовая копия |
Пример двух профилей:
default-profile: "production"
profiles:
production:
repo-url: "https://github.com/USER/REPOSITORY.git"
branch: "main"
repository-subdirectory: "denizen"
target-directory: "scripts"
reload-denizen: true
username: "gitizen"
token-env: "GITIZEN_GITHUB_TOKEN"
token: ""
staging:
repo-url: "https://github.com/USER/REPOSITORY.git"
branch: "develop"
repository-subdirectory: "denizen"
target-directory: "scripts-staging"
reload-denizen: false
username: "gitizen"
token-env: "GITIZEN_GITHUB_TOKEN"
token: ""
Что произойдёт при sync production
/gitizen sync production
Gitizen выполнит следующую последовательность:
- Загрузит ветку
main из указанного repo-url.
- Возьмёт только содержимое папки
denizen из репозитория.
- Проверит найденные
.dsc parser-ом Denizen.
- Подготовит новую версию во временной папке.
- Заменит
plugins/Denizen/scripts.
- Перезагрузит Denizen, потому что указано
reload-denizen: true.
- При ошибке автоматически вернёт предыдущие скрипты.
После успешной команды изменения становятся активными на игровом сервере.
Что произойдёт при sync staging
/gitizen sync staging
Gitizen загрузит ветку develop, проверит файлы и положит их в
plugins/Denizen/scripts-staging. Рабочая папка plugins/Denizen/scripts при
этом не изменяется, а Denizen продолжает исполнять текущую production-версию.
Профиль staging полезен, чтобы:
- убедиться, что нужные файлы действительно загружаются из Git;
- заранее проверить структуру
.dsc;
- посмотреть подготовленную версию на сервере;
- не затронуть игроков во время подготовки релиза.
Важно: Gitizen не переносит staging в production автоматически. Обычный безопасный
процесс выглядит так:
- Разработчик отправляет изменения в ветку
develop.
- Администратор выполняет
/gitizen sync staging и проверяет результат.
- Изменения объединяются из
develop в main через GitHub.
- Администратор выполняет
/gitizen sync production.
Staging-проверка подтверждает, что файлы читаются parser-ом, но не проверяет их
поведение внутри игры: reload-denizen: false означает, что эти файлы не
подключаются к работающему Denizen.
Разница между source и target
Эти два параметра часто путают:
repository-subdirectory — откуда брать файлы внутри Git-репозитория;
target-directory — куда помещать файлы на Minecraft-сервере.
Для приведённого примера путь выглядит так:
GitHub: REPOSITORY/denizen/
│
├─ production → plugins/Denizen/scripts/
└─ staging → plugins/Denizen/scripts-staging/
target-directory задаётся относительно plugins/Denizen:
| Значение |
Полный путь на сервере |
scripts |
plugins/Denizen/scripts |
scripts-staging |
plugins/Denizen/scripts-staging |
test/server-one |
plugins/Denizen/test/server-one |
Указать ../ и выйти за пределы plugins/Denizen нельзя — Gitizen заблокирует
такую конфигурацию.
Что означает reload-denizen
true — после замены файлов Gitizen просит Denizen загрузить новую версию.
Используйте это для активного production-каталога.
false — файлы копируются и проверяются, но работающий Denizen их не загружает.
Используйте это для staging, архива или ручной проверки.
Если указано reload-denizen: true, Gitizen сверяет target-directory с реальной
активной папкой Denizen. При несовпадении deployment останавливается. Это защищает
от ситуации, когда команда сообщает об успехе, но Denizen продолжает использовать
другую папку.
Разные репозитории и токены
Профили не обязаны использовать один репозиторий. Например, production можно
загружать из закрытого основного репозитория, а staging — из отдельного тестового.
Для разных токенов укажите разные переменные окружения:
profiles:
production:
token-env: "GITIZEN_PRODUCTION_TOKEN"
staging:
token-env: "GITIZEN_STAGING_TOKEN"
default-profile: "production" означает, что команда /gitizen sync без имени
профиля равнозначна /gitizen sync production.
Профиль можно создать командой:
/gitizen setup production https://github.com/USER/REPOSITORY.git main
После изменения repository-subdirectory, каталога или секретов выполните
/gitizen reload.
Команды
| Команда |
Описание |
Право |
/gitizen help |
Показать доступные команды |
— |
/gitizen sync [profile] |
Проверить и развернуть выбранную ветку |
gitizen.sync |
/gitizen status [profile] |
Показать Git HEAD, remote HEAD и метрики |
gitizen.status |
/gitizen rollback [profile] <номер|hash> |
Вернуть предыдущую версию |
gitizen.rollback |
/gitizen logs [profile] [count] |
Показать последние commits |
gitizen.logs |
/gitizen list [profile] |
Показать все .dsc рекурсивно |
gitizen.list |
/gitizen profiles |
Показать настроенные профили |
gitizen.status |
/gitizen setup <profile> <url> [branch] |
Создать или изменить профиль |
gitizen.admin |
/gitizen reload |
Перечитать config.yml |
gitizen.admin |
Если профиль не указан, используется default-profile.
Право gitizen.admin включает все остальные права.
Что показывает status
/gitizen status production выводит:
- ветку профиля;
- HEAD внутреннего checkout;
- HEAD удалённой ветки;
- commit, который сейчас развёрнут;
- дату последнего успешного deployment;
- количество успешных и неуспешных операций;
- длительность и число файлов последней операции.
Если deployed commit отличается от remote HEAD, доступно обновление либо сейчас
активен rollback.
Rollback
Вернуть deployment, который был перед текущим:
/gitizen rollback 1
То же для конкретного профиля:
/gitizen rollback production 1
Откатиться на конкретный commit:
/gitizen rollback production a1b2c3d
Число означает позицию среди предыдущих успешных deployment:
1 — версия перед текущей;
2 — ещё одна версия назад.
История хранится в plugins/Gitizen/state.yml. Её размер задаётся параметром
deployment.max-history.
После ручного rollback команда /gitizen sync снова развернёт актуальный
origin/<branch>.
Автоматический rollback
Перед заменой рабочей папки Gitizen проверяет staging-файлы parser-ом Denizen.
После замены выполняется настоящий reload Denizen. Если Denizen сообщает об ошибке:
- Новая папка удаляется.
- Возвращается предыдущая папка.
- Возвращается предыдущий Git HEAD.
- Denizen повторно загружает восстановленные скрипты.
- Ошибка записывается в метрики и отправляется в настроенные уведомления.
Discord и Telegram
Отдельно хостить бота или веб-приложение не требуется. Gitizen отправляет HTTPS-запрос
прямо с Minecraft-сервера. Хостинг должен разрешать исходящие соединения.
Discord
- Откройте настройки Discord-сервера.
- Перейдите в Integrations → Webhooks.
- Создайте webhook и скопируйте URL.
- Передайте URL через переменную окружения:
GITIZEN_DISCORD_WEBHOOK=https://discord.com/api/webhooks/...
Конфигурация:
notifications:
discord:
webhook-url-env: "GITIZEN_DISCORD_WEBHOOK"
webhook-url: ""
Если переменные окружения недоступны, URL можно записать в webhook-url.
Telegram
- Создайте бота через
@BotFather.
- Отправьте своему боту любое сообщение.
- Получите ID пользователя, группы или канала.
- Добавьте бота в нужную группу/канал и выдайте необходимые права.
- Настройте переменные:
GITIZEN_TELEGRAM_BOT_TOKEN=123456:ABC...
GITIZEN_TELEGRAM_CHAT_ID=-1001234567890
Конфигурация:
notifications:
telegram:
bot-token-env: "GITIZEN_TELEGRAM_BOT_TOKEN"
chat-id-env: "GITIZEN_TELEGRAM_CHAT_ID"
bot-token: ""
chat-id: ""
Если уведомления не приходят, проверьте токен, chat ID, права бота и доступ
Minecraft-хостинга к api.telegram.org.
Настройки безопасности
security:
require-https: true
allowed-hosts:
- "github.com"
validation:
require-dsc-files: true
max-script-size-kb: 1024
deployment:
max-history: 20
max-changes-in-chat: 30
require-https запрещает незашифрованные и SSH URL.
allowed-hosts ограничивает серверы, которым Gitizen может передать Git credentials.
require-dsc-files запрещает deployment без Denizen-скриптов.
max-script-size-kb ограничивает размер одного проверяемого скрипта.
max-history определяет глубину rollback.
max-changes-in-chat ограничивает количество строк изменений в Minecraft-чате.
Для GitHub Enterprise добавьте его домен в allowed-hosts.
Репозиторий Denizen фактически содержит исполняемую серверную логику. Выдавайте
доступ на запись только доверенным разработчикам и используйте read-only PAT.
Частые проблемы
«Ветка не найдена в origin»
Проверьте точное имя branch, регистр букв и наличие этой ветки в репозитории.
«Хост отсутствует в security.allowed-hosts»
Добавьте домен Git-сервера в security.allowed-hosts. Не добавляйте неизвестные
домены, если используете приватный токен.
Ошибка авторизации GitHub
Проверьте:
- URL использует HTTPS;
- PAT не истёк;
- PAT имеет Contents: Read для нужного репозитория;
- организация разрешила токен, если используется SSO;
- переменная окружения действительно передана процессу Java.
«target-directory не совпадает с активным каталогом Denizen»
Для профиля с reload-denizen: true каталог должен совпадать с папкой, которую
реально использует Denizen. Обычно это plugins/Denizen/scripts, поэтому значение
должно быть scripts.
Deployment отклонён до активации
Проверьте сообщения Gitizen и консоль. Возможные причины: пустой .dsc, ошибка
структуры YAML/Denizen, слишком большой файл, symlink или отсутствие .dsc.
Уведомления не отправляются
Убедитесь, что хостинг разрешает исходящий HTTPS на:
github.com;
discord.com;
api.telegram.org.
Некоторые игровые панели требуют отдельного разрешения внешних соединений.
Старый config.yml
Конфигурация старых версий с ключами repo-url, github-token и branch
читается как профиль production. Для доступа ко всем новым настройкам рекомендуется
сделать копию старого файла, удалить его и перезапустить сервер, затем перенести URL,
ветку и токен в новую структуру.
Служебные файлы
| Путь |
Назначение |
plugins/Gitizen/config.yml |
Пользовательские настройки |
plugins/Gitizen/state.yml |
История и метрики |
plugins/Gitizen/repositories/<profile> |
Внутренние Git checkout |
plugins/Denizen/scripts |
Активные production-скрипты |
Не редактируйте внутренние checkout вручную. Изменения в активном каталоге будут
обнаружены и заменены при следующем sync.
English
Gitizen safely deploys Denizen scripts from Git repositories directly to a
Minecraft server. It fetches the configured branch, validates the candidate
scripts, swaps the Denizen directory, and restores the previous version
automatically when Denizen reports an error.
Features
- Public and private GitHub repositories over HTTPS.
- Multiple deployment profiles such as
production and staging.
- A separate repository, branch, source directory, and target for each profile.
- Preflight validation using the parser of the installed Denizen plugin.
- Staged directory replacement and automatic rollback.
- Manual rollback by deployment number or commit hash.
- Status command with repository, remote, deployment, and metrics information.
- Persistent deployment history.
- Discord and Telegram notifications.
- Adventure components with hover details, hash copying, and GitHub links.
- Per-profile operation lock and working-directory drift detection.
Git checkouts are stored under plugins/Gitizen/repositories. The active
plugins/Denizen/scripts directory is not used as a Git repository.
Requirements
- Paper 1.21.x.
- Java 21 or newer.
- Denizen installed and enabled.
- Outbound HTTPS access to GitHub.
- Outbound HTTPS access to Discord or Telegram when notifications are enabled.
Gitizen declares Denizen as a required dependency.
Installation
- Stop the Minecraft server.
- Copy
Gitizen-1.0.0.jar to the plugins directory.
- Make sure Denizen is installed.
- Start the server once.
- Stop it and open
plugins/Gitizen/config.yml.
- Configure the repository URL and branch.
- Configure a token if the repository is private.
- Start the server and run
/gitizen status.
- Run
/gitizen sync for the first deployment.
Create a manual backup of plugins/Denizen/scripts before the first installation.
Gitizen protects the previous directory during later deployments.
Quick start
Minimal public-repository configuration:
default-profile: "production"
profiles:
production:
repo-url: "https://github.com/USER/REPOSITORY.git"
branch: "main"
repository-subdirectory: ""
target-directory: "scripts"
reload-denizen: true
username: "gitizen"
token-env: "GITIZEN_GITHUB_TOKEN"
token: ""
If scripts are stored in a repository subdirectory:
repository-subdirectory: "minecraft/denizen"
Apply and deploy:
/gitizen reload
/gitizen status production
/gitizen sync production
For a private repository, create a fine-grained GitHub Personal Access Token with
Contents: Read access to the required repository. Prefer an environment variable:
GITIZEN_GITHUB_TOKEN=github_pat_...
If your hosting panel does not support environment variables:
token-env: ""
token: "github_pat_..."
Do not send the token through a Minecraft command. /gitizen setup intentionally
does not accept secrets.
Production and staging profiles
A profile is a saved deployment recipe. It answers five questions:
- Which Git repository should be fetched?
- Which branch should be used?
- Which directory inside the repository contains the scripts?
- Which Denizen directory should receive them?
- Should the active Denizen scripts be reloaded afterward?
production and staging are not special keywords. They are ordinary profile
names. Their behavior comes from branch, repository-subdirectory,
target-directory, and reload-denizen.
The default workflow is:
| Profile |
Git branch |
Destination |
Does Denizen execute it? |
production |
main |
plugins/Denizen/scripts |
Yes, after successful validation |
staging |
develop |
plugins/Denizen/scripts-staging |
No, it is a separate test copy |
profiles:
production:
repo-url: "https://github.com/USER/REPOSITORY.git"
branch: "main"
repository-subdirectory: "denizen"
target-directory: "scripts"
reload-denizen: true
username: "gitizen"
token-env: "GITIZEN_GITHUB_TOKEN"
token: ""
staging:
repo-url: "https://github.com/USER/REPOSITORY.git"
branch: "develop"
repository-subdirectory: "denizen"
target-directory: "scripts-staging"
reload-denizen: false
username: "gitizen"
token-env: "GITIZEN_GITHUB_TOKEN"
token: ""
What sync production does
/gitizen sync production fetches main, reads the repository's denizen
directory, validates its .dsc files, replaces plugins/Denizen/scripts, and
reloads Denizen. If the reload reports an error, Gitizen restores the previous
directory automatically. A successful production deployment becomes live
immediately.
What sync staging does
/gitizen sync staging fetches develop, validates the files, and writes them
to plugins/Denizen/scripts-staging. It does not modify
plugins/Denizen/scripts, and Denizen continues running the current production
version.
Staging is useful for checking the downloaded files and their basic parser
compatibility without affecting players. It is not promoted automatically.
A typical workflow is:
- Push changes to
develop.
- Run
/gitizen sync staging and inspect the result.
- Merge
develop into main on GitHub.
- Run
/gitizen sync production.
Because staging uses reload-denizen: false, it does not test actual in-game
behavior.
Source and target directories
repository-subdirectory is the source directory inside the Git repository.
target-directory is the destination on the Minecraft server.
GitHub: REPOSITORY/denizen/
│
├─ production → plugins/Denizen/scripts/
└─ staging → plugins/Denizen/scripts-staging/
target-directory is relative to plugins/Denizen. For example, scripts
means plugins/Denizen/scripts. Paths cannot escape the Denizen directory.
reload-denizen
true loads the deployed files into the running Denizen instance. Use it for
the active production directory.
false copies and parses the files without activating them. Use it for staging
or manual inspection.
When reload is enabled, Gitizen verifies that the target matches Denizen's actual
active script directory. A mismatch blocks deployment instead of reporting a false
success.
Profiles may use different repositories, branches, or credentials. Set a different
token-env name for each profile when separate tokens are required.
default-profile: "production" makes /gitizen sync equivalent to
/gitizen sync production.
Create or update a profile without exposing a token:
/gitizen setup production https://github.com/USER/REPOSITORY.git main
Commands
| Command |
Description |
Permission |
/gitizen help |
Show available commands |
— |
/gitizen sync [profile] |
Validate and deploy the configured branch |
gitizen.sync |
/gitizen status [profile] |
Show Git state and deployment metrics |
gitizen.status |
/gitizen rollback [profile] <number|hash> |
Restore an earlier deployment |
gitizen.rollback |
/gitizen logs [profile] [count] |
Show recent commits |
gitizen.logs |
/gitizen list [profile] |
Recursively list .dsc files |
gitizen.list |
/gitizen profiles |
Show configured profiles |
gitizen.status |
/gitizen setup <profile> <url> [branch] |
Create or update a profile |
gitizen.admin |
/gitizen reload |
Reload config.yml |
gitizen.admin |
The configured default-profile is used when no profile is specified.
gitizen.admin includes every other Gitizen permission.
Rollback
Restore the deployment before the current one:
/gitizen rollback 1
Restore it for a specific profile:
/gitizen rollback production 1
Deploy a specific commit:
/gitizen rollback production a1b2c3d
1 means the successful deployment immediately before the current one; 2
means one version further back. History is stored in
plugins/Gitizen/state.yml and limited by deployment.max-history.
After a manual rollback, /gitizen sync deploys the current remote branch again.
For automatic rollback, Gitizen validates staging scripts first, swaps the directory,
reloads Denizen, checks Denizen's error flag, and restores the old directory and Git
HEAD when validation fails.
Discord and Telegram
No separate hosting is required. Gitizen sends HTTPS requests directly from the
Minecraft server. Your provider must allow outbound connections.
Discord environment variable:
GITIZEN_DISCORD_WEBHOOK=https://discord.com/api/webhooks/...
notifications:
discord:
webhook-url-env: "GITIZEN_DISCORD_WEBHOOK"
webhook-url: ""
Telegram environment variables:
GITIZEN_TELEGRAM_BOT_TOKEN=123456:ABC...
GITIZEN_TELEGRAM_CHAT_ID=-1001234567890
notifications:
telegram:
bot-token-env: "GITIZEN_TELEGRAM_BOT_TOKEN"
chat-id-env: "GITIZEN_TELEGRAM_CHAT_ID"
bot-token: ""
chat-id: ""
For Telegram, create a bot with @BotFather, send it a message, determine the
target chat ID, and add the bot to the required group or channel.
Security
security:
require-https: true
allowed-hosts:
- "github.com"
validation:
require-dsc-files: true
max-script-size-kb: 1024
deployment:
max-history: 20
max-changes-in-chat: 30
- Keep HTTPS enforcement enabled.
- Restrict
allowed-hosts to trusted Git servers.
- Use a read-only, repository-scoped token.
- Grant repository write access only to trusted developers.
- Keep secrets in hosting environment variables when possible.
Add the hostname explicitly when using GitHub Enterprise.
Troubleshooting
Branch not found in origin
Check the exact branch name, capitalization, and whether it exists remotely.
Host is not in security.allowed-hosts
Add the trusted Git server hostname to security.allowed-hosts.
GitHub authentication fails
Verify that the URL uses HTTPS, the token is not expired, it has Contents: Read
permission, any organization SSO requirement is satisfied, and the environment
variable reaches the Java process.
Target directory does not match Denizen's active directory
A profile with reload-denizen: true must target Denizen's actual script folder.
For a default Denizen installation, use target-directory: "scripts".
Deployment fails before activation
Check Gitizen's message and the server console for an empty or invalid .dsc,
oversized file, symbolic link, or missing Denizen scripts.
Notifications do not arrive
Confirm credentials and make sure the hosting provider allows outbound HTTPS access
to discord.com or api.telegram.org.
Migrating an old configuration
Legacy repo-url, github-token, and branch keys are read as the
production profile. To use all new options, back up the old file, regenerate
config.yml, and copy the repository, branch, and token into the new structure.
Data files
| Path |
Purpose |
plugins/Gitizen/config.yml |
User configuration |
plugins/Gitizen/state.yml |
Deployment history and metrics |
plugins/Gitizen/repositories/<profile> |
Internal Git checkouts |
plugins/Denizen/scripts |
Active production scripts |
Do not manually edit internal checkouts. Manual changes in an active target are
detected and replaced during the next sync.
Building from source
mvn clean verify
The integration tests create local Git repositories and verify branch selection,
origin URL changes, path containment, change detection, and manual target drift.
License
MIT License. Copyright (c) 2026 Bloodulon.
评论 0
登录后参与评分
还没有评论,来抢沙发吧