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:

• English Wiki Guide (GitHub Wiki)

---

中文介绍

⚠️ 2.0.0 升级必读

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

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

核心特性

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

完整指南与文档

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

• 中文 Wiki 玩家指南 (GitHub Wiki)