Skip to content
Item Despawn To What

Quick rating

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

Item Despawn To What

By meteoritelOwner

No reviews yet

This mod enables players to customize the conversion result after dropped items disappeared via JSON configuration files.

Mod Loaders
Minecraft

About

Description

ItemDespawnToWhat (自定义掉落物转化)

Turn despawning or destroyed item entities into anything you want!

让消失或被销毁的掉落物,转化为你指定的任何东西!


English Description

⚠️ 2.0.0 Upgrade Notice

Version 2.0.0 has been completely rewritten from the ground up and is no longer compatible with 1.x config files:

  • Please back up your old configuration files for reference before updating.
  • After updating, simply run /idtw editor in-game to recreate your rules using the new visual interface.

Key Features

  • Multiple Triggers: Trigger conversions not only when items despawn naturally, but also the exact moment they are destroyed by fire, lava, or cacti.
  • Versatile Outputs:
    • Spawn new items or roll from Loot Tables
    • Summon mobs and entities
    • Place blocks in custom shapes at the item's location
    • Summon lightning, create explosions, drop XP orbs, or change the weather
  • In-Game Visual Editor: No need to write JSON by hand. Run /idtw editor in-game to open an intuitive GUI where you can easily create rules, set environmental conditions (weather, biome, Y-level, etc.), and configure outputs.
  • Modpack Friendly: Besides local configs, read-only rules can be loaded via Datapacks, making it easy for modpack creators to bundle and distribute custom mechanics.
  • Server & Multiplayer Optimized: Features built-in batch scheduling to prevent lag spikes when massive amounts of items convert at once, plus an editing lock system to prevent config conflicts among multiple server admins.

Documentation & Guides

Want to learn how to set up complex condition branches, weighted random outputs, cost mechanics, or check the full command list? Visit our official Wiki:


中文介绍

⚠️ 2.0.0 升级必读

2.0.0 版本进行了底层全面重写,不再兼容 1.x 版本的旧配置文件:

  • 升级前请先备份旧配置文件,方便对照参考。
  • 升级后进入游戏,输入 /idtw editor 即可通过可视化界面重新配置规则。

核心特性

  • 多种触发方式:除了掉落物到期自然消失,还支持在被火焰烧毁、岩浆吞没或仙人掌扎破的瞬间触发转化。
  • 多样化的转化结果:
    • 生成新物品,或直接调用战利品表(Loot Table)
    • 生成生物与实体
    • 在原地放置指定形状的方块
    • 召唤闪电、产生爆炸、掉落经验球或改变天气
  • 游戏内可视化编辑器:告别手写 JSON。在游戏内输入 /idtw editor 即可打开图形界面,直接点击完成规则创建、环境条件筛选(如限定天气、群系、高度)与结果设置。
  • 整合包友好:除本地配置外,支持通过数据包(Datapack)加载只读规则,方便整合包作者统一打包分发。
  • 服务端与联机优化:内置分批处理机制,避免大量掉落物同时转化造成服内卡顿;支持多人编辑防冲突锁,防止多名管理员同时修改配置导致互相覆盖。

完整指南与文档

需要配置特定环境条件、多结果随机概率、消耗机制,或查询全部指令?请查阅官方 Wiki:

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.

logo


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

Type Description
Item → Item Spawns a new item drop when the source item despawns
Item → Entity Spawns an entity when the source item despawns
Item → Block Places a block nearby when the source item despawns

egg hatch in 1 second


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.

Condition Description
Dimension Only triggers in specified dimensions (e.g. Overworld, Nether, End)
Outdoor No opaque blocks between the item and the sky above it
Surrounding Blocks Checks all six adjacent directions; supports block IDs or block tags (prefix with #)
Catalyst Items Requires a specific item drop to be in the same block space; optionally consumed
Inner Fluid Requires the item's block to contain a specific fluid (supports waterlogged blocks); optionally consumed
Result Limit Caps the number of existing conversion results within a radius to prevent infinite accumulation

Getting Started

Visual Configuration GUI

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

gui_edit

gui_reedit

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

Field Description Default Constraints
item Registry ID of the source item — Required
result Registry ID of the conversion result — Required
conversion_time Seconds the item must remain on the ground before converting 300 1 – 300
result_multiple Output quantity multiplier per conversion 1 At least 1
dimension Restricts the conversion to a specific dimension (no restriction) —
need_outdoor Whether the item must be in an outdoor (sky-exposed) location false —
surrounding_blocks Block conditions for all six adjacent directions (no restriction) Supports tags
catalyst_items Required co-located item drop condition (no restriction) —
inner_fluid Required fluid condition in the item's block (no restriction) —

Item → Entity Only

Field Description Default
result_limit Max number of the same entity type allowed nearby; skips conversion if exceeded 30
entity_age Age of the spawned entity (negative values produce babies) -24000

Item → Block Only

Field Description Default
radius_limit Maximum radius for outward block placement 6
block_of_item When enabled, automatically uses the block form of the source item (source must be a block item) false

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.