콘텐츠로 이동

DataStores

HD Admin은 저장하는 모든 데이터를 HDAdmin이라는 DataStore 하나에 보관해요:

이미지

데이터는 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 친화적 Studio API 접근이 꺼져 있으면 오류를 내지 않고 기본값을 사용하며, 콘솔에 안내를 한 번만 표시해요

데이터 초기화

ConfigSettings에는 DataGroupName(기본값 "HD")이라는 설정이 있어요. 이 값을 바꾸면 플레이어 프로필, 역할, 밴을 포함한 HD Admin의 모든 데이터를 완전히 초기화할 수 있어요.

Tip

DataGroupName을 바꿔도 이전 데이터는 그대로 남아 있어요. 그래서 원래 값으로 되돌리면 이전 데이터가 모두 복원돼요.