[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6CBBRQG2W37M7B92KFGF6T1":3,"skill-same:01M6CBBRQG2W37M7B92KFGF6T1":44},{"skillNo":4,"name":5,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":21,"frontMatter":22,"refName":23,"commitSha":24,"skillDirectory":25,"forksCount":13,"repositoryHtmlUrl":26,"repositoryHomepageUrl":6,"ownerHtmlUrl":27,"ownerBlogUrl":6,"ownerDescription":28,"updatedAt":29,"install":30,"resources":43},"01M6CBBRQG2W37M7B92KFGF6T1","26-player-prefs",null,"devwinsoft\u002Fdevian","devwinsoft","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F22570160?v=4","01M6C6RR8W05NH8NPKQNCE3Q72","maoshy","01M6C6RRDJ5TJJCZXRTY801YDH",0,"MIT","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian-unity\u002F20-common-package\u002F26-player-prefs\u002FSKILL.md",[],[18],"26 player prefs","2026-11-10 10:12:30",false,"# 26-player-prefs\n\n## 0. 목적\nUnity PlayerPrefs를 실전적으로 안전\u002F일관되게 사용하기 위해,\n- 키 오타\u002F난립을 줄이고\n- 기본값\u002F자동 초기화를 통일하며\n- class(복합 설정) 저장을 JSON(1-key)로 표준화한다.\n\n본 스킬은 Devian Foundation Runtime에서 제공하는 Prefs 래퍼의 정본이다.\n설정 자산 SSOT는 CommonSystem의 BundleSettings를 따른다.\n\n---\n\n## 1. 포함 범위\n- Primitive: IntPrefs \u002F FloatPrefs \u002F BoolPrefs \u002F StringPrefs\n- Enum(string): EnumPrefs\u003CT>\n- Class(JSON 1-key): JsonPrefs\u003CT>\n\n---\n\n## 2. Key 네이밍 규약 (Hard)\n- 키는 prefix를 포함한 dot-style을 사용한다.\n  - 예: `devian.game.audio.bgm`\n- prefix는 코드에서 상수로 직접 선언한다.\n  - 예: `const string Prefix = \"devian.game.\";`\n\n---\n\n## 3. 기본값 및 자동 초기화 (Hard)\n- 모든 Prefs 래퍼는 `HasKey(key)==false`일 때:\n  - defaultValue를 즉시 SetXXX로 기록한 뒤\n  - defaultValue를 반환한다.\n- Delete는 `PlayerPrefs.DeleteKey(key)`만 수행한다.\n\n---\n\n## 4. Save 정책 (Hard)\n- Prefs 래퍼의 setter는 Save()를 자동 호출하지 않는다.\n- 앱 종료\u002F백그라운드 진입 시점에서 호출한다:\n  - `OnApplicationPause(true)`\n  - `OnApplicationQuit()`\n\n예외:\n- JsonPrefs.Edit(..., saveNow:true)로 즉시 저장이 필요한 설정만 선택적으로 Save 가능.\n\n---\n\n## 5. Enum 저장 규약 (Hard)\n- Enum은 반드시 문자열로 저장한다.\n  - `PlayerPrefs.SetString(key, enumValue.ToString())`\n- enum에 새 값이 중간 삽입\u002F리오더 될 수 있으므로 int 저장 방식은 금지한다.\n\n---\n\n## 6. Class(JSON) 저장 규약 (Hard)\n- JsonPrefs\u003CT>는 1개의 key에 JSON 문자열로 저장한다.\n- Load는 default 인스턴스를 만든 후 `FromJsonOverwrite`로 덮어쓴다.\n  - 목적: 필드 추가 시 default 유지(부분 overwrite)\n- JSON 파싱 실패 시 default로 복구하여 저장한다.\n\n제한:\n- Unity JsonUtility 제한을 따른다 (Dictionary 직렬화 불가 등).\n\n---\n\n## 7. 사용 예시 (짧게)\n\n```csharp\nusing System;\nusing UnityEngine;\n\nnamespace Devian\n{\n    public enum QualityPreset { Low, Medium, High }\n\n    [Serializable]\n    public class UserSettings\n    {\n        public int version = 1;\n        public float bgmVolume = 1f;\n        public bool haptic = true;\n        public QualityPreset quality = QualityPreset.Medium;\n    }\n\n    public static class GamePrefs\n    {\n        private const string Prefix = \"devian.game.\";\n\n        public static readonly FloatPrefs BgmVolume = new(Prefix + \"audio.bgm\", 1f);\n        public static readonly BoolPrefs Haptic = new(Prefix + \"haptic.enabled\", true);\n        public static readonly EnumPrefs\u003CQualityPreset> Quality = new(Prefix + \"gfx.quality\", QualityPreset.Medium);\n\n        public static readonly JsonPrefs\u003CUserSettings> Settings = new(Prefix + \"settings\", new UserSettings());\n    }\n\n    public sealed class PrefsExample : MonoBehaviour\n    {\n        private void Start()\n        {\n            GamePrefs.BgmVolume.Value = 0.7f;\n            GamePrefs.Haptic.Value = false;\n            GamePrefs.Quality.Value = QualityPreset.High;\n\n            GamePrefs.Settings.Edit(s =>\n            {\n                s.version = 2;\n                s.bgmVolume = GamePrefs.BgmVolume.Value;\n                s.haptic = GamePrefs.Haptic.Value;\n                s.quality = GamePrefs.Quality.Value;\n            }, saveNow: true);\n        }\n    }\n}\n```\n\n---\n\n## 8. 파일 구조\n\n```\nRuntime\u002FUnity\u002FPrefs\u002F\n  PrefsValue.cs       # 추상 베이스 클래스\n  IntPrefs.cs         # int 래퍼\n  FloatPrefs.cs       # float 래퍼\n  BoolPrefs.cs        # bool 래퍼 (int 0\u002F1 저장)\n  StringPrefs.cs      # string 래퍼\n  EnumPrefs.cs        # enum 래퍼 (string 저장)\n  JsonPrefs.cs        # class JSON 래퍼\n```\n\n---\n\n## 9. API 요약\n\n### PrefsValue\u003CT> (추상 베이스)\n```csharp\npublic abstract class PrefsValue\u003CT>\n{\n    public bool HasKey { get; }\n    public abstract T Value { get; set; }\n    public void Delete();\n}\n```\n\n### IntPrefs \u002F FloatPrefs \u002F BoolPrefs \u002F StringPrefs\n```csharp\npublic sealed class IntPrefs : PrefsValue\u003Cint>\n{\n    public IntPrefs(string key, int defaultValue);\n}\n\u002F\u002F FloatPrefs, BoolPrefs, StringPrefs 동일 패턴\n```\n\n### EnumPrefs\u003CT>\n```csharp\npublic sealed class EnumPrefs\u003CT> : PrefsValue\u003CT> where T : struct, Enum\n{\n    public EnumPrefs(string key, T defaultValue);\n}\n```\n\n### JsonPrefs\u003CT>\n```csharp\npublic sealed class JsonPrefs\u003CT> where T : class, new()\n{\n    public JsonPrefs(string key, T defaultValue = null);\n    public T Value { get; }\n    public void Edit(Action\u003CT> mutator, bool saveNow = true);\n    public void Save(bool saveNow = false);\n    public void Delete();\n}\n```\n",{},"main","8cb5bd877a3a7004867d2f55697cb9e4ff2f1734","skills\u002Fdevian-unity\u002F20-common-package\u002F26-player-prefs","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian","https:\u002F\u002Fgithub.com\u002Fdevwinsoft","Kim Hyong Joon","2026-04-12 18:44:10",{"source":7,"skillName":5,"commands":31,"prompt":41,"zipAvailable":42},[32,35,38],{"tool":33,"command":34},"npx","npx skills add devwinsoft\u002Fdevian --skill 26-player-prefs",{"tool":36,"command":37},"bunx","bunx skills add devwinsoft\u002Fdevian --skill 26-player-prefs",{"tool":39,"command":40},"pnpm","pnpm dlx skills add devwinsoft\u002Fdevian --skill 26-player-prefs","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian-unity\u002F20-common-package\u002F26-player-prefs\u002FSKILL.md",true,[],[45,51,59,67,76,83],{"skillNo":46,"name":47,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":48,"categories":49,"keywords":50,"publishedAt":19},"01M6CBX3K2JJV38ANHVGCAT8A0","devian","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002FSKILL.md",[],[47],{"skillNo":52,"name":53,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":54,"categories":55,"keywords":56,"publishedAt":19},"01M6CBX210BFMM8AMN770J9WY8","90-project-archive","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F90-project-archive\u002FSKILL.md",[],[57,58],"archive","90 project archive",{"skillNo":60,"name":61,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":62,"categories":63,"keywords":64,"publishedAt":19},"01M6CBWZSGRR9R3YJZB3177667","30-env-management","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F30-env-management\u002FSKILL.md",[],[65,66],"management","30 env management",{"skillNo":68,"name":69,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":70,"categories":71,"keywords":72,"publishedAt":19},"01M6CBWYD3TGWBQV7V35551THF","19-page-push-send","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F20-operation\u002F19-page-push-send\u002FSKILL.md",[],[73,74,75],"push","page","19 page push send",{"skillNo":77,"name":78,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":79,"categories":80,"keywords":81,"publishedAt":19},"01M6CBWWRQ05A7604GHJKTPJTF","18-page-savedata","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F20-operation\u002F18-page-savedata\u002FSKILL.md",[],[74,82],"18 page savedata",{"skillNo":84,"name":85,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":86,"categories":87,"keywords":88,"publishedAt":19},"01M6CBWVH4S2VF1V7B2GBTESCT","17-page-deobfuscate","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F20-operation\u002F17-page-deobfuscate\u002FSKILL.md",[],[74,89],"17 page deobfuscate"]