![\"mod](\"https:\/\/cdn.modrinth.com\/data\/pZ0PWFaa\/images\/74b5f15e18065a3b3e94dcc05f759b6feb241ca2.png\")
<\/p>\n# Unruled API<\/p>\n
<\/p>\n
Allows to create new form of gamerules, beyond the restrictive vanilla integers and booleans.<\/p>\n
This mod enables developers to easily create new floating, long, double, string, text, enum-driven,
\nentity selector and even registry-entry gamerules, using their respective builders,
\nall available from the `com.nerjal.unruled_api.UnruledApi` class’s static methods.<\/p>\n
It also provides means to add value validators alongside registering new gamerules, which in turn
\nallows to restrict the range of valid values for gamerules. For instance, it can be used to only allow
\nodd values in an integer gamerule.<\/p>\n
Additionally, this mod also adds per-dimension gamerule overrides! These are applied in their
\nstrict dimension (provided they are queried correctly).
\nSee [gamerules overrides](#gamerules-overrides) for more details about it.<\/p>\n
### Gamerules registration<\/p>\n
Example:
\n“`java
\nimport com.nerjal.unruled_api.UnruledApi;<\/p>\n
public class MyClass {
\n private static final int STRING_RULE_MAX_LENGTH = 24;<\/p>\n
public void gamerulesRegistration() {
\n var myFloatingRule = UnruledApi.floatRuleBuilder(category, 1.5) \/\/ takes the category and the initial value as arguments
\n \/\/ the category determines where in the world creation screen will it be placed
\n .register(“mymod:my_gamerule”); \/\/ gamerule registration always takes the gamerule’s ID
\n \/\/ the ID also determines the translated name of the gamerule
\n var myStringRule = new StringRule.Builder(category, “initial value”, STRING_RULE_MAX_LENGTH)
\n \/\/ using the UnruledApi methods or directly creating the builder has the same result, and arguments are the same.
\n \/\/ however, mind that in some cases, it is strongly recommended to use the specified builders such as for string
\n \/\/ rules, enum, and dynamic registry entry rules, as they have a more specific processing of their values and
\n \/\/ command handling.
\n .register(“mymod:my_other_gamerule”);
\n }<\/p>\n
}
\n“`<\/p>\n
Additionally, quick creation and registration methods have been added for your convenience<\/p>\n
“`java
\nimport com.nerjal.unruled_api.UnruledApi;<\/p>\n
public static void quickGamerulesRegistration() {
\n var myLongRule = UnruledApi.registerLong(Identifier.of(“mymod:my_long_rule”), category, 25L);
\n \/\/ Quick registration methods always follow the same parameter order: name, category, initial value, gamerule-type specific arguments
\n \/\/ Except for enum rules, for which the enum class goes before the initial value
\n var myEnumRule = UnruledApi.registerEnumRule(Identifier.of(“mymod:my_enum_rule”), category, MyEnum.FIRST, MyEnum.class);
\n }<\/p>\n
enum MyEnum {
\n FIRST,
\n SECOND,
\n THIRD
\n }
\n“`<\/p>\n
For consistency, methods have also been created to allow quickly register vanilla-type gamerules.<\/p>\n
“`java
\nimport com.nerjal.unruled_api.UnruledApi;<\/p>\n
public static void registerBasicRules() {
\n UnruledApi.registerInteger(“my_int_rule”, category, 5);
\n UnruledApi.registerBoolean(“my_bool_rule”, category, false);
\n }
\n“`<\/p>\n
~~You can also retrieve their values using the same class’s methods~~
\nThis has become outdated since release 2.0 (for Minecraft 1.21.11 and later).
\nPlease use the gamerule methods directly as now meant by the game code.<\/p>\n
“`java
\n public long getMyLongGamerules(ServerWorld dimension) { \/\/ ServerWorld is a Yarn mapping class. Might be Level or ServerLevel with Mojmap
\n return UnruledApi.getLong(dimension.getGameRules(), myLongGamerule);
\n }<\/p>\n
public Block getMyBlockRule(ServerWorld dimension) {
\n \/\/ querying a registry entry rule returns the registry entry’s very value, as it can only be set if it exists in the registry
\n return UnruledApi.getRegistryEntry(dimension.getGameRules(), myBlockRegistryEntryRule);
\n }
\n“`<\/p>\n
### Command Tweaks<\/p>\n
The average experience of using gamerules in vanilla minecraft is pretty poor.
\nNavigating a long list of names, trying to remember the one of the rule you need,
\nor even worse, searching for a hypothetic one, can be pretty annoying.<\/p>\n
Thus, Unruled API aims to alleviate that burden ever so slightly, by allowing you
\nto navigate the same list *by category*!<\/p>\n
Hence, you can now add the category name or full ID (both in full caps) in the command and the following
\nlist will only contain rules in the appropriate category.<\/p>\n
E.g. `\/gamerule CHAT ` will then have your game suggest you only the rules inside the
\n*chat* category, according to the world creation menu listing.<\/p>\n
This also applies to all modded gamerules and categories, as well as modded gamerule types
\nfrom any and all mod.<\/p>\n
“` ### Gamerules Overrides<\/p>\n Gamerules overrides are set per dimension. They allow players to set specific rules to specific values This command has many uses:<\/p>\n * `gamerule-override` alone and with no arguments allows you to get a list of existing overrides in the current dimension. Gamerule overrides are stored in the dimension’s data folder, as the `gamerules.dat` file. Additionally, for your convenience, the `get`, `set` and `unset` in all cases also ### Configurable Default Values<\/p>\n Especially relevant for modpack creators, this feature allows to set custom values to be used as default gamerule In order to set them, you only need to create a `config\/default_gamerules.json` file, and for each gamerule you want Example: Obviously, this works just as well with modded gamerules and gamerule types!<\/p>\n ### Custom Gamerule Categories<\/p>\n **As of 1.21.11, gamerule categories are now a registry. The following is only relevant to game versions prior to this**<\/p>\n Developers can easily register new custom gamerule categories, that will be added straight to the category enum! This can be done on Fabric with a `preLaunch` entrypoint, on (Neo)Forge upon initializing your `@Mod` class, You only need to add a `CategoryProvider` implementation to the `UnruledEarlyUtils.CATEGORY_PROVIDERS` set.<\/p>\n The `CategoryProvider` interface is a String supplier-like class, that allows for an optional implementation of a ## How to use in your project<\/p>\n You can implement this mod in your project using the Modrinth maven. Don’t hesitate to read the official documentation.<\/p>\n ### Add the Modrinth maven repository<\/p>\n “`groovy ### Import the mod<\/p>\n loom example: (neo)forgeGradle example: For copyright reasons, we require you to **not** include (JiJ, jar-in-a-jar, shadow, etc) this mod inside of your own. Thank you for your comprehension.<\/p>\n","protected":false},"excerpt":{"rendered":" Expands on the vanilla gamerules, adding new gamerules types for other mods to use and enabling players to set per-dimension overrides for gamerules<\/p>\n","protected":false},"featured_media":162846,"template":"","meta":{"_minecraft_slug":"unruled-api","_minecraft_project_id":"pZ0PWFaa","_minecraft_author":"Nerjal_Nosk","_minecraft_license":"GPL-3.0-or-later","_minecraft_downloads":32269,"_minecraft_follows":21,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"unruled-api.zip","_minecraft_size_bytes":34441669,"_minecraft_version_count":196,"_minecraft_updated_at":"2026-05-16T16:01:13.081374Z","_minecraft_date_created":"2024-01-28T02:01:03.727130Z","_minecraft_date_modified":"2026-04-22T20:41:48.754736Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/unruled-api","_minecraft_icon_attachment_id":162846,"_minecraft_imported_at":"2026-06-09T16:20:07+00:00","_minecraft_import_hash":"1946ab18fecf89e0c8c20fdda739e915","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[43,97,104,89,873,158,98,92],"mod_loader":[99,106,160,100],"minecraft_version":[51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82,83,167,163],"class_list":["post-162845","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-cursed","mod_category-fabric","mod_category-forge","mod_category-game-mechanics","mod_category-library","mod_category-neoforge","mod_category-quilt","mod_category-utility","mod_loader-fabric","mod_loader-forge","mod_loader-neoforge","mod_loader-quilt","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\n
\n\/gamerule [
\n“`<\/p>\n
\nin the wanted dimension, all via the `gamerule-override` command.<\/p>\n
\n* `gamerule-override
\n* `gamerule-override get
\n* `gamerule-override set
\n* `gamerule-override unset
\n* `gamerule-override in
\n* `gamerule-override in
\n* `gamerule-override in
\nRemoving it while the server is offline\/world is not being played will simply remove all overrides for the dimension.<\/p>\n
\nsupport the per-category filtering, for easier usage.
\nYou can thus use the command as follows:
\n“`
\n\/gamerule-override in
\n“`<\/p>\n
\nvalues upon world creation.<\/p>\n
\nto add a default value for, set a key-value pair with the wanted new value, set as a string. (due to limitations in
\nthe mojang code for easy JSON-parsing, only string values are accepted, anything else will simply be ignored)<\/p>\n
\n“`json
\n{
\n “doDaylightCycle”: “false”,
\n “mobGriefing”: “false”
\n}
\n“`<\/p>\n
\nHowever, you do need it to be done *early* in the game load process, i.e. before the gamerules class gets loaded.<\/p>\n
\nor on any launcher from your mixin config plugin.<\/p>\n
\ncategory consumer upon creation of the matching category. The provided String will be set as the category name, but
\nwill not allow for duplicate entries (i.e. if two mods want to add a same category, only one will be created, but both
\nproviders will receive it as well)<\/p>\n
\nrepositories {
\n maven {
\n name = “Modrinth”
\n url = “https:\/\/api.modrinth.com\/maven”
\n }
\n}
\n“`<\/p>\n
\n“`groovy
\ndependencies {
\n \/\/ using modApi allows your project’s dependents to also import dependencies by default
\n modApi “maven.modrinth:unruled-api:${project.unruled_version}”
\n}
\n“`<\/p>\n
\n“`groovy
\ndependencies {
\n implementation “maven.modrinth:unruled-api:${project.unruled_version}”
\n}
\n“`<\/p>\n