GitPuller

Работа с приватными репозиториями

Для доступа к защищенным репозиториям потребуется настроить токен доступа. На GitHub его можно быстро создать в соответствующем разделе настроек. Убедитесь, что выбран доступ к репозиториям.

Модификация ищет токены в следующей последовательности: сначала проверяет переменные окружения, затем параметры конфигурации. При использовании команды с токеном в процессе работы, он применяется только на текущую сессию, переопределяя другие способы авторизации.

Настройка через переменные окружения

Используйте системные переменные окружения для установки постоянного токена доступа.

Для Linux и macOS:

export GITPULLER_TOKEN=<ваш_токен>

Для Windows:

Командная строка CMD:

set GITPULLER_TOKEN=<ваш_токен>

PowerShell:

$Env:GITPULLER_TOKEN = "<ваш_токен>"

Настройка через конфигурационный файл

Альтернативный способ - задать токен в файле настроек:

gitpuller.key=<ваш_токен>

Временный токен для сессии

В игре можно временно установить токен, который действует только до перезапуска сервера:

/git token <токен>

Использование команд

Стандартный режим

# Переключение на ветку, коммит, тег или ссылку
git checkout <название_пакета> <ветка>

# Клонирование нового репозитория в папку world/datapacks.
# <название_пакета> определяет имя создаваемой папки
git clone <название_пакета> <url>

# Получение информации о текущих репозиториях
git info

# Загрузка изменений для выбранного пакета.
# Если HEAD соответствовал последнему доступному коммиту в ветке,
# но появились новые коммиты, произойдет переключение на последний доступный коммит
git pull <название_пакета>

# Использование временного токена (не рекомендуется)
git token <токен>

Режим MonoRepo

В режиме монорепозитория отключается команда git clone, а другие команды изменяют синтаксис. Подробнее о монорепозиториях в соответствующем разделе.

# Переключение на ветку, коммит, тег или ссылку
git checkout <ветка>

# Получение информации о текущем репозитории
git info

# Загрузка изменений.
# Если HEAD соответствовал последнему доступному коммиту в ветке,
# но появились новые коммиты, произойдет переключение на последний доступный коммит
git pull

# Использование временного токена (не рекомендуется)
git token <токен>

Режим MonoRepo

Начиная с версии 1.1.0, GitPuller поддерживает работу в режиме монорепозитория. В этом режиме папка /world/datapacks/ рассматривается как единый репозиторий, а не как коллекция отдельных репозиториев. Все команды /git теперь взаимодействуют только с монорепозиторием, а не с отдельными репозиториями.

Для активации этого режима необходимо установить параметр gitpuller.monorepo на URL вашего удаленного репозитория в конфигурации:

gitpuller.monorepo=<url>

Удаление этой настройки или установка пустого значения отключает режим монорепозитория.

⚠️ ВНИМАНИЕ: папка /world/datapacks/ должна быть пустой перед включением этого режима.