Eroded World

Hardcore survival overhaul for Minecraft Fabric 1.21.6 - 1.21.8

Darkness is not cosmetic.
Mining has consequences.
Energy defines your limits.

Eroded World reacts to your actions. The more you mine, the more dangerous the environment around you becomes.

This project is a beta version and some parts may change between builds.

---

Table of Contents

• About
• Current Beta Highlights
• Installation
• Core Systems
• Items and Blocks
• Commands
• Configuration
• Technical Information
• Wiki
• License

---

About

Eroded World is built around consequence-driven survival:

• every physical action can matter,
• mining and pollution affect local territory,
• darkness is a real threat,
• crafting quality depends on preparation and progression,
• death creates recoverable remains instead of simply deleting progress,
• server-side systems remain authoritative for survival balance.

The mod is designed for atmospheric multiplayer survival servers, especially where slow progression, risk, resource planning and long-term world impact are part of the gameplay.

---

Current Beta Highlights

This beta update expands several major survival systems:

• added temporary player protection after death,
• added Return Compass weapon functionality,
• added territory protection using Territory Anchor and Territory Module,
• added Eroded Torch as a rechargeable handheld light source,
• improved special skeleton behavior, especially daylight and shade handling.

These changes make death recovery, base protection and darkness exploration more connected to the core survival loop.

---

Installation

Requirements

• Minecraft 1.21.6 - 1.21.8
• Fabric Loader
• Fabric API
• Cloth Config API
• Java 21

Client / Server

Eroded World is designed as a client + server mod.

For multiplayer servers, the mod should be installed on both:

• the server,
• all connecting clients.

Setup

1. Install Fabric Loader for the supported Minecraft version.
2. Install Fabric API.
3. Install Cloth Config API.
4. Place the Eroded World .jar file into the mods folder.
5. Start the game or server once to generate configuration files.
6. Edit generated config files if needed.
7. Use /eroded reload after manual config changes.

---

Core Systems

Energy & Stamina

Energy is the player's main physical resource.

Energy can be consumed by:

• sprinting,
• dodging,
• mining,
• crafting.

Energy states include:

• Normal – full performance,
• Tired – reduced safety margin,
• Exhausted – sprinting becomes restricted and Mining Fatigue can be applied,
• Empty – the player collapses and must recover.

Energy can regenerate passively, through sleep, food and special recovery items depending on server configuration. The client HUD displays energy state, warnings and important feedback.

🧠 Skills / CG Progression

The mod tracks crafting growth through CG values. Current skill categories include:

• Woodworking
• Smelting

CG progression is intentionally slow and is used by crafting and quality systems to reward preparation instead of fast grinding.

Crafting & Item Quality

Crafting is no longer just a recipe check.

The crafting system can:

• consume energy,
• grant CG experience,
• require vanilla XP level for special items,
• apply item quality,
• show feedback through client-side overlays.

Quality tiers:

• POOR
• STANDARD
• EXCELLENT

Quality affects item behavior through durability and repair-related modifiers. Input quality and player CG influence the resulting quality. Repairing through an anvil can degrade quality over time, making high-quality gear valuable but not permanent.

Territory, Mining & Collapse

The world reacts to player activity.

Territory is evaluated in larger local areas based on chunk groups. These areas track:

• mining activity,
• pollution,
• forestation,
• threat.

Heavy mining increases instability. Below configured Y-levels, repeated mining can trigger cave-ins. Collapses can produce warning sounds, dust particles, falling gravel and hostile encounters.

Tunnels can be protected by nearby stabilizer blocks. The Warding Lamp can also hold back a cave-in while active.

Territory Protection

Eroded World also includes a player territory protection system.

This system is separate from environmental territory threat. It is used to protect player-built areas from unauthorized interaction by other players.

To create a protected territory, players need:

• Territory Anchor
• Territory Module

Protected territory can prevent unauthorized players from breaking, placing or interfering with protected blocks and systems.

Territory protection does not make the area completely safe. Mobs, darkness, energy exhaustion, cave collapses and ecosystem danger can still threaten the player.

A protected claim is a base protection system, not a complete safety bubble.

Dynamic Ecosystem

High-threat areas can visually decay over time:

• grass can turn into dirt,
• dirt can become coarse dirt,
• coarse dirt can become podzol,
• vegetation can be damaged in eroded areas.

If an area is left alone and threat drops, the ecosystem can slowly recover. The system is designed to make overused locations feel worn down while calmer places slowly heal.

True Darkness

Darkness is handled as a survival mechanic, not only as a visual effect.

The system can include:

• server-side darkness detection,
• client-side dark overlay,
• eye adaptation,
• heartbeat audio,
• calm-down audio when leaving danger darkness,
• debug information for testing light levels.

Exploring caves or nights without a light source is meant to be risky.

Mutated Mobs & Light Eater

High-threat territory can spawn special hostile mobs.

Mutated mobs can receive:

• increased health,
• custom titles such as Forsaken, Eroded or Apocalypse,
• special command tags,
• protection behavior against sunlight,
• light-related AI behavior.

The Light Eater system allows mutated mobs to interfere with nearby light sources, making darkness a direct part of combat pressure.

Special skeleton behavior has been improved to reduce unwanted shade-lock behavior and make daylight handling more reliable.

Warding Lamp

The Warding Lamp is a special survival tool for darkness and cave exploration.

When held in dark underground conditions, it can create temporary light around the player. It has configurable duration, light level and darkness requirements. While active, it can also protect against some cave-in events.

When placed, it can create a powerful protective burst that affects nearby hostile mobs.

Eroded Torch

The Eroded Torch is a rechargeable handheld light source.

Unlike a normal torch, it can help break dangerous darkness while being held. It is useful during cave exploration, death recovery and emergency escapes.

The Eroded Torch can also be placed as a normal light-emitting torch.

Depending on configuration, it can:

• work as handheld light,
• reduce dangerous darkness,
• use a limited charge system,
• recharge when not actively used,
• continue working as a placed light source.

Death & Soul Recovery

Death is punishing, but recoverable.

When a player dies:

• their inventory is stored in a Death Chest,
• the death chest is protected for a configurable time,
• a hologram can appear above the remains,
• a Return Compass helps guide the player back,
• the compass can reveal remaining protection time and coordinates.

The system is designed to keep death meaningful without turning every death into permanent loss.

Post-Death Protection

After death, the player can receive temporary protection from hostile mobs.

This short protection window helps prevent immediate repeated deaths and gives the player a chance to start recovering, prepare for the return journey and follow the compass back to the Death Chest.

The protection is temporary and configurable. It is meant to reduce unfair death loops, not remove danger completely.

Return Compass as Weapon

The Return Compass guides the player back to the latest Death Chest.

It can also be used as an emergency weapon. This gives the player a basic way to defend themselves while returning after death.

The compass is not intended to replace normal weapons. It is a recovery tool for dangerous post-death situations.

Eroded Loot System

Naturally found containers can become part of the Eroded Loot system.

The loot system can:

• modify chest and barrel contents,
• lock protected containers until searched,
• create curated survival loot,
• include food, light sources, tools, armor, valuables and special items,
• support admin-created loot chests through commands.

Spawn Sovereignty

Spawn can be protected as a safe preparation zone.

Depending on configuration, spawn protection can prevent:

• hostile mob pressure,
• explosions,
• block breaking,
• block placement,
• piston griefing.

Creative mode and OP bypass behavior can be configured.

---

Items and Blocks

Current custom content includes:

• Energy Drink – restores energy when the player is not already full,
• Energy Stabilizer / Adrenaline Shot – temporarily locks energy consumption through an immunity window,
• Return Compass – guides players back to their latest stored death memory and can act as an emergency weapon,
• Death Chest – stores player remains after death,
• Warding Lamp – temporary underground light and collapse protection tool,
• Eroded Torch – rechargeable handheld and placeable light source,
• Territory Anchor – core block used for player territory protection,
• Territory Module – item used together with the Territory Anchor,
• Eroded Block – decorative/custom block with multiple visual variants.

---

Commands

Main command:

/eroded

Available subcommands:

/eroded reload

Reloads all Eroded World configuration files. Requires OP level 2.

/eroded chest

Gives an admin Eroded Loot Chest item. Requires OP level 2.

/eroded energy <player> <amount>

Sets a player's energy value. Requires OP level 2.

/eroded icon <position>

Changes the Energy HUD position.

Supported positions:

• left_down
• right_down
• center_down
• left_up
• right_up
• center_up

/eroded sound volume <1-10>
/eroded sound delay <1-10>
/eroded sound info
/eroded sound reset

Allows players to tune the darkness heartbeat sound.

/eroded territory info

Shows information about the territory claim at the player's current position. Requires OP level 2.

/eroded territory list

Lists all territory claims in the current world. Requires OP level 2.

/eroded territory remove

Removes the territory claim at the player's current position and removes its anchor block. Requires OP level 2.

/eroded territory remove <pos>

Removes the territory claim at the selected block position and removes its anchor block. Requires OP level 2.

/eroded territory clear

Removes all territory claims in the current world and removes their anchor blocks. Requires OP level 2.

Default debug keybind:

F6

Used for Eroded debug overlays depending on the active client systems.

---

Configuration

Eroded World uses Cloth Config / AutoConfig.

Configuration categories include:

• ErodedWorld/energy
• ErodedWorld/crafting
• ErodedWorld/darkness
• ErodedWorld/territory
• ErodedWorld/death
• ErodedWorld/combat
• ErodedWorld/loot

After the first run, configuration files are generated in the Minecraft config directory. Server owners can edit JSON files manually or use compatible configuration UI tools.

Use this command after manual changes:

/eroded reload

---

Technical Information

• Mod ID: eroded
• Minecraft target: 1.21.8
• Minecraft compatibility range: 1.21.6 - 1.21.8
• Java: 21
• Loader: Fabric
• Architecture: client + server split
• Networking: custom payloads for energy, skills, darkness, compass and feedback synchronization
• Persistence: PersistentState-based world and player data
• Configuration: Cloth Config / AutoConfig
• Localization: English and Czech language files are included
• Dependencies: Fabric API, Cloth Config API

---

Wiki

The project wiki contains gameplay and administration documentation:

https://github.com/MSWHendys/Eroded_World/wiki

Recommended pages:

• Getting Started
• Core Systems
• Commands
• Config Guide
• Energy & Stamina
• Darkness & Atmosphere
• Territory & Ecosystem
• Death & Soul Recovery
• Loot System
• Special Items & Blocks

---

License

See LICENSE.txt.

The repository currently uses an internal/custom license notice. License details may change in the future.