Allow anonymous analytics?

Our cookieless analytics show us which features get used and store nothing on your device. We never sell your data or use it for advertising.

Privacy choices

Choose what ModDex may collect. You can change this anytime from Privacy choices in the footer.

Read the full privacy policy

Strictly necessary Required for the site to work: login sessions, security tokens, and abuse prevention. Always on and cannot be disabled. Always on
Analytics Cookieless analytics through PostHog's EU servers, used only to see which features get used. Nothing is stored on your device, and the anonymous visitor ID resets every day. Needs your consent because usage data goes to a third party. Never used for advertising or profiling. Off by default in the EU and UK.

LootInj

Quick rating

Community listing page, reviews may not be monitored by the author.

Report a bug to the author How listings work Are you the author?

LootInj

By ThePotatoArchivistOwner

No reviews yet

Simple data-driven loot table modification library

Mod Loaders
Minecraft
26.3 26.2
Shockbyte server hosting: 35% off your first server with code MODDEX35 (opens in a new tab)

About

Description

⚠️ LootInj seems to have a crash on dedicated servers in 26.3+ and may require breaking changes to fix. I do not recommend using that version of LootInj in production until it is resolved.

LootInj is a simple data-driven loot modification library, primarily for mods. It essentially acts as a JSON frontend to the Fabric API LootTableEvents.MODIFY event.

Features

  • Can add pools & modifiers, and modify pools
  • Supports data generation via FabricDynamicRegistryProvider (26.3+) or FabricCodecDataProvider (26.1-26.2)
    • Datagen matches the vanilla/FAPI LootTable.Builder and LootPool.Builder api
    • Can access other loot registries such as minecraft:predicate, minecraft:item_modifier, minecraft:context_int_provider, etc. (26.3+)
    • Can be reloaded without relogging using /reload

Format

In your mod data/datapack, loot modifications are JSON files at data/<namespace>/lootinj/loot_modification/<path>.json. The exact namespace and path do not matter, they should just be unique.

The format generally follows the vanilla loot table format:

26.3+ Format 
{
  // All fields are optional except `targets`

  // A loot table id or list of ids to modify
  "targets": [
    "minecraft:blocks/dirt"
  ],

  // A list of loot pools to add
  "pools": [
    {
      "rolls": 1,
      "entries": [
        {
          "type": "minecraft:item",
          "name": "minecraft:diamond"
        }
      ]
    }
  ],

  // A loot function or list of functions to add to the whole table
  "modifier": {
    "count": 2,
    "function": "minecraft:set_count"
  },

  // Modify all existing pools
  // Requires some extra processing so only include if you need to modify pools
  "modify_pools": {
    // Again, all fields are optional

    // A list of entries to add to the pool
    "entries": [
      {
        "type": "minecraft:item",
        "name": "minecraft:gold_ingot"
      }
    ],
    
    // A loot condition or list of conditions to add to the whole pool
    "condition": {
      "type": "minecraft:survives_explosion"
    },

    // A loot function or list of functions to add to the whole pool
    "modifier": {
      "count": 3,
      "function": "minecraft:set_count"
    }

  }

}
26.1-26.2 Format 
{
  // All fields are optional except `targets`

  // A loot table id or list of ids to modify
  "targets": [
    "minecraft:blocks/dirt"
  ],

  // A list of loot pools to add
  "pools": [
    {
      "rolls": 1,
      "entries": [
        {
          "type": "minecraft:item",
          "name": "minecraft:diamond"
        }
      ]
    }
  ],

  // A list of loot functions to add to the whole table
  "functions": [
    {
      "count": 2,
      "function": "minecraft:set_count"
    }
  ],

  // Modify all existing pools
  // Requires some extra processing so only include if you need to modify pools
  "modify_pools": {
    // Again, all fields are optional

    // A list of entries to add to the pool
    "entries": [
      {
        "type": "minecraft:item",
        "name": "minecraft:gold_ingot"
      }
    ],
    
    // A list of loot condition to add to the whole pool
    "conditions": [
      {
        "type": "minecraft:survives_explosion"
      }
    ],

    // A list of loot functions to add to the whole pool
    "functions": [
      {
        "count": 3,
        "function": "minecraft:set_count"
      }
    ]

  }

}

Comparison

I made this library because Datapatched did not quite fit my needs:

  • I usually like to datagen as much as possible, and Datapatched does not work with data generation
  • I usually try to update my mods within a few days of a minecraft update, and Datapatched sometimes takes longer to update
  • I primarily mod for Fabric 26.1+ so this library will only support those versions

If you are an end user who doesn't care about these and/or is on Neoforge, Datapatched will probably work better for you as it is better documented and supports more versions & loaders.

Developer Installation

For use in a mod, install and JiJ it from the Modrinth maven.

# gradle.properties
lootinj_version=1.0.2+mc26.3

// build.gradle
repositories {
    exclusiveContent {
        forRepository {
            maven {
                name = "Modrinth"
                url = "https://api.modrinth.com/maven"
            }
        }
        filter {
            includeGroup "maven.modrinth"
        }
    }
}

dependencies {
    // ...
    implementation include("maven.modrinth:lootinj:${project.lootinj_version}")
}