Releases

08 Dec 2025
@ZachHembree
1.3.0.0
9eb595e

[1.3.0.0] Performance & Stability Overhaul Latest

This release delivers a comprehensive refactor of the UI implementation, focusing on performance, layout stability, and a few QOL utilities. Accumulated optimizations and architectural improvements significantly reduce latency, improve layout responsiveness, reduce jitter, and greatly reduce Space Engineers profiler overhead.

Highlights

  • Iterative tree update system
    Rich HUD Master now traverses and updates client UI trees directly via reference handles, eliminating inefficient polling. Core UI state management for v1.3 clients has been centralized in Rich HUD Master, yielding:

    • Near-instant element registration and visibility changes (one-frame latency)
    • 80%+ fewer delegate invocations and lower mod profiler overhead
    • Dramatically reduced cost for UI nodes; invisible but loaded nodes are now essentially free. Build Vision's list menu update time was reduced by 45%.

  • Improved layout stability
    The standard UI library has been refactored with separate bottom-up Measure and top-down Layout passes. This architectural change eliminates the bouncing and lag previously caused by timing issues and top-down data flow limitations. As a result, self-sizing elements and dynamic containers are now nearly jitter-free.

  • Public API documentation
    All public APIs and core source code now include expanded inline documentation. A new DocFX-based reference site provides detailed remarks, usage examples, and supplementary materials.

Additions

  • Bind Manager
    • Support for bind aliases (secondary and tertiary key combinations)
    • Added analog control and gamepad input support
  • Declarative input utilities
    • BindInputElement, IBindInput, and IBindInputElement – logic-only nodes for context-aware, event-driven input handling, complimenting preexisting layout utilities like HudChain.
    • IValueControls interface with unified value accessors and change callbacks, enabling near-fully declarative custom UI when using library elements with built-in layout utilties.

Other Changes

  • Added convenience combinations for DimAlignment and ParentAlignment flags
  • TextBox now supports text highlighting using Shift + arrow keys
  • Input focus management separated from IMouseInput; now handled via dedicated IFocusHandler and InputFocusHandler interfaces
  • Added UnpaddedSize property to HudElementBase
  • HudMain.Root and HudMain.HighDpiRoot now support DimAlignment and ParentAlignment flags on child nodes

Breaking Changes (from v1.2.x)

Mods that directly modify or depend on internal library implementation will require refactoring. Mods that use public interfaces compositionally are minimally affected.

  • HudElementBase: Width, Height, and Size properties are no longer virtual
  • Selection box and text element value properties renamed to align with IValueControl contract
  • Mouse input focus/active state removed from IMouseInput/MouseInputElement
    • Now managed separately via IFocusHandler, InputFocusHandler, and IFocusableElement
  • IClickableElement implementations must now also implement IFocusableElement
  • BindManager groups can no longer be instantiated directly from deserialized definitions; groups must be declared before loading
  • Preload flag is now obsolete (removed from registration methods)
  • Minor naming adjustments and method relocations in core types

The above list is representative but not exhaustive. Consult the API reference as needed for more detail and usage examples.

Assets 4
24 Feb 2023
@ZachHembree
1.2.3.1
a7f288a

[1.2.3.1] Fix TextBox Exception and Unload Edge Case

• Fixed bug that could cause a TextBox to throw an out-of-range exception if formatting or content were changed externally.
• Added checks for edge case that could throw a null ref exception on unload

Assets 5
26 Feb 2022
@ZachHembree
1.2.3.0
c1a1dab

[1.2.3.0] Text and Cursor Fixes

Additions

• Added universal InputEnabled flag to HudElement base for enabling/disabling input updates for any element type
• Added implicit conversion for RichText to ToolTip

Fixes

• Fixed bug causing reported cursor position to be out of sync for custom HUD spaces
• Fixed bug causing TextBox caret to jump back to start
• NamedSliderBox now clips name text to prevent overlap with value
• Fixed face range calculation in PolyBoard types causing incorrect triangles to be drawn for a given slice
• Stabilized input for RadialSelectionBox and increased sensitivity range
• Fixed null ref exception in TextBuilder lined formatter
• Fixed null ref exception preventing client reload on crash
• Fixed typo in IRichChar accessor index

Other Changes

• Removed HudSpaceNode.DrawCursorInHudSpace. The captured draw matrix is out of sync and not easily fixed, so I've removed this feature for now.
• BindGroupInitializer now accepts empty binds

Assets 5
18 Feb 2022
@ZachHembree
1.2.2.0
fe72eae

[1.2.2.0] Billboard Pooling, Text Renderer Optimizations & Misc. Library Changes

This update is focused on taking advantage of the changes made in SE's billboard API in v1.200, while also including a few bug fixes and minor additions for the UI library.

Additions

• Added system for handling billboard pooling using recent mod API additions
• Added BillboardUtils class to provide utilites for efficiently rendering billboards in bulk
• Added RadialSelectionBox, a generic radial selection menu extending HudCollection
• Added GlyphFormat constructor that takes font style enum instead of requiring full Vector2I index
• Added tools for rendering polygonal circles & annuli
• Added name indexer to BindGroup
• Added utility methods to selection boxes to simplify adding entries from internal pools
• Added low latency IsChatOpen property to BindManager for input polling
• Added IsNewPressed and IsReleased properties to IControl

Fixes

• Cursor position now continues to update even when not visible
• Fixed bugs in textbox causing caret to appear out of position
• Fixed out of range exceptions in TextBox
• Fixed bug in Dropdown text formatting
• Fixed several instances where library UI elements would fail to initialize previous BG and text colors before taking input focus
• Fixed bug in ListInputElement affecting selection box types that would prevent it from handling disabled entries correctly
• Fixed bug in BindManager where binds would sometimes fail to finish releasing, blocking other inputs

Other Changes

• Refactored text renderer to render billboards in batches, combined with new pooling system,
reducing text draw time by 60-80%
• Binds now use EventHandler delegate type for events
• Removed candidate bind input filter
• Overlapping binds can now be pressed without previously pressed binds being fully released

Assets 2
28 Nov 2021
@ZachHembree
1.2.0.1
09918de

[1.2.0.1] Fix ScrollBox Min Visible Range Calculation

• Fixed bug preventing ScrollBoxes from correctly calculating logical end of visible range when MinVisibleCount property causes it to run over
• Moved some library UI elements erroneously placed in server ns

Assets 5
13 Sep 2021
@ZachHembree
1.2.0.0
02c1347

[1.2.0.0] UI Clipping, Better Cursor and Input Management

This is a smaller feature update. Unlike previous versions, this update is focused on adding new core functionality to the UI framework without any significant optimizations or changes to the UI library.

Additions:

  • Support for UI clipping. Partially visible elements in scrolling lists, windows, and the like are now clipped instead of simply being set to invisible if they can't fit.
    • Clipping controlled via IsMasking, IsSelectivelyMasked and CanIgnoreMasking properties in HudElementBase
  • ScrollBox and dependent elements now support smooth scrolling
  • Added ToolTips
    • Tooltips are registered with the cursor once every frame on HandleInput
  • Added shared control blacklist to BindManager for disabling the game's built-in binds
    • Controlled via SeBlacklistModes flags. The current version doesn't allow per-control blacklisting. Instead, there are three groups of controls: mouse, camera look, and all binds.

Fixes:

  • Slider bars sliders no longer jump to the cursor when clicked
  • Fixed index out of range bug in TextBox when copying/pasting text
  • UI elements will no longer attempt to capture the cursor when they're not visible

Other Changes:

  • Scaling properties removed from UI elements in favor of the new ScaledSpaceNode, a type of HUD Space Node. The scaling properties were made redundant in the 1.0 release when I introduced support for custom draw matrices and they were just adding a bunch of complexity and jitteriness for no reason. So, I've removed them.
  • Cursor can now be enabled without requiring chat to be open
    • Text entry still requires chat
    • Added a new InputMode property to HudMain to differentiate between cursor input modes.
  • Removed obsolete fast unregister/reregister for UI elements
  • Now using length 1 array wrappers to minimize copies of draw matrix copies when drawing billboards. Hud Space Nodes and HudMain also now expose these wrapper properties. The things I do in lieu of return by ref...
Assets 5
05 May 2021
@ZachHembree
1.1.1.0
03b9652

[1.1.1.0] Text Update Fixes and Minor Formatting Optimization

• Library UI elements that change text formatting now only change text color. This should make it easier to use custom text formats with these types, especially SelectionBox types.
• Fixed bug underline bounding calculation preventing it from correctly clipping underlines on text with a horizontal offset.
• SetText() and SetFormatting() methods in TextBuilders affecting the entire text now change default formatting.
• Changes to text formatting that only affect color will not trigger a full update; it'll just update the billboard color.
• GlyphFormat is now a value type.

Assets 5
02 Apr 2021
@ZachHembree
1.1.0.1
f579221

[1.1.0.1] Cursor Hotfix

Assets 4
27 Mar 2021
@ZachHembree
1.1.0.0
a6c98cb

[1.1.0.0] UI Tree Optimization and Library Overhaul

This update doesn't feature any major feature additions and is mostly focused on improving performance, scalability, and the code quality of elements supplied in the included UI library.

Tree Optimization

In previous versions, update delegates for every node, visible or not, were loaded into the update list on Master. This had the advantage of only requiring the client to update its delegate list when new elements were registered, but with the downside of introducing a constant load, even if nothing was on screen, significantly limiting scalability. Fortunately, there's a simple solution to this problem: just stop trying to load everything at once!

Master now rebuilds its update list constantly, and clients (1.1.0.0+) will only register visible elements; any invisible element in the tree will be omitted along with its children, simultaneously eliminating the overhead of invoking update methods for invisible elements and making tree rebuilds/sorting faster by just reducing the size of the collection. This has the consequence of both significantly raising the ceiling for UI complexity while lowering the cost of invisible UI elements to almost nothing.

But there is one small snag: the update list on Master doesn't update on every draw tick, it's spread out over 5 ticks, meaning there's a little under 100ms of latency, causing perceptible lag time between making an element visible, and having it actually appear. For most use cases, this isn't an issue, but if you're implementing a scrolling list, you'll need to preload a range of elements before and after the visible range, unless you're okay waiting a few frames for your members to appear in the list. The generic ScrollBox in the UI library does this automatically.

Library Overhaul

Every non-generic UI element in the library has been reworked to more closely align with the changes to the appearance and function of Space Engineer's UI elements since the Xbox release, and have gained limited support for keyboard input when focused. Selection Box types, like ListBox, TreeBox and Dropdown, for example, by default, allow scrolling and selection using the arrow keys and space bar, in addition to normal mouse input. It's a small detail, but I think it's small details like that that really bring a UI together.

And that's another thing: Input Focus. While window focusing functions to bring a window to the foreground, the new input focus functionality determines which element should be accepting keyboard input, usually, the last one clicked/selected. This functionality has been integrated into the MouseInputElement, and by extension, every other element that accepts mouse input.

Other Changes:

• Selection Boxes: The ListBox, TreeBox, and Dropdown UI elements have been completely reimplemented to improve reliability, appearance and flexibility, and are now all built on a new generic SelectionBox type. In previous iterations, they only supported a single type of entry element; now, they can support custom entry types with arbitrary dimensions, in addition to the more restrictive variants.

• Added support for page subcategories to the terminal.

Assets 5
12 Mar 2021
@ZachHembree
1.0.3
master

[1.0.3] Minor Terminal Fixes and List Box Refactoring

• Added new API accessors for terminal ListBox types to allow insertion, removal, and retrieval of the selection's current index.
• Terminal ListBox entries now allow the user to retrieve/modify the name of the entry
• Refactored ListBox, Dropdown and TreeBox to allow the use of custom entry elements
• Fixed bug preventing clients from reading/writing to terminal ListBox entry properties
• The terminal will now automatically close when the SE terminal or other windows open

Assets 2

View all releases on GitHub