> For the complete documentation index, see [llms.txt](https://docs.vanillasquad.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.vanillasquad.com/drugoe/squad-sync.md).

# Squad Sync

Squad Sync создан для ваших сообществ и устанавливается по ссылке, как любой другой бот.

[Добавьте бота](http://vanillasquad.com/squadsync) на ваш Discord-сервер, и он начнёт изменять никнеймы участников так, чтобы они соответствовали их игровым никнеймам. Это упрощает общение и взаимодействие, особенно если вы играете вместе или управляете городом в игре.

### 1. Добавьте бота на сервер

Перейдите [по ссылке](http://vanillasquad.com/squadsync) и пригласите бота на ваш сервер. Убедитесь, что у него есть права на изменение никнеймов и управление ролями — без этого он не сможет работать корректно.

### 2. Настройте бота

Введите команду `/help` в чате Discord, чтобы получить подсказки по настройке. Это поможет вам включить синхронизацию и разобраться с основными функциями бота.

### 3. Сделайте роль бота выше синхронизируемых ролей

В настройках сервера перетащите роль `Squad Sync` выше тех ролей, которые бот будет выдавать или синхронизировать. Если роль бота окажется ниже, он не сможет изменять никнеймы или выдавать роли участникам.

<figure><img src="/files/Xrvk2JjKFY8vYPU3Vnrd" alt=""><figcaption></figcaption></figure>

### 4. Проверьте настройки бота

Перед запуском синхронизации ещё раз используйте команду `/help`, чтобы убедиться, что всё настроено правильно. Это займёт всего пару секунд, но поможет избежать ошибок.

### 5. Синхронизуйте игроков, которые зашли на сервер до установки бота

Введите команду `/everyone-sync`, чтобы синхронизировать всех участников сервера. Это нужно сделать только один раз — новых пользователей бот будет обрабатывать автоматически. Процесс может занять от пары секунд до двух минут из-за ограничений Discord.

### 6. Готово

Поздравляем! Бот настроен и теперь будет автоматически синхронизировать ники и роли участников. Если кто-то изменит ник в игре, бот обновит его и в Discord. Наслаждайтесь удобством!

### Дополнительные команды бота

`/settings` — включить/выключить автосинхронизацию (каждые 15 мин)\
`/help` — Показывает все доступные команды и подсказки по использованию бота.\
`/everyone-sync` — разовая массовая синхронизация всех участников\
`/sync  @user` — обновить ник одного пользователя вручную\
`/setup` — быстрый старт