Item Despawn To What

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

fabric-1.21.1-2.0.0

File nameitemdespawntowhat-fabric-1.21.1-2.0.0.jar
Uploader
meteoritelmeteoritel
Uploaded
Nov 6, 2026
Downloads
10
Size
2.6 MB
Mod Loaders
Fabric
File ID
9477996
Type
R
Release
Supported game versions
  • 1.21.1

Curse Maven Snippet

Fabric

modImplementation "curse.maven:item-despawn-to-what-1461907:9477996"

Learn more about Curse Maven

What's new

Breaking Update

2.0.0 is a breaking update. The mod has been extensively rewritten. Rule files and server settings from 1.x are incompatible and must be recreated.

Upgrading and Recreating Your Configuration

  1. Back up your old configuration before upgrading so you can refer to it when rebuilding your rules. Copying or renaming old files will not make them compatible.
  2. Enter a world or join your server, then run /idtw editor open in chat to open the rule editor GUI. /idtw editor also works.
  3. Select New rule and recreate your input items, conversion timing, conditions, and results using the old configuration as a reference.
  4. Click Apply changes at the bottom and wait for a successful save. Rules reload and take effect automatically.

Single-player world owners can open the editor directly. On multiplayer servers, you need OP permission level 2 or higher, and the player using the editor must also have the mod installed on their client.

File Locations

These are the default locations. config/ is relative to your single-player game directory or server root directory. Multiplayer rules are stored on the server.

Content Location Purpose
Custom rules config/itemdespawntowhat/rules/ Rule JSON files, including rules saved through the GUI; subfolders are allowed
Server settings config/itemdespawntowhat/server.json Performance and runtime settings; generated when you first start a world or server
World datapack rules <world save>/datapacks/<pack>/data/<namespace>/idtw/rules/ Rules supplied through a datapack

The overlay_directory setting in server.json changes the rule directory to config/<overlay_directory>/rules/. The location of server.json stays fixed.

After editing rule JSON files by hand, run /idtw rule validate to check them, then /idtw rule reload to apply them. After editing server.json, restart the server or leave and reopen your single-player world.

Guides: Getting started · Command reference · Server settings.

破坏性更新

2.0.0 是一次破坏性更新。 模组经过大规模重写,1.x 的规则配置和服务端配置已不兼容,升级后需要重新配置。

升级与重新配置

  1. 升级前备份旧配置,作为重新编写规则时的参考。旧文件无法通过复制或改名继续使用。
  2. 进入世界或加入服务器,在聊天栏执行 /idtw editor open 打开规则编辑 GUI,也可使用 /idtw editor。
  3. 在 GUI 中选择「新建规则」,参照旧配置重新设置输入物品、转化时机、条件和结果。
  4. 点击界面底部的「应用更改」,等待保存成功。规则会自动重载并生效。

单人存档房主可直接打开编辑器;多人服务器需要 OP 权限(等级 ≥2),操作玩家的客户端也需安装本模组。

文件存储位置

以下为默认位置。config/ 相对于单人游戏目录或服务器根目录;多人游戏中的规则保存在服务器端。

内容 位置 用途
自定义规则 config/itemdespawntowhat/rules/ 存放规则 JSON,也是 GUI 保存规则的位置;可按子目录整理
服务端运行配置 config/itemdespawntowhat/server.json 存放性能与运行参数,首次启动世界或服务器时自动生成
世界数据包规则 <世界存档>/datapacks/<数据包>/data/<命名空间>/idtw/rules/ 通过数据包提供规则

规则目录可通过 server.json 中的 overlay_directory 调整为 config/<overlay_directory>/rules/;server.json 自身位置固定。

手动修改规则 JSON 后,执行 /idtw rule validate 检查,再执行 /idtw rule reload 应用。修改 server.json 后,重启服务器;单人游戏退出并重新进入世界。

使用说明:首次使用 · 命令参考 · 服务端配置。

This mod has no additional files