?
Host a serverModrinth App
ModsResource PacksData PacksShadersModpacksPluginsServers
Settings
IbukiGourd

IbukiGourd

Library Mod for GUI, Configuration

1.6Kdownloads
2followers
1.6Kdownloads
2followers

Compatibility

Minecraft: Java Edition

26.3
26.2
26.1.2
1.21.10–1.21.11
1.21.4

Platforms

Supported environments

Client and server

Links

Report issues View source

Tags

Creators

Details

Licensed MIT
Published 2 years ago
Updated 3 weeks ago

IBUKI GOURD

icon

Modrinth

IbukiGourd is a modding library / prerequisite mod written in Kotlin, shipping no gameplay content of its own — it exists so other mods don't have to reinvent a config system, a config screen, a GUI toolkit, command helpers and input plumbing. One codebase runs on both Fabric and NeoForge.

What you get

Feature What it does
Config system Delegated config entries, groups, serialization, automatic load/save — client and server side
Config GUI Turn a config manager into a screen: group navigation, cross-group search, per-type controls, drag-and-drop editors
Pixel-art UI toolkit Minecraft-native Compose components: buttons, switches, sliders, text fields, tables, tabs, dialogs, dropdowns, selectors, colour picker, bezier & easing curve editors, tooltips, toasts
Global overlay Persistent content drawn above the vanilla HUD, vanilla screens and Compose screens (Toast runs on it)
Command DSL Kotlin DSL over Brigadier: literal / argument / suggests / executes, plus client-side source helpers
Event bus Client & server lifecycle, tick, keyboard and mouse events, all cancellable
Input / keybinds Key combos, press / long-press / hold-repeat timings, environment and pass-through rules, conflict detection, in-game keybinding editor
Text DSL & i18n Literal / translatable / inline-style text, layout helpers, language-key namespaces
Scheduling & utils Client tick tasks, coroutine helpers, vectors, colours, codecs, bezier and easing math
Multi-loader SPI PlatformHelper + ModInitialization service loading, so one addon works on both loaders

The look is pixel art: .aseprite assets rendered with integer upscaling, drawn straight into vanilla GuiGraphics by the in-house Compose-Minecraft — no Material3, no Skia offscreen rendering.

Requirements

The graphical parts (config screen, UI, overlay, toast) are client-side; config, commands and events also work server-side.

For developers

  • Coordinates: moe.forpleuvoir:ibukigourd-<platform>-26.3:1.1.0-alpha, where platform is common / fabric / neoforge; repo https://maven.forpleuvoir.moe/releases (or /snapshots)
  • nebula and compose-minecraft are bundled inside the loader artifacts — don't declare them
  • Config entry builders are context(ConfigGroup) functions, so your project needs the -Xexplicit-context-arguments compiler flag
  • Declare your package in the mod metadata (custom.ibukigourd.package on Fabric, modproperties.<modid>.package on NeoForge) to let IbukiGourd scan your annotated classes
  • Developer manual (Chinese, 12 chapters): doc/manual
  • English README: README-ENG.md
  • Live examples: 37 component test screens under common/src/devOnly/

Links