?
Host a serverModrinth App
Sign in
ModsResource PacksData PacksShadersModpacksPluginsServers
Settings
NegiLib

NegiLib

Minecraft UI runtime API plugin

87downloads
0followers
87downloads
0followers

Compatibility

Minecraft: Java Edition

26.2
26.1.x
1.21.x
1.20.x

Platforms

Tags

Creators

Details

Licensed ARR
Published last month
Updated 2 weeks ago

NegiLib

A modern, cross-platform UI library for Minecraft servers.

NegiLib is a powerful UI framework designed for Minecraft plugin developers. It provides a unified API for creating interactive menus across Java Edition and Bedrock Edition, with support for Paper, Purpur, Folia, and GeyserMC.

Originally developed as the foundation of EasyMenu v7, NegiLib is also available as a standalone library for other plugins.

Build once, support multiple UI systems, and let NegiLib handle the rendering.

✨ Features

🖥️ Multiple UI Backends

  • Inventory GUI: Traditional chest-based menus compatible with older Minecraft versions.
  • Java Native Dialog: Modern, interactive menus using Minecraft's native Dialog API.
  • Bedrock Rich UI: Custom multi-column menus powered by Bedrock JSON UI and resource packs.
  • Automatic Fallback: Falls back to compatible UI backends when a preferred renderer is unavailable.

🎨 Rich UI & Customization

  • Multi-column button layouts.
  • Custom item icons and textures.
  • Colored text, descriptions, and tooltips.
  • Scrollable Bedrock menus.
  • Support for different screen sizes and input methods.
  • Resource pack generation and management.

⚡ Developer-Friendly Architecture

  • Unified Java API across supported platforms.
  • Extensible rendering system with custom renderer support.
  • Built-in UI session and interaction management.
  • Platform-aware scheduling, including Folia compatibility.
  • Asynchronous resource preparation.
  • Automatic UI capability detection.
  • Designed to minimize version-specific dependencies.

🔗 GeyserMC Integration

NegiLib supports Bedrock Edition players through GeyserMC.

Instead of being limited to standard vertical Bedrock forms, NegiLib can display customized grid-based interfaces using JSON UI.

Rich UI features include custom layouts, item icons, tooltips, and scrolling, with fallback support when Rich UI is unavailable.

No additional client-side mods are required.

📦 Installation

Paper / Purpur / Folia

  1. Download the latest NegiLib JAR.
  2. Place it in your server's plugins/ directory.
  3. Restart the server.
  4. Install a compatible plugin that uses NegiLib, such as EasyMenu 7.

NegiLib can operate without GeyserMC when only Java Edition support is required.

Bedrock Support — Geyser on Paper

If GeyserMC is installed directly on your Paper-compatible server:

  1. Install NegiLib on the server.
  2. Install Geyser-Spigot.
  3. Restart the server.
  4. Connect using a Bedrock Edition client.

The Velocity companion plugin is not required for this setup.

Bedrock Support — Geyser on Velocity

If GeyserMC runs on your Velocity proxy, you must install the separate NegiLib Geyser Velocity companion plugin.

Velocity Proxy:

  1. Install Geyser-Velocity.
  2. Install NegiLib Geyser Velocity in the proxy's plugins/ directory.

Backend Servers (Paper / Purpur / Folia):

  1. Install the regular NegiLib plugin on every backend server that uses NegiLib.
  2. Install EasyMenu or other NegiLib-based plugins as needed.
  3. Restart the proxy and backend servers.

Important: The Velocity companion does not replace the regular NegiLib plugin. Both components are required when using NegiLib with Geyser-Velocity.

The Velocity companion handles Bedrock UI communication and resource pack delivery, while the backend NegiLib plugin manages menus, rendering requests, and interactions.

🛠️ Compatibility

  • Server Software: Paper, Purpur, Folia
  • Minecraft Java Edition: 1.20.1+
  • Native Dialog: Available on supported newer Minecraft versions
  • Bedrock Edition: Through GeyserMC
  • Proxy Integration: Velocity with the NegiLib Geyser Velocity companion
  • Java: Java 17+ bytecode compatibility; newer Minecraft server versions may require a newer Java runtime

Compatibility with newly released Minecraft versions may require additional verification.

Spigot is not supported.

👨‍💻 For Developers

NegiLib is designed to be reusable beyond EasyMenu.

Its public API provides abstractions for UI documents, interactive elements, renderer selection, session management, and player interactions.

Developers can implement their own menu systems while relying on NegiLib to handle platform-specific rendering and compatibility.

📚 API Documentation

The API reference is currently being prepared.

NegiLib's public API is available, but the complete developer documentation, integration guides, and code examples are not yet published.

Please stay tuned for the official API reference!

NegiLib — One UI framework. Multiple platforms.