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 API0.165.0+26.3, Fabric Language Kotlin1.14.2+kotlin.2.4.21 - NeoForge: NeoForge
26.3.0.99+, Kotlin for Forge6.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, whereplatformiscommon/fabric/neoforge; repohttps://maven.forpleuvoir.moe/releases(or/snapshots) nebulaandcompose-minecraftare bundled inside the loader artifacts — don't declare them- Config entry builders are
context(ConfigGroup)functions, so your project needs the-Xexplicit-context-argumentscompiler flag - Declare your package in the mod metadata (
custom.ibukigourd.packageon Fabric,modproperties.<modid>.packageon 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
No gallery available for this project.
| Version | Minecraft | Loader | Download |
|---|---|---|---|
|
1.1.0-alpha NeoForge 26.3 1.1.0-alpha |
26.3
|
neoforge
|
Download |
|
1.1.0-alpha Fabric 26.3 1.1.0-alpha |
26.3
|
fabric
|
Download |
|
IbukiGourd 1.0.0-alpha 1.0.0-alpha |
26.2
|
neoforge
|
Download |
|
IbukiGourd 1.0.0-alpha 1.0.0-alpha |
26.2
|
fabric
|
Download |
|
IbukiGourd 0.11.1+alpha 0.11.1+alpha |
26.1.2
|
neoforge
|
Download |
|
IbukiGourd 0.11.1+alpha 0.11.1+alpha |
26.1.2
|
fabric
|
Download |
|
IbukiGourd 0.10.4+beta 0.10.4+beta |
1.21.11
|
neoforge
|
Download |
|
IbukiGourd 0.10.4+beta 0.10.4+beta |
1.21.11
|
fabric
|
Download |
|
IbukiGourd 0.10.3+beta 0.10.3+beta |
1.21.11
|
neoforge
|
Download |
|
IbukiGourd 0.10.3+beta 0.10.3+beta |
1.21.11
|
fabric
|
Download |
|
IbukiGourd 0.10.2+beta 0.10.2+beta |
1.21.11
|
neoforge
|
Download |
|
IbukiGourd 0.10.2+beta 0.10.2+beta |
1.21.11
|
fabric
|
Download |
|
IbukiGourd 0.10.1+beta 0.10.1+beta |
1.21.11
|
fabric
|
Download |
|
IbukiGourd 0.10.1+beta 0.10.1+beta |
1.21.11
|
neoforge
|
Download |
|
IbukiGourd 0.10.0+beta 0.10.0+beta |
1.21.10
|
fabric
|
Download |
|
IbukiGourd 0.10.0+beta 0.10.0+beta |
1.21.10
|
neoforge
|
Download |
|
IbukiGourd 0.8.5+beta 0.8.5+beta |
1.21.4
|
fabric
|
Download |
|
IbukiGourd 0.8.4+beta 0.8.4+beta |
1.21.4
|
fabric
|
Download |
|
IbukiGourd 0.8.3+beta 0.8.3+beta |
1.21.4
|
fabric
|
Download |
|
IbukiGourd 0.8.2+beta 0.8.2+beta |
1.21.4
|
fabric
|
Download |
|
IbukiGourd 0.8.1+beta 0.8.1+beta |
1.21.4
|
fabric
|
Download |
|
IbukiGourd 0.8.0+beta 0.8.0+beta |
1.21.4
|
fabric
|
Download |
|
IbukiGourd 0.7.19+beta 0.7.19+beta |
1.21.4
|
fabric
|
Download |
|
IbukiGourd 0.7.18+beta 0.7.18+beta |
1.21.4
|
fabric
|
Download |
|
IbukiGourd 0.7.17+beta 0.7.17+beta |
1.21.4
|
fabric
|
Download |
|
IbukiGourd 0.7.16+beta 0.7.16+beta |
1.21.4
|
fabric
|
Download |
|
IbukiGourd 0.7.14+beta 0.7.14+beta |
1.21.4
|
fabric
|
Download |
|
IbukiGourd 0.7.13+beta 0.7.13+beta |
1.21.4
|
fabric
|
Download |
|
IbukiGourd 0.7.8+beta 0.7.8+beta |
1.21.4
|
fabric
|
Download |
|
IbukiGourd 0.7.6+dev 0.7.6+dev |
1.21.4
|
fabric
|
Download |
|
IbukiGourd 0.7.4+dev 0.7.4+dev |
1.21.4
|
fabric
|
Download |
|
IbukiGourd 0.7.3a-dev 0.7.3a-dev |
1.21.4
|
fabric
|
Download |