GRIP - Core is the foundation library suite for the GRIP addon
family. It ships seven LibStub-registered libraries that consumer
addons embed via .pkgmeta externals, plus a small standalone hub
UI bound to /gripcore.
What it provides
- LibGRIPSchema-1.0 -- canonical schema-type registry (FourCC + version + owner).
- LibGRIPEncode-1.0 -- wire-format encoder/decoder (
!GRIP: envelope, deflate, base91).
- LibGRIPVersion-1.0 -- schema migration helpers.
- LibGRIPSnapshot-1.0 -- provider registry for unified snapshot collection.
- LibGRIPDiff-1.0 -- snapshot diff producing structured change-set tables.
- LibGRIPComm-1.0 -- snapshot exchange over addon messages, chunked + deflated + schema-tagged.
- LibGRIPBridge-1.0 -- in-game to external bridge (clipboard frame + BattleNet community paste helper).
The lib suite handles serialization, transmission, snapshot collection,
and diff comparison so consumer addons (GRIP - Enhanced Macro Sequencer,
GRIP - Guild Recruitment, GRIP - Forge, GRIP - Export, plus any
third-party consumer) don't have to roll their own.
Status
GRIP - Core is alpha (v0.1.x). The seven lib bodies are implemented
and the in-game smoketest passes 56/56 across all groups, but the API
is not yet frozen. Public-method signatures and err_table codes may
change before v1.0. Pin to a specific git tag in your .pkgmeta externals
if you need a stable embed during alpha.
For end users
Most players never see GRIP - Core directly -- managed clients install
it as a Required Dependency for the consumer addons. If you do install
it standalone, type /gripcore for the hub UI (Snapshots, Export, Diff,
Version, Comm tabs), /gripcore version for the loaded-lib inventory,
or /gripcore smoketest to run the 56 in-game test cases.
For addon developers
See the GitHub repo for the embed pattern (.pkgmeta externals block
Compatibility
- WoW Retail 12.0.1+ Midnight only.
- No Classic (Era / SoD / Cata) support.
- Lua 5.1 (the WoW interpreter version).
License
MIT. Consumer addons pull these libraries via .pkgmeta externals
which requires a permissive license; the lib suite is intentionally
licensed differently from the All-Rights-Reserved consumer addons.
Links
