Yapi: Forgotten Echoes

Yapi: Forgotten Echoes is a gameplay utility mod that gives naturally despawned equipment a chance to return later on hostile mobs.

When supported dropped items expire naturally in the world, the mod can save them into per-world storage instead of letting them disappear completely. Later, when a compatible mob spawns, the mod may equip that mob with one of the stored items.

The mod does not add new items, blocks, mobs, or dimensions. It only reuses equipment that already existed in the world.

What This Mod Is For

In vanilla Minecraft, dropped equipment eventually despawns and is gone forever.

Forgotten Echoes changes that behavior for supported equipment types. Instead of simply deleting expired gear, the mod can preserve it and reintroduce it through mob equipment.

This gives item loss a small gameplay consequence without flooding the world with new loot.

The mod is designed for:

survival worlds
long-running servers
modpacks
players who want old equipment to have a chance to affect future encounters
worlds where item loss should matter a bit more

How It Works

A supported item is dropped in the world.
If the item expires naturally, the mod checks whether it can be stored.
If valid, the item is saved in that world’s forgotten item storage.
When a compatible mob spawns, the mod rolls a configurable equip chance.
If successful, the mob receives a stored item that matches its allowed equipment rules.
The item is removed from storage after being equipped.

By default, stored items are dimension-specific.

That means:

items lost in the Overworld return only in the Overworld
items lost in the Nether return only in the Nether
items lost in the End return only in the End

This behavior can be changed in the config.

Supported Item Types

By default, Forgotten Echoes can store and return:

armor
melee weapons
bows
crossbows

Stored items keep their original data, including:

enchantments
custom names
durability
NBT data
charged crossbows
compatible modded item data

Modded equipment can work if it behaves like normal Minecraft equipment.

Additional melee item IDs can also be added manually in the config.

Supported Mobs By Default

The default mob rules include mobs that can normally hold, wear, or use equipment:

zombies
husks
drowned
zombie villagers
zombified piglins
piglins
piglin brutes
skeletons
strays
wither skeletons
pillagers
vindicators
illusioners
vexes

Each mob only receives item types that match its configured rules.

Examples:

zombies can receive armor and melee weapons
skeletons can receive armor, melee weapons, and bows
pillagers can receive crossbows
piglins can receive armor, melee weapons, and crossbows
vexes can receive melee weapons

Default Balance

Forgotten Echoes is configured to be rare by default.

The default equip chance is:

equipChance = 0.005

This means compatible mobs have a 0.5% chance to try receiving forgotten equipment when they spawn.

Returned gear also has reduced drop chances by default:

mainHandDropChance = 0.08
armorDropChance = 0.04

This means mobs can bring old equipment back into the world, but players are not guaranteed to recover it.

Returned damageable items also receive extra durability damage before being equipped. By default, the mod removes 35% to 99% of the item’s remaining durability, while leaving at least 1 durability point.

Configuration

Config file:

config/yapi_forgotten_echoes-common.toml

The config is generated after launching the game or server once with the mod installed.

Configurable options include:

mob whitelist
allowed item types per mob
equip chance
debug equip chance
main hand drop chance
armor drop chance
durability damage range
dimension-specific storage
single-item or multi-item equipping per mob
maximum equip attempts per mob spawn
item blacklist
extra melee item IDs
experimental modded bow support
experimental modded crossbow support
experimental ranged weapon blacklists
storage limit per dimension

Debug Mode

For testing, enable:

debugMode = true

Debug mode uses the debug equip chance:

equipChanceDebug = 0.5

It also writes extra information to the log.

For normal gameplay, keep:

debugMode = false

Experimental Modded Ranged Weapons

Vanilla bows and vanilla crossbows are supported by default.

Modded bows and crossbows are disabled by default because many modded ranged weapons require custom mob AI support. Without proper AI support, a mob may hold the weapon but fail to use it correctly.

Experimental support can be enabled in the config.

Important notes:

vanilla bows are supported by default
vanilla crossbows are supported by default
modded bows require experimental bow support
modded crossbows require experimental crossbow support
mobs must still be allowed by the mob rules
some modded ranged weapons may not work correctly with vanilla mob AI

Storage Safety

Forgotten item data is stored per world save.

The mod includes:

per-world storage
dimension-based storage
atomic saving
corrupt-file backup
automatic saving on server stop
configurable storage limit per dimension

By default, each dimension can store up to 100 forgotten items.

If the limit is exceeded, one random old stored record is removed.

Limitations

Forgotten Echoes only captures items that expire naturally as dropped items.

It does not handle equipment destroyed by:

lava
cactus
explosions
commands
other mods deleting the item directly

The mod also does not rewrite mob AI.

It relies on Minecraft’s normal equipment behavior, so the best results come from mobs that already know how to use the item they receive.

Credits

Special thanks to Saorise for the updated logo.

Community

Follow development, share ideas, report issues, and stay updated here:

YouTube: https://www.youtube.com/@YAPILabs

Discord: https://discord.gg/KYGyy9jFCz