Item Despawn To What

Minecraft 版本： 1.21.1

平台： fabric

标签： game-mechanics utility

ItemDespawnToWhat

Let items about to despawn quietly transform into something else before they disappear.

Chicken rotting into rotten flesh? Eggs hatching into chickens? Saplings planting themselves? — All fully customizable.

What This Mod Does

In vanilla Minecraft, dropped items on the ground disappear naturally after a while.
This mod lets you define custom conversion rules that trigger just before items despawn.

You can configure conversions through a GUI or config files, and attach optional conditions to each rule.

Three Conversion Types

Combinable Trigger Conditions

All conditions are optional. Leaving a condition blank means no restriction. When multiple conditions are set, all of them must be satisfied for the conversion to trigger.

Getting Started

Visual Configuration GUI

This mod includes an easy-to-use rule editor GUI.

How to open it:

• Keybind: Unbound by default — assign one in Options → Controls
• Command: /conversion_config edit (requires OP permission or singleplayer)
• Main Menu Button: Top-right corner of the game's main screen

If you prefer editing JSON directly, config files are located in .minecraft/config/itemdespawntowhat/.

Defining Conversion Rules

Common Fields

Item → Entity Only

Item → Block Only

Saving & Reloading

In the GUI:

• Click Add to Cache to queue up more rules
• Click Apply to File to save all cached rules to disk

Then run in-game:

/conversion_config reload

This hot-reloads the config without restarting the server.

Configuration Examples

Chicken → Rotten Flesh (200 seconds, no conditions)

{
  "item": "minecraft:chicken",
  "result": "minecraft:rotten_flesh",
  "conversion_time": 200
}

Egg → Chicken (Overworld only, on a hay bale)

{
  "item": "minecraft:egg",
  "result": "minecraft:chicken",
  "conversion_time": 5,
  "dimension": "minecraft:overworld",
  "surrounding_blocks": {
    "down": "minecraft:hay_block"
  },
  "result_limit": 30
}

Sapling → Auto-planted (on dirt, must be outdoors)

{
  "item": "minecraft:oak_sapling",
  "result": "minecraft:oak_sapling",
  "block_of_item": true,
  "conversion_time": 30,
  "need_outdoor": true,
  "surrounding_blocks": {
    "down": "#minecraft:dirt"
  }
}

Notes

• Conversion time is capped at 300 seconds, matching vanilla's maximum item lifetime. This mod does not modify the natural despawn timer — to extend it, pair this mod with something like Custom Item Despawn Duration.

• Returned items and death drops are excluded from conversion checks. Items returned after a failed conversion, and items dropped on player death, must be picked up and re-thrown before re-entering the conversion pipeline.

• Catalyst items cannot be the same as the source item — such a config will be rejected at load time.

• Item → Item conversions cannot use the same item as both source and result, to prevent infinite conversion loops.

• To find item IDs: Press F3 + H to enable advanced tooltips. Hover over any item and its registry name will appear at the bottom of the tooltip.

Multiplayer

• Config files are stored server-side and automatically synced to connecting clients.
• The hot-reload command requires OP permission.
• The config GUI and keybind are only available in singleplayer or on a local server.