AGENT SKILL
14-achieve-storage
暂无简介
- License 许可
- MIT
- 最近更新
- 2026-04-12
- Stars
- ★ 0
- Forks
- 0
03 SKILL.md 正文
14-achieve-storage
Status: ACTIVE AppliesTo: v10
AchieveStorage 저장 모델 규약 문서다.
Implementation Location
framework-cs/apps/UnityExample/Assets/Samples/Devian Samples/{version}/MobilePackage/Runtime/Achieve/AchieveStorage.csframework-cs/apps/UnityExample/Assets/Samples/Devian Samples/{version}/MobilePackage/Runtime/SaveData/JsonCodec/SaveDataJsonCodecAchieve.csframework-cs/apps/UnityExample/Assets/Samples/Devian Samples/{version}/MobilePackage/Runtime/SaveData/JsonCodec/SaveDataJsonCodec.cs
Ownership
AchieveManager가AchieveStorage를 소유한다.- 정본 접근 경계:
AchieveManager.Storage
Storage Model
AchieveStorage 필드:
schemaVersionnextAchieveUidruntimes: Dictionary<int, AchieveRuntimeBase>
규칙:
runtimes는 업적 진행/claim 상태의 저장 정본이다.- progress source는 runtime별
MESSAGE.saveType규칙을 따른다.TOTAL_*: 외부 저장(GameMessageStorage) projectionSESSION_*: runtime 내부progressValue
Clear()는 schema 기본값 + 모든 컬렉션 초기화
SaveData Payload
루트 payload에서 Achieve 섹션은 achieve 키를 사용한다.
{
"version": 15,
"achieve": {
"schemaVersion": 2,
"nextAchieveUid": 1,
"runtimes": [
{
"achieveType": 1,
"achieve_id": "...",
"achieveUid": 1,
"level": 1,
"index": 0,
"progressValue": { "base": 0, "pow": 0 },
"isWaiting": false,
"isCompleted": false
}
]
}
}
핵심 규칙:
- achieve runtime 저장 위치는 반드시
achieve.runtimes - period 개념은 없고
achieve.period계층을 사용하지 않는다.
Deserialize Rules
AchieveStorage.Clear()후 복원- uid <= 0 항목은 무시
nextAchieveUid <= 0이면 1로 보정- 누락 키는 안전 기본값 사용
- 구버전 payload에
achieveType이 없으면 table(TB_ACHIEVE_SOCIAL,TB_ACHIEVE_PASS) 기반으로 타입을 추론한다.