Build Stellar plugins for Blue Protocol: Star Resonance.
Stellar is a Dalamud-style plugin framework — a read-only C# API over the live game, a native uGUI overlay toolkit, and a launcher that ships your plugin to players. Quality-of-life only; no cheating, by design.
public sealed class HelloSpec : IStellarPlugin
{
private readonly IPluginServices _s;
public string Name => "Hello Spec";
public HelloSpec(IPluginServices s)
{
_s = s;
_s.CombatEvents.CombatEventOccurred += OnCombat;
}
private void OnCombat(CombatEvent e)
{
// a nearby player's spec, known the moment they appear
if (e is CombatEvent.SpecChanged c)
_s.Log.Info($"spec → {c.NewSubProfessionId}");
}
public void Dispose() =>
_s.CombatEvents.CombatEventOccurred -= OnCombat;
}Start where you are
From pull request to players
What’s new for plugin authors
-
SocialSnapshot.Presence(SocialPresence?, init-only), decoded fromSocialData.basic_data:OfflineTimeMs(field 9, Unix ms, 0 while online)OnlineTimeMs(field 16)PersonalStates(field 8, packed or unpacked;ChatStatusTableids, never null)ReceivedAtMs(stamped by the cache)IsOnline(OfflineTimeMs == 0, the game’s own rule)
The shortcut
SocialSnapshot.IsOnline(bool?) is null whenPresenceis unknown. (#165) -
SocialSnapshot.Sections(SocialSectionsflags) records whichSocialDatasections a snapshot holds.Nonemeans not reported (hand-built snapshot). (#165) -
Cache merge:
SocialDataCachenow merges per section instead of letting the last reply win.- A section the reply carries replaces the cached one, even when it is present but empty.
- A section the reply leaves out is kept.
Presence,LocationandPartycarry forward.Sections == Nonekeeps the old replace-everything behaviour.
This fixes thin replies (basic-only, nameplate) wiping
FightPoint/ProfessionId/Gear/Fashion/Identity. (#165) -
Dye hue decoding (
Stellar.Wire): a dye’sxis hue degrees only for a Board colour group (ColorGroupTable.Type == 3). For other group types it is a swatch id looked up in the group’sHuerows. A miss,x == 0orColorGroupId == 0decodes to hue 0, matching the client (fashion_data.lua:327-351).- New
DyeHuePalette+DyeHueMapper, with additiveRead(span, DyeHueMapper?)overloads onAttrFashionDataReader/SocialDataReader. FashionDyePaletteResolvercaches per fashion id and per group id, and reflects only on the main thread. A miss during an I/O-thread decode falls back to degrees.- In release_3.7 every dyeable piece uses a Board group, so this only changes the 4 group-0 pieces and guards future builds. (#164)
- New
-
{-1,-1,-1}reset sentinel: a reset area is now dropped fromFashionEntry.Dyes/DyeAreas(the piece’s default colour) instead of decoding to black. (#164) -
Compatibility. All additions are init-only properties and new types, with no positional-record change, so existing plugins keep working. A plugin that reads
Presence/IsOnline/Sectionsneeds framework ≥ 2.32.0.