Перейти к содержанию

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 не удаляются, поэтому если вернуть исходное значение, все прежние данные восстановятся.