Yapi: Forgotten Echoes

Yapi: Forgotten Echoes

Lost gear should not simply vanish.

The world remembers it.

Yapi: Forgotten Echoes changes what happens to equipment that disappears in the world.

When armor, weapons, bows, or crossbows expire naturally as dropped items, the mod can capture them and store their full item data. Later, when compatible mobs spawn, that forgotten gear may return — worn, carried, and used against the world.

A sword lost in a cave might come back in a zombie’s hand.
A helmet abandoned after a fight might appear on a skeleton.
A crossbow that vanished from the ground might return with a pillager.

Your world starts building its own history.

What The Mod Does

• Captures naturally expired dropped equipment.
• Stores forgotten items per world save.
• Keeps item data such as:
  • enchantments
  • custom names
  • durability
  • NBT data
  • charged crossbows
  • modded item data
• Later gives stored items to compatible mobs when they spawn.
• Removes an item from storage once it successfully returns.
• Adds extra durability damage before an item comes back, so returned gear feels worn by time.

This mod does not add new items.
It makes your old items matter again.

Examples

You might run into:

• a zombie wearing armor that once belonged to a player
• a skeleton carrying a forgotten bow
• a drowned holding an old weapon
• a piglin returning with gear lost in the world
• a pillager carrying a crossbow that vanished earlier
• a random hostile mob with equipment that has a real history

Every encounter can become a small story.

That mob is not just wearing loot. It found something the world forgot.

Supported Item Types

By default, the mod can store and return:

• armor
• melee weapons
• bows
• crossbows

Modded items can work too, as long as they behave like normal Minecraft equipment.

Supported Mobs By Default

Default mob rules include common mobs that can hold, wear, or use equipment, such as:

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

Each mob only receives item types that make sense for it.

For example:

• 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

How It Works

1. A supported item is dropped in the world.
2. If it expires naturally, Forgotten Echoes captures it.
3. The item is saved in that world’s forgotten item storage.
4. When a compatible mob spawns, it has a configurable chance to receive a stored item.
5. If the item fits the mob’s rules, the mob equips it.
6. The item is removed from storage.

By default, items respect dimensions.

That means:

• Overworld items return in the Overworld
• Nether items return in the Nether
• End items return in the End

This can be changed in the config.

Configuration

The mod is highly configurable.

You can change:

• which mobs can receive forgotten items
• what item types each mob can receive
• equip chance
• drop chance
• durability damage
• whether items stay dimension-specific
• whether a mob can receive one or multiple items per spawn
• item blacklist
• extra melee item ids
• experimental modded bow support
• experimental modded crossbow support

Config file:

config/yapi_forgotten_echoes-common.toml

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

Default Balance

Forgotten Echoes is intentionally subtle by default.

The default equip chance is low, so mobs with old gear feel rare and memorable instead of constant.

If you want a more chaotic world, you can increase the chance in the config.

For testing, enable:

debugMode = true

This uses the debug equip chance and writes detailed logs.

For normal gameplay, keep:

debugMode = false

Experimental Modded Ranged Weapons

Modded bows and crossbows can be enabled in the experimental config section.

This is disabled by default because many modded ranged weapons need special mob AI support.

For best results, install these compatibility mods:

• Skeleton Uses Custom Bow — helps skeleton-type mobs use modded bows correctly.
• Piglin Hunt Fix — helps piglins use crossbows correctly.

Important:

• vanilla bows are safe by default
• vanilla crossbows are safe by default
• modded bows require experimental bow support
• modded crossbows require experimental crossbow support
• mobs must still be allowed by mob rules
• without the compatibility mods above, some mobs may hold modded ranged weapons but fail to use them properly

Use this if you want mobs to return with weapons from other mods.

Some modded ranged weapons may appear in a mob’s hand but not fire correctly if the mob AI cannot use them.

Important Notes

This mod does not rewrite mob AI.

It relies on Minecraft’s normal equipment and mob behavior.
That means the best results come from mobs that already know how to hold, wear, or use items.

Some mobs are not supported by default because they do not naturally use equipment in a useful way.

Storage Safety

Forgotten item data is stored per world save.

The mod includes:

• per-world storage
• atomic saving
• corrupt-file protection
• automatic saving on server stop
• storage limit per dimension

By default, each dimension can store up to 100 forgotten items.
If the limit is exceeded, one random old record is removed.

Why Use This Mod?

Because dropped items disappearing forever is boring.

Forgotten Echoes turns item loss into world memory.

It makes old fights matter.
It makes mobs feel like part of the world’s history.
It creates moments where you stop and think:

Wait… was that my sword?

Concept

This mod does not flood the game with new loot.

It brings back what was already there.

Not always.
Not immediately.
Not safely.

Nothing is truly lost.
Sometimes, it is just waiting for something else to pick it up.