FrameworkVersion class
Single source of truth for the framework’s version string. Lives in Abstractions so every layer (Host’s BepInPlugin manifest, Infrastructure’s AboutPanel, and any plugin that wants to gate behaviour on a particular framework release) can read the same constant without re-declaring it. Bump this on each user-visible release; Host’s BootstrapPlugin.PluginVersion forwards to it so the BepInEx plugin manifest stays in lockstep.
public static class FrameworkVersionPublic Members
Section titled “Public Members”| name | description |
|---|---|
| const Value | Current framework version. Plain SemVer (no pre-release suffix) keeps the BepInEx chainloader happy. 2.32.0 adds SocialSnapshot.Presence / IsOnline / Sections (SocialPresence, SocialSections) (additive init-only); a plugin that reads them needs ≥2.32.0. Runtime: per-section social cache merge, dye reset/palette hues. 2.31.0 adds IWardrobePreviewOptions (a base of IWardrobePreview): ShowWeapon and the Show(self, outfit, dyes, hidden) overload (the outfit’s own show/hide state) (additive); a plugin that uses either needs ≥2.31.0. Runtime: the mouse wheel scrolls a list while one of its rows is being drag-reordered. 2.30.0 adds IThemeStatusColors (theme.Colors.Success/Danger/Caution), ThemePreset.Sakura``TextElement.MaxLines and TextElement.Height, plus WindowSpec.Topmost and IWindowTopmost (control.SetTopmost(bool) / control.IsTopmost() via WindowTopmostExtensions), and ListElement.Gap / Horizontal / CanReorder, and WindowSpec.Prebuild / PrebuildSignature (build a hidden window ahead of its first open), and ICombatBuffEffectLookup.TryGetBuffEffectIds (a base of ICombatLookup: per-buff PlayEffect / Customize effect ids off the wire), and IFrameworkDeveloperMode (a base of IFramework: read-only services.Framework.DeveloperMode + DeveloperModeChanged) (all additive); a plugin that uses any of them needs ≥2.30.0. Runtime: window stacking is no longer sticky — BringToFront acts like a fresh open, a window shown from hidden goes on top of its layer, a fronted HUD rises above Tools/Debug only until it is hidden. 2.29.1 is runtime-only (no API change): plugin MainMenuRail buttons stack below the Stellar button and draw their icon untinted; SquareHandle slider knobs are true circles; slider/hidden-window/Passive-window hit-test fixes. 2.29.0 adds DropdownElement.CornerRadius (opt-in rounded Pill trigger), VirtualListElement.OnReorder (opt-in drag-reorder for uniform-row virtual lists) and SocialSnapshot.Party (another player’s party roster from SocialData.team_data); a plugin that uses any of them needs ≥2.29.0. 2.28.1 is runtime-only (no API change): ICombatSnapshot.ServerNowMs anchors on SyncServerTime server_milliseconds (field 2) instead of our own echoed PC time (field 1), so it is real server time. 2.28.0 adds DropdownStyle + the DropdownElement.Style init property (opt-in Pill dropdown look) and WindowSpec.FrameOpacity (per-window GlassMenu frame opacity override; null follows the global setting); a plugin that sets either needs ≥2.28.0. 2.27.2 is runtime-only (no API change): the Korean Han/Eng key and live IME composition work in Stellar text fields, and the quick-use item bar stays visible while one is focused. 2.27.1 is runtime-only (no API change): Auto Combo keeps casting while a Stellar text field is focused, and ellipsized labels re-cut against the final width when a virtual-list row is rebound. 2.27.0 adds two pure helpers on VariableListMath — TopVisibleIndex (the top visible row without FirstIndex’s pool clamp) and FindRowById (bounded outward search by RowId) — used by the variable-list scroll anchor; a plugin that calls them needs ≥2.27.0. The rest of 2.27.0 is runtime-only (opt-in sticky cursor, game press-check shield, rich-input caret, virtual-list row culling). 2.26.0 adds IPluginServices.PlayerProfile (IPlayerProfile) — resolve a player’s profile AVATAR IMAGE URL by char/role id. RequestAvatarUrl(long charId, Action<string?> onResult) issues the game’s own Social.GetSocialData RPC (service uuid 901134105, methodId 1, with the request Mask bit 2 = SocialDataTypeAvatar) and invokes onResult exactly once on the main (Unity) thread with the full server-supplied https://…png URL read from GetSocialDataReply.Data.AvatarInfo.Profile.Url, or null when the player has no custom photo or the request failed. Fire-and-forget and defensive (never throws across the IL2CPP boundary); the proxy is acquired through the game’s own Zservice.ServiceRegister.GetSocialProxy(ZRpcCtrl.Instance, true) accessor and the returned UniTask<GetSocialDataReply> is polled on the framework tick (the framework has no compile-time UniTask reference, so it mirrors GameAssetsService’s reflected Status/GetAwaiter/GetResult poll rather than awaiting). The service returns only the URL — the consumer owns downloading, caching and texture creation. Intended for chat / nameplate avatars. 2.26.0 also adds window-element API for chat-style UIs (all init props, not ctor params): TextElement.RichEmoji / InputElement.RichEmoji (TMP text / TMP_InputField with the game’s chat sprite asset, so <sprite=N> draws as an emoji image — falls back to plain uGUI when TMP or the rich field is unavailable); InputElement.FocusRequest (counter token: a change focuses the field with the caret at the end); InputElement.Placeholder (polled hint text shown while the field is empty, both field kinds); VirtualListElement.OnAtBottomChanged (reports the stick-to-bottom pin decision) and ScrollToBottomRequest (counter token: forces the bottom pin until unmeasured rows settle) — VariableHeight + StickToBottom only; SelectableElement.OnRightClick (right-button-down, ticker hook, FrontWindowBlocks-aware); ListElement.OnReorder(from, to) (ticker-driven drag reorder, remove-then-insert indices, never fires for a no-op). IWindowHost.PrewarmText(string) is a new member WITH a default no-op body (implementors keep compiling): the framework rasterizes the text’s missing TMP glyphs a few per rendered frame (≤8 glyphs / ~3 ms) ahead of layout — a plugin that calls it needs ≥2.26.0. HitchProbe.Count(name, n) adds per-frame [Hitch] event counters (name=#N). Rendering changes behind the same release (login chat-history freeze fix, 0.9–4.3 s → ~70 ms): TMP dynamic faces sample at 48 pt / pad 5 instead of 90 / 9 (~3.5× cheaper per glyph, same SDF spread), and a variable-height VirtualListElement keeps at most 8 not-yet-measured rows active at once (the rest stay inactive until a latch frees budget; Conditionals inside an inactive slot don’t poll or lazy-build). Additive throughout — binary-compatible with plugins built against ≤2.25.5. 2.26.0 also adds chat/whisper API (all init-only props, new types, or default-implemented members): ChatMessage.TargetId (decoded ChatMsgInfo.target_id, a charId) and ChatMessage.PeerId (the other party of a whisper — sender, or target when the sender is self; private history batches tagged from the request’s target_id; ChatTarget.Reply uses it); client-generated SYSTEM notices (“Obtained …”) captured by a Lua wrap of the chat VM’s SetReceiveSystemMsg (polled 4 Hz in-world, no Lua→C# callback) and raised on IChat.MessageReceived as ChatChannel.System with ChatMessage.SystemLabel/ SystemType/SystemRefId; the server-driven send cooldown from SendChitChatMsgReply.cd_end_time (Unix seconds) via IChat.TryGetSendCooldown(channel, out remainingSeconds) + IChat.SendResult (ChatSendResult, ErrorTooFrequent = 5211) — both default-implemented on IChat; and IPluginServices.Friends (IFriends: Friends / PrivateChats / Changed polled from the game’s Lua data every 2.5 s in-world, plus queued RequestPrivateHistory / MarkPrivateRead / CreatePrivateChat / ClosePrivateChat run as the game’s own coroutine VM calls). A plugin that CALLS any of these needs ≥2.26.0. 2.25.5 is a fix: switching chat tabs/channels (any ResetScroll on a variable-height VirtualListElement) — and, more briefly, a burst of new messages — no longer FLASHES the rows overlapping each other for a couple of frames before they settle into place. On a ResetScroll every row’s latched height is cleared (ResetState), so for the 2-3 applies it takes MeasureActiveSlots to re-latch them each row falls back to the seed/running-average ESTIMATE (the chat consumer seeds RowHeight 28px, shorter than a real wrapping bubble); BuildOffsets packed the rows at that too-short estimate while Reposition sized each slot to its real content, so adjacent rows visibly OVERLAPPED inside the clipped viewport until the real heights latched and the offsets rebuilt. Now Reposition PARKS any row whose height is not yet latched off-screen (a large positive y, above the viewport top where the ScrollRect viewport’s RectMask2D clips it) instead of drawing it at its estimate offset — the slot stays ACTIVE and sized so MeasureActiveSlots can still measure it, and the apply it latches, Reposition re-runs and snaps it on-screen at its true offset. The viewport briefly blanks (~2 frames) on a tab switch rather than flashing overlapped rows; steady state and scrolling of already-measured rows are unchanged (a measured row always takes the on-screen branch). Infrastructure-only (VariableListBinding.Reposition in WindowBuilder.VariableList.cs); VariableListMath and the VirtualListElement API are unchanged — no API change, binary-compatible with all existing plugins (chat consumers like ChatTools need no rebuild). 2.25.4 is a fix: a variable-height VirtualListElement (the 2.25.0 measured/wrapping chat log of BubbleElement rows) no longer leaves a tall empty GAP below a freshly appended message (the text also briefly wrapped one character per line before snapping to size). This was a regression introduced by 2.25.3’s own measure-once cache: a row’s height latched from the FIRST reading taken while the slot was active, but BubbleElement solves the row’s WIDTH a tick LATER (BubbleBinding), so that first reading was taken at ~0 width — the text wrapped to ~1 char per line → a hugely tall preferred height that got locked in permanently even after the text visually corrected. The latch policy is now “measure until stable, then latch”: a height is committed only after two CONSECUTIVE measurements agree within a small epsilon (StableEps), which waits out the width-solve lag without depending on its exact timing (a pre-width-solve tall reading never matches the next settled one, so it stays provisional and never latches). A settled on-screen row is still latched and never re-measured, so 2.25.3’s no-jitter property is fully preserved. Infrastructure-only (VariableListBinding in WindowBuilder.VariableList.cs); VariableListMath and the VirtualListElement API are unchanged — no API change, binary-compatible with all existing plugins (chat consumers like ChatTools need no rebuild). 2.25.3 is a fix: a variable-height VirtualListElement (the 2.25.0 measured/wrapping list — a chat log of BubbleElement rows) no longer JITTERS while you scroll. The rows would “shift back and forth” vertically mid-scroll because the renderer re-read every visible slot’s uGUI preferred height EVERY apply: sub-pixel layout jitter — compounded by the BubbleElement width-solve settling one tick behind — let a SETTLED on-screen row’s measured height cross the 0.5 px change threshold frame-to-frame, and each crossing rebuilt the cumulative offsets and re-drove the scroll position, fighting the ScrollRect’s own inertia. The height model is now a per-DATA-INDEX cache: each row is measured ONCE (the apply after it binds and lays out) and never re-measured, so a settled visible row is pinned and cannot wobble. A stored height is dropped and re-measured only on a viewport-WIDTH change (rows re-wrap), ResetScroll (tab switch), or a Count DECREASE (rows dropped/filtered/front-dropped → indices remap); an append (Count INCREASE) keeps the cache and measures only the new tail rows. The topmost-visible anchor compensation (unchanged) now fires only on a row’s one-time estimate→measured correction as it scrolls into view, not every tick, so append + stick-to-bottom + tab-switch behaviour is preserved. Infrastructure-only (VariableListBinding in WindowBuilder.VariableList.cs); VariableListMath and the VirtualListElement API are unchanged — no API change, binary-compatible with all existing plugins (chat consumers like ChatTools need no rebuild). 2.25.2 is a fix: login chat HISTORY is correctly filed by channel again — the 2.25.1 fix did not work in-game. 2.25.1 moved the per-request channel capture to a Harmony prefix on ZTcpClient.Send(ReadOnlySpan<byte>), but the game’s own RPC never calls that overload (it is a plugin/helper entry — the prefix fired ZERO times for game traffic), and chat can route over UDP/KCP entirely, so nothing was ever stored and every login history batch resolved Unknown (messages appeared under NO channel tab). The capture now sits on the transport-agnostic ZRpcImpl.SendBytes(uuid, stubId, callId, methodId, pbData, pbSize, framePack) — above the TCP/UDP split, cold, public (PosingSendTap already patches it and proved it fires) — which carries BOTH the call_id and the raw request body as plain params: the channel is parsed off the body argument (the proven pre-2.25.1 source) and keyed by call_id in one invocation, with no cross-site/thread correlation. The call_id-keyed Return resolve (unconditional TryRemove(callId)), the map bounding, and the per-sender fallback are unchanged. Infrastructure-only — no API change, binary-compatible with all existing plugins (chat consumers like ChatTools need no rebuild). 2.25.1 is a fix: login chat HISTORY is no longer mislabeled with the wrong channel (e.g. Party/Guild history showing under World). The framework back-fills a history batch’s channel by correlating its GetChipChatRecords reply to the channel that was requested; that correlation was a positional FIFO (_pendingHistoryChannels) whose dequeue sat AFTER the empty/invalid early-returns, so the FIRST requested channel with EMPTY login history never dequeued and left its stale channel at the queue head for the next non-empty batch to mis-claim (and it also broke under out-of-order RPC replies). Now the channel is keyed by the RPC call_id: the ZTcpClient.Send prefix records call_id -> channel_type for each outbound GetChipChatRecords, and the Return resolves it with an UNCONDITIONAL TryRemove(call_id) (so an empty batch removes its own entry and poisons no other, and the map never leaks); a Return with no recorded id stays Unknown and falls through to the existing per-sender channel hint. The map is bounded (evict-oldest). The redundant ZRpcImpl.ProxyCall channel-capture patch was retired. Infrastructure-only — no API change, binary-compatible with all existing plugins (chat consumers like ChatTools need no rebuild). 2.25.0 adds VARIABLE-HEIGHT virtualization to VirtualListElement via two init props: VariableHeight (opt into measured rows — each pooled slot’s uGUI preferred height is measured after it binds to a data index, with un-measured rows using RowHeight as a running-average estimate; a per-index height model + cumulative offsets position the slots and derive the content height, so a long history of WRAPPING rows — e.g. chat bubbles — renders with only ~viewport+buffer GameObjects) and StickToBottom (newest-at-bottom: start scrolled to the bottom, keep pinned on append while at the bottom, preserve position when scrolled up). A measurement that replaces an estimate anchors to the topmost visible row so the view does not jump. New pure math helper VariableListMath (BCL, unit-tested). Both props default off → the uniform fixed-RowHeight path is byte-identical; init-props only, so additive and binary-compatible with plugins built against ≤2.24.0. 2.24.0 adds BubbleElement — a content-hugging rounded “chat bubble” / card for window UIs: a FillColor-tinted rounded sliced background (alpha honoured, so translucent bubbles work; null = a themed default) hosting one child with PaddingX/PaddingY. Its width HUGS the child’s preferred width (short label → narrow bubble; long sentence → wide), capped at MaxWidth (0 = the available/parent width) past which a wrapping child flows to multiple lines and the bubble grows in height — the content-size measurement a plugin cannot do itself. CornerRadius 0 reuses the SelectableElement chip, > 0 bakes a rounder sprite. Purely visual (click-through-neutral — wrap it in a SelectableElement to make it clickable). New record only — additive, binary-compatible with plugins built against ≤2.23.0. 2.23.1 is a fix: the Module Optimizer produces results again after the release_3.7_2 game patch moved each module part’s magnitude into Item.ModPartLevel.Levels (per-attribute module leveling); the old positional read returned 0 for every part, so Optimize scored every combo at ~0. PandaInventoryPullReader now reads the value from Item.ModPartLevel.Levels[attrId] with a positional fallback for pre-3.7_2 builds. Infrastructure-only — no API change, binary-compatible with all existing plugins. PR #129. 2.23.0 adds IPluginServices.Voice (IVoiceInjection) — play audio into the game’s OUTGOING team-voice stream (mixed with the live mic) through a process-wide native DirectSound capture hook and a shared 16-source mixer: IVoiceInjection (LoadFileAsync WAV/MP3/WMA/M4A, LoadPcm for TTS/generated audio, CreateSource, SetUplinkPolicy, Available/Status), IVoiceSource (clip/volume/loop/play/stop/position, PlayOnce), IVoiceClip and VoiceInjectionStatus. Sources a plugin creates are auto-disposed on plugin teardown (mirrors IHarmonyHost); the uplink DSP policy is process-global, last-writer-wins, auto-restored when nothing plays. New services + records only — additive, binary-compatible with plugins built against ≤2.22.1. 2.22.1 is a fix: clicking a Stellar window button no longer leaves it selected in the EventSystem (which routed WASD into chat instead of moving the character). No API change. 2.22.0 adds IInputShield.IsPointerOverGameUi (is the pointer over the game’s own interface, not a Stellar window — a free camera that shows the game interface leaves clicks on it to the game). Additive. 2.21.0 adds Korean ("ko", 한국어) as a UI language: ILocalization.Language may now return "ko" and plugins can ship Lang/ko.json; “Follow game client” maps the game’s Korean client. Hangul font coverage added to the overlay font chains. Additive. 2.20.0 adds the game photo screen’s full hide list as VisibilityLayers (SelfCharacter, OwnSpiritEcho, Strangers, Friends, Party, Guild, NonPlayers, Enemies, Weapons, Collectibles, OtherSpiritEchoes; sets PlayerGroups/World; legacy layers unchanged), IHotkeys.IsActionHeld (level query, default-implemented) and the [``\``] keys (StellarKeyCode.LeftBracket/Backslash/RightBracket). Additive. 2.19.1 fixes expired potion/food buffs staying in ICombatLookup.BuffsFor (a RemoveLayer that leaves no layers now ends the buff). No API change. 2.19.0 adds InputElement.SingleLine (a true one-line field: never grows, scrolls sideways, strips pasted newlines, Enter submits and ends editing; a submit grace on IsFocused keeps Enter from opening chat), TextAreaElement (fixed-height multi-line box with a themed scrollbar; Lines, ReadOnly) and per-row BarElement.FillColorFn/LabelColorFn; fixed-box fields pin layoutPriority 2. Additive. 2.18.0 adds XYPadElement: a two-axis pad (grid + centre crosshair + dot; click or drag sets X/Y over [Min, Max], Y up; Set on every drag frame like SliderElement; Size, GridLines). Additive. 2.17.1 is the stable release of the 2.17 line (identical code to the 2.17.0 testing build). 2.17.0 adds ReShade support: IReShade (IPluginServices.ReShade — effects on/off, technique toggles by effect file + name, preset switching, shader/texture search paths; unavailable and a no-op without ReShade and the Stellar bridge add-on), IPluginDownloads (IPluginServices.Downloads — sha256-pinned https downloads, optionally unzipped, into the plugin’s own data folder), CaptureRequest.ApplyReShade (default true: a photo carries ReShade’s active effects; a shaped photo skips depth-based ones for that photo only) and CaptureResult.Notes (for example “ReShade was not ready — photo taken without it.”). Additive. 2.16.0 adds hiding yourself and effects by caster: VisibilityLayers.Self and the four effect layers (EffectsMine/EffectsParty/EffectsOthers/EffectsMonsters, VisibilityLayerSets.Effects). 2.15.0 adds posing by person: IPosing / IPoseTarget (the local player live, other players as a local photo copy, NPCs as a generated model; action + moment, held expression, head/eye look, facing; available in the world with or without the free camera; every touched person reset when the scene ends — zone change, cutscene, the game’s camera mode, disconnect — or on despawn or unload; the scene freeze never holds the local player) plus the domain types PersonKind, PersonInfo, ExpressionInfo, LookMode, LookPart, PoseTargetState, PoseResult; IEntityPicker also picks NPCs. Additive. 2.14.0 adds the free-camera contracts on top of 2.13.0’s photo services: ICameraOverride/ICameraControl (exclusive, main-thread-only camera takeover with a 60 m hard leash and a CameraReleaseReason raised on every forced release), IInputShield/ IInputShieldHandle (reference-counted game-input blocking plus raw keyboard/mouse reads for the holder), ISceneFreeze (freezes entity animation, effects and — budget permitting — drawn positions), IEmotes (the local player’s unlocked emote wheel + PlayAsync through the game’s own action, no packet construction), ICombatState (local-player in-combat, event-driven) and IEntityPicker (screen-point → EntityId hit-testing for IEntityTransforms). Domain-only additions: CameraPose, CameraReleaseReason, EmoteInfo, EmoteResult. Every service is implemented and wired on IPluginServices; IInputShieldHandle.TextFieldFocused reports a focused Stellar text field so a holder can ignore keys typed into a panel. Additive, binary-compatible with plugins built against ≤2.13.0. 2.13.0 — photo services: IScreenCapture, ISceneVisibility, IRenderLook, IPhotoModeState (IPluginServices.ScreenCapture / .SceneVisibility / .RenderLook / .PhotoMode). Additive only. 2.12.0 adds HitchProbe (diagnostics-gated render-frame hitch attribution) and makes windows cheaper: a hidden window is parked (deactivated) rather than destroyed, ConditionalElement branches build on first show, and meter debuff cells are created on demand. Additive only. 2.11.0 adds player spec from talent root buffs: ICombatSpec.TryGetTalentSpec, CombatEvent.SpecChanged and CombatEvent.EntityBuffsSeeded (a player’s full buff set when they appear). Additive only. 2.10.0 adds ILoadoutSave (IPluginServices.LoadoutSave): SaveCurrentToAsync(index) saves the WORN setup into another saved loadout through the game’s own AsyncSaveRolePlan wrapper (refused without dispatch for the worn / unknown loadout or while a switch or save is in flight), and HasUnsavedChanges — the game’s own CheckRolePlanIsChange, cached and re-evaluated on the container-merge event, the loadout-list re-read and after a save (never on a timer). Additive only. 2.8.3 adds IEntityPortrait.ShowWeapon (hide the subject’s weapon in the 3D portrait) and IEntityPortrait.LightPreset (-1 = Scene/dynamic, 0..4 = custom, environment-independent creature-light profiles rebased on the real HDR scene scale), with the camera controls (Orbit/Zoom/Pan/SetViewport) factored onto a new base IEntityPortraitView (IEntityPortrait : IEntityPortraitView) so each interface stays under the STELLAR0005 8-member cap. The portrait’s custom creature light is world-isolated: the five shared creature-light shader globals are captured before the portrait’s CommandBuffer draw and restored byte-identical after, so in-world characters are unaffected regardless of frame timing. Also adds BarElement.LabelColor (ColorRgba?) — a per-bar override for the inside label colour that wins over the theme’s muted tone (default null keeps every existing bar byte-identical). Additive members + a new base interface; binary-compatible with plugins built against ≤2.8.2 EXCEPT a plugin that CALLS the camera methods moved onto IEntityPortraitView must be recompiled (only EntityInspector consumes them, rebuilt in tandem). Consumed by StellarEntityInspectorPlugin. 2.8.2 is a fix: a player-stats sampling pass in which NO attribute read is no longer allowed to mark those attributes permanently unreadable. The local-player entity exists for several ticks before its attribute sheet is populated, so a pass taken inside that login window missed every subscribed id and latched them all for the life of the process — Stat Inspector then showed “—” for every tracked stat until the client was relaunched (owner report 2026-09-21). The decision moved out of the reflection probe into the pure, unit-pinned AttrReadabilityMemo: a pass may condemn its misses only once the attribute sheet is known populated — a live read in the same pass, or the caller’s explicit readiness signal — so the anti-spam for genuinely absent ids such as 11760 / 11980 is unchanged. The verdict itself now EXPIRES after 60 s and the id is probed once more, so an attribute the game publishes late (11951 on a test client) appears within a minute instead of dashing for the session; re-subscribing an attribute re-probes it at once, and a logout forgets every verdict. Infrastructure/Application only — no API change, binary-compatible with all existing plugins. 2.8.0 adds MeterRowData.LabelStyle (MeterLabelStyle Plain / Outline / Shadow): how the two values drawn on a meter row’s bar stay readable over the fill — CombatMeter 2.10.0 can paint the bar with the class crest colour (yellow / green / orange), where plain white text had a contrast of 1.4–2.0 (owner 2026-09-09: “text on meter is barely readable” → “it should be option for players”). Outline = the stat HUD’s readability halo (UGuiPrimitives.AddReadabilityOutline, 1.1 px); Shadow = a soft dark shade under the value whose strength follows the fill’s luminance. Default Plain keeps every pre-2.8 plugin’s rows byte-identical. Additive API; binary-compatible. 2.8.1 is a fix: the Steam Class::Init injection guard (Il2CppClassInitFix.EnsureSeeded) is now armed BEFORE user plugins load, not only inside the tick host’s install (which ran AFTER plugin construction). A plugin that injects an IL2CPP type in its constructor (e.g. an enabled overlay like Minimal Nameplate) previously crashed the Steam StarSEA_STEAM build at boot because the guard wasn’t seeded yet. Infrastructure/boot-order only — no API change, binary-compatible with all existing plugins. 2.7.4 is a fix: repairs Il2CppInterop’s IL2CPP type injector on game builds whose GameAssembly.dll codegen defeats InjectorHelpers.FindClassInit()’s hardcoded Class::Init byte-signature scan — it mis-resolves to a bad pointer and hard-crashes the CLR (0x80131506) at the FIRST ClassInjector.RegisterTypeInIl2Cpp. Observed on the Steam StarSEA_STEAM build (separate SKU compile; the standalone StarSEA resolves fine). The framework now pre-seeds the process-global InjectorHelpers.ClassInit with Il2CppInterop’s own documented substitute (il2cpp_class_has_references) before its first injection, so the broken scan is skipped; harmless on builds where the scan already worked (the substitute is the library’s own fallback). Infrastructure-only (Il2CppClassInitFix) — no API change, binary-compatible with all existing plugins. See docs/recon/steam-client-classinit-injection.md. 2.7.3 is the STABLE release of the 2.7 line: same code as the 2.7.2 testing build, promoted to the stable channel (2.7.2’s version number was already taken by that testing release, and a taken version is never re-minted — the promotion rides a patch bump). No API change. 2.7.2 carries the 2.6.3 native-UI layout fixes and the 2.6.4 IPlayerIdentity.CharId API into the 2.7.x (rDPS groundwork) line — additive, binary-compatible with ≤2.7.1. 2.7.1 carries the 2.6.2 Deep-Slumber loadout hotfix into the 2.7.0 (rDPS groundwork) line — no API change. 2.6.4 adds IPlayerIdentity.CharId — the local character’s stable id (char-record-backed, known before the world entity syncs; 0 when unknown), so plugins can key per-character storage instead of colliding across characters on one account. Additive (a new interface member + getter): binary-compatible with plugins built against ≤2.6.3, but a plugin that CALLS CharId needs this framework (LoadoutSwitcher/Wardrobe bump their min to 2.6.4). Abstractions/Application surface only; built on v2.6.3 (native-UI layout fixes + the 2.6.2 Deep-Slumber cross-loadout factor-move fix). 2.6.3 is a fix: native game-UI elements you have repositioned (quest tracker, boss HP bar, etc.) survive a resolution round-trip, no longer ratchet on repeated hide/show, and fall back to the game’s default pose at an unconfigured resolution. The SetRect idempotent guard now keys on (target, anchoredPosition, curatedSize) equality; adds INativeUiAdapter.RestoreOriginalPose. Infrastructure/Application-only (native-UI positioning) — no plugin API change, binary-compatible. 2.6.1 is a fix: IWardrobe.GetWornWeaponSkin reports “no weapon skin” as SkinId 0 again. The Wardrobe’s ⊘ tile is not skin 0 — the game stores the current weapon’s ORIGIN row id (a concrete WeaponSkinTable row per weapon family), so capture saved a specific skin and re-applying the outfit forced that look. Infrastructure-only (capture chunk) — no API change, binary-compatible. 2.4.1 is a fix: the framework-only “Cannot perform this action during combat” toast (~every 5s in sustained open-world combat) is gone. Root cause: every CharSerialize merge re-armed the loadout refresh, whose weapon-VM SyncProjectList RPC the server rejects in combat (ErrStateIllegal 3202) and the game’s own wrapper toasts. PandaLoadoutProbe.DecideRefresh now defers ONLY that RPC while the local player is in combat (game’s own check), keeping the pending/first-refresh state armed so exactly one refresh fires at combat end; the RPC-free live-state re-read keeps running in combat. Infrastructure-only — no API change, binary-compatible with all existing plugins. (2.4.0 shipped the Wardrobe surface but did not bump this constant; 2.4.1 realigns it.) 2.2.0 is the live-build release. Adds ILoadout.LiveState (LiveLoadoutState — the live class + talents, never a saved plan), ILoadout.LiveStateChanged (ONE game-tick event covering the whole build: equipped gear/module slots, class, talent stage/nodes, the equipped Battle Imagine pair, and Deep-Slumber — raised only after the framework’s re-read actually changed what it serves, so a consumer may treat it as “the setup I can read right now is the new one”), and IPluginServices.DeepSlumber (IDeepSlumber) — the live Deep-Slumber Psychoscope (season cultivate) state: season levels, lines, areas, socketed cards and node levels, read live per call. IInventory.SelfGearChanged widens from gear-only to the local player’s BUILD-state signal (it now also fires on talent field-61 and season-cultivate field-101 dirty deltas). IResonanceState.Installed keeps its shape but changes SOURCE and id space: the equipped Battle Imagines are now read from the skill hotbar’s aoyi slots 7/8 as aoyi SKILL ids (resolve via IGameDataResonance.GetImagineForSkill) because CharSerialize.resonance (wire field 28) is never re-serialized on an in-session swap. Internally the framework’s last per-tick game reads are gone — live-state capture and the dungeon defeated count are both event-driven now (container-merge / scene-attr sync). New members + a new service only — additive, binary-compatible with plugins built against ≤2.1.0. 2.1.0 adds IPluginServices.Localization (ILocalization) — a plugin-scoped UI-text localizer. A plugin ships four embedded Lang/{en,ja,th,id}.json catalogs and calls Localization.T(key) / TFormat(key, args), resolved to the active language (English fallback, then the key literal). The framework auto-discovers each plugin’s catalogs at load, and Stellar’s own settings UI is now localized in English / 日本語 / ไทย / Bahasa Indonesia (Settings → Themes → Language, defaulting to Follow-game-client). Adds ILocalizationControl (Settings-facing, NOT on IPluginServices). New service only — additive, binary-compatible with plugins built against ≤2.0.3. 1.18.1 is a fix: game-region detection matches the running executable by name PREFIX (StarSEA = SEA, StarASIA = JP) rather than exact filename, so the Steam build’s StarSEA_STEAM.exe resolves to SEA instead of Unknown (which had made upload plugins withhold every run). Detection-logic only — no API change, binary-compatible with all existing plugins. 1.18.0 adds SliderElement.SquareHandle, an OPT-IN knob that is exactly HandleSize square. Unity’s Slider drives the handle’s cross-axis anchors to full stretch every frame, so by default HandleSize ADDS to the row height instead of setting the knob’s height — a 13px handle in a 16px row draws a 13×29 capsule (measured 2026-07-30). The stretched shape stays the default on purpose: every existing slider already renders that way, and correcting it globally would restyle every plugin’s sliders at once. Additive only — no existing slider changes appearance, and drag behaviour is identical (the value maps from the container’s width, which is untouched). 1.17.0 adds ActorState and CombatEvent.EntityStateChanged (2026-07-28 entity-state-death-signal spec): the client’s own entity state-machine transitions (death, break phase), surfaced on the existing ICombatEvents stream — no service interface gains a member, so the STELLAR0005 8-member ceiling is untouched. Lets plugins (e.g. the CombatMeter’s BossKill) know an entity died without inferring it from HP reaching zero, which scripted kills never do. Field-proven sourcing, after three recon rounds (see recon/entity-state-death-signal-notes.md): Panda.ZGame.ZStateDead.OnEnter fired for all ten deaths in the owner’s confirming run and is the sole installed death source; Panda.ZGame.ZStateBreaking.OnEnter (untested, not disproven — no break phase occurred in that run) is its kept sibling. The originally-spec’d EntityCtrlDead.OnEnter stayed silent across those same ten deaths (disproven) and the wider ZStateMachine.onStateChanged/EnterState hooks tried in between were dropped for cost, not correctness — EnterState also resolved every one of the ten deaths correctly and remains a documented, field-proven fallback if ZStateDead is ever removed/renamed, just not installed by default because it fires on every actor’s every transition rather than only the one that matters. New enum + new discriminated-union case only — additive, binary-compatible with plugins built against ≤1.16.1. 1.15.0 adds IPluginServices.Data — an IPluginDataStore giving each plugin its own binary file storage (Write/Read/Delete/List, never-throws, path-traversal-safe) for data too large/opaque for IConfigSection; rooted OUTSIDE the plugin-scan dir. New service only — additive, binary-compatible with plugins built against ≤1.14.0. 1.14.0 adds EntityVitals.HasHpObservation (MaxHp-only observations no longer read as dead; init-prop, binary-compatible), AOI-appear vitals seeding, PartyMember.FastSyncState (raw TeamMemberFastSyncData.state transport; init-prop), and IDungeonState.CurrentFlowState/FlowStateVersion (EDungeonState surfaced with a poll-friendly transition counter) — all additive, binary-compatible with plugins built against ≤1.13.0. 1.13.0 adds IExchange.GetStallSubcategoryMap (live StallDetailTable membership). 1.12.0 adds IGameEnvironment — region (SEA/JP/Unknown) + installed game version, detected once at boot from install markers with a framework-config override; additive, binary-compatible with plugins built against ≤1.11.0. 1.11.0 consolidates the portraits/replay line: IDungeonState (settlement + outcome + achieved score), IEntityTransforms (live entity transforms for position/replay capture), IEntityDetail.RefreshSocialSnapshot (self social-data refresh), IGameDataWorld.GetMonsterByEntity, SocialSnapshot.MasterScore, GearInstance.BreakThroughTime, skill-phase CombatEvents — all additive (new services / init-props / defaulted params), binary-compatible with plugins built against 1.10.0. 1.10.0 adds additive window-framework support behind the CooldownBar overlay: WindowSpec.BackgroundOpacity (poll-diffed backdrop on the borderless root that expands on height resize), ColumnElement.Padding, RowElement.Justify + RowJustify (with a compat overload), BackdropElement, VirtualListElement.ResetScroll, and CooldownTileElement.OnClick — all init-props / new records / defaulted params, so binary-compatible. Infrastructure: atomic game-asset icon rebind via a WindowToken binding (no scroll blink), buff icons as atlas Sprites, a ConditionalElement flex clamp, and a VirtualList viewport inset. (#32) 1.9.1 is a fix: PandaMenuStateProbe now also detects NPC dialogue, loading screens, the dungeon-enter confirm popup (team_copy_popup on UILayerFuncPopup), the line-selector panel, and story cutscenes as full-screen menu states, so AutoHideBehindGameMenus windows hide in all those cases. 1.9.0 adds IWindowControl.BringToFront() (a ZFront counter that sorts above category so explicit fronting works cross-category, with a pending flag so SetVisible(true) + BringToFront() works on a still-hidden window), a front-window interaction pass-through guard, and a restyled dropdown item to match SelectableElement. 1.8.0 adds DropdownElement — a reusable compact dropdown (trigger caption + ▾ that opens a themed floating option list above the window’s scroll clip; dismiss on pick, outside-click, or Escape). The Settings → Performance per-plugin Self-rate control now uses it in place of the click-to-cycle button. 1.7.1 was a binary-compatibility hotfix: SliderElement’s Width/HandleSize moved off the record primary constructor (added in 1.7.0, which broke the old positional ctor) to init-only properties, so plugins compiled against ≤1.6.0 (e.g. AutoFishing) load again. 1.7.0 adds per-plugin & dynamic update-rate control: each plugin’s IFramework.Update ticks at its own rate (user-configurable in Settings → Performance), and a plugin may temporarily ramp its own rate via IFramework.RequestUpdateRate (returns an IUpdateRateScope), gated by a per-plugin user permission. The framework tick became a single variable-speed clock at max(global, all active rates), with the Lua-bridge probe drains riding it so RPC latency falls with the rate. Also adds SliderElement.Width/HandleSize and honors ToggleElement.Enabled. 1.6.0 adds IExchange (player Trading-Center query + buy via the game’s own trade flow, exposed as IPluginServices.Market) and the extensible INotifications.Create() toast builder (custom-icon support). 1.5.0 added team-voice mic status + dungeon ready-check on the meter row (IPartyEvents/IPartyRoster) plus the click-away popup / PanelElement / z-ordering UI primitives. 1.4.2 was a hotfix for non-ASCII (e.g. Thai) text input truncated in uGUI fields (onValidateInput → onValueChanged); 1.4.1 scoped the rail-button template lookup (periodic freeze); 1.4.0 added IWindowControl.SetVisiblePersist plus the native-UI grab-box / cutscene-reposition fixes. |
Remarks
Section titled “Remarks”BepInEx parses Value with SemVer semantics — it rejects trailing letters like 0.9.0a (“Skipping type because its version is invalid”). Use SemVer pre-release suffix syntax (0.9.0-alpha) so the chainloader accepts the manifest.
See Also
Section titled “See Also”- namespace Stellar.Abstractions.Domain