Skip to content
Version 2.32.0
↓ Get the launcher
Stellar framework · 2.32.0 · plugin SDK

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.

70services on IPluginServices2,169API pages19registry plugins
HelloSpec.cs
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

Three kinds of reader, three front doors

From pull request to players

Interactive — drag to pan, scroll to zoom, click a box for its source
All diagrams →
Ecosystem

What’s new for plugin authors

Generated from the CHANGELOG’s developer notes
Full changelog →
Framework 2.32.02026-11-13
  • SocialSnapshot.Presence (SocialPresence?, init-only), decoded from SocialData.basic_data:

    • OfflineTimeMs (field 9, Unix ms, 0 while online)
    • OnlineTimeMs (field 16)
    • PersonalStates (field 8, packed or unpacked; ChatStatusTable ids, never null)
    • ReceivedAtMs (stamped by the cache)
    • IsOnline (OfflineTimeMs == 0, the game’s own rule)

    The shortcut SocialSnapshot.IsOnline (bool?) is null when Presence is unknown. (#165)

  • SocialSnapshot.Sections (SocialSections flags) records which SocialData sections a snapshot holds. None means not reported (hand-built snapshot). (#165)

  • Cache merge: SocialDataCache now 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, Location and Party carry forward.
    • Sections == None keeps 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’s x is 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’s Hue rows. A miss, x == 0 or ColorGroupId == 0 decodes to hue 0, matching the client (fashion_data.lua:327-351).

    • New DyeHuePalette + DyeHueMapper, with additive Read(span, DyeHueMapper?) overloads on AttrFashionDataReader / SocialDataReader.
    • FashionDyePaletteResolver caches 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)
  • {-1,-1,-1} reset sentinel: a reset area is now dropped from FashionEntry.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 / Sections needs framework ≥ 2.32.0.

Reference

Rebuilt from the source on every deploy — it cannot drift