IbukiGourd

IBUKI GOURD

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

• Minecraft 26.3
• Java 25
• Fabric: Fabric Loader 0.20.1+, Fabric API 0.165.0+26.3, Fabric Language Kotlin 1.14.2+kotlin.2.4.21
• NeoForge: NeoForge 26.3.0.99+, Kotlin for Forge 6.4.0
• Mod Menu — optional, adds a config button to the mod list

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

• Source: github.com/forpleuvoir/ibuki_gourd — active branch 26.3
• Changelog: CHANGE_LOG-ENG.md
• License: MIT — see LICENSE, bundled third-party sources in NOTICE.md