Skip to content

Repository files navigation

Custom Despawn Timer

Choose how long items lie on the ground before they despawn. Vanilla gives every dropped item five minutes; this mod defaults to 30 seconds and lets you set any value from one second to about 27 minutes.

Works in singleplayer and on multiplayer servers. Despawning is decided by the server, so on a server it is the server's setting that counts, and players do not need the mod installed to join.

Installation

Minecraft Loader Required mods Java
26.2 Fabric Loader 0.19.3+ Cloth Config 25
26.2 NeoForge 26.2+ Cloth Config 25

Fabric API is not required. Mod Menu is recommended on Fabric for the config button; NeoForge shows it in the mod list.

Config

One setting: Seconds until dropped items despawn (default 30, range 1 to 1638).

  • Singleplayer: open the config screen from Mod Menu (Fabric) or the mod list (NeoForge). Changes apply immediately to items dropped from then on.
  • Servers: edit config/customdespawntimer.json and restart the server. The value is read once at startup.

The upper limit of 1638 seconds comes from Minecraft saving an item's age as a 16-bit number; beyond that an item's age would wrap around when its chunk is saved and reloaded.

How it works

Vanilla removes an item once its age reaches a hardcoded 6000 ticks. On Fabric a small mixin swaps that number for the configured one. On NeoForge each item already carries its own lifespan field, so the mod sets that field whenever an item enters a world. Both loaders run the check only on the server side.

On NeoForge this overrides other mods that give particular items a longer or shorter lifespan; every item gets the configured time.

Building

Clone, then ./gradlew build. Jars land in fabric/build/libs and neoforge/build/libs. ./gradlew :fabric:runClientGameTest launches a client that drops an item with a three-second timer and checks that it disappears on schedule, leaving screenshots in fabric/build/run/clientGameTest/screenshots.

License

MIT, see LICENSE.

About

Minecraft mod: choose how many seconds items lie on the ground before they despawn. Fabric and NeoForge.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages