nccgs 2.1.1 → 3.0.0-rc.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (705) hide show
  1. package/CHANGELOG.md +76 -235
  2. package/LICENSE +1 -1
  3. package/README.md +87 -206
  4. package/THIRD_PARTY_NOTICES.md +6 -34
  5. package/bin/nccgs.mjs +96 -0
  6. package/cli/doctor.mjs +82 -0
  7. package/cli/feedback.mjs +13 -0
  8. package/cli/install.mjs +111 -0
  9. package/cli/release.mjs +59 -0
  10. package/cli/run.mjs +35 -0
  11. package/cli/spawn.mjs +20 -0
  12. package/cli/uninstall.mjs +43 -0
  13. package/cli/update-check.mjs +66 -0
  14. package/docs/EVIDENCE-VERIFICATION.md +22 -0
  15. package/package.json +23 -30
  16. package/runtime/core/diag.mjs +43 -0
  17. package/runtime/core/feedback-policy.mjs +54 -0
  18. package/runtime/core/fs.mjs +80 -0
  19. package/runtime/core/job-object.mjs +73 -0
  20. package/runtime/core/modes.mjs +87 -0
  21. package/runtime/core/process-tree.mjs +109 -0
  22. package/runtime/core/project.mjs +113 -0
  23. package/runtime/core/snapshot.mjs +114 -0
  24. package/runtime/hooks/common.mjs +22 -0
  25. package/runtime/hooks/done-guard.mjs +15 -0
  26. package/runtime/hooks/guard-mcp.mjs +8 -0
  27. package/runtime/hooks/guard-shell.mjs +16 -0
  28. package/runtime/hooks/guard-write.mjs +25 -0
  29. package/runtime/hooks/session-log.mjs +7 -0
  30. package/runtime/hooks/session-start.mjs +40 -0
  31. package/runtime/hooks/unity-transport.mjs +12 -0
  32. package/runtime/modes.json +39 -0
  33. package/runtime/task/cost.mjs +103 -0
  34. package/runtime/task/criteria.mjs +128 -0
  35. package/runtime/task/feedback.mjs +136 -0
  36. package/runtime/task/ledger.mjs +109 -0
  37. package/runtime/task/plan.mjs +69 -0
  38. package/runtime/task/project.mjs +79 -0
  39. package/runtime/task/report.mjs +252 -0
  40. package/runtime/task/task.mjs +238 -0
  41. package/runtime/unity/assets.mjs +51 -0
  42. package/runtime/unity/playtest.mjs +145 -0
  43. package/runtime/unity/unity.mjs +350 -0
  44. package/scripts/check-job-object.mjs +18 -0
  45. package/scripts/sync-unity-skills.mjs +35 -119
  46. package/template/CLAUDE.md +39 -0
  47. package/template/agents/fast-fix.md +9 -0
  48. package/template/agents/implementer.md +19 -0
  49. package/template/agents/playtester.md +15 -0
  50. package/template/agents/reviewer.md +19 -0
  51. package/template/agents/scout.md +9 -0
  52. package/template/ponytail/README.md +8 -0
  53. package/{.claude/nccgs/packages → template}/ponytail/engineering.md +10 -0
  54. package/template/protocols/evidence.md +52 -0
  55. package/template/protocols/playtest.md +45 -0
  56. package/template/protocols/review.md +34 -0
  57. package/template/protocols/unity-cli-notes.md +56 -0
  58. package/template/settings.fragment.json +33 -0
  59. package/template/skills/art-bible/SKILL.md +19 -0
  60. package/template/skills/asset-spec/SKILL.md +19 -0
  61. package/template/skills/brainstorm/SKILL.md +17 -0
  62. package/template/skills/feedback/SKILL.md +16 -0
  63. package/template/skills/map-systems/SKILL.md +25 -0
  64. package/template/skills/playtest/SKILL.md +17 -0
  65. package/template/skills/status/SKILL.md +18 -0
  66. package/template/skills/test/SKILL.md +34 -0
  67. package/template/skills/unity-foundation/SKILL.md +17 -0
  68. package/template/skills/vertical-slice/SKILL.md +17 -0
  69. package/template/skills/work/SKILL.md +65 -0
  70. package/tools/feedback-worker/README.md +12 -0
  71. package/tools/feedback-worker/worker.js +39 -0
  72. package/tools/feedback-worker/wrangler.toml +12 -0
  73. package/unity-skills/2d-pixel-perfect/SKILL.md +208 -0
  74. package/unity-skills/2d-pixel-perfect/references/api-reference.md +81 -0
  75. package/unity-skills/2d-pixel-perfect/references/camera-setup-builtin.cs +40 -0
  76. package/unity-skills/2d-pixel-perfect/references/camera-setup-urp.cs +49 -0
  77. package/unity-skills/2d-pixel-perfect/references/pipeline-detection.cs +50 -0
  78. package/unity-skills/2d-pixel-perfect/references/sprite-settings.cs +37 -0
  79. package/unity-skills/asset-transformer-toolkit/SECURITY.md +15 -0
  80. package/unity-skills/asset-transformer-toolkit/SKILL.md +39 -0
  81. package/unity-skills/asset-transformer-toolkit/references/create-importer.md +121 -0
  82. package/unity-skills/asset-transformer-toolkit/references/lods.md +61 -0
  83. package/unity-skills/asset-transformer-toolkit/references/rule-api.md +154 -0
  84. package/unity-skills/asset-transformer-toolkit/references/ruleblock-api.md +37 -0
  85. package/unity-skills/asset-transformer-toolkit/references/ruleset-api.md +138 -0
  86. package/unity-skills/asset-transformer-toolkit/references/rulesets-and-actions.md +227 -0
  87. package/unity-skills/audio-setup-mixers/SECURITY.md +16 -0
  88. package/unity-skills/audio-setup-mixers/SKILL.md +127 -0
  89. package/unity-skills/audio-setup-mixers/references/api.md +162 -0
  90. package/unity-skills/build-gtk/SKILL.md +242 -0
  91. package/unity-skills/build-gtk/references/graph-api.md +324 -0
  92. package/unity-skills/build-gtk/references/pitfalls.md +86 -0
  93. package/unity-skills/build-gtk/references/runtime-and-visualization.md +196 -0
  94. package/unity-skills/build-gtk/references/state-machine-api.md +286 -0
  95. package/unity-skills/build-live-game/SKILL.md +255 -0
  96. package/{.claude/skills → unity-skills}/build-live-game/references/achievements.md +132 -154
  97. package/{.claude/skills → unity-skills}/build-live-game/references/apis.md +10 -19
  98. package/{.claude/skills → unity-skills}/build-live-game/references/authentication.md +14 -20
  99. package/{.claude/skills → unity-skills}/build-live-game/references/battlepass.md +269 -225
  100. package/unity-skills/build-live-game/references/blueprints-and-samples.md +75 -0
  101. package/unity-skills/build-live-game/references/cloud-code-cloudbehaviours.md +1111 -0
  102. package/unity-skills/build-live-game/references/cloud-code-modules.md +1276 -0
  103. package/unity-skills/build-live-game/references/cloud-code.md +58 -0
  104. package/{.claude/skills → unity-skills}/build-live-game/references/cloud-save.md +15 -25
  105. package/{.claude/skills → unity-skills}/build-live-game/references/deployment.md +33 -18
  106. package/{.claude/skills → unity-skills}/build-live-game/references/player-account.md +31 -23
  107. package/{.claude/skills → unity-skills}/build-live-game/references/tooling.md +0 -56
  108. package/unity-skills/build-live-game/references/ugs-cli.md +86 -0
  109. package/unity-skills/craft-game-floors/SECURITY.md +23 -0
  110. package/unity-skills/craft-game-floors/SKILL.md +134 -0
  111. package/unity-skills/craft-game-floors/references/art-direction.md +85 -0
  112. package/unity-skills/craft-game-floors/references/camera-rigs.md +51 -0
  113. package/unity-skills/craft-game-floors/references/character-motion.md +35 -0
  114. package/unity-skills/craft-game-floors/references/game-audio.md +47 -0
  115. package/unity-skills/craft-game-floors/references/game-feel.md +68 -0
  116. package/unity-skills/craft-game-floors/references/game-shell.md +45 -0
  117. package/unity-skills/craft-game-floors/references/live-floor.md +35 -0
  118. package/unity-skills/craft-game-floors/references/placeholder-assets.md +35 -0
  119. package/unity-skills/craft-game-floors/references/scene-lighting.md +52 -0
  120. package/unity-skills/craft-game-floors/references/toon-shading.md +34 -0
  121. package/unity-skills/craft-game-floors/references/vfx.md +40 -0
  122. package/unity-skills/craft-game-floors/references/visual-scorecard.md +43 -0
  123. package/unity-skills/create-2d-physics/SECURITY.md +16 -0
  124. package/unity-skills/create-2d-physics/SKILL.md +128 -0
  125. package/unity-skills/create-2d-physics/references/2d-physics-core.md +155 -0
  126. package/unity-skills/create-2d-physics/references/legacy-2d-physics.md +45 -0
  127. package/unity-skills/create-tile-palette-or-rule-tiles/SKILL.md +12 -0
  128. package/unity-skills/create-tile-palette-or-rule-tiles/references/hexagonalruletile.md +71 -0
  129. package/unity-skills/create-tile-palette-or-rule-tiles/references/palette-create.md +38 -0
  130. package/unity-skills/create-tile-palette-or-rule-tiles/references/ruletile-createempty.md +35 -0
  131. package/unity-skills/create-tile-palette-or-rule-tiles/references/ruletile-createfromsegment.md +212 -0
  132. package/unity-skills/create-tile-palette-or-rule-tiles/references/ruletile.md +90 -0
  133. package/unity-skills/create-tile-palette-or-rule-tiles/scripts/CreatePaletteTemplate.cs +148 -0
  134. package/unity-skills/create-tile-palette-or-rule-tiles/scripts/ManualWorkflowExample.cs +63 -0
  135. package/unity-skills/create-tile-palette-or-rule-tiles/scripts/RuleTileGenerator.cs +61 -0
  136. package/unity-skills/create-tile-palette-or-rule-tiles/scripts/TilemapRuleTileCreateFromSegment.cs +225 -0
  137. package/unity-skills/generate-editor-search-query/SECURITY.md +17 -0
  138. package/unity-skills/generate-editor-search-query/SKILL.md +117 -0
  139. package/unity-skills/generate-editor-search-query/references/open-search-window.md +70 -0
  140. package/unity-skills/generate-editor-search-query/references/query-patterns.md +124 -0
  141. package/{.claude/skills → unity-skills}/implement-in-app-purchases/SKILL.md +1 -2
  142. package/{.claude/skills → unity-skills}/implement-in-app-purchases/references/api-notes.md +25 -28
  143. package/{.claude/skills → unity-skills}/implement-in-app-purchases/references/path-convert-native-google-billing.md +1 -1
  144. package/{.claude/skills → unity-skills}/implement-in-app-purchases/references/path-implement-iap-d2c.md +40 -5
  145. package/{.claude/skills → unity-skills}/initialize-ai-navigation/SKILL.md +4 -4
  146. package/{.claude/skills → unity-skills}/initialize-ai-navigation/references/navigation-system.md +3 -3
  147. package/{.claude/skills → unity-skills}/levelplay-unity-integration/CHANGELOG.md +12 -0
  148. package/{.claude/skills → unity-skills}/levelplay-unity-integration/README.md +9 -5
  149. package/unity-skills/levelplay-unity-integration/SKILL.md +442 -0
  150. package/{.claude/skills → unity-skills}/levelplay-unity-integration/references/banner-api.md +15 -8
  151. package/{.claude/skills → unity-skills}/levelplay-unity-integration/references/best-practices.md +604 -536
  152. package/unity-skills/levelplay-unity-integration/references/dependency-resolution.md +94 -0
  153. package/{.claude/skills → unity-skills}/levelplay-unity-integration/references/ilrd-api.md +2 -2
  154. package/{.claude/skills → unity-skills}/levelplay-unity-integration/references/initialization-api.md +221 -0
  155. package/{.claude/skills → unity-skills}/levelplay-unity-integration/references/interstitial-api.md +11 -3
  156. package/{.claude/skills → unity-skills}/levelplay-unity-integration/references/ios-setup.md +6 -34
  157. package/{.claude/skills → unity-skills}/levelplay-unity-integration/references/migration-sdk-9.md +1 -1
  158. package/{.claude/skills → unity-skills}/levelplay-unity-integration/references/privacy-settings.md +14 -29
  159. package/{.claude/skills → unity-skills}/levelplay-unity-integration/references/rewarded-api.md +20 -4
  160. package/unity-skills/levelplay-unity-integration/references/testing-and-validation.md +222 -0
  161. package/unity-skills/levelplay-unity-integration/references/troubleshooting.md +99 -0
  162. package/unity-skills/localization/SKILL.md +347 -0
  163. package/{.claude/skills → unity-skills}/localization/references/api-notes.md +4 -0
  164. package/unity-skills/localization/resources/L10nBatchProcessor.cs +191 -0
  165. package/unity-skills/manage-sprite-atlas/SKILL.md +351 -0
  166. package/unity-skills/manage-sprite-atlas/references/addressables-delivery.md +58 -0
  167. package/unity-skills/manage-sprite-atlas/references/api.md +382 -0
  168. package/unity-skills/manage-sprite-atlas/references/best-practices.md +183 -0
  169. package/unity-skills/manage-sprite-atlas/references/common-errors.md +123 -0
  170. package/unity-skills/manage-sprite-atlas/references/custom-packing.md +147 -0
  171. package/unity-skills/manage-sprite-atlas/references/manual-authoring.md +39 -0
  172. package/unity-skills/manage-sprite-atlas/resources/authoringvsruntime.cs +176 -0
  173. package/unity-skills/manage-sprite-atlas/resources/buildaddressablespostprocess.cs +59 -0
  174. package/unity-skills/manage-sprite-atlas/resources/cacheloadedatlases.cs +145 -0
  175. package/unity-skills/manage-sprite-atlas/resources/cleanupbatchoperations.cs +119 -0
  176. package/unity-skills/manage-sprite-atlas/resources/createandconfiguremasteratlas.cs +57 -0
  177. package/unity-skills/manage-sprite-atlas/resources/custompackersetup.cs +88 -0
  178. package/unity-skills/manage-sprite-atlas/resources/deprecatedmethods.cs +142 -0
  179. package/unity-skills/manage-sprite-atlas/resources/dontmodifywithoutsaving.cs +120 -0
  180. package/unity-skills/manage-sprite-atlas/resources/dontpackinruntimebuilds.cs +190 -0
  181. package/unity-skills/manage-sprite-atlas/resources/dontscriptspriteatlasineditor.cs +114 -0
  182. package/unity-skills/manage-sprite-atlas/resources/editorconfiguration.cs +95 -0
  183. package/unity-skills/manage-sprite-atlas/resources/enablespritepacking.cs +172 -0
  184. package/unity-skills/manage-sprite-atlas/resources/gridspritepacker.cs +50 -0
  185. package/unity-skills/manage-sprite-atlas/resources/handlelatebinding.cs +147 -0
  186. package/unity-skills/manage-sprite-atlas/resources/handlenullcases.cs +141 -0
  187. package/unity-skills/manage-sprite-atlas/resources/migratev1tov2.cs +335 -0
  188. package/unity-skills/manage-sprite-atlas/resources/multipagepacker.cs +80 -0
  189. package/unity-skills/manage-sprite-atlas/resources/optimizetexturesettings.cs +191 -0
  190. package/unity-skills/manage-sprite-atlas/resources/packerdebugging.cs +158 -0
  191. package/unity-skills/manage-sprite-atlas/resources/packtransform.cs +51 -0
  192. package/unity-skills/manage-sprite-atlas/resources/platformnames.cs +127 -0
  193. package/unity-skills/manage-sprite-atlas/resources/queryspritesefficiently.cs +222 -0
  194. package/unity-skills/manage-sprite-atlas/resources/registercallbacks.cs +152 -0
  195. package/unity-skills/manage-sprite-atlas/resources/runtimeatlasloader.cs +15 -0
  196. package/unity-skills/manage-sprite-atlas/resources/runtimespriteaccess.cs +19 -0
  197. package/unity-skills/manage-sprite-atlas/resources/savespriteatlasasset.cs +107 -0
  198. package/unity-skills/manage-sprite-atlas/resources/scriptablepacker.cs +81 -0
  199. package/unity-skills/manage-sprite-atlas/resources/setincludeinbuild.cs +164 -0
  200. package/unity-skills/manage-sprite-atlas/resources/sizeoptimizedpacker.cs +88 -0
  201. package/unity-skills/manage-sprite-atlas/resources/spriteatlaslatebinding.cs +123 -0
  202. package/unity-skills/manage-sprite-atlas/resources/spriteatlasprebuildgenerator.cs +219 -0
  203. package/unity-skills/manage-sprite-atlas/resources/spritedata.cs +35 -0
  204. package/unity-skills/manage-sprite-atlas/resources/spritepack.cs +39 -0
  205. package/unity-skills/manage-sprite-atlas/resources/texturedata.cs +15 -0
  206. package/unity-skills/manage-sprite-atlas/resources/updatebuildscripts.cs +357 -0
  207. package/unity-skills/manage-sprite-atlas/resources/updatesettingsconfiguration.cs +135 -0
  208. package/unity-skills/manage-sprite-atlas/resources/usevariantswisely.cs +179 -0
  209. package/unity-skills/manage-sprite-atlas/resources/variantatlas.cs +39 -0
  210. package/unity-skills/manifest.json +1155 -0
  211. package/unity-skills/migrate-birp-to-urp/SECURITY.md +16 -0
  212. package/unity-skills/migrate-birp-to-urp/SKILL.md +543 -0
  213. package/unity-skills/migrate-birp-to-urp/references/capturing-the-editor.md +66 -0
  214. package/unity-skills/migrate-birp-to-urp/references/complex-shader-situations.md +272 -0
  215. package/unity-skills/migrate-birp-to-urp/references/custom-shader-triage.md +123 -0
  216. package/unity-skills/migrate-birp-to-urp/references/implementation-patterns.md +529 -0
  217. package/unity-skills/migrate-birp-to-urp/references/migration-workflow.md +265 -0
  218. package/unity-skills/migrate-birp-to-urp/references/quality-settings-map.md +69 -0
  219. package/unity-skills/new-unity-project/SECURITY.md +26 -0
  220. package/unity-skills/new-unity-project/SKILL.md +386 -0
  221. package/unity-skills/new-unity-project/references/skill-setup.md +66 -0
  222. package/unity-skills/optimize-audio/SECURITY.md +16 -0
  223. package/{.claude/skills → unity-skills}/optimize-audio/SKILL.md +17 -17
  224. package/{.claude/skills → unity-skills}/optimize-audio/resources/audio-import-api.md +8 -5
  225. package/{.claude/skills → unity-skills}/optimize-text-mesh-pro/SKILL.md +1 -11
  226. package/unity-skills/optimize-web/SECURITY.md +16 -0
  227. package/{.claude/skills → unity-skills}/optimize-web/SKILL.md +164 -27
  228. package/unity-skills/optimize-web/scripts/WebOptimizer.cs +46 -0
  229. package/unity-skills/optimize-web/scripts/toktx-examples.sh +11 -0
  230. package/{.claude/skills → unity-skills}/physics-3d-collision/SKILL.md +2 -2
  231. package/unity-skills/physics-3d-collision/references/troubleshooting.md +8 -0
  232. package/unity-skills/project-auditor-fixes/SKILL.md +64 -0
  233. package/{.claude/skills → unity-skills}/setup-multiplayer-services/SKILL.md +1 -4
  234. package/{.claude/skills → unity-skills}/setup-vivox-voice-chat/SKILL.md +1 -1
  235. package/{.claude/skills → unity-skills}/shader-graph-create-custom-node/SKILL.md +1 -1
  236. package/unity-skills/sprite-editor/SECURITY.md +16 -0
  237. package/{.claude/skills → unity-skills}/sprite-editor/SKILL.md +9 -9
  238. package/{.claude/skills → unity-skills}/sprite-editor/references/templates.md +1 -1
  239. package/unity-skills/sprite-segment-3x3grid/SKILL.md +136 -0
  240. package/unity-skills/sprite-segment-3x3grid/scripts/SpriteGridAnalysis.cs +119 -0
  241. package/{.claude/skills → unity-skills}/ui/SKILL.md +1 -1
  242. package/{.claude/skills → unity-skills}/ui-imgui/SKILL.md +1 -7
  243. package/{.claude/skills → unity-skills}/ui-ugui/SKILL.md +3 -9
  244. package/{.claude/skills → unity-skills}/ui-uitk/SKILL.md +8 -14
  245. package/{.claude/skills → unity-skills}/ui-uitk/references/custom-elements.md +1 -1
  246. package/unity-skills/unity-cli/CHANGELOG.md +515 -0
  247. package/unity-skills/unity-cli/SECURITY.md +68 -0
  248. package/unity-skills/unity-cli/SKILL.md +723 -0
  249. package/unity-skills/unity-cli/references/auth-license-cloud.md +318 -0
  250. package/unity-skills/unity-cli/references/build-run-test.md +555 -0
  251. package/unity-skills/unity-cli/references/cloud-automation.md +736 -0
  252. package/{.claude/skills → unity-skills}/unity-cli/references/collaboration.md +166 -105
  253. package/unity-skills/unity-cli/references/config-hub.md +239 -0
  254. package/unity-skills/unity-cli/references/diagnostics-maintenance.md +720 -0
  255. package/unity-skills/unity-cli/references/docs-workflow.md +179 -0
  256. package/unity-skills/unity-cli/references/editors-install.md +476 -0
  257. package/unity-skills/unity-cli/references/integration-advanced.md +1130 -0
  258. package/unity-skills/unity-cli/references/playmode-verification-loop.md +279 -0
  259. package/unity-skills/unity-cli/references/projects-templates.md +996 -0
  260. package/unity-skills/unity-cli/references/version-control.md +612 -0
  261. package/{.claude/skills → unity-skills}/unity-package-management/SKILL.md +60 -12
  262. package/{.claude/skills → unity-skills}/unity-package-management/references/select-packages.md +39 -21
  263. package/unity-skills/unity-pipeline/SECURITY.md +17 -0
  264. package/unity-skills/unity-pipeline/SKILL.md +335 -0
  265. package/unity-skills/urp-postprocessing/SECURITY.md +16 -0
  266. package/{.claude/skills → unity-skills}/urp-postprocessing/SKILL.md +12 -12
  267. package/{.claude/skills → unity-skills}/urp-postprocessing/references/code-templates.md +39 -8
  268. package/{.claude/skills → unity-skills}/validate-urp-render-graph-renderer-feature/SKILL.md +1 -1
  269. package/.claude/agents/nccgs-adversarial-reviewer.md +0 -43
  270. package/.claude/agents/nccgs-engine-programmer.md +0 -27
  271. package/.claude/agents/nccgs-fast-implementer.md +0 -30
  272. package/.claude/agents/nccgs-game-designer.md +0 -26
  273. package/.claude/agents/nccgs-gameplay-programmer.md +0 -26
  274. package/.claude/agents/nccgs-qa-engineer.md +0 -27
  275. package/.claude/agents/nccgs-task-scout.md +0 -24
  276. package/.claude/agents/nccgs-ui-programmer.md +0 -27
  277. package/.claude/agents/nccgs-unity-build-specialist.md +0 -27
  278. package/.claude/agents/nccgs-unity-implementer.md +0 -28
  279. package/.claude/agents/nccgs-unity-systems-specialist.md +0 -27
  280. package/.claude/agents/nccgs-unity-ui-specialist.md +0 -27
  281. package/.claude/agents/nccgs-verification-engineer.md +0 -27
  282. package/.claude/nccgs/MEMORY.md +0 -66
  283. package/.claude/nccgs/THIRD_PARTY_NOTICES.md +0 -29
  284. package/.claude/nccgs/VERSION +0 -1
  285. package/.claude/nccgs/agent-library/nccgs-accessibility-specialist.md +0 -25
  286. package/.claude/nccgs/agent-library/nccgs-adversarial-reviewer.md +0 -41
  287. package/.claude/nccgs/agent-library/nccgs-ai-programmer.md +0 -25
  288. package/.claude/nccgs/agent-library/nccgs-analytics-engineer.md +0 -25
  289. package/.claude/nccgs/agent-library/nccgs-art-direction-lead.md +0 -25
  290. package/.claude/nccgs/agent-library/nccgs-audio-direction-lead.md +0 -25
  291. package/.claude/nccgs/agent-library/nccgs-creative-director.md +0 -25
  292. package/.claude/nccgs/agent-library/nccgs-documentation-manager.md +0 -25
  293. package/.claude/nccgs/agent-library/nccgs-economy-designer.md +0 -25
  294. package/.claude/nccgs/agent-library/nccgs-engine-programmer.md +0 -25
  295. package/.claude/nccgs/agent-library/nccgs-fast-implementer.md +0 -28
  296. package/.claude/nccgs/agent-library/nccgs-game-design-lead.md +0 -25
  297. package/.claude/nccgs/agent-library/nccgs-game-designer.md +0 -24
  298. package/.claude/nccgs/agent-library/nccgs-gameplay-programmer.md +0 -24
  299. package/.claude/nccgs/agent-library/nccgs-level-designer.md +0 -25
  300. package/.claude/nccgs/agent-library/nccgs-live-ops-designer.md +0 -25
  301. package/.claude/nccgs/agent-library/nccgs-localization-lead.md +0 -25
  302. package/.claude/nccgs/agent-library/nccgs-narrative-lead.md +0 -25
  303. package/.claude/nccgs/agent-library/nccgs-network-programmer.md +0 -25
  304. package/.claude/nccgs/agent-library/nccgs-performance-analyst.md +0 -25
  305. package/.claude/nccgs/agent-library/nccgs-producer.md +0 -25
  306. package/.claude/nccgs/agent-library/nccgs-production-coordinator.md +0 -22
  307. package/.claude/nccgs/agent-library/nccgs-programming-lead.md +0 -25
  308. package/.claude/nccgs/agent-library/nccgs-prototyper.md +0 -25
  309. package/.claude/nccgs/agent-library/nccgs-qa-engineer.md +0 -25
  310. package/.claude/nccgs/agent-library/nccgs-qa-lead.md +0 -25
  311. package/.claude/nccgs/agent-library/nccgs-release-engineer.md +0 -25
  312. package/.claude/nccgs/agent-library/nccgs-release-lead.md +0 -25
  313. package/.claude/nccgs/agent-library/nccgs-security-engineer.md +0 -25
  314. package/.claude/nccgs/agent-library/nccgs-sound-designer.md +0 -25
  315. package/.claude/nccgs/agent-library/nccgs-systems-designer.md +0 -25
  316. package/.claude/nccgs/agent-library/nccgs-task-scout.md +0 -22
  317. package/.claude/nccgs/agent-library/nccgs-technical-architect.md +0 -25
  318. package/.claude/nccgs/agent-library/nccgs-technical-artist.md +0 -25
  319. package/.claude/nccgs/agent-library/nccgs-technical-director.md +0 -25
  320. package/.claude/nccgs/agent-library/nccgs-tools-programmer.md +0 -25
  321. package/.claude/nccgs/agent-library/nccgs-ui-programmer.md +0 -25
  322. package/.claude/nccgs/agent-library/nccgs-unity-build-specialist.md +0 -25
  323. package/.claude/nccgs/agent-library/nccgs-unity-content-specialist.md +0 -25
  324. package/.claude/nccgs/agent-library/nccgs-unity-implementer.md +0 -26
  325. package/.claude/nccgs/agent-library/nccgs-unity-rendering-specialist.md +0 -25
  326. package/.claude/nccgs/agent-library/nccgs-unity-systems-specialist.md +0 -25
  327. package/.claude/nccgs/agent-library/nccgs-unity-ui-specialist.md +0 -25
  328. package/.claude/nccgs/agent-library/nccgs-ux-designer.md +0 -25
  329. package/.claude/nccgs/agent-library/nccgs-verification-engineer.md +0 -25
  330. package/.claude/nccgs/agent-library/nccgs-world-builder.md +0 -25
  331. package/.claude/nccgs/agent-library/nccgs-writer.md +0 -25
  332. package/.claude/nccgs/constitution.md +0 -187
  333. package/.claude/nccgs/hooks/agent-audit.mjs +0 -16
  334. package/.claude/nccgs/hooks/closure-guard.mjs +0 -59
  335. package/.claude/nccgs/hooks/common.mjs +0 -42
  336. package/.claude/nccgs/hooks/post-compact.mjs +0 -1
  337. package/.claude/nccgs/hooks/pre-compact.mjs +0 -8
  338. package/.claude/nccgs/hooks/protect-git.mjs +0 -22
  339. package/.claude/nccgs/hooks/protect-write.mjs +0 -17
  340. package/.claude/nccgs/hooks/runtime-observation.mjs +0 -11
  341. package/.claude/nccgs/hooks/session-start.mjs +0 -29
  342. package/.claude/nccgs/hooks/session-stop.mjs +0 -7
  343. package/.claude/nccgs/hooks/unity-transport-guard.mjs +0 -11
  344. package/.claude/nccgs/packages/ponytail/README.md +0 -46
  345. package/.claude/nccgs/packages/ponytail/manifest.json +0 -24
  346. package/.claude/nccgs/pipeline.json +0 -260
  347. package/.claude/nccgs/protocols/agent-contract.md +0 -101
  348. package/.claude/nccgs/protocols/astra-claude.md +0 -111
  349. package/.claude/nccgs/protocols/bounded-repair.md +0 -246
  350. package/.claude/nccgs/protocols/context-packets.md +0 -23
  351. package/.claude/nccgs/protocols/delivery-acceptance.md +0 -105
  352. package/.claude/nccgs/protocols/design-lifecycle.md +0 -139
  353. package/.claude/nccgs/protocols/editor-session-evidence.md +0 -52
  354. package/.claude/nccgs/protocols/evidence.md +0 -31
  355. package/.claude/nccgs/protocols/model-routing.md +0 -46
  356. package/.claude/nccgs/protocols/orchestration.md +0 -74
  357. package/.claude/nccgs/protocols/review-handoff.md +0 -101
  358. package/.claude/nccgs/protocols/shared-workflow-context.md +0 -33
  359. package/.claude/nccgs/protocols/standalone-gates.md +0 -329
  360. package/.claude/nccgs/protocols/standalone-pilot.md +0 -144
  361. package/.claude/nccgs/protocols/standalone.md +0 -207
  362. package/.claude/nccgs/protocols/task-autonomy.md +0 -55
  363. package/.claude/nccgs/protocols/task-gates.md +0 -144
  364. package/.claude/nccgs/protocols/task-slices.md +0 -106
  365. package/.claude/nccgs/protocols/unity-boundary.md +0 -31
  366. package/.claude/nccgs/routing.generated.md +0 -49
  367. package/.claude/nccgs/settings.fragment.json +0 -213
  368. package/.claude/nccgs/studio.json +0 -472
  369. package/.claude/nccgs/tools/approve-overrides.mjs +0 -81
  370. package/.claude/nccgs/tools/autonomy.mjs +0 -40
  371. package/.claude/nccgs/tools/command-process.mjs +0 -50
  372. package/.claude/nccgs/tools/command-tokens.mjs +0 -22
  373. package/.claude/nccgs/tools/compile-policy.mjs +0 -121
  374. package/.claude/nccgs/tools/configure-models.mjs +0 -96
  375. package/.claude/nccgs/tools/criteria.mjs +0 -121
  376. package/.claude/nccgs/tools/delivery-budget.mjs +0 -52
  377. package/.claude/nccgs/tools/design-readiness.mjs +0 -158
  378. package/.claude/nccgs/tools/editor-session-evidence.mjs +0 -66
  379. package/.claude/nccgs/tools/evidence.mjs +0 -153
  380. package/.claude/nccgs/tools/gates.mjs +0 -297
  381. package/.claude/nccgs/tools/handoff.mjs +0 -51
  382. package/.claude/nccgs/tools/hook-transport.mjs +0 -34
  383. package/.claude/nccgs/tools/inputs.mjs +0 -108
  384. package/.claude/nccgs/tools/installation-guard.mjs +0 -55
  385. package/.claude/nccgs/tools/integrity.mjs +0 -69
  386. package/.claude/nccgs/tools/lifecycle.mjs +0 -542
  387. package/.claude/nccgs/tools/native-completion.mjs +0 -30
  388. package/.claude/nccgs/tools/orchestration.mjs +0 -680
  389. package/.claude/nccgs/tools/paths.mjs +0 -60
  390. package/.claude/nccgs/tools/policy.mjs +0 -107
  391. package/.claude/nccgs/tools/process-lock.mjs +0 -74
  392. package/.claude/nccgs/tools/repair-packet.mjs +0 -106
  393. package/.claude/nccgs/tools/returned-handoff.mjs +0 -47
  394. package/.claude/nccgs/tools/review-budget.mjs +0 -171
  395. package/.claude/nccgs/tools/review-handoff.mjs +0 -66
  396. package/.claude/nccgs/tools/runtime.mjs +0 -71
  397. package/.claude/nccgs/tools/session-budget.mjs +0 -67
  398. package/.claude/nccgs/tools/shared-context-guard.mjs +0 -60
  399. package/.claude/nccgs/tools/shared-context.mjs +0 -25
  400. package/.claude/nccgs/tools/task-slices.mjs +0 -147
  401. package/.claude/nccgs/tools/task.mjs +0 -145
  402. package/.claude/nccgs/tools/tool-guard.mjs +0 -120
  403. package/.claude/nccgs/tools/unity-repair.mjs +0 -128
  404. package/.claude/nccgs/tools/unity-transport.mjs +0 -170
  405. package/.claude/nccgs/tools/verification-jobs.mjs +0 -171
  406. package/.claude/nccgs/tools/verification-worker.mjs +0 -71
  407. package/.claude/nccgs/tools/windows-compiler-server.cs +0 -163
  408. package/.claude/nccgs/tools/windows-job.cs +0 -103
  409. package/.claude/nccgs/unity-skills-manifest.json +0 -727
  410. package/.claude/nccgs/workflow-catalog.json +0 -654
  411. package/.claude/rules/nccgs-canonical-docs.md +0 -19
  412. package/.claude/rules/nccgs-editor-tools.md +0 -12
  413. package/.claude/rules/nccgs-localization.md +0 -12
  414. package/.claude/rules/nccgs-networking.md +0 -13
  415. package/.claude/rules/nccgs-performance.md +0 -14
  416. package/.claude/rules/nccgs-rendering.md +0 -16
  417. package/.claude/rules/nccgs-security.md +0 -13
  418. package/.claude/rules/nccgs-tests.md +0 -18
  419. package/.claude/rules/nccgs-ui.md +0 -14
  420. package/.claude/rules/nccgs-unity-assets.md +0 -21
  421. package/.claude/rules/nccgs-unity-code.md +0 -22
  422. package/.claude/skills/accessibility-review/SKILL.md +0 -22
  423. package/.claude/skills/accessibility-review/references/astra.md +0 -17
  424. package/.claude/skills/accessibility-review/references/legacy.md +0 -7
  425. package/.claude/skills/architecture-decision/SKILL.md +0 -22
  426. package/.claude/skills/architecture-decision/references/astra.md +0 -12
  427. package/.claude/skills/architecture-decision/references/legacy.md +0 -7
  428. package/.claude/skills/asset-audit/SKILL.md +0 -22
  429. package/.claude/skills/asset-audit/references/astra.md +0 -17
  430. package/.claude/skills/asset-audit/references/legacy.md +0 -7
  431. package/.claude/skills/audit/SKILL.md +0 -22
  432. package/.claude/skills/audit/references/astra.md +0 -17
  433. package/.claude/skills/audit/references/dimensions.md +0 -46
  434. package/.claude/skills/audit/references/legacy.md +0 -9
  435. package/.claude/skills/balance-review/SKILL.md +0 -22
  436. package/.claude/skills/balance-review/references/astra.md +0 -17
  437. package/.claude/skills/balance-review/references/legacy.md +0 -7
  438. package/.claude/skills/bug-triage/SKILL.md +0 -22
  439. package/.claude/skills/bug-triage/references/astra.md +0 -27
  440. package/.claude/skills/bug-triage/references/legacy.md +0 -7
  441. package/.claude/skills/build-live-game/SKILL.md +0 -317
  442. package/.claude/skills/build-live-game/references/cloud-code.md +0 -563
  443. package/.claude/skills/closure/SKILL.md +0 -22
  444. package/.claude/skills/closure/references/astra.md +0 -15
  445. package/.claude/skills/closure/references/legacy.md +0 -7
  446. package/.claude/skills/compatibility-review/SKILL.md +0 -22
  447. package/.claude/skills/compatibility-review/references/astra.md +0 -17
  448. package/.claude/skills/compatibility-review/references/legacy.md +0 -7
  449. package/.claude/skills/context-pack/SKILL.md +0 -22
  450. package/.claude/skills/context-pack/references/astra.md +0 -12
  451. package/.claude/skills/context-pack/references/legacy.md +0 -7
  452. package/.claude/skills/dependency-review/SKILL.md +0 -22
  453. package/.claude/skills/dependency-review/references/astra.md +0 -17
  454. package/.claude/skills/dependency-review/references/legacy.md +0 -7
  455. package/.claude/skills/design/SKILL.md +0 -24
  456. package/.claude/skills/design/references/astra.md +0 -12
  457. package/.claude/skills/design/references/legacy.md +0 -13
  458. package/.claude/skills/design-review/SKILL.md +0 -24
  459. package/.claude/skills/design-review/references/astra.md +0 -17
  460. package/.claude/skills/design-review/references/legacy.md +0 -7
  461. package/.claude/skills/evidence-review/SKILL.md +0 -22
  462. package/.claude/skills/evidence-review/references/astra.md +0 -17
  463. package/.claude/skills/evidence-review/references/legacy.md +0 -7
  464. package/.claude/skills/hotfix/SKILL.md +0 -22
  465. package/.claude/skills/hotfix/references/astra.md +0 -30
  466. package/.claude/skills/hotfix/references/legacy.md +0 -7
  467. package/.claude/skills/incident-recovery/SKILL.md +0 -22
  468. package/.claude/skills/incident-recovery/references/astra.md +0 -27
  469. package/.claude/skills/incident-recovery/references/legacy.md +0 -7
  470. package/.claude/skills/levelplay-unity-integration/SKILL.md +0 -1126
  471. package/.claude/skills/localization/SKILL.md +0 -135
  472. package/.claude/skills/localization/resources/L10nBatchProcessor.cs +0 -69
  473. package/.claude/skills/localize-game/SKILL.md +0 -22
  474. package/.claude/skills/localize-game/references/astra.md +0 -27
  475. package/.claude/skills/localize-game/references/legacy.md +0 -7
  476. package/.claude/skills/migrate-project/SKILL.md +0 -22
  477. package/.claude/skills/migrate-project/references/astra.md +0 -30
  478. package/.claude/skills/migrate-project/references/legacy.md +0 -19
  479. package/.claude/skills/migrate-project/references/procedure.md +0 -96
  480. package/.claude/skills/milestone-review/SKILL.md +0 -22
  481. package/.claude/skills/milestone-review/references/astra.md +0 -12
  482. package/.claude/skills/milestone-review/references/legacy.md +0 -7
  483. package/.claude/skills/nccgs-code-review/SKILL.md +0 -22
  484. package/.claude/skills/nccgs-code-review/references/astra.md +0 -21
  485. package/.claude/skills/nccgs-code-review/references/legacy.md +0 -7
  486. package/.claude/skills/new-unity-project/SKILL.md +0 -179
  487. package/.claude/skills/performance-audit/SKILL.md +0 -22
  488. package/.claude/skills/performance-audit/references/astra.md +0 -17
  489. package/.claude/skills/performance-audit/references/legacy.md +0 -7
  490. package/.claude/skills/physics-3d-collision/references/troubleshooting.md +0 -41
  491. package/.claude/skills/plan-feature/SKILL.md +0 -22
  492. package/.claude/skills/plan-feature/references/astra.md +0 -12
  493. package/.claude/skills/plan-feature/references/legacy.md +0 -7
  494. package/.claude/skills/playtest/SKILL.md +0 -22
  495. package/.claude/skills/playtest/references/astra.md +0 -31
  496. package/.claude/skills/playtest/references/legacy.md +0 -7
  497. package/.claude/skills/project-stage/SKILL.md +0 -22
  498. package/.claude/skills/project-stage/references/astra.md +0 -12
  499. package/.claude/skills/project-stage/references/legacy.md +0 -7
  500. package/.claude/skills/prototype-feature/SKILL.md +0 -22
  501. package/.claude/skills/prototype-feature/references/astra.md +0 -31
  502. package/.claude/skills/prototype-feature/references/legacy.md +0 -7
  503. package/.claude/skills/qa-plan/SKILL.md +0 -22
  504. package/.claude/skills/qa-plan/references/astra.md +0 -12
  505. package/.claude/skills/qa-plan/references/legacy.md +0 -7
  506. package/.claude/skills/release/SKILL.md +0 -22
  507. package/.claude/skills/release/references/astra.md +0 -30
  508. package/.claude/skills/release/references/legacy.md +0 -11
  509. package/.claude/skills/release-readiness/SKILL.md +0 -22
  510. package/.claude/skills/release-readiness/references/astra.md +0 -17
  511. package/.claude/skills/release-readiness/references/legacy.md +0 -7
  512. package/.claude/skills/retrospective/SKILL.md +0 -22
  513. package/.claude/skills/retrospective/references/astra.md +0 -12
  514. package/.claude/skills/retrospective/references/legacy.md +0 -7
  515. package/.claude/skills/review/SKILL.md +0 -22
  516. package/.claude/skills/review/references/astra.md +0 -21
  517. package/.claude/skills/review/references/legacy.md +0 -9
  518. package/.claude/skills/security-audit/SKILL.md +0 -22
  519. package/.claude/skills/security-audit/references/astra.md +0 -17
  520. package/.claude/skills/security-audit/references/legacy.md +0 -7
  521. package/.claude/skills/sprint-plan/SKILL.md +0 -22
  522. package/.claude/skills/sprint-plan/references/astra.md +0 -12
  523. package/.claude/skills/sprint-plan/references/legacy.md +0 -7
  524. package/.claude/skills/status/SKILL.md +0 -22
  525. package/.claude/skills/status/references/astra.md +0 -19
  526. package/.claude/skills/status/references/legacy.md +0 -9
  527. package/.claude/skills/story-readiness/SKILL.md +0 -24
  528. package/.claude/skills/story-readiness/references/astra.md +0 -17
  529. package/.claude/skills/story-readiness/references/legacy.md +0 -7
  530. package/.claude/skills/test/SKILL.md +0 -22
  531. package/.claude/skills/test/references/astra.md +0 -27
  532. package/.claude/skills/test/references/legacy.md +0 -9
  533. package/.claude/skills/ui-review/SKILL.md +0 -22
  534. package/.claude/skills/ui-review/references/astra.md +0 -17
  535. package/.claude/skills/ui-review/references/legacy.md +0 -7
  536. package/.claude/skills/unity-cli/CHANGELOG.md +0 -233
  537. package/.claude/skills/unity-cli/SECURITY.md +0 -22
  538. package/.claude/skills/unity-cli/SKILL.md +0 -414
  539. package/.claude/skills/unity-cli/references/auth-license-cloud.md +0 -146
  540. package/.claude/skills/unity-cli/references/build-run-test.md +0 -349
  541. package/.claude/skills/unity-cli/references/config-hub.md +0 -103
  542. package/.claude/skills/unity-cli/references/diagnostics-maintenance.md +0 -326
  543. package/.claude/skills/unity-cli/references/editors-install.md +0 -327
  544. package/.claude/skills/unity-cli/references/integration-advanced.md +0 -472
  545. package/.claude/skills/unity-cli/references/projects-templates.md +0 -574
  546. package/.claude/skills/work/SKILL.md +0 -22
  547. package/.claude/skills/work/references/astra.md +0 -32
  548. package/.claude/skills/work/references/classification.md +0 -41
  549. package/.claude/skills/work/references/closure.md +0 -60
  550. package/.claude/skills/work/references/feature-contracts.md +0 -36
  551. package/.claude/skills/work/references/legacy.md +0 -29
  552. package/.claude/skills/work/references/verification.md +0 -26
  553. package/CLAUDE.md +0 -10
  554. package/MEMORY.md +0 -109
  555. package/UPGRADING.md +0 -130
  556. package/VERSION +0 -1
  557. package/docs/ARCHITECTURE.md +0 -131
  558. package/docs/ASSET-PRODUCTION-GRAPHIFY-PLAN.md +0 -230
  559. package/docs/BOUNDED-REPAIR.md +0 -80
  560. package/docs/EDITOR-SESSION-EVIDENCE.md +0 -52
  561. package/docs/HANDOFF-AUTOMATION.md +0 -144
  562. package/docs/HUONG-DAN-MIGRATE-VA-SU-DUNG.md +0 -117
  563. package/docs/MIGRATION-MATRIX.md +0 -23
  564. package/docs/NCCGS-1.3.md +0 -13
  565. package/docs/NCCGS-1.4.1.md +0 -149
  566. package/docs/NCCGS-1.4.md +0 -184
  567. package/docs/NCCGS-1.5-IMPLEMENTATION-PLAN.md +0 -378
  568. package/docs/NCCGS-1.5-PILOT.md +0 -130
  569. package/docs/NCCGS-1.5.md +0 -237
  570. package/docs/PHASE-1-OPERATIONS.md +0 -278
  571. package/docs/PHASE-2-OPERATIONS.md +0 -183
  572. package/docs/PROJECT-POLICY.md +0 -94
  573. package/docs/RELEASE-STATUS.md +0 -150
  574. package/docs/TASK-SLICING.md +0 -57
  575. package/docs/UNINSTALL.md +0 -134
  576. package/docs/UPGRADE-QUALIFICATION.md +0 -45
  577. package/docs/WFK17-HOOK-REPAIR.md +0 -71
  578. package/docs/WORKFLOWS.md +0 -85
  579. package/package-assets/nccgs-project.gitignore +0 -2
  580. package/package-assets/setup-vivox-voice-chat-evals.gitignore +0 -7
  581. package/scaffold/.nccgs/autonomy.json +0 -4
  582. package/scaffold/.nccgs/bugs/.gitkeep +0 -1
  583. package/scaffold/.nccgs/closures/.gitkeep +0 -1
  584. package/scaffold/.nccgs/context/.gitkeep +0 -1
  585. package/scaffold/.nccgs/decisions/.gitkeep +0 -1
  586. package/scaffold/.nccgs/evidence/.gitkeep +0 -1
  587. package/scaffold/.nccgs/execution.json +0 -10
  588. package/scaffold/.nccgs/features/.gitkeep +0 -1
  589. package/scaffold/.nccgs/gates.json +0 -7
  590. package/scaffold/.nccgs/inputs.json +0 -6
  591. package/scaffold/.nccgs/migrations/.gitkeep +0 -1
  592. package/scaffold/.nccgs/playtests/.gitkeep +0 -1
  593. package/scaffold/.nccgs/project.yaml +0 -109
  594. package/scaffold/.nccgs/requirements.yaml +0 -10
  595. package/scaffold/.nccgs/reviews/.gitkeep +0 -1
  596. package/scaffold/.nccgs/state.md +0 -40
  597. package/scaffold/.nccgs/templates/agent-handoff.md +0 -37
  598. package/scaffold/.nccgs/templates/architecture-decision.md +0 -27
  599. package/scaffold/.nccgs/templates/closure-record.md +0 -62
  600. package/scaffold/.nccgs/templates/context-packet.yaml +0 -17
  601. package/scaffold/.nccgs/templates/design-contract.json +0 -34
  602. package/scaffold/.nccgs/templates/evidence-record.md +0 -23
  603. package/scaffold/.nccgs/templates/feature-contract.md +0 -60
  604. package/scaffold/.nccgs/templates/implementation-report.md +0 -52
  605. package/scaffold/.nccgs/templates/migration-plan.md +0 -40
  606. package/scaffold/.nccgs/templates/repair-packet.json +0 -14
  607. package/scaffold/.nccgs/templates/repair-unity-code.json +0 -18
  608. package/scaffold/.nccgs/templates/repair-unity-editor.json +0 -21
  609. package/scaffold/.nccgs/templates/task-slices.json +0 -28
  610. package/scaffold/.nccgs/templates/waiver.md +0 -11
  611. package/scripts/benchmark-snapshot.mjs +0 -205
  612. package/scripts/benchmark-v15.mjs +0 -173
  613. package/scripts/cli.mjs +0 -205
  614. package/scripts/doctor.mjs +0 -261
  615. package/scripts/install.mjs +0 -530
  616. package/scripts/recover-session.mjs +0 -89
  617. package/scripts/run.mjs +0 -86
  618. package/scripts/supervise.mjs +0 -152
  619. package/scripts/uninstall.mjs +0 -292
  620. package/scripts/validate.mjs +0 -285
  621. package/scripts/work-handoff.mjs +0 -38
  622. package/tests/autonomy.test.mjs +0 -126
  623. package/tests/benchmark-v15.test.mjs +0 -65
  624. package/tests/design-readiness.test.mjs +0 -200
  625. package/tests/editor-session-evidence.test.mjs +0 -45
  626. package/tests/evidence.test.mjs +0 -186
  627. package/tests/fixtures/compiler-shutdown.cs +0 -67
  628. package/tests/fixtures/native-provider.mjs +0 -61
  629. package/tests/framework.test.mjs +0 -740
  630. package/tests/gates.test.mjs +0 -479
  631. package/tests/hook-repair.test.mjs +0 -106
  632. package/tests/lifecycle-v15.test.mjs +0 -346
  633. package/tests/native-completion-notices.test.mjs +0 -181
  634. package/tests/orchestration-v15.test.mjs +0 -596
  635. package/tests/phase1.test.mjs +0 -427
  636. package/tests/phase2.test.mjs +0 -250
  637. package/tests/policy-v15.test.mjs +0 -234
  638. package/tests/ponytail-package.test.mjs +0 -75
  639. package/tests/returned-handoff-notices.test.mjs +0 -170
  640. package/tests/review-budget.test.mjs +0 -177
  641. package/tests/runtime-v15.test.mjs +0 -1198
  642. package/tests/session-budget.test.mjs +0 -34
  643. package/tests/task-slices.test.mjs +0 -285
  644. package/tests/uninstall.test.mjs +0 -477
  645. package/tests/unity-generated.test.mjs +0 -140
  646. package/tests/unity-transport.test.mjs +0 -348
  647. /package/{.claude/nccgs/packages → template}/ponytail/LICENSE +0 -0
  648. /package/{.claude/nccgs/packages → template}/ponytail/NOTICE.md +0 -0
  649. /package/{.claude/nccgs/packages → template}/ponytail/complexity-review.md +0 -0
  650. /package/{.claude/skills → unity-skills}/build-live-game/references/remote-config.md +0 -0
  651. /package/{.claude/skills → unity-skills}/implement-in-app-purchases/README.md +0 -0
  652. /package/{.claude/skills → unity-skills}/implement-in-app-purchases/references/codeless-catalog.md +0 -0
  653. /package/{.claude/skills → unity-skills}/implement-in-app-purchases/references/convert-adapty.md +0 -0
  654. /package/{.claude/skills → unity-skills}/implement-in-app-purchases/references/convert-essentialkit.md +0 -0
  655. /package/{.claude/skills → unity-skills}/implement-in-app-purchases/references/convert-revenuecat.md +0 -0
  656. /package/{.claude/skills → unity-skills}/implement-in-app-purchases/references/convert-unipay.md +0 -0
  657. /package/{.claude/skills → unity-skills}/implement-in-app-purchases/references/migration-v4-to-v5.md +0 -0
  658. /package/{.claude/skills → unity-skills}/implement-in-app-purchases/references/path-add-iap-to-new-project.md +0 -0
  659. /package/{.claude/skills → unity-skills}/implement-in-app-purchases/references/path-convert-native-storekit.md +0 -0
  660. /package/{.claude/skills → unity-skills}/implement-in-app-purchases/references/platform-notes.md +0 -0
  661. /package/{.claude/skills → unity-skills}/implement-in-app-purchases/references/pre-check.md +0 -0
  662. /package/{.claude/skills → unity-skills}/localization/resources/LocalizedFontAsset.cs +0 -0
  663. /package/{.claude/skills → unity-skills}/optimize-audio/resources/platform-settings.md +0 -0
  664. /package/{.claude/skills → unity-skills}/optimize-web/resources/WebOptimizer.cs +0 -0
  665. /package/{.claude/skills → unity-skills}/optimize-web/resources/toktx-examples.sh +0 -0
  666. /package/{.claude/skills → unity-skills}/physics-3d-collision/resources/CollisionDebugger.cs +0 -0
  667. /package/{.claude/skills → unity-skills}/setup-multiplayer-services/references/dgs-entrypoint.md +0 -0
  668. /package/{.claude/skills → unity-skills}/setup-multiplayer-services/references/entrypoints.md +0 -0
  669. /package/{.claude/skills → unity-skills}/setup-multiplayer-services/references/examples.md +0 -0
  670. /package/{.claude/skills → unity-skills}/setup-multiplayer-services/references/implementation-fit.md +0 -0
  671. /package/{.claude/skills → unity-skills}/setup-multiplayer-services/references/underlying-services.md +0 -0
  672. /package/{.claude/skills → unity-skills}/setup-multiplayer-services/references/workflows-prerequisites.md +0 -0
  673. /package/{.claude/skills → unity-skills}/setup-vivox-voice-chat/evals/.env.example +0 -0
  674. /package/{.claude/skills → unity-skills}/setup-vivox-voice-chat/evals/README.md +0 -0
  675. /package/{.claude/skills → unity-skills}/setup-vivox-voice-chat/evals/promptfooconfig.yaml +0 -0
  676. /package/{.claude/skills → unity-skills}/setup-vivox-voice-chat/evals/tests/init-and-login.yaml +0 -0
  677. /package/{.claude/skills → unity-skills}/setup-vivox-voice-chat/evals/tests/text-chat.yaml +0 -0
  678. /package/{.claude/skills → unity-skills}/setup-vivox-voice-chat/evals/tests/voice-channels.yaml +0 -0
  679. /package/{.claude/skills → unity-skills}/setup-vivox-voice-chat/references/events-and-participants.md +0 -0
  680. /package/{.claude/skills → unity-skills}/setup-vivox-voice-chat/references/init-and-login.md +0 -0
  681. /package/{.claude/skills → unity-skills}/setup-vivox-voice-chat/references/text-chat.md +0 -0
  682. /package/{.claude/skills → unity-skills}/setup-vivox-voice-chat/references/troubleshooting.md +0 -0
  683. /package/{.claude/skills → unity-skills}/setup-vivox-voice-chat/references/voice-channels.md +0 -0
  684. /package/{.claude/skills → unity-skills}/shader-graph-create-custom-node/resources/all_hints.hlsl +0 -0
  685. /package/{.claude/skills → unity-skills}/sprite-editor/references/api_reference.md +0 -0
  686. /package/{.claude/skills → unity-skills}/sprite-editor/references/background.md +0 -0
  687. /package/{.claude/skills → unity-skills}/sprite-editor/scripts/AutomaticSliceTexture.cs +0 -0
  688. /package/{.claude/skills → unity-skills}/sprite-editor/scripts/GenerateNewSpriteRects.cs +0 -0
  689. /package/{.claude/skills → unity-skills}/sprite-editor/scripts/GetTextureSourceImageSize.cs +0 -0
  690. /package/{.claude/skills → unity-skills}/sprite-editor/scripts/GetTextureToSlice.cs +0 -0
  691. /package/{.claude/skills → unity-skills}/sprite-editor/scripts/GridSliceTexture.cs +0 -0
  692. /package/{.claude/skills → unity-skills}/sprite-editor/scripts/IsometricSliceTexture.cs +0 -0
  693. /package/{.claude/skills → unity-skills}/sprite-editor/scripts/README.md +0 -0
  694. /package/{.claude/skills → unity-skills}/sprite-editor/scripts/SetPivotExample.cs +0 -0
  695. /package/{.claude/skills → unity-skills}/sprite-editor/scripts/SpriteToPng.cs +0 -0
  696. /package/{.claude/skills → unity-skills}/ui-imgui/references/gui-elements.md +0 -0
  697. /package/{.claude/skills → unity-skills}/ui-imgui/references/templates.md +0 -0
  698. /package/{.claude/skills → unity-skills}/ui-ugui/references/scrollview-setup.md +0 -0
  699. /package/{.claude/skills → unity-skills}/ui-uitk/references/common-issues.md +0 -0
  700. /package/{.claude/skills → unity-skills}/ui-uitk/references/painter2d.md +0 -0
  701. /package/{.claude/skills → unity-skills}/ui-uitk/references/pointermanipulator-guide.md +0 -0
  702. /package/{.claude/skills → unity-skills}/ui-uitk/references/svg-icons.md +0 -0
  703. /package/{.claude/skills → unity-skills}/ui-uitk/references/ui-runtime-binding.md +0 -0
  704. /package/{.claude/skills → unity-skills}/ui-uitk/references/uss-guide.md +0 -0
  705. /package/{.claude/skills → unity-skills}/urp-postprocessing/references/effect-reference.md +0 -0
@@ -1,536 +1,604 @@
1
- # LevelPlay Ad Unit Implementation Best Practices
2
-
3
- ## Contents
4
- - [Overview](#overview)
5
- - [Strategic Framework: Revenue vs UX Optimization](#strategic-framework-revenue-vs-ux-optimization)
6
- - [Ad Format Strategy by Goal](#ad-format-strategy-by-goal)
7
- - [Placement Strategy](#placement-strategy)
8
- - [Implementation Patterns](#implementation-patterns)
9
- - [Frequency Management](#frequency-management)
10
- - [Error Handling and Graceful Degradation](#error-handling-and-graceful-degradation)
11
- - [A/B Testing Considerations](#ab-testing-considerations)
12
- - [Common Mistakes to Avoid](#common-mistakes-to-avoid)
13
- - [Platform-Specific Considerations](#platform-specific-considerations)
14
- - [Success Metrics by Strategy](#success-metrics-by-strategy)
15
- - [Final Recommendations](#final-recommendations)
16
-
17
- ## Overview
18
-
19
- This reference compiles best practices from the LevelPlay enablement playbook, covering strategy selection, placement optimization, and common implementation patterns that drive both revenue and user satisfaction.
20
-
21
- ## Strategic Framework: Revenue vs UX Optimization
22
-
23
- ### Understanding the Trade-off
24
-
25
- Every ad implementation involves a fundamental trade-off between revenue generation and user experience. Your optimization goal should guide every decision.
26
-
27
- | Optimization Goal | Philosophy | Typical Outcome |
28
- |-------------------|------------|-----------------|
29
- | **Revenue-Focused** | Maximize impression opportunities | Higher revenue, potential UX impact |
30
- | **UX-Focused** | Protect user experience at all costs | Better retention, lower short-term revenue |
31
- | **Balanced** | Optimize for sustainable long-term value | Moderate revenue with good UX |
32
-
33
- ### Choosing Your Optimization Goal
34
-
35
- **Ask yourself:**
36
- 1. What stage is your app in? (Early = UX focus, Mature = revenue optimization)
37
- 2. What's your business model? (Ads-only = revenue, Hybrid = balanced)
38
- 3. What's your competitive landscape? (High competition = UX focus)
39
- 4. What are your user expectations? (Casual games = more ads tolerated)
40
-
41
- ## Ad Format Strategy by Goal
42
-
43
- ### Revenue-Focused Implementation
44
-
45
- **Goal**: Maximize ad revenue and impression opportunities
46
-
47
- **Rewarded Ads** (Primary):
48
- - Implement 3-5 placements across high-value moments
49
- - Examples: Hints, extra lives, power-ups, bonus currency, skip levels
50
- - Always keep a rewarded ad loaded and ready
51
- - Reload immediately after showing
52
-
53
- **Interstitial Ads** (Secondary):
54
- - Show at every natural transition point
55
- - Frequency cap: Every 3-5 minutes of active gameplay
56
- - Placements: Level complete, game over, returning to menu
57
- - Load proactively before transitions
58
-
59
- **Banner Ads** (Tertiary):
60
- - Show persistently during gameplay
61
- - Position: Bottom (less intrusive than top)
62
- - Keep loaded throughout session for continuous impressions
63
- - Accept some visual clutter for revenue
64
-
65
- **Expected Outcomes:** *(Industry benchmarks, not LevelPlay-specific)*
66
- - ✅ 30-50% higher ad revenue
67
- - ⚠ 5-15% increase in early abandonment
68
- - ⚠ Lower user satisfaction scores
69
- - ✅ Strong monetization from engaged users
70
-
71
- ### UX-Focused Implementation
72
-
73
- **Goal**: Maintain excellent user experience while monetizing thoughtfully
74
-
75
- **Rewarded Ads** (Only or Primary):
76
- - Single placement or 2 maximum
77
- - User-initiated only (player chooses to watch)
78
- - High-value rewards that feel generous
79
- - Never force ads
80
-
81
- **Interstitial Ads** (Optional, Rare):
82
- - Only at major session boundaries (returning to menu, closing app)
83
- - Frequency cap: 10+ minutes or once per session
84
- - Skip during active gameplay entirely
85
-
86
- **Banner Ads** (Avoid or Minimize):
87
- - Show only in menus, never during gameplay
88
- - If used, small sizes (standard 320x50, not rectangles)
89
- - Hide during any active user engagement
90
-
91
- **Expected Outcomes:** *(Industry benchmarks, not LevelPlay-specific)*
92
- - ⚠ 40-60% lower ad revenue vs revenue-focused
93
- - ✅ Better user retention and satisfaction
94
- - ✅ Higher organic growth and word-of-mouth
95
- - ✅ Premium brand perception
96
-
97
- ### Balanced Implementation (Recommended for Most Apps)
98
-
99
- **Goal**: Sustainable monetization with good user experience
100
-
101
- **Rewarded Ads** (Primary):
102
- - 2-3 well-chosen placements
103
- - Focus on moments of high user engagement
104
- - Make rewards feel valuable but not exploitative
105
- - Examples: Extra attempts, time skips, premium currency
106
-
107
- **Interstitial Ads** (Moderate):
108
- - Natural transition points only (level complete, game over)
109
- - Frequency cap: Every 5-7 minutes
110
- - Never interrupt active gameplay
111
- - Respect user flow
112
-
113
- **Banner Ads** (Selective):
114
- - Show in menus and low-attention moments
115
- - Hide during intense or immersive gameplay
116
- - Position at bottom with proper UI offset
117
- - Rotation: Show/hide based on context
118
-
119
- **Expected Outcomes:** *(Industry benchmarks, not LevelPlay-specific)*
120
- - ✅ Strong ad revenue (70-85% of revenue-focused approach)
121
- - ✅ Good user retention
122
- - ✅ Sustainable long-term monetization
123
- - ✅ Positive user sentiment
124
-
125
- ## Placement Strategy
126
-
127
- ### Identifying Strong Placement Moments
128
-
129
- **High-value moments** (Best for rewarded ads):
130
- - Post-victory celebrations
131
- - Level progression milestones
132
- - Unlock opportunities
133
- - User feels positive emotion
134
-
135
- **Natural transitions** (Good for interstitials):
136
- - Level complete
137
- - Game over
138
- - Returning to main menu
139
- - Session boundaries
140
-
141
- **Low-attention periods** (Acceptable for banners):
142
- - Waiting screens
143
- - Loading periods
144
- - Menu browsing
145
- - Non-interactive moments
146
-
147
- ### Placement Anti-Patterns (Avoid These)
148
-
149
- ❌ **Mid-gameplay interruptions**: Never show interstitials during active play
150
- ❌ **Bait-and-switch**: Don't offer rewards then show unrewarded interstitials
151
- ❌ **Excessive frequency**: Showing ads every 1-2 minutes frustrates users
152
- ❌ **Punitive ads**: Using ads as punishment for failure feels manipulative
153
- ❌ **Blocking progression**: Making ads mandatory to continue playing
154
- ❌ **Poor timing**: Showing ads right before key moments or cliffhangers
155
-
156
- ## Implementation Patterns
157
-
158
- ### Pattern 1: Rewarded Hints System
159
-
160
- **Use case**: Puzzle or strategy games where hints add value
161
-
162
- ```csharp
163
- public class HintSystem : MonoBehaviour
164
- {
165
- [SerializeField] private RewardedAdManager adManager;
166
- [SerializeField] private int hintsAvailable = 3;
167
-
168
- public void RequestHint()
169
- {
170
- if (hintsAvailable > 0)
171
- {
172
- // User has free hints remaining
173
- UseHint();
174
- hintsAvailable--;
175
- }
176
- else
177
- {
178
- // Offer ad-based hint
179
- if (adManager.IsRewardedAdAvailable())
180
- {
181
- ShowHintAdOffer();
182
- }
183
- else
184
- {
185
- ShowHintNotAvailableMessage();
186
- }
187
- }
188
- }
189
-
190
- private void ShowHintAdOffer()
191
- {
192
- // Show dialog: "Watch an ad to get a hint?"
193
- // If user accepts:
194
- adManager.ShowRewardedAd(OnHintAdCompleted);
195
- }
196
-
197
- private void OnHintAdCompleted(LevelPlayAdInfo adInfo, LevelPlayReward reward)
198
- {
199
- if (reward != null && !string.IsNullOrEmpty(reward.Name))
200
- {
201
- // User completed ad, grant hint
202
- UseHint();
203
- }
204
- }
205
-
206
- private void UseHint()
207
- {
208
- // Show hint to player
209
- Debug.Log("Showing hint");
210
- }
211
-
212
- private void ShowHintNotAvailableMessage()
213
- {
214
- // Inform user that hints aren't available right now
215
- Debug.Log("Hints not available at the moment");
216
- }
217
- }
218
- ```
219
-
220
- **Why this works:**
221
- - User has free hints first (generous)
222
- - Ad is optional, not forced
223
- - Clear value exchange (ad for hint)
224
- - Graceful handling when ads unavailable
225
-
226
- ### Pattern 2: Level Transition Interstitial (Frequency Capped)
227
-
228
- **Use case**: Showing interstitials between levels without annoying users
229
-
230
- ```csharp
231
- public class LevelTransitionAds : MonoBehaviour
232
- {
233
- [SerializeField] private InterstitialAdManager adManager;
234
- private int levelsCompletedSinceAd = 0;
235
- private int levelsRequiredBetweenAds = 3; // Show ad every 3 levels
236
-
237
- public void OnLevelComplete()
238
- {
239
- levelsCompletedSinceAd++;
240
-
241
- if (levelsCompletedSinceAd >= levelsRequiredBetweenAds)
242
- {
243
- ShowInterstitialOpportunistically();
244
- levelsCompletedSinceAd = 0;
245
- }
246
-
247
- ProceedToNextLevel();
248
- }
249
-
250
- private void ShowInterstitialOpportunistically()
251
- {
252
- // Try to show, but don't wait if not ready
253
- if (adManager.IsInterstitialReady())
254
- {
255
- adManager.ShowInterstitialAd();
256
- }
257
- }
258
-
259
- private void ProceedToNextLevel()
260
- {
261
- // Load next level regardless of ad status
262
- // Never block user flow waiting for ads
263
- }
264
- }
265
- ```
266
-
267
- **Why this works:**
268
- - Frequency capping prevents ad fatigue
269
- - Opportunistic showing (doesn't block if not ready)
270
- - User flow never interrupted
271
- - Predictable pattern users can adapt to
272
-
273
- ### Pattern 3: Context-Aware Banner Management
274
-
275
- **Use case**: Showing banners in menus but hiding during gameplay
276
-
277
- ```csharp
278
- public class ContextAwareBanners : MonoBehaviour
279
- {
280
- [SerializeField] private BannerAdManager bannerManager;
281
-
282
- public enum AppContext
283
- {
284
- MainMenu,
285
- Playing,
286
- Paused,
287
- GameOver
288
- }
289
-
290
- private AppContext currentContext;
291
-
292
- public void SetContext(AppContext newContext)
293
- {
294
- currentContext = newContext;
295
- UpdateBannerVisibility();
296
- }
297
-
298
- private void UpdateBannerVisibility()
299
- {
300
- switch (currentContext)
301
- {
302
- case AppContext.MainMenu:
303
- case AppContext.GameOver:
304
- // Show banners in menu contexts
305
- bannerManager.ShowBanner();
306
- break;
307
-
308
- case AppContext.Playing:
309
- // Hide during active gameplay
310
- bannerManager.HideBanner();
311
- break;
312
-
313
- case AppContext.Paused:
314
- // Optional: Show or hide based on your preference
315
- // For UX-focused: Hide
316
- // For revenue-focused: Show
317
- bannerManager.ShowBanner();
318
- break;
319
- }
320
- }
321
- }
322
- ```
323
-
324
- **Why this works:**
325
- - Banners shown only in appropriate contexts
326
- - Gameplay experience uninterrupted
327
- - Easy to adjust strategy by changing visibility logic
328
- - Clean separation of concerns
329
-
330
- ## Frequency Management
331
-
332
- ### Time-Based Frequency Capping
333
-
334
- Implement minimum time intervals between ads:
335
-
336
- ```csharp
337
- public class FrequencyManager : MonoBehaviour
338
- {
339
- private float minSecondsBetweenInterstitials = 300f; // 5 minutes
340
- private float lastInterstitialTime = -300f; // Allow first ad immediately
341
-
342
- public bool CanShowInterstitial()
343
- {
344
- float timeSinceLast = Time.realtimeSinceStartup - lastInterstitialTime;
345
- return timeSinceLast >= minSecondsBetweenInterstitials;
346
- }
347
-
348
- public void RecordInterstitialShown()
349
- {
350
- lastInterstitialTime = Time.realtimeSinceStartup;
351
- }
352
- }
353
- ```
354
-
355
- **Recommended intervals:**
356
- - Revenue-focused: 3-5 minutes
357
- - Balanced: 5-7 minutes
358
- - UX-focused: 10+ minutes
359
-
360
- ### Count-Based Frequency Capping
361
-
362
- Implement minimum actions between ads:
363
-
364
- ```csharp
365
- private int actionsRequiredBetweenAds = 3;
366
- private int actionsSinceLastAd = 0;
367
-
368
- public void OnUserAction()
369
- {
370
- actionsSinceLastAd++;
371
-
372
- if (actionsSinceLastAd >= actionsRequiredBetweenAds)
373
- {
374
- // Eligible to show ad
375
- TryShowAd();
376
- actionsSinceLastAd = 0;
377
- }
378
- }
379
- ```
380
-
381
- **Examples of "actions":**
382
- - Levels completed
383
- - Games played
384
- - Sessions started
385
- - Feature uses
386
-
387
- ## Error Handling and Graceful Degradation
388
-
389
- ### Always Have a Fallback
390
-
391
- Never let ad failures block user flow:
392
-
393
- ```csharp
394
- public void OnAdLoadFailed()
395
- {
396
- // Log for debugging
397
- Debug.LogWarning("Ad failed to load");
398
-
399
- // Continue with user flow
400
- ProceedWithoutAd();
401
-
402
- // Schedule retry
403
- Invoke(nameof(RetryLoadAd), 30f);
404
- }
405
-
406
- private void ProceedWithoutAd()
407
- {
408
- // Your app continues normally
409
- // Never block users because ads aren't available
410
- }
411
- ```
412
-
413
- ### Reward Users Even When Ads Fail
414
-
415
- For rewarded ads, consider granting rewards even if ad fails:
416
-
417
- ```csharp
418
- public void OnRewardedAdShowFailed()
419
- {
420
- // User intended to watch ad, but it failed
421
- // Consider granting reward anyway (generous approach)
422
- if (shouldBeGenerousOnFailure)
423
- {
424
- GrantReward();
425
- ShowMessage("Reward granted! (Ad unavailable)");
426
- }
427
- else
428
- {
429
- ShowMessage("Ad unavailable, please try again later");
430
- }
431
- }
432
- ```
433
-
434
- **When to be generous:**
435
- - UX-focused strategy
436
- - High-value users
437
- - Failure is on your end (not user's fault)
438
-
439
- ## A/B Testing Considerations
440
-
441
- ### What to Test
442
-
443
- **High-impact variables:**
444
- 1. **Frequency caps**: 3min vs 5min vs 7min between interstitials
445
- 2. **Placement timing**: Immediate vs delayed interstitials
446
- 3. **Reward generosity**: 1x vs 2x multiplier for rewarded ads
447
- 4. **Banner visibility**: Always vs context-aware vs never during gameplay
448
- 5. **Interstitial presence**: With vs without interstitials
449
-
450
- **How to test:**
451
- - Split users into cohorts
452
- - Track both revenue AND retention
453
- - Run tests for 7-14 days minimum
454
- - Focus on long-term value (LTV), not just day-1 revenue
455
-
456
- ### Metrics to Track
457
-
458
- **Revenue metrics:**
459
- - ARPDAU (Average Revenue Per Daily Active User)
460
- - Impression per DAU
461
- - eCPM (effective Cost Per Mille)
462
-
463
- **UX metrics:**
464
- - D1, D7, D30 retention
465
- - Session length
466
- - Session frequency
467
- - Organic virality (shares, referrals)
468
-
469
- **Balance metrics:**
470
- - LTV (Lifetime Value)
471
- - ARPU / Retention ratio
472
- - User satisfaction scores
473
-
474
- ## Common Mistakes to Avoid
475
-
476
- 1. **Over-monetizing early**: Don't show tons of ads before users are engaged
477
- 2. **Ignoring retention**: High revenue means nothing if users quit
478
- 3. **Blocking without ads**: Never require watching ads to progress
479
- 4. **Poor frequency capping**: Ads every minute frustrate users
480
- 5. **Forcing rewarded ads**: Rewarded ads should always be optional
481
- 6. **Ignoring load failures**: Always handle ad failures gracefully
482
- 7. **One-size-fits-all**: Different user segments may need different strategies
483
- 8. **Neglecting testing**: Always A/B test major monetization changes
484
-
485
- ## Platform-Specific Considerations
486
-
487
- ### iOS
488
- - Lower opt-in rates post-ATT (iOS 14.5+)
489
- - Users who deny tracking see lower-value ads
490
- - More privacy-conscious user base
491
- - Consider more UX-focused approach
492
-
493
- ### Android
494
- - Higher ad fill rates
495
- - More permissive user expectations
496
- - Diverse hardware requires testing
497
- - Can push frequency slightly higher
498
-
499
- ## Success Metrics by Strategy
500
-
501
- *(Example benchmarks from industry typical ranges, not LevelPlay-specific targets)*
502
-
503
- ### Revenue-Focused Success
504
- - ARPDAU > $0.15
505
- - Impression/DAU > 8
506
- - D7 retention > 20%
507
-
508
- ### UX-Focused Success
509
- - D7 retention > 35%
510
- - Session length > 15 minutes
511
- - Low uninstall rate (<5% weekly)
512
- - ARPDAU > $0.05
513
-
514
- ### Balanced Success
515
- - ARPDAU > $0.10
516
- - D7 retention > 28%
517
- - Impression/DAU > 5
518
- - High user satisfaction
519
-
520
- ## Final Recommendations
521
-
522
- 1. **Start UX-focused**: Better to under-monetize early than drive users away
523
- 2. **Increase gradually**: Add monetization as users become engaged
524
- 3. **Always test**: Data beats assumptions
525
- 4. **Watch retention closely**: It's easier to add ads than win back users
526
- 5. **Be transparent**: Users appreciate honesty about ad-supported models
527
- 6. **Reward patience**: Give users free options before pushing ads
528
- 7. **Optimize continuously**: Ad strategy should evolve with your product
529
-
530
- ## Additional Resources
531
-
532
- For detailed API implementation, see:
533
- - `rewarded-api.md`: Rewarded ad implementation
534
- - `interstitial-api.md`: Interstitial ad implementation
535
- - `banner-api.md`: Banner ad implementation
536
- - `initialization-api.md`: SDK setup and configuration
1
+ # LevelPlay Ad Unit Implementation Best Practices
2
+
3
+ ## Contents
4
+ - [Overview](#overview)
5
+ - [Strategic Framework: Revenue vs UX Optimization](#strategic-framework-revenue-vs-ux-optimization)
6
+ - [Ad Format Strategy by Goal](#ad-format-strategy-by-goal)
7
+ - [Placement Strategy](#placement-strategy)
8
+ - [Implementation Patterns](#implementation-patterns)
9
+ - [Frequency Management](#frequency-management)
10
+ - [Error Handling and Graceful Degradation](#error-handling-and-graceful-degradation)
11
+ - [A/B Testing Considerations](#ab-testing-considerations)
12
+ - [Common Mistakes to Avoid](#common-mistakes-to-avoid)
13
+ - [Platform-Specific Considerations](#platform-specific-considerations)
14
+ - [Success Metrics by Strategy](#success-metrics-by-strategy)
15
+ - [Final Recommendations](#final-recommendations)
16
+ - [Code Generation Guidelines (Step 9)](#code-generation-guidelines-step-9)
17
+
18
+ ## Overview
19
+
20
+ This reference compiles best practices from the LevelPlay enablement playbook, covering strategy selection, placement optimization, and common implementation patterns that drive both revenue and user satisfaction.
21
+
22
+ ## Strategic Framework: Revenue vs UX Optimization
23
+
24
+ ### Understanding the Trade-off
25
+
26
+ Every ad implementation involves a fundamental trade-off between revenue generation and user experience. Your optimization goal should guide every decision.
27
+
28
+ | Optimization Goal | Philosophy | Typical Outcome |
29
+ |-------------------|------------|-----------------|
30
+ | **Revenue-Focused** | Maximize impression opportunities | Higher revenue, potential UX impact |
31
+ | **UX-Focused** | Protect user experience at all costs | Better retention, lower short-term revenue |
32
+ | **Balanced** | Optimize for sustainable long-term value | Moderate revenue with good UX |
33
+
34
+ ### Choosing Your Optimization Goal
35
+
36
+ **Ask yourself:**
37
+ 1. What stage is your app in? (Early = UX focus, Mature = revenue optimization)
38
+ 2. What's your business model? (Ads-only = revenue, Hybrid = balanced)
39
+ 3. What's your competitive landscape? (High competition = UX focus)
40
+ 4. What are your user expectations? (Casual games = more ads tolerated)
41
+
42
+ ## Ad Format Strategy by Goal
43
+
44
+ ### Revenue-Focused Implementation
45
+
46
+ **Goal**: Maximize ad revenue and impression opportunities
47
+
48
+ **Rewarded Ads** (Primary):
49
+ - Implement 3-5 placements across high-value moments
50
+ - Examples: Hints, extra lives, power-ups, bonus currency, skip levels
51
+ - Always keep a rewarded ad loaded and ready
52
+ - Reload immediately after showing
53
+
54
+ **Interstitial Ads** (Secondary):
55
+ - Show at every natural transition point
56
+ - Frequency cap: Every 3-5 minutes of active gameplay
57
+ - Placements: Level complete, game over, returning to menu
58
+ - Load proactively before transitions
59
+
60
+ **Banner Ads** (Tertiary):
61
+ - Show persistently during gameplay
62
+ - Position: Bottom (less intrusive than top)
63
+ - Keep loaded throughout session for continuous impressions
64
+ - Accept some visual clutter for revenue
65
+
66
+ **Expected Outcomes:** *(Industry benchmarks, not LevelPlay-specific)*
67
+ - ✅ 30-50% higher ad revenue
68
+ - ⚠ 5-15% increase in early abandonment
69
+ - ⚠ Lower user satisfaction scores
70
+ - ✅ Strong monetization from engaged users
71
+
72
+ ### UX-Focused Implementation
73
+
74
+ **Goal**: Maintain excellent user experience while monetizing thoughtfully
75
+
76
+ **Rewarded Ads** (Only or Primary):
77
+ - Single placement or 2 maximum
78
+ - User-initiated only (player chooses to watch)
79
+ - High-value rewards that feel generous
80
+ - Never force ads
81
+
82
+ **Interstitial Ads** (Optional, Rare):
83
+ - Only at major session boundaries (returning to menu, closing app)
84
+ - Frequency cap: 10+ minutes or once per session
85
+ - Skip during active gameplay entirely
86
+
87
+ **Banner Ads** (Avoid or Minimize):
88
+ - Show only in menus, never during gameplay
89
+ - If used, small sizes (standard 320x50, not rectangles)
90
+ - Hide during any active user engagement
91
+
92
+ **Expected Outcomes:** *(Industry benchmarks, not LevelPlay-specific)*
93
+ - ⚠ 40-60% lower ad revenue vs revenue-focused
94
+ - ✅ Better user retention and satisfaction
95
+ - ✅ Higher organic growth and word-of-mouth
96
+ - ✅ Premium brand perception
97
+
98
+ ### Balanced Implementation (Recommended for Most Apps)
99
+
100
+ **Goal**: Sustainable monetization with good user experience
101
+
102
+ **Rewarded Ads** (Primary):
103
+ - 2-3 well-chosen placements
104
+ - Focus on moments of high user engagement
105
+ - Make rewards feel valuable but not exploitative
106
+ - Examples: Extra attempts, time skips, premium currency
107
+
108
+ **Interstitial Ads** (Moderate):
109
+ - Natural transition points only (level complete, game over)
110
+ - Frequency cap: Every 5-7 minutes
111
+ - Never interrupt active gameplay
112
+ - Respect user flow
113
+
114
+ **Banner Ads** (Selective):
115
+ - Show in menus and low-attention moments
116
+ - Hide during intense or immersive gameplay
117
+ - Position at bottom with proper UI offset
118
+ - Rotation: Show/hide based on context
119
+
120
+ **Expected Outcomes:** *(Industry benchmarks, not LevelPlay-specific)*
121
+ - ✅ Strong ad revenue (70-85% of revenue-focused approach)
122
+ - ✅ Good user retention
123
+ - ✅ Sustainable long-term monetization
124
+ - ✅ Positive user sentiment
125
+
126
+ ## Placement Strategy
127
+
128
+ ### Identifying Strong Placement Moments
129
+
130
+ **High-value moments** (Best for rewarded ads):
131
+ - Post-victory celebrations
132
+ - Level progression milestones
133
+ - Unlock opportunities
134
+ - User feels positive emotion
135
+
136
+ **Natural transitions** (Good for interstitials):
137
+ - Level complete
138
+ - Game over
139
+ - Returning to main menu
140
+ - Session boundaries
141
+
142
+ **Low-attention periods** (Acceptable for banners):
143
+ - Waiting screens
144
+ - Loading periods
145
+ - Menu browsing
146
+ - Non-interactive moments
147
+
148
+ ### Placement Anti-Patterns (Avoid These)
149
+
150
+ ❌ **Mid-gameplay interruptions**: Never show interstitials during active play
151
+ ❌ **Bait-and-switch**: Don't offer rewards then show unrewarded interstitials
152
+ ❌ **Excessive frequency**: Showing ads every 1-2 minutes frustrates users
153
+ ❌ **Punitive ads**: Using ads as punishment for failure feels manipulative
154
+ ❌ **Blocking progression**: Making ads mandatory to continue playing
155
+ ❌ **Poor timing**: Showing ads right before key moments or cliffhangers
156
+
157
+ ## Implementation Patterns
158
+
159
+ > **Note:** These patterns build on the manager classes defined in `rewarded-api.md` and `interstitial-api.md` (`RewardedAdManager`, `InterstitialAdManager`). They use only those managers' public members — `LoadAd()`, `ShowAd()`, `IsAdReady()`, and (for rewarded) the `OnRewardGranted` hook. Generate the manager classes from those references first so these examples compile.
160
+
161
+ ### Pattern 1: Rewarded Hints System
162
+
163
+ **Use case**: Puzzle or strategy games where hints add value
164
+
165
+ ```csharp
166
+ public class HintSystem : MonoBehaviour
167
+ {
168
+ [SerializeField] private RewardedAdManager adManager;
169
+ [SerializeField] private int hintsAvailable = 3;
170
+
171
+ public void RequestHint()
172
+ {
173
+ if (hintsAvailable > 0)
174
+ {
175
+ // User has free hints remaining
176
+ UseHint();
177
+ hintsAvailable--;
178
+ }
179
+ else
180
+ {
181
+ // Offer ad-based hint
182
+ if (adManager.IsAdReady())
183
+ {
184
+ ShowHintAdOffer();
185
+ }
186
+ else
187
+ {
188
+ ShowHintNotAvailableMessage();
189
+ }
190
+ }
191
+ }
192
+
193
+ private void ShowHintAdOffer()
194
+ {
195
+ // Show dialog: "Watch an ad to get a hint?"
196
+ // If user accepts, subscribe to the reward hook and show the ad.
197
+ adManager.OnRewardGranted = OnHintAdRewardEarned;
198
+ adManager.ShowAd();
199
+ }
200
+
201
+ private void OnHintAdRewardEarned()
202
+ {
203
+ // RewardedAdManager invokes this only after the user earns the reward
204
+ UseHint();
205
+ }
206
+
207
+ private void UseHint()
208
+ {
209
+ // Show hint to player
210
+ Debug.Log("Showing hint");
211
+ }
212
+
213
+ private void ShowHintNotAvailableMessage()
214
+ {
215
+ // Inform user that hints aren't available right now
216
+ Debug.Log("Hints not available at the moment");
217
+ }
218
+ }
219
+ ```
220
+
221
+ **Why this works:**
222
+ - User has free hints first (generous)
223
+ - Ad is optional, not forced
224
+ - Clear value exchange (ad for hint)
225
+ - Graceful handling when ads unavailable
226
+
227
+ ### Pattern 2: Level Transition Interstitial (Frequency Capped)
228
+
229
+ **Use case**: Showing interstitials between levels without annoying users
230
+
231
+ ```csharp
232
+ public class LevelTransitionAds : MonoBehaviour
233
+ {
234
+ [SerializeField] private InterstitialAdManager adManager;
235
+ private int levelsCompletedSinceAd = 0;
236
+ private int levelsRequiredBetweenAds = 3; // Show ad every 3 levels
237
+
238
+ public void OnLevelComplete()
239
+ {
240
+ levelsCompletedSinceAd++;
241
+
242
+ if (levelsCompletedSinceAd >= levelsRequiredBetweenAds)
243
+ {
244
+ ShowInterstitialOpportunistically();
245
+ levelsCompletedSinceAd = 0;
246
+ }
247
+
248
+ ProceedToNextLevel();
249
+ }
250
+
251
+ private void ShowInterstitialOpportunistically()
252
+ {
253
+ // Try to show, but don't wait if not ready
254
+ if (adManager.IsAdReady())
255
+ {
256
+ adManager.ShowAd();
257
+ }
258
+ }
259
+
260
+ private void ProceedToNextLevel()
261
+ {
262
+ // Load next level regardless of ad status
263
+ // Never block user flow waiting for ads
264
+ }
265
+ }
266
+ ```
267
+
268
+ **Why this works:**
269
+ - Frequency capping prevents ad fatigue
270
+ - Opportunistic showing (doesn't block if not ready)
271
+ - User flow never interrupted
272
+ - Predictable pattern users can adapt to
273
+
274
+ ### Pattern 3: Context-Aware Banner Management
275
+
276
+ **Use case**: Showing banners in menus but hiding during gameplay
277
+
278
+ ```csharp
279
+ public class ContextAwareBanners : MonoBehaviour
280
+ {
281
+ [SerializeField] private BannerAdManager bannerManager;
282
+
283
+ public enum AppContext
284
+ {
285
+ MainMenu,
286
+ Playing,
287
+ Paused,
288
+ GameOver
289
+ }
290
+
291
+ private AppContext currentContext;
292
+
293
+ public void SetContext(AppContext newContext)
294
+ {
295
+ currentContext = newContext;
296
+ UpdateBannerVisibility();
297
+ }
298
+
299
+ private void UpdateBannerVisibility()
300
+ {
301
+ switch (currentContext)
302
+ {
303
+ case AppContext.MainMenu:
304
+ case AppContext.GameOver:
305
+ // Show banners in menu contexts
306
+ bannerManager.ShowBanner();
307
+ break;
308
+
309
+ case AppContext.Playing:
310
+ // Hide during active gameplay
311
+ bannerManager.HideBanner();
312
+ break;
313
+
314
+ case AppContext.Paused:
315
+ // Optional: Show or hide based on your preference
316
+ // For UX-focused: Hide
317
+ // For revenue-focused: Show
318
+ bannerManager.ShowBanner();
319
+ break;
320
+ }
321
+ }
322
+ }
323
+ ```
324
+
325
+ **Why this works:**
326
+ - Banners shown only in appropriate contexts
327
+ - Gameplay experience uninterrupted
328
+ - Easy to adjust strategy by changing visibility logic
329
+ - Clean separation of concerns
330
+
331
+ ## Frequency Management
332
+
333
+ ### Time-Based Frequency Capping
334
+
335
+ Implement minimum time intervals between ads:
336
+
337
+ ```csharp
338
+ public class FrequencyManager : MonoBehaviour
339
+ {
340
+ private float minSecondsBetweenInterstitials = 300f; // 5 minutes
341
+ private float lastInterstitialTime = -300f; // Allow first ad immediately
342
+
343
+ public bool CanShowInterstitial()
344
+ {
345
+ float timeSinceLast = Time.realtimeSinceStartup - lastInterstitialTime;
346
+ return timeSinceLast >= minSecondsBetweenInterstitials;
347
+ }
348
+
349
+ public void RecordInterstitialShown()
350
+ {
351
+ lastInterstitialTime = Time.realtimeSinceStartup;
352
+ }
353
+ }
354
+ ```
355
+
356
+ **Recommended intervals:**
357
+ - Revenue-focused: 3-5 minutes
358
+ - Balanced: 5-7 minutes
359
+ - UX-focused: 10+ minutes
360
+
361
+ ### Count-Based Frequency Capping
362
+
363
+ Implement minimum actions between ads:
364
+
365
+ ```csharp
366
+ private int actionsRequiredBetweenAds = 3;
367
+ private int actionsSinceLastAd = 0;
368
+
369
+ public void OnUserAction()
370
+ {
371
+ actionsSinceLastAd++;
372
+
373
+ if (actionsSinceLastAd >= actionsRequiredBetweenAds)
374
+ {
375
+ // Eligible to show ad
376
+ TryShowAd();
377
+ actionsSinceLastAd = 0;
378
+ }
379
+ }
380
+ ```
381
+
382
+ **Examples of "actions":**
383
+ - Levels completed
384
+ - Games played
385
+ - Sessions started
386
+ - Feature uses
387
+
388
+ ## Error Handling and Graceful Degradation
389
+
390
+ ### Always Have a Fallback
391
+
392
+ Never let ad failures block user flow:
393
+
394
+ ```csharp
395
+ public void OnAdLoadFailed()
396
+ {
397
+ // Log for debugging
398
+ Debug.LogWarning("Ad failed to load");
399
+
400
+ // Continue with user flow
401
+ ProceedWithoutAd();
402
+
403
+ // Schedule retry
404
+ Invoke(nameof(RetryLoadAd), 30f);
405
+ }
406
+
407
+ private void ProceedWithoutAd()
408
+ {
409
+ // Your app continues normally
410
+ // Never block users because ads aren't available
411
+ }
412
+ ```
413
+
414
+ ### Reward Users Even When Ads Fail
415
+
416
+ For rewarded ads, consider granting rewards even if ad fails:
417
+
418
+ ```csharp
419
+ public void OnRewardedAdShowFailed()
420
+ {
421
+ // User intended to watch ad, but it failed
422
+ // Consider granting reward anyway (generous approach)
423
+ if (shouldBeGenerousOnFailure)
424
+ {
425
+ GrantReward();
426
+ ShowMessage("Reward granted! (Ad unavailable)");
427
+ }
428
+ else
429
+ {
430
+ ShowMessage("Ad unavailable, please try again later");
431
+ }
432
+ }
433
+ ```
434
+
435
+ **When to be generous:**
436
+ - UX-focused strategy
437
+ - High-value users
438
+ - Failure is on your end (not user's fault)
439
+
440
+ ## A/B Testing Considerations
441
+
442
+ ### What to Test
443
+
444
+ **High-impact variables:**
445
+ 1. **Frequency caps**: 3min vs 5min vs 7min between interstitials
446
+ 2. **Placement timing**: Immediate vs delayed interstitials
447
+ 3. **Reward generosity**: 1x vs 2x multiplier for rewarded ads
448
+ 4. **Banner visibility**: Always vs context-aware vs never during gameplay
449
+ 5. **Interstitial presence**: With vs without interstitials
450
+
451
+ **How to test:**
452
+ - Split users into cohorts
453
+ - Track both revenue AND retention
454
+ - Run tests for 7-14 days minimum
455
+ - Focus on long-term value (LTV), not just day-1 revenue
456
+
457
+ ### Metrics to Track
458
+
459
+ **Revenue metrics:**
460
+ - ARPDAU (Average Revenue Per Daily Active User)
461
+ - Impression per DAU
462
+ - eCPM (effective Cost Per Mille)
463
+
464
+ **UX metrics:**
465
+ - D1, D7, D30 retention
466
+ - Session length
467
+ - Session frequency
468
+ - Organic virality (shares, referrals)
469
+
470
+ **Balance metrics:**
471
+ - LTV (Lifetime Value)
472
+ - ARPU / Retention ratio
473
+ - User satisfaction scores
474
+
475
+ ## Common Mistakes to Avoid
476
+
477
+ 1. **Over-monetizing early**: Don't show tons of ads before users are engaged
478
+ 2. **Ignoring retention**: High revenue means nothing if users quit
479
+ 3. **Blocking without ads**: Never require watching ads to progress
480
+ 4. **Poor frequency capping**: Ads every minute frustrate users
481
+ 5. **Forcing rewarded ads**: Rewarded ads should always be optional
482
+ 6. **Ignoring load failures**: Always handle ad failures gracefully
483
+ 7. **One-size-fits-all**: Different user segments may need different strategies
484
+ 8. **Neglecting testing**: Always A/B test major monetization changes
485
+
486
+ ## Platform-Specific Considerations
487
+
488
+ ### iOS
489
+ - Lower opt-in rates post-ATT (iOS 14.5+)
490
+ - Users who deny tracking see lower-value ads
491
+ - More privacy-conscious user base
492
+ - Consider more UX-focused approach
493
+
494
+ ### Android
495
+ - Higher ad fill rates
496
+ - More permissive user expectations
497
+ - Diverse hardware requires testing
498
+ - Can push frequency slightly higher
499
+
500
+ ## Success Metrics by Strategy
501
+
502
+ *(Example benchmarks from industry typical ranges, not LevelPlay-specific targets)*
503
+
504
+ ### Revenue-Focused Success
505
+ - ARPDAU > $0.15
506
+ - Impression/DAU > 8
507
+ - D7 retention > 20%
508
+
509
+ ### UX-Focused Success
510
+ - D7 retention > 35%
511
+ - Session length > 15 minutes
512
+ - Low uninstall rate (<5% weekly)
513
+ - ARPDAU > $0.05
514
+
515
+ ### Balanced Success
516
+ - ARPDAU > $0.10
517
+ - D7 retention > 28%
518
+ - Impression/DAU > 5
519
+ - High user satisfaction
520
+
521
+ ## Final Recommendations
522
+
523
+ 1. **Start UX-focused**: Better to under-monetize early than drive users away
524
+ 2. **Increase gradually**: Add monetization as users become engaged
525
+ 3. **Always test**: Data beats assumptions
526
+ 4. **Watch retention closely**: It's easier to add ads than win back users
527
+ 5. **Be transparent**: Users appreciate honesty about ad-supported models
528
+ 6. **Reward patience**: Give users free options before pushing ads
529
+ 7. **Optimize continuously**: Ad strategy should evolve with your product
530
+
531
+ ## Code Generation Guidelines (Step 9)
532
+
533
+ Read this before generating ad implementation code in Step 9. It contains the general ad lifecycle,
534
+ per-organization-approach guidance, the always-include requirements, and bid-floor wiring.
535
+
536
+ ### General Implementation Pattern
537
+
538
+ All ad formats follow a similar lifecycle:
539
+
540
+ 1. **Load**: Request an ad from LevelPlay
541
+ 2. **Listen**: Register callbacks for ad events (loaded, failed, shown, clicked, closed)
542
+ 3. **Check readiness**: Verify ad is ready before showing
543
+ 4. **Show**: Display the ad to the user
544
+ 5. **Handle callbacks**: Respond to user interactions and ad lifecycle events
545
+
546
+ ### Adapt Output to the Chosen Organization Approach
547
+
548
+ **If the user mentions they have existing code**, ask to see it before providing implementation
549
+ guidance. This allows you to provide targeted fixes rather than generating new code from scratch.
550
+
551
+ **Option 1: Separate manager scripts**
552
+ - Create complete, production-ready `.cs` files for each ad format
553
+ - Name them clearly: `RewardedAdManager.cs`, `InterstitialAdManager.cs`, `BannerAdManager.cs`
554
+ - Include full class structure with proper namespaces
555
+ - Each manager handles one ad format completely
556
+
557
+ **Option 2: Unified AdManager**
558
+ - Create a single `AdManager.cs` file
559
+ - Include methods and callbacks for all requested ad formats in one class
560
+ - Use clear method naming to distinguish between formats (e.g., `LoadRewardedAd()`, `LoadInterstitial()`)
561
+ - Keep code organized with regions or comments separating each ad format
562
+
563
+ **Option 3: Code snippets only**
564
+ - Provide focused code blocks without full class wrappers
565
+ - Clearly label each snippet (e.g., "Rewarded Ad Initialization", "Interstitial Event Callbacks")
566
+ - Explain where/how to integrate each snippet
567
+ - Note any dependencies between snippets
568
+
569
+ ### Regardless of Chosen Approach, Always Include
570
+ - All manager classes must inherit from `MonoBehaviour` — required for Unity lifecycle methods (`Start()`, `OnDestroy()`) and to attach the script to a GameObject
571
+ - After generating any manager script, instruct the user to attach it to a persistent GameObject in their scene (the same one as the initializer, with `DontDestroyOnLoad`)
572
+ - For banner and interstitial managers, call `DestroyAd()` in `OnDestroy()` so ads are destroyed and memory is freed when the manager is destroyed
573
+ - Rewarded and interstitial show paths check `IsAdReady()` before `ShowAd()`. If the game uses dashboard placements, also check the static `IsPlacementCapped(placementName)` — capping is configured per placement in the LevelPlay dashboard, and showing a capped placement fails (error codes 524/526)
574
+ - Proper event subscription and unsubscription (to avoid memory leaks)
575
+ - Null checks and defensive programming
576
+ - Debug logs for troubleshooting
577
+ - Clear variable names that match LevelPlay conventions
578
+ - Error handling and graceful degradation
579
+
580
+ ### Bid Floor Handling (per-format)
581
+ - If the user provided a bid floor value for a format, wrap construction in `Config.Builder().SetBidFloor(value).Build()` and pass the config to the constructor.
582
+ - If the user said 'skip' for that format, use the basic constructor (`new LevelPlayRewardedAd(adUnitId)`).
583
+ - Apply per-format: a publisher may set a floor on rewarded but skip banner.
584
+
585
+ Example (with bid floor):
586
+ ```csharp
587
+ var config = new LevelPlayRewardedAd.Config.Builder()
588
+ .SetBidFloor(0.80)
589
+ .Build();
590
+ rewardedAd = new LevelPlayRewardedAd(adUnitId, config);
591
+ ```
592
+
593
+ Example (skipped):
594
+ ```csharp
595
+ rewardedAd = new LevelPlayRewardedAd(adUnitId);
596
+ ```
597
+
598
+ ## Additional Resources
599
+
600
+ For detailed API implementation, see:
601
+ - `rewarded-api.md`: Rewarded ad implementation
602
+ - `interstitial-api.md`: Interstitial ad implementation
603
+ - `banner-api.md`: Banner ad implementation
604
+ - `initialization-api.md`: SDK setup and configuration