Serpentine
by pero_sk
Serpentine is a Fabric configuration library that other mods can build on to add settings screens without writing their own interface code.
What it does
A mod using Serpentine declares its settings in a class that extends the library's Config class, then registers that class during its initializer. The library reads the fields it finds and detects each default value's type, so the settings screen is generated from the declarations rather than written by hand.
Each type gets its own control. Integer values appear as a slider running from 0 to 100, boolean values as two buttons labelled True and False with the selected one marked by a checkmark, and float and string values as a text field where the user types the value. The author states that more slider customisation is planned for later versions.
Serpentine is a dependency for other projects rather than a standalone feature, and it is published for Fabric only, with files for 12 game versions, 1.21 – 1.21.11. Its environment is client and server, so the library must be present on both sides, and it is released under the MIT License as open source.
Key features
Generated settings screen
A configuration screen is built from the fields of a Config class, so a mod author does not write the interface.
Type detection
Default values are inspected to pick the right control for each setting, with no type list to maintain.
Slider for integers
Integer settings appear as a slider that runs from 0 to 100 by default.
Buttons for booleans
Boolean settings show True and False buttons, with the chosen value marked by a checkmark.
Text fields for floats and strings
Float and string settings are typed into a text field, where the user enters the exact value.
Gallery
Compatibility
Latest build for each game version and loader.
1.21.x12 of 12 versions with builds
Only full game releases are shown. This mod publishes no snapshot builds.
Use cases
Mod authors adding settings
A developer who wants a settings screen can declare the options in a Config class and register it, instead of building the screen manually.
Server owners configuring mods
Mods that use the library present their options in one consistent style, so settings are found in the same kind of screen across installed mods.
Who it’s for: Fabric mod developers who want a configuration screen without building one from scratch. Players who only install the library will see no settings of their own until a mod that uses it is added.
Questions
Does Serpentine need to be installed on the server?
How does a mod use Serpentine?
Which game versions does Serpentine support?
In the catalog
Serpentine is one of 3,514 Library mods on ModsFinder, and one of 2,348 Library mods for Fabric. 19,862 mods support Minecraft 1.21.11.
More from pero_sk
Similar mods
What the author says
Serpentine is a lightweight configuration library mod that can easily be used in other projects. Serpentine provides an easy way to setup configuration for any mod, all you need is a class that extends the Config class provided by Serpentine and to then register it in your modInitializer.
Official listing
- Modrinth page
- modrinth.com/mod/serpentine
- Owner
- pero_sk
- Published
- 2025-11-18
- Updated on Modrinth
- 2026-01-01
- Facts verified
- 2026-10-15