DataStores
HD Admin хранит все свои сохранённые данные в одном DataStore под названием HDAdmin:

Они разложены по двум путям, PlayerStore и GameStore:

...в которых лежат такие данные:
| Данные | Ключ |
|---|---|
| Профиль игрока | HD/PlayerStore/[USER_ID]/Profile |
| Данные всей игры (роли, настройки игры, проверенные команды и т. д.) | HD/GameStore/Game |
| Баны | HD/GameStore/Bans |
| Постоянные участники ролей | HD/GameStore/Members |
| Предупреждения | HD/GameStore/Warns |
| Логи | HD/GameStore/Logs |
Сохраняются только изменения¶
В v1 при каждом сохранении записывался весь набор данных игрока целиком. В v2 вместо этого считается разница с настройками по умолчанию, и сохраняется только то, что реально изменилось. Если игрок ни разу не менял настройку, не получал роль и не получал бан, для него вообще ничего не записывается. Изменения для всей игры работают так же: хранятся только те поля, которые ты поменял, а значения по умолчанию подставляются обратно при запуске.
Info
Так профили остаются маленькими, запросов на запись минимум, а HD Admin меньше расходует твой лимит DataStore.
Безопасно по своей конструкции¶
Мы сделали так, чтобы HD Admin работал с данными по тем же лучшим практикам, что и топовые игры:
| Особенность | Что делает |
|---|---|
| Блокировка сессии | Профили игроков блокируются на время сессии, поэтому два сервера никогда не перезапишут изменения друг друга, если игрок быстро перескакивает между серверами или оказывается сразу на двух |
| Самоочистка | Истёкшие временные баны, записи уровня сервера и устаревшие данные удаляются автоматически при загрузке данных, так что старый мусор не копится в хранилище |
| Готово к GDPR | Данные игрока сохраняются вместе с его UserId, поэтому инструменты Roblox для права на удаление данных отслеживают их автоматически |
| Удобно в Studio | Если доступ к API в Studio отключён, HD Admin откатывается к значениям по умолчанию и выводит в консоль одно уведомление вместо ошибки |
Сброс данных¶
В ConfigSettings есть настройка DataGroupName (по умолчанию "HD"). Если её изменить, все данные HD Admin сбросятся полностью, включая профили игроков, роли и баны.
Tip
Старые данные при смене DataGroupName не удаляются, поэтому если вернуть исходное значение, все прежние данные восстановятся.