GitPuller

GitPuller

Приватный репозиторий

Если вы хотите использовать приватный репозиторий, вам нужно настроить токен. Токен можно легко сгенерировать на GitHub здесь. Убедитесь, что выбрали область repo.

Больше информации о том, как настроить токен, можно найти на странице помощи GitHub.

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

Токен из окружения

Вы можете использовать (системную) переменную окружения, чтобы задать токен для всех сессий.

Unix/Linux/macOS:

export GITPULLER_TOKEN=<token>

Windows:

CMD:

set GITPULLER_TOKEN=<token>

Powershell:

$Env:GITPULLER_TOKEN = "<token>"

Файл конфигурации

Вы также можете задать токен в файле конфигурации.

gitpuller.key=<token>

Временный токен

Вы можете задать токен в игре для текущей сессии (будет потерян после перезапуска сервера).

/git token <token>

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

Классический режим

# Переключение на ветку, коммит, тег или ref
git checkout <pack name> <branch>

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

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

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

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

Режим MonoRepo

Режим MonoRepo отключает команду git clone и меняет синтаксис остальных. Больше информации о монорепозиториях в разделе о монорепозиториях.

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

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

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

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

MonoRepo

Начиная с версий 1.1.0+ GitPuller поддерживает режим монорепозитория.

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

Чтобы включить этот режим, нужно задать параметр gitpuller.monorepo с URL вашего удалённого репозитория в конфиге.

gitpuller.monorepo=<url>

Если оставить этот параметр пустым или удалить запись из конфига, режим монорепозитория отключится.

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