⛏️ Immersive Ore Expedition 🧭✨

A smarter, slower, more adventurous way to discover ores 🌍💎

Immersive Ore Expedition is a NeoForge Minecraft mod focused on making ore discovery feel more like an actual expedition instead of random strip mining. 🏔️🔦

Rather than simply flooding the world with more ore, IOE is being built around a more immersive loop:

🌱 surface clues → 🪨 mine entrances → 🧭 underground anchors → 💎 targeted ore loads

The goal is to turn mining into exploration, observation, planning, and discovery. ⚒️🗺️

---

🌟 What is IOE?

Immersive Ore Expedition is designed to make ores feel connected to the world around them.
Instead of every valuable resource appearing as random blobs underground, IOE aims to create a more readable and believable mining experience. 🌋⛰️🪨

You should eventually be able to notice clues in the world, follow them underground, and discover meaningful ore deposits through exploration. 🔍💠

---

✅ Current Project Status

IOE is currently in an early technical foundation phase. 🧪⚙️

The current build includes:

• 🧱 Consolidated NeoForge module structure

• ⚙️ Server config foundations

• 🧭 Default-off worldgen proof gates

• 🪨 Custom proof feature registration

• 📦 Configured + placed feature declaration bridge

• 🛡️ Resource-policy safety checks

• 🚫 No fake ore substitution

• 📚 Documentation and smoke-validation tracking

Current worldgen systems are intentionally cautious and mostly default-off. This means the mod is being built safely before live gameplay features are fully enabled. 🔒🌍

---

🧭 Planned Gameplay Direction

The long-term gameplay loop is:

1️⃣ Surface Clues 🌱🪨

Find visible hints in the world that suggest something valuable may exist underground.

2️⃣ Mine Entrances ⛏️🚪

Discover small, natural-looking entry points connected to deeper underground systems.

3️⃣ Mineshaft Anchors 🪵🕯️

Follow underground structures or anchor points that guide exploration.

4️⃣ Anchored Ore Loads 💎🪨

Find ore deposits that feel intentional, rare, and rewarding.

---

💎 Design Philosophy

IOE is built around a few core principles:

• 🧭 Exploration over strip mining

• 🌍 World clues over randomness

• 💎 Meaningful ore discovery

• 🛡️ Safe registry/resource handling

• ⚙️ Default-off experimental systems

• 🚫 No fake resources

• 🔍 Clear validation before gameplay claims

This mod is not trying to make mining easier.
It is trying to make mining more interesting. ⚒️✨

---

🛡️ Resource Safety

IOE is built with strict resource-policy rules. 🧰

That means:

• ✅ Real loaded registry entries are respected

• ✅ Missing resources are skipped safely

• ✅ Strict exclusions win

• ✅ Optional integrations stay optional

• 🚫 Fake ores are not invented

• 🚫 Missing resources are not replaced with random fallback blocks

If a resource is not actually available, IOE avoids pretending it exists. 🧪🔒

---

⚠️ Important Note

This mod is still under active development. 🚧

Some systems are present as scaffolding, proof gates, or declaration bridges, but the complete live gameplay loop is not finished yet. 🌱➡️⛏️➡️💎

Current builds should be treated as early technical releases, not final gameplay-complete releases.

Manual client/server/world smoke validation is still required before live world placement or full gameplay proof is claimed. 🧪📋

---

🔧 Configuration

IOE currently keeps experimental worldgen behavior safe by default. ⚙️🔒

Important defaults include:

worldgen.runtimePlacementEnabled = false
worldgen.runtimePlacementDiagnostics = false
worldgen.runtimeProofFeatureEnabled = false
worldgen.runtimeProofFeatureDiagnostics = false
worldgen.provinces.runtimeIntegrationEnabled = false
worldgen.provinces.resourcePolicyRules = []

This means default worlds should remain safe/no-op unless experimental features are explicitly enabled. 🛡️🌍

---

🧪 For Testers

If you are testing IOE, please report:

• 🧾 Minecraft version

• 🧾 NeoForge version

• 🧾 IOE jar filename

• 🧾 Config values used

• 🧾 Latest log excerpts

• 🧾 Crash reports, if any

• 🧾 Whether client/server/world smoke was actually run

Clear evidence helps separate real gameplay proof from untested scaffolding. 🔬✅

---

🚧 Roadmap Preview

Future work may include:

• 🌱 Better surface clue logic

• ⛏️ Mine entrance generation

• 🪵 Mineshaft anchor behavior

• 💎 Anchored ore-load placement

• 🧭 Province-aware ore distribution

• 🔍 Optional prospecting-style integrations

• 🌋 More believable underground discovery systems

Each feature will be added carefully, with validation boundaries and safe defaults. 🛡️⚙️

---

❤️ Why Use This Mod?

Use Immersive Ore Expedition if you want mining to feel less like:

“Dig in a straight line until numbers go up.” 😴

And more like:

“Read the world, follow the clues, descend underground, and discover something rare.” 🧭⛏️💎✨

---

⛏️ Immersive Ore Expedition

Explore smarter. Mine deeper. Discover with purpose. 🌍🧭💎