Echo HarmonicBlessing

Package: com.amanotes.echo.harmonicblessing v1.0.1
Unity: 2022.3+
Namespace: Amanotes.Echo.HarmonicBlessing
Dependencies: com.amanotes.orchestra 0.2.41, com.amanotes.echo.foundation 1.0.1

Winning-streak blessing module for Echo games. Tracks a single consecutive-win streak, advances through configurable streak tiers that grant boosters, unlocks at a configurable player level, and resets on loss / quit / crash.

Setup

1. Add the package: it's already embedded under Packages/ in this repo, or install it into another project via a scoped registry. In that project's Packages/manifest.json:

   {
     "scopedRegistries": [
       {
         "name": "Amanotes",
         "url": "https://registry.npmjs.org",
         "scopes": ["com.amanotes"]
       }
     ],
     "dependencies": {
       "com.amanotes.echo.harmonicblessing": "1.0.1"
     }
   }

   com.amanotes.echo.foundation resolves automatically as a transitive dependency. No auth token needed — these are public packages on npmjs.org.
2. (Optional, recommended) Package Manager → Echo HarmonicBlessing → Samples → Import "HarmonicBlessing Entry Point" — or open Packages/com.amanotes.echo.harmonicblessing/Samples/Scenes/HarmonicBlessingSample.unity directly — and press Play to see HarmonicBlessingManager initialize, unlock, and progress through streak tiers with zero host code. The module has no standalone view of its own (its panels are meant to be embedded inside the host's PreplayPopup), so this sample is state-only: watch tier/streak progress and drive it via HarmonicBlessingDebugGUI's cheat buttons.
3. Run Echo → HarmonicBlessing → Setup Wizard to generate the host-integration layer (HarmonicBlessingBridge, HarmonicBlessingConfigBridge, SRCheat.HarmonicBlessing) into your game's Assets/_Echo/.
4. Wire the bridge // TODO: markers to your host systems (PlayerData, Boosters, icon resolver, Gameplay events).

Debug tooling

Two interchangeable options — both call the same HarmonicBlessingManager/HarmonicBlessingService public API, so their cheats never drift out of sync:

• With SRDebugger: SRCheat.HarmonicBlessing.cs, generated by the Setup Wizard, adds a Force Unlock / Simulate Win / Simulate Loss / Simulate Quit / Log State panel to the SRDebugger overlay.
• Without SRDebugger: drop HarmonicBlessingDebugGUI (Scripts/Debug/HarmonicBlessingDebugGUI.cs, ships with the module, zero third-party dependencies) onto any scene GameObject for the same cheats via a plain OnGUI() toggle panel. Already included in the sample scene above.

Architecture

HarmonicBlessingManager (logic) + HarmonicBlessingConfig (object JSON with tier validation) + cumulative streak tiers granting boosters + injected icon resolver + host bridge. The module emits KEventBus events and never references host systems directly.

See HarmonicBlessing.md for the full design doc.