Gitizen

Gitizen

Gitizen — это системный плагин для серверов Minecraft (Paper/Spigot), предназначенный для автоматизации деплоя скриптов Denizen напрямую из репозиториев GitHub.

Русский (Russian)

Описание

Плагин обеспечивает связь между вашей средой разработки на GitHub и рабочим сервером. Он устраняет необходимость использования ручных методов передачи файлов (таких как FTP или SFTP), позволяя обновлять логику сервера одной командой.

Основные функции

- Безопасность: Использование стратегии Fetch и Hard Reset гарантирует, что локальные файлы на сервере будут идентичны состоянию репозитория, исключая ошибки слияния (merge conflicts). - Безопасность: Система сравнивает хеши коммитов и выводит список модифицированных файлов с маркерами статуса: Безопасность (добавлен), Безопасность (изменен), Безопасность (удален). - Безопасность: После завершения загрузки файлов плагин инициирует внутреннюю команду перезагрузки скриптов Denizen. - Безопасность: Поддержка аутентификации через Personal Access Tokens (PAT) позволяет работать с приватными репозиториями без передачи пароля от аккаунта.

Команды и права доступа

| Команда | Описание | Право (Permission) | |--------------------------|-----------------------------------------------|---------------------| | `/gitizen setup [url] [token]` | Конфигурация репозитория и токена доступа. | `gitizen.admin` | | `/gitizen sync` | Запуск процесса синхронизации. | `gitizen.sync` | | `/gitizen list` | Вывод списка всех файлов .dsc в папке скриптов. | `gitizen.admin` |

Порядок установки

1. Разместите JAR-файл в папку `plugins` и запустите сервер. 2. Сгенерируйте токен доступа в настройках GitHub (Developer Settings > Personal access tokens). 3. Выполните команду настройки: `/gitizen setup <url> <token>` или же зайдите в `pluginsGitizenconfig.yml` и настройте в ручную (РЕКОМЕНДОВАНО). 4. Выполните `/gitizen sync` для первичной загрузки данных.

English

Description

Gitizen is a utility plugin for Minecraft servers that synchronizes the Denizen scripts directory with a remote GitHub repository. It streamlines the development workflow by removing the need for manual file uploads.

Features

- Private Repository Support: By employing Fetch and Hard Reset operations, the plugin ensures the server's script folder strictly matches the remote repository, bypassing any potential local conflicts. - Private Repository Support: During synchronization, the plugin analyzes the difference between commits and reports all changes using status markers: Private Repository Support, Private Repository Support, and Private Repository Support. - Private Repository Support: Automatically triggers the Denizen script reload process upon successful synchronization. - Private Repository Support: Securely connects to GitHub using Personal Access Tokens (PAT).

Commands and Permissions

| Command | Description | Permission | |--------------------------|--------------------------------------------------|--------------------| | `/gitizen setup [url] [token]` | Configures the repository URL and access token. | `gitizen.admin` | | `/gitizen sync` | Triggers the synchronization process. | `gitizen.sync` | | `/gitizen list` | Displays a list of all current .dsc files. | `gitizen.admin` |

Installation

1. Install the plugin and restart the server. 2. Create a GitHub Personal Access Token with the 'repo' scope. 3. Use the command: `/gitizen setup <url> <token>` to link your repository OR go to `pluginsGitizenconfig.yml` and configure manually (RECOMMENDED). 4. Run `/gitizen sync` to deploy your scripts.

---

Поддержка: MIT License Поддержка: Bloodulon Поддержка: 0.21 Поддержка: Если у вас есть вопросы, создайте issue в репозитории GitHub.