SaeLibVie

SaeLibVie is a library mod. It adds no blocks, items or recipes of its own. If it is in your pack, it is because another mod requires it for some functionality.

For players

The one thing you get directly is control over how the mods built on it look.

• Themes. Every colour, border and metric comes from a named theme. Four ship with the mod: dark, midnight, blood and vanilla. Switch with /saelibvie theme <id>, list them with /saelibvie themes.
• Config file. config/saelibvie/themes.json sets the default theme, a global opacity, and per-theme colour overrides. Resource packs can add themes too, so a pack can restyle every screen a dependent mod draws.
• HUD layout. Mods register HUD elements here rather than hardcoding a corner. /saelibvie hud opens an editor: drag to move, right-click to toggle, scroll to scale. Saved to config/saelibvie/hud.json.
• NBT editor. /saelibvie nbtedit block <pos>, entity <target>, player <target> or item opens a tree editor for that target's data. Requires permission to run.

Nothing here changes gameplay. Every screen is optional.

For modders

A retained-mode GUI toolkit plus the utility layer that usually grows around one.

GUI toolkit. Widgets hold bounds relative to their parent and receive mouse events in that space, so nesting, scrolling and scaled panels work without any widget knowing where it sits on screen. Five layout strategies, draggable and resizable windows, modal layers, context menus, toasts, confirm dialogs and a colour picker. Around forty widgets: buttons in several flavours, text fields with filters and validators, a multi-line text area, virtualised lists, paged grids, scrolling panels, tab panels, progress bars, fluid gauges, graphs, entity views and a 3D viewport.

Screen bases. Plain screens, container screens and three-region forms, with parent-screen navigation, cursor shapes, double-click detection and deferred tooltips.

Utility layer. An RGBA colour value type with palettes and codecs, maths and chunk helpers, a chat-format-code parser with custom named colours, item and fluid hash keys, search term parsing, and network codec helpers.

Menu helpers. Typed ContainerData syncing, button id allocation, and a generic client-to-server menu action payload.

Recipe viewer hooks. Ingredient lookup works over any library screen, so the recipe and usage keys do the right thing over an item view, a fluid gauge or a grid cell. Ghost ingredient drop targets are supported.

Add it to a build with:

repositories {
    maven { url = "" rel="noopener nofollow" target="_blank">https://maven.breakinblocks.com/releases" }
}
dependencies {
    implementation "com.breakinblocks.saelibvie:saelibvie:<minecraft>-<version>"
}

Then declare saelibvie as a required dependency in neoforge.mods.toml.

/saelibvie demo opens a screen that exercises every widget, which is the fastest way to see what is available.

Support

Source, issues and full documentation are on GitHub. Licensed under the PolyForm Shield License 1.0.0 and the PolyForm Perimeter License 1.0.0.