NeaxLib

NeaxLib is a reusable UI framework and visual library for Minecraft NeoForge mods. It provides a modular foundation for building interfaces without recreating common UI systems from scratch.

The library is primarily developed for use across my own projects, while remaining available for other developers who want to experiment with or integrate it into their mods. As NeaxLib matures, its API and documentation will continue to improve for broader development use.

Features

Render Targets

• HUD rendering.
• Custom screens.
• Inventory integration.
• Container screen integration.
• Pause screen integration.
• World and entity UI rendering.

UI System

• Reusable UI components.
• Panel-based interface composition.
• Parent and child component hierarchy.
• Layer and Z-Index control.
• Responsive layout and GUI scaling.
• Position, size, anchor, pivot, scale and rotation controls.
• Automatic sizing, wrapping and clipping.

Interaction

• Mouse and keyboard events.
• Hover and focus handling.
• Text input.
• Component state changes.

Visuals

• Text and image rendering.
• Basic shapes and clipping.
• Colors, backgrounds, borders and opacity.
• Hover, pressed and disabled visual states.
• Basic tweening and easing animations.

Purpose

NeaxLib focuses on the visual and interaction layer of a mod. It does not provide gameplay systems, complex server logic or networking for consuming mods.

Mods using NeaxLib remain responsible for their own gameplay logic, data, networking and server-side validation. NeaxLib provides the reusable visual tools used to represent and interact with those systems.

Development

NeaxLib is built around a modular and maintainable architecture. The current version provides the initial stable foundation of the library and will continue to evolve while preserving its core architecture.

The project is currently focused primarily on development use across my own mods. External developers may also use the library, while the public API and documentation continue improving as the project matures.

Requirements

• Minecraft: 1.21.1
• Mod Loader: NeoForge