Community listing page, reviews may not be monitored by the author.
Item Despawn To What
No reviews yet
This mod enables players to customize the conversion result after dropped items disappeared via JSON configuration files.
Community voices
Reviews
No reviews yet. Be the first to review this project!
Get it on
Available Platforms
Compatibility
Supported Environments
Required on the server. Installing it on the client adds functionality.
About
Project Details
For authors
Embed Badge
If you're the author of this project, you can embed a live badge anywhere that supports HTML or Markdown. It updates automatically whenever ratings change.
Use HTML for any page that supports it, or Markdown for README files and Markdown-based descriptions.
Identifiers
Platform IDs
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 editorin-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 editorin-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.

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 |

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.


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 + Hto 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.
Screenshots
Gallery
Versions
Files
Relations
Project Relations
More like this
Similar Mods
Suggestions use data such as tags, dependencies, dependents, descriptions, titles, and more to rank how much they overlap with this mod.
On ModDex
Community snapshot
By the numbers
Statistics
Get it on
Available Platforms
On ModDex
Community snapshot
By the numbers