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을 바꿔도 이전 데이터는 그대로 남아 있어요. 그래서 원래 값으로 되돌리면 이전 데이터가 모두 복원돼요.