Bento Box
Bento Box is a modular library with expressive GUIs, declarative configs, and more down the road!
For developers
Thanks to Bento Box being modular, you can depend on just the modules you need without pulling in everything else.
Bento modules include:
-
Bento Config, a declarative configuration system built using Bento GUI. It aims to be simple yet powerful, with no magic pre-processors or arbitrary limitations.
-
Bento GUI, an expressive GUI library that makes building dynamic screens fast and easy. It is a replacement for Minecraft’s UI widgets that is inspired by HTML and CSS, and uses the builder pattern for building GUI elements.
-
Bento Util, a general utility library that other Bento modules tend to make use of. It has a few things here you might find useful yourself!
Bento Box is documented in-code with JavaDocs and on my wiki.
For users
If you have multiple Bento modules (i.e. Bento Config, Bento GUI) in your mod list, you can replace them all with just Bento Box.
All Versions
+ Add VersionSushi Bar is now known as **Bento Box**, with a broader scope of expressive GUIs, declarative configs, and *more down the road*, wrapped up in a modular package. If you the developer only need just the GUI library and nothing else, you can do that! As for users, they can download just the Bento Box mod to keep their mod lists clean. It's a win-win for both!
## Bento Util
Just a simple general utility library. Its main features is a fully-featured
Color class that can parse many formats, and a nifty integration with [Placeholder API](https://modrinth.com/mod/placeholder-api) that lets you use it within language translation files!To activate [QuickText formatting](https://placeholders.pb4.eu/user/quicktext/), surround a string with square brackets. You can use translation slots with the new
<%s n> tag!``
json
"text.bento_gui.checkbox.on": ["<gray>[<green>✔<gray>]</*> <%s 1>"]
`
## Bento GUI
An expressive GUI library inspired by HTML that I built from scratch using the builder pattern. No more will you have to suffer dealing with Minecraft's UI widgets. Simply build your elements, add them as children to panels, and the system will automatically lay them out according to their constraints like min/max dimensions and alignments.
java
Label title = Label.builder()
.text(Text.translatable("config." + config.getModId() + ".title"))
.dimensions(true, 32) // Fixed height of 32, width expands to fill
.build();
Panel body = Panel.ofMenu()
.dimensions(true, true) // Width and height expand to fill
.alignCenter()
.padding(10, 0) // Padding of 10 on the X axis
.spacing(10) // Spacing of 10 between children
.displayAxis(Panel.DisplayAxis.HORIZONTAL)
.build();
Panel footer = Panel.builder()
.dimensions(true, 32) // Fixed height of 32, width expands to fill
.alignCenter()
.alignMiddle()
.padding(20, 0) // Padding of 20 on the X axis
.spacing(8) // Spacing of 8 between children
.displayAxis(Panel.DisplayAxis.HORIZONTAL)
.build();
`
## Bento Config
A declarative configuration system built on top of Bento GUI. Simply declare your options in a class file, progressively enhance them with annotations, and then optionally register it to Modmenu!
java
public class TestConfig extends BentoConfig<TestConfig> {
public boolean spawn_creepers = true;
@Range(min = 1, max = 10)
public int spawn_amount = 3;
@Percentage
public float spawn_chance = 0.5f;
public Item creeper_loot = Items.GUNPOWDER;
@Regex("[a-z]{1,10}")
public String creeper_name = "creeper";
}
``- Split into 1.20 and 1.20.3 to fix a Lavender crash issue on 1.20.3
- Fixed silly fabric.mod.json issue
- Split into 1.20 and 1.20.3 to fix a Lavender crash issue on 1.20.3
- Fixed silly fabric.mod.json issue
- Added item registration helper
register.item(String)register.item(String, Item)register.item(String, Item::new)register.item(String, ItemSettings)- Added dynamic recipe templates for Lavender
- 2x2 crafting grid
- e.g.
<recipe_2x2;minecraft:crafting_table> - 1x1 crafting grid
- e.g.
<recipe_1x1;minecraft:oak_planks>
List<Identifier> breaking on +1.20.2
