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

1. A supported item is dropped in the world.
2. If the item expires naturally, the mod checks whether it can be stored.
3. If valid, the item is saved in that world’s forgotten item storage.
4. When a compatible mob spawns, the mod rolls a configurable equip chance.
5. If successful, the mob receives a stored item that matches its allowed equipment rules.
6. 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.

Community

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

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

Discord: https://discord.gg/KYGyy9jFCz