Pack makers & modders

Ex Nihilo Reborn is built to have packs made on top of it. Almost everything is data: change it with a data pack, no code needed. For new blocks and items there is a Java API.

Data packs#

Every sieve, hammer, crook, crucible and barrel recipe is a JSON file under data/exnihiloreborn/recipe/. To change one, ship a data pack with a file at the same path. To remove one, override it with a recipe that cannot load, or use Fabric's load conditions. To add one, put a new file anywhere under recipe/.

Fluid amounts are in droplets: 81000 = one bucket. Chances are per roll, from 0 to 1; a list of chances means several rolls.

Recipe types#

Sieve: exnihiloreborn:sieve#

input is an item or tag. rolls maps each mesh to its list of chances; leave a mesh out (or give it 0) and it never finds the drop.

{
  "type": "exnihiloreborn:sieve",
  "input": "#exnihiloreborn:siftable/gravel",
  "result": {
    "count": 1,
    "id": "minecraft:angler_pottery_sherd"
  },
  "rolls": {
    "exnihiloreborn:diamond_mesh": [
      0.0008
    ],
    "exnihiloreborn:netherite_mesh": [
      0.0015
    ]
  }
}

Hammer: exnihiloreborn:hammer#

{
  "type": "exnihiloreborn:hammer",
  "block": {
    "id": "exnihiloreborn:compressed_cobblestone",
    "states": {}
  },
  "result": {
    "chances": [
      1
    ],
    "stack": {
      "count": 1,
      "id": "exnihiloreborn:compressed_gravel"
    }
  }
}

Hammers only crush blocks in #exnihiloreborn:hammerables.

Crook: exnihiloreborn:crook#

{
  "type": "exnihiloreborn:crook",
  "block": {
    "id": "minecraft:acacia_leaves",
    "states": {}
  },
  "result": {
    "chances": [
      0.25
    ],
    "stack": {
      "count": 1,
      "id": "minecraft:acacia_sapling"
    }
  }
}

Crucible: exnihiloreborn:crucible#

Set requiresFireproofCrucible for melts that need a porcelain crucible and heat.

{
  "type": "exnihiloreborn:crucible",
  "amount": 20250,
  "fluid": {
    "fluid": "minecraft:lava"
  },
  "input": "minecraft:cobblestone",
  "requiresFireproofCrucible": true
}

Crucible heat: exnihiloreborn:crucible_heat#

{
  "type": "exnihiloreborn:crucible_heat",
  "block": {
    "id": "#c:torches",
    "states": {}
  },
  "heat": 1
}

Barrel: exnihiloreborn:barrel#

A barrel recipe has a trigger, a list of conditions and a list of actions.

{
  "type": "exnihiloreborn:barrel",
  "actions": [
    {
      "type": "store_item",
      "stack": {
        "count": 1,
        "id": "minecraft:obsidian"
      }
    }
  ],
  "conditions": [
    {
      "type": "fluid_in",
      "fluid": "minecraft:lava"
    },
    {
      "type": "fluid_above",
      "fluid": "minecraft:water"
    }
  ],
  "duration": 0,
  "icon": "minecraft:obsidian",
  "trigger": {
    "type": "tick",
    "chance": 1
  }
}

{
  "type": "exnihiloreborn:barrel",
  "actions": [
    {
      "type": "fill_compost",
      "increment": 0.05,
      "result": {
        "count": 1,
        "id": "minecraft:dirt"
      }
    }
  ],
  "conditions": [],
  "duration": 0,
  "icon": "minecraft:dirt",
  "trigger": {
    "type": "insert_item",
    "item": "#minecraft:leaves"
  }
}

{
  "type": "exnihiloreborn:barrel",
  "actions": [
    {
      "type": "consume_fluid",
      "amount": 40500,
      "fluid": "#exnihiloreborn:witchwater"
    },
    {
      "type": "convert_block",
      "filter": {
        "id": "minecraft:podzol",
        "states": {}
      },
      "result": {
        "id": "minecraft:mycelium",
        "properties": {
          "snowy": "false"
        }
      }
    }
  ],
  "conditions": [],
  "duration": 0,
  "icon": "minecraft:mycelium",
  "trigger": {
    "type": "tick",
    "chance": 0.1
  }
}

Milking: exnihiloreborn:milking#

{
  "type": "exnihiloreborn:milking",
  "amount": 810,
  "cooldown": 20,
  "entity": "minecraft:cow",
  "fluid": {
    "fluid": "exnihiloreborn:milk"
  }
}

Witch water: exnihiloreborn:witch_water_entity and witch_water_world#

{
  "type": "exnihiloreborn:witch_water_entity",
  "nbt": "",
  "result": "minecraft:cave_spider",
  "target": "minecraft:spider"
}

{
  "type": "exnihiloreborn:witch_water_world",
  "result": {
    "minecraft:andesite": 1,
    "minecraft:cobblestone": 3,
    "minecraft:diorite": 1,
    "minecraft:granite": 1
  },
  "target": "#exnihiloreborn:true_lava"
}

Ore pieces: exnihiloreborn:ore_piece#

Turns four pieces into whatever item is first in the result tag, so modded metals work without hard dependencies.

{
  "type": "exnihiloreborn:ore_piece",
  "piece": "exnihiloreborn:raw_tin_piece",
  "result": "#c:raw_materials/tin"
}

Tags#

Sieve and hammer inputs go by tags, so modded blocks can join in by adding themselves to a tag.

Feature packs#

The big optional parts are built-in data packs that players switch per world on the Create World screen. Pack makers set what new worlds get in config/exnihiloreborn-extras.json under features:

Code that belongs to a feature checks for the marker tag exnihiloreborn:features/<id>, so your own data packs can tell whether a feature is on.

Config files#

All in the config/ folder. /exnihilo reload applies changes without a restart. With Mod Menu installed there is also a config screen.

exnihiloreborn.json#

exnihiloreborn-extras.json#

Your own island#

Packs with their own start: set buildSkyIsland to false and place your island with a structure, a datapack function or another mod. The Sky Island world type stays empty void with a plains biome. Set skyIslandByDefault to false if your pack uses a different world type.

Addon API#

For new woods, meshes, ore pieces, seeds and crushed blocks, write a Fabric mod with an exnihiloreborn:api entrypoint. The mod uses Mojang names (Fabric Loom without remapping on 26.x).

1. Depend on the mod#

Add the Ex Nihilo Reborn jar from CurseForge to your build, for example through CurseMaven, and declare the dependency:

// build.gradle
repositories { maven { url = "https://cursemaven.com" } }
dependencies {
    // replace PROJECT_ID and FILE_ID with the numbers from the CurseForge file page
    implementation "curse.maven:ex-nihilo-reborn-PROJECT_ID:FILE_ID"
}

// fabric.mod.json
"depends": { "exnihiloreborn": "*" },
"entrypoints": {
  "exnihiloreborn:api": [ "com.example.myaddon.MyExNihiloModule" ]
}

2. Register your content#

package com.example.myaddon;

import ohpancake.exnihiloreborn.api.ExNihiloApiModule;
import ohpancake.exnihiloreborn.api.ExNihiloRegistries;

public class MyExNihiloModule implements ExNihiloApiModule {
    @Override
    public void onInit(ExNihiloRegistries registries) {
        // a full wood set: sieve, strainer, barrel and crucible, registered as exnihiloreborn:<name>_sieve and so on
        registries.registerWood("redwood", false, registries.woodenBlockSettings());
        // a new ore piece, exnihiloreborn:raw_cobalt_piece
        registries.registerOrePiece("raw_cobalt", registries.defaultItemSettings());
    }
}

Blocks and items are registered with the game after every module has run; you provide the models, textures and recipes. If two addons register the same name, the second one gets the first one's block.

Override shouldLoad() to load your module only when another mod is present.

Events#

Server-side events in ohpancake.exnihiloreborn.api.ExNihiloEvents. Both fire after the world has changed.

ExNihiloEvents.SIFTED.register((level, pos, input, player) -> {
    // input: a copy of the block that was sifted; player: null for an auto sieve
});
ExNihiloEvents.LEAVES_INFESTED.register((level, pos, state) -> {
    // state: the new infested leaves
});

Translations#

The guide book, advancements and newer items are translated into Spanish, Portuguese, German, French, Russian and Chinese; everything else falls back to English. Resource packs can override any string through assets/exnihiloreborn/lang/<code>.json.

Using it in a modpack#

Ex Nihilo Reborn is MIT licensed: include it in any modpack, public or private. Questions or a pack to show off? Get in touch.