Customization

Little Joys 26.3 and above stores event definitions in data pack registries instead of recipes like older versions. Put each definition in the folder for its event type:

Dig Spots: data/<namespace>/littlejoys/dig_spot/<name>.json
Fishing Spots: data/<namespace>/littlejoys/fishing_spot/<name>.json
Drop Rushes: data/<namespace>/littlejoys/drop_rush/<name>.json
Gold Rushes: data/<namespace>/littlejoys/gold_rush/<name>.json

Unlike the older recipe format, these files do not have a top-level type field. The folder identifies the event type.

Definitions can be added or replaced with a data pack in the same way as other data-driven registries. To replace a built-in definition, use the same namespace and path as the original. Little Joys ships definitions for vanilla content and many popular mods; the complete set is available in the GitHub repository.

The loot tables used by the built-in Dig Spots and Fishing Spots are also available in the GitHub repository.

Event definitions with the same event type and matching conditions are weighted against each other. weight defaults to 1 when omitted.

Dig Spots

data/example/littlejoys/dig_spot/white_sand.json

{
  "condition": {
    "type": "shogi:below",
    "effect": {
      "type": "shogi:is_block",
      "block": "minecraft:sand"
    }
  },
  "lootTable": "example:dig_spot/white_sand",
  "weight": 1
}

Fishing Spots

data/example/littlejoys/fishing_spot/lush_water.json

{
  "condition": {
    "type": "shogi:and",
    "conditions": [
      {
        "type": "shogi:below",
        "effect": {
          "type": "shogi:and",
          "conditions": [
            {
              "type": "shogi:is_fluid",
              "fluid": "minecraft:water"
            },
            {
              "type": "shogi:is_fluid_source"
            },
            {
              "type": "shogi:not",
              "condition": {
                "type": "shogi:is_waterlogged"
              }
            }
          ]
        }
      },
      {
        "type": "shogi:can_see_sky"
      }
    ]
  },
  "lootTable": "example:fishing_spot/lush_water",
  "weight": 1
}

Drop Rushes

data/example/littlejoys/drop_rush/glow_berries.json

{
  "condition": {
    "type": "shogi:and",
    "conditions": [
      {
        "type": "shogi:is_block",
        "block": "minecraft:cave_vines"
      },
      {
        "type": "shogi:is_block_state_property",
        "property": "berries",
        "value": "true"
      }
    ]
  },
  "lootTable": "minecraft:blocks/cave_vines",
  "chanceMultiplier": 1.0,
  "rolls": 8,
  "seconds": 12.5,
  "range": 8,
  "weight": 1
}

chanceMultiplier multiplies the configured Drop Rush base chance. rolls controls how often the loot table is rolled. seconds is the timer length and range controls how far the rush spreads. The defaults are the values shown above.

Gold Rushes

data/example/littlejoys/gold_rush/mythril_ore.json

{
  "condition": {
    "type": "shogi:and",
    "conditions": [
      {
        "type": "shogi:is_block",
        "block": "example:mythril_ore"
      },
      {
        "type": "shogi:is_item",
        "item": "#littlejoys:can_trigger_goldrush"
      },
      {
        "type": "shogi:not",
        "condition": {
          "type": "shogi:is_item",
          "item": "#littlejoys:cannot_trigger_goldrush"
        }
      }
    ]
  },
  "lootTable": "example:blocks/mythril_ore",
  "chanceMultiplier": 0.5,
  "seconds": 7.0,
  "maxDropsPerSecond": -1,
  "weight": 1
}

chanceMultiplier multiplies the configured Gold Rush base chance. seconds controls how long the block remains in a rush. maxDropsPerSecond limits repeated drops; -1 means no additional limit. The defaults are 1.0, 7.0, and -1, respectively.

Event conditions

Little Joys 26.3 uses Shogi conditions in condition. Condition type names are usually namespaced with shogi:. See the Shogi effect catalog for the complete list of available conditions and their fields. The built-in definitions use:

shogi:and: matches when every entry in conditions matches.
shogi:not: inverts one nested condition.
shogi:below: evaluates the nested effect against the block below the event position.
shogi:can_see_sky: requires sky access at the event position.
shogi:is_block: matches a block or block tag.
shogi:is_block_state_property: matches one property value on the current block state.
shogi:is_fluid: matches a fluid or fluid tag.
shogi:is_fluid_source: requires the current fluid to be a source.
shogi:is_waterlogged: matches waterlogged blocks.
shogi:is_item: matches the player's held item against an item id or item tag.