# 🧠🌍 IMMERSIVE EGO 🌍🧠

> **Your body adapts. Your mind reacts. Your environment remembers.**

**Immersive EGO** is a deeply configurable survival-RPG overhaul for **Minecraft 1.21.1 NeoForge**.
It unifies physiology, sleep, nutrition, psychology, stamina, environmental exposure, biome adaptation, and character statistics into **one coherent living system** — displayed directly through **Apothic Attributes**. 🧬⚔️📊

---

## 🚧 DEVELOPMENT STATUS

Immersive EGO is currently in active development. 🛠️
Features described below represent the intended design and may evolve during implementation, testing, and balancing.

---

## ✨ THE CORE IDEA

Immersive EGO does not add random survival bars that operate independently.

Every system feeds another:

```text
🌦️ Environment
↓
🌡️ Temperature • 💧 Hydration • 🫁 Respiration
↓
⚡ Stamina • 🪫 Fatigue • 🛏️ Sleep
↓
🥗 Nutrition • 🦠 Gut Health • 🩹 Recovery
↓
🧠 Stress • 🎯 Focus • ❤️‍🔥 Mental Stability
↓
🧬 Adaptation • 📈 Readiness • 🌌 EGO Load
```

A hot biome increases hydration demand. 💧
Dehydration reduces stamina recovery. 🪫
Low stamina increases fatigue. 😮‍💨
Fatigue damages sleep quality. 🛏️
Poor sleep increases stress. 🧠
Stress slows recovery and acclimation. 🌀

Everything matters. Everything connects. 🔗

---

# 📊 BUILT AROUND APOTHIC ATTRIBUTES

Immersive EGO uses **Apothic Attributes** as its primary character-stat interface. ⚔️📖

Open the familiar Apothic Attributes page from your inventory to inspect:

- 💧 Hydration efficiency
- 🌡️ Heat and cold tolerance
- ⚡ Maximum stamina
- 🔋 Stamina regeneration
- 🪫 Fatigue resistance
- 🛏️ Sleep efficiency
- 🌙 Circadian resilience
- 🫁 Oxygen efficiency
- 🥗 Metabolic efficiency
- 🧠 Stress resistance
- ❤️‍🩹 Mental recovery
- 🎒 Carrying capacity
- 🧬 Acclimation speed
- 🩹 Recovery efficiency
- 🌦️ Environmental adaptation
- 📈 Current vital-state mirrors

Every modifier can show its source:

```text
🧬 Biome Origin
🌦️ Climate
🥗 Nutrition
🛏️ Sleep
🧠 Psychology
🎒 Encumbrance
⚔️ Apotheosis Affix
🏘️ Profession or Faction — future society module
```

Immersive EGO does **not** redistribute Apothic Attributes assets.
Its interface resources remain provided by the separately installed Apothic Attributes mod. ⚖️

---

# 💧 HYDRATION & WATER QUALITY

Water is more than a second hunger bar.

Hydration is influenced by:

- 🏃 Physical activity
- 🌡️ Body temperature
- ☀️ Heat exposure
- 🌬️ Dry climate
- 🫁 Respiratory strain
- 🧬 Biome origin
- 🎒 Carried weight
- 🛏️ Sleep debt
- 🥗 Nutrition
- ⚙️ Configured difficulty

Water sources may be:

- 🦠 Contaminated
- 🟤 Dirty
- 💧 Potable
- ✨ Purified

Purification can rely on existing Minecraft interactions, without requiring a new machine or custom block. 🔥🫙

---

# 🌡️ BODY TEMPERATURE & EXPOSURE

Immersive EGO evaluates more than the biome name.

Temperature and exposure can consider:

- 🌍 Biome climate
- 🍂 Season
- 🕒 Time of day
- 🌧️ Weather
- 💨 Wind exposure
- ☔ Rain exposure
- 💦 Wetness
- 🌳 Shade
- 🏠 Roof coverage
- 🔥 Nearby heat
- ⛰️ Altitude
- 🕳️ Depth
- 🧥 Equipment modifiers
- 🧬 Origin and acclimation

Wet clothing, poor shelter, cold rain, and exhaustion can become more dangerous together. 🌧️🥶

---

# 🫁 RESPIRATION, ALTITUDE & DEPTH

Air becomes a contextual survival pressure instead of a permanent nuisance.

Respiratory strain may increase in:

- ⛰️ High mountains
- 🕳️ Deep underground areas
- 🔥 Hostile dimensions
- 🌫️ Poorly ventilated environments
- 🏃 Extreme physical exertion

Low oxygen can affect:

- ⚡ Stamina
- 🪫 Fatigue
- 🎯 Focus
- 🌡️ Thermoregulation
- 🛏️ Sleep quality
- 🧠 Stress

Most normal environments remain comfortable and require no micromanagement. ✅

---

# ⚡ STAMINA, EXERTION & ENCUMBRANCE

Different actions consume different amounts of stamina:

- 🏃 Sprinting
- 🏊 Swimming
- 🧗 Climbing
- ⛏️ Mining
- ⚔️ Attacking
- 🛡️ Blocking
- 🦘 Jumping
- 🪂 Elytra use
- 🎒 Carrying excessive weight

Your equipment and inventory have a configurable load value. ⚖️

```text
Current Load ÷ Carrying Capacity = Load Ratio
```

A high load can increase:

- ⚡ Stamina cost
- 🫁 Oxygen demand
- 🌡️ Body heat
- 🪫 Fatigue
- 🩹 Pain load
- 🐌 Movement penalties

No new backpack or accessory is required. Existing inventories remain the foundation. 🎒

---

# 🛏️ SLEEP, FATIGUE & CIRCADIAN RHYTHM

Sleeping is not an instant full reset.

Immersive EGO tracks:

- ⚡ Current stamina
- 🪫 Physical fatigue
- 🌙 Sleep debt
- 🕒 Circadian phase
- 💤 Sleep pressure
- ⭐ Last sleep quality

Sleep quality can depend on:

- ⏳ Duration
- 🏠 Shelter
- 🛡️ Real nearby safety
- 🌡️ Thermal comfort
- 💧 Hydration
- 🥗 Nutrition
- 🫁 Oxygenation
- 🧠 Stress
- 🩹 Pain
- 🧬 Environmental affinity

### 🌙 Full Sleep

A complete night restores stamina, reduces fatigue, repays sleep debt, and supports mental recovery.

### 😴 Naps

Configurable daytime naps may restore stamina and reduce fatigue without fully resetting sleep debt or advancing multiplayer time.

### 👻 Phantoms

Phantom prevention can require genuinely restorative sleep instead of briefly touching a bed.

---

# 🥗 NUTRITION & DIETARY MEMORY

Immersive EGO separates three questions:

```text
🍗 Vanilla Hunger:
Have I eaten enough right now?

🥗 Nutrition:
Has my diet been balanced over time?

🍞 Dietary Memory:
Have I eaten the same food repeatedly?
```

Nutrition may track configurable food groups such as:

- 🌾 Grains
- 🥩 Proteins
- 🥕 Vegetables
- 🍎 Fruits
- 🥛 Dairy
- 🍄 Fungi
- 🐟 Seafood
- 🍲 Complete meals

Repeated food remains useful, but may gradually provide less:

- 😊 Meal satisfaction
- ❤️‍🩹 Mental recovery
- 🧬 Secondary nutritional absorption
- 📈 Dietary variety

The system is designed to encourage variety without forcing the player to carry twenty foods at all times. ✅

---

# 🦠 GUT HEALTH & CONTAMINATION

Food and water safety can influence:

- 🥗 Nutrient absorption
- 💧 Hydration loss
- 🪫 Fatigue
- 🛏️ Sleep quality
- 🧠 Stress
- ❤️‍🩹 Recovery

This is a lightweight systemic layer — not a medical simulator and not a collection of new medicine items. 🧪

---

# 🧠 PSYCHOLOGY, STRESS & FOCUS

Immersive EGO replaces a simplistic “sanity bar” with connected psychological states:

- 🧠 Stress
- 🎯 Focus
- 🛡️ Mental stability
- 😨 Fear
- 🌤️ Comfort
- ❤️‍🩹 Mental recovery
- 🌀 Systemic strain

Possible stressors include:

- 🌑 Darkness
- 👹 Nearby danger
- 💥 Recent damage
- 💧 Dehydration
- 🍽️ Hunger
- 🪫 Exhaustion
- 🌡️ Thermal strain
- 🫁 Respiratory strain
- 🛏️ Sleep debt
- 🩹 Pain
- 🏚️ Unsafe shelter

Positive recovery can come from:

- 🛏️ Rest
- 🔥 Safe shelter
- 🐺 Friendly animals
- 🏘️ Settlements
- 🍲 Satisfying meals
- 💧 Good hydration
- 🌤️ Familiar environments

Extreme visual or auditory effects will be configurable and disabled by default in accessibility-friendly presets. ♿

---

# 🩹 PAIN & RECOVERY

Immersive EGO includes a lightweight pain and injury-load system.

It does **not** add:

- ❌ Separate limb health
- ❌ Fractures
- ❌ Medical item spam
- ❌ Anatomical HUD clutter

Instead, recent damage creates a configurable **Pain Load** that may affect:

- ⚡ Stamina cost
- 🛏️ Sleep quality
- 🎯 Focus
- 🧠 Stress
- ❤️‍🩹 Recovery demand

---

# 🧬 BIOME ORIGINS & ACCLIMATION

Your origin represents environmental heritage — not a fantasy race lock.

Possible origin families include:

- 🏜️ Desertborn
- ⛰️ Alpine
- 🌲 Forestborn
- 🌊 Coastal
- 🐸 Marshborn
- 🌾 Plainsborn
- 🕳️ Cavernborn
- 🔥 Nether-Adapted

Origins can modify:

- 🌡️ Comfortable temperature range
- 💧 Hydration efficiency
- 🫁 Oxygen tolerance
- 💦 Humidity tolerance
- 🛏️ Sleep efficiency
- 🥗 Dietary preferences
- 🧠 Environmental comfort
- 🧬 Acclimation speed

### 🔄 Acclimation

Living in a new climate gradually builds partial adaptation.

Acclimation is:

- ⏳ Slow
- 🔁 Reversible
- 📈 Configurable
- 🧬 Weaker than inherited affinity
- 🌍 Driven by actual exposure

Changing faction or biome does not magically rewrite biological heritage. ✅

---

# 🌌 EGO LOAD, READINESS & RECOVERY

Immersive EGO combines its modules through higher-level derived states.

### 🌌 EGO Load

A configurable measure of accumulated systemic strain:

```text
Thermal Strain
+ Dehydration
+ Hypoxia
+ Fatigue
+ Sleep Debt
+ Malnutrition
+ Pain
+ Psychological Stress
```

### 📈 Readiness

Your immediate ability to travel, fight, work, and recover.

### ❤️‍🩹 Recovery Capacity

A shared recovery budget produced by:

- 🛏️ Sleep
- 🥗 Nutrition
- 💧 Hydration
- 🫁 Oxygenation
- 🌡️ Thermal comfort
- 🧠 Mental stability
- ⚔️ Character attributes

Recovery is allocated across stamina, fatigue, pain, stress, sleep debt, and acclimation instead of every bar regenerating independently. 🔗

---

# ⚔️ APOTHEOSIS SYNERGY

**Apotheosis is optional but strongly recommended.**

When installed, equipment, affixes, and gems may modify EGO capacities such as:

- 💧 Hydration efficiency
- 🌡️ Heat or cold tolerance
- ⚡ Maximum stamina
- 🔋 Stamina regeneration
- 🪫 Fatigue resistance
- 🛏️ Sleep efficiency
- 🫁 Oxygen efficiency
- 🧠 Stress resistance
- 🧬 Acclimation speed
- ❤️‍🩹 Recovery efficiency

Example affix concepts:

- 💧 **Oasis**
- 🔥 **Insulated**
- ⚡ **Enduring**
- 🛏️ **Restful**
- 🧠 **Clear-Minded**
- 🫁 **Iron Lungs**
- 🧬 **Adaptable**
- 🪫 **Tireless**

Affixes modify capacities — never directly refill current hydration, erase current stress, or bypass the survival simulation. ⚖️

---

# ⚙️ EXTENSIVE TOML CONFIGURATION

Everything that materially affects gameplay is intended to be configurable. 🛠️

Configurable areas include:

- ✅ Entire module enable/disable switches
- ✅ Update intervals
- ✅ Loss and recovery rates
- ✅ Thresholds and penalties
- ✅ Curves and multipliers
- ✅ Synergy strength
- ✅ Difficulty presets
- ✅ Sleep and nap rules
- ✅ Multiplayer time behavior
- ✅ Phantom behavior
- ✅ Water quality
- ✅ Food classification
- ✅ Item weight
- ✅ Climate profiles
- ✅ Origin perks and maluses
- ✅ Acclimation speed
- ✅ Psychological intensity
- ✅ Attribute visibility
- ✅ Performance limits
- ✅ Death and respawn policies

Planned configuration families:

```text
immersive_ego-core.toml
immersive_ego-environment.toml
immersive_ego-physiology.toml
immersive_ego-sleep.toml
immersive_ego-nutrition.toml
immersive_ego-psychology.toml
immersive_ego-origins.toml
immersive_ego-encumbrance.toml
immersive_ego-synergies.toml
immersive_ego-apothic.toml
immersive_ego-performance.toml
```

Planned presets:

- 🌱 **CASUAL**
- 🧭 **IMMERSIVE**
- ☠️ **HARDCORE**
- 🛠️ **CUSTOM**

---

# 🧱 NO CONTENT BLOAT

Immersive EGO is a systems mod.

It is designed around:

- ✅ No custom blocks
- ✅ No custom machines
- ✅ No required custom items
- ✅ No Blockbench models
- ✅ No decorative content dependency
- ✅ Existing vanilla and modded equipment
- ✅ Data-driven behavior
- ✅ Server-authoritative calculations

The goal is deeper gameplay — not a larger creative inventory. 🎯

---

# 📦 DEPENDENCIES

## ✅ Required

- ⚔️ **Apothic Attributes**
- 🧩 **Placebo**
- 📚 **MariesLib**

## 🌟 Optional

- 🔥 **Apotheosis** — deep affix and equipment synergy

Matching **Minecraft 1.21.1 NeoForge** builds are required.

---

# 🔄 COMPATIBILITY PHILOSOPHY

Immersive EGO is designed as the authoritative owner of its survival statistics.

Installing another mod that independently adds the same mechanic may create duplicate systems, such as:

- two hydration bars;
- two temperature systems;
- two stamina systems;
- two nutrition models;
- two sanity systems.

Avoid overlapping survival mods unless an official compatibility profile is available. ⚠️

Future compatibility targets may include:

- 🧑‍🌾 Villagers
- 🏘️ Colonists
- 👨‍👩‍👧 MCA residents
- ⚔️ Companion NPCs
- 🏴 Biome factions
- ⭐ Reputation systems

---

# 🖥️ TECHNICAL TARGET

```text
🎮 Minecraft: 1.21.1
🧩 Loader: NeoForge
☕ Java: 21
📜 License: MIT
🆔 Mod ID: immersive_ego
```

---

# ⚖️ LICENSE & ATTRIBUTION

Immersive EGO is planned under the **MIT License**.

The project may adapt and unify compatible MIT-licensed concepts and code with full attribution and source-provenance documentation.

- ✅ Third-party notices will be preserved
- ✅ Source commits will be documented
- ✅ No restricted assets will be redistributed
- ✅ Apothic Attributes and Apotheosis assets remain inside their own installed mods
- ✅ Immersive EGO will use original branding and resources

---

# ❓ FAQ

### ❔ Does Immersive EGO add new items or blocks?

No. 🚫🧱
The project focuses on systems, attributes, configuration, and integration.

### ❔ Is Apotheosis required?

No. ✅
Apothic Attributes is required; Apotheosis is an optional deep integration.

### ❔ Will I see dozens of permanent bars?

No. 📊
The main statistical view is the Apothic Attributes page. Critical warnings can be contextual and configurable.

### ❔ Can I disable a system?

Yes. ⚙️
Every major module is intended to have independent configuration.

### ❔ Is this only for hardcore players?

No. 🌱
Presets are planned for casual, immersive, hardcore, and fully custom gameplay.

### ❔ Will NPCs use these systems?

That is planned for the future society expansion: colonists, MCA residents, professions, factions, and reputation. 🏘️👥

---

# 🧠 IMMERSIVE EGO

> **Survival is not a collection of bars. It is the relationship between body, mind, equipment, and world.** 🌍🧬⚔️

# 🙏✨ Immersive EGO — Group 1 Credits, Inspirations & Respectful Attribution

**Immersive EGO** is an original Minecraft mod project focused on immersive survival systems, body-state simulation, environmental pressure, psychology, identity, and configurable player adaptation. 🌍🧠💧🔥

The projects below are credited because they are:

- ✅ required runtime dependencies
- 🌟 optional runtime integrations
- 🧬 MIT/LGPL projects whose concepts, APIs, structure, or design philosophy helped inform **Group 1**
- 📚 references studied for compatibility, architecture, and safe original implementation

**Immersive EGO does not redistribute restricted assets, icons, textures, sounds, models, GUI resources, branding, or language files from any credited project.** 🛡️📜

---

## ✅⚙️ Required Runtime Dependencies

These mods/libraries are required for the intended Group 1 runtime stack.

Project	Author / Team	License	Role in Immersive EGO
[Apothic Attributes](https://www.curseforge.com/minecraft/mc-mods/apothic-attributes)	[Shadows_of_Fire](https://www.curseforge.com/members/shadows_of_fire/projects) / Stormraven Studios, LLC	[MIT](https://opensource.org/license/mit) code; assets All Rights Reserved	Core attribute framework, attribute GUI concepts, and modifier-display philosophy ⚔️📊
[Placebo](https://www.curseforge.com/minecraft/mc-mods/placebo)	Brennan Ward / [Shadows_of_Fire](https://www.curseforge.com/members/shadows_of_fire/projects)	[MIT](https://opensource.org/license/mit)	Required library dependency for [Apothic Attributes](https://www.curseforge.com/minecraft/mc-mods/apothic-attributes) 🧩
[MariesLib](https://modrinth.com/mod/marieslib)	[kgbcupcake](https://modrinth.com/user/kgbcupcake)	[LGPL-3.0-only](https://spdx.org/licenses/LGPL-3.0-only.html)	Shared value tracking, classification, memory, decay, diagnostics, and compatibility infrastructure 🧠📈🛠️

---

## 🌟🔌 Optional Runtime Integration

These projects are not mandatory for the base experience, but may unlock deeper synergy when installed.

Project	Author / Team	License	Role in Immersive EGO
[Apotheosis](https://www.curseforge.com/minecraft/mc-mods/apotheosis)	[Shadows_of_Fire](https://www.curseforge.com/members/shadows_of_fire/projects) / Stormraven Studios, LLC	[MIT](https://opensource.org/license/mit) code; assets All Rights Reserved	Optional affix, gem, and attribute synergy for EGO progression 💎⚔️✨

---

## 🧬📚 Group 1 Design / Code-Study Credits

These projects helped inform the design direction of **Immersive EGO Group 1**.
Credit does **not** imply asset reuse, direct redistribution, official affiliation, or endorsement. 🛡️

Project	Author / Team	License	Immersive EGO Module Inspired / Informed
[Thirst Was Taken](https://www.curseforge.com/minecraft/mc-mods/thirst-was-taken)	[ghen-git](https://github.com/ghen-git)	[MIT](https://opensource.org/license/mit)	Hydration, water purity, climate-related dehydration, and fluid survival pressure 💧🏜️
[Homeostatic](https://www.curseforge.com/minecraft/mc-mods/homeostatic)	[wendall911](https://www.curseforge.com/members/wendall911/projects)	[MIT](https://opensource.org/license/mit)	Body temperature, wetness, activity-linked thirst, and thermal stress logic 🌡️🔥❄️
[Homeostatic Seasons](https://www.curseforge.com/minecraft/mc-mods/homeostatic-seasons)	[wendall911](https://www.curseforge.com/members/wendall911/projects)	[MIT](https://opensource.org/license/mit)	Seasons, sub-seasons, weather pressure, and biome climate context 🍂🌧️🌨️
[Thick Air](https://modrinth.com/mod/thick-air)	[JpnRndr01](https://github.com/JpnRndr01); rewrite credited to [Leclowndu93150](https://github.com/Leclowndu93150); based on [Thin Air](https://modrinth.com/mod/thin-air) by [Fuzss](https://github.com/Fuzss)	[MIT](https://opensource.org/license/mit)	Altitude, depth, dimension-based respiratory pressure, and air-quality concepts 🫁⛰️🌌
[Nourished](https://modrinth.com/mod/nourished)	[kgbcupcake](https://modrinth.com/user/kgbcupcake)	[MIT](https://opensource.org/license/mit)	Nutrition groups, diet balance, gut health, food variety, and food-scanning concepts 🍎🥩🥕
[Sanity: Renewed](https://www.curseforge.com/minecraft/mc-mods/sanity-renewed)	[metal_knight53](https://www.curseforge.com/members/metal_knight53/projects) / [guivnf](https://github.com/guivnf); original concept by [croissantnova](https://github.com/croissantnova); credits also include [toujourspareil](https://twitter.com/toujourspareil) and [Desynq](https://github.com/Desynq)	[MIT](https://opensource.org/license/mit)	Stress stimuli, environmental psychology, fear pressure, and sanity-trigger concepts adapted into EGO psychology 🧠🌑👁️
[Origins](https://modrinth.com/mod/origins)	[apace100](https://github.com/apace100)	[MIT](https://opensource.org/license/mit)	Origin-style identity layer, player profile logic, and biome-origin design concepts 🧬🧍🌿
[Apoli](https://github.com/apace100/apoli)	[apace100](https://github.com/apace100)	[MIT](https://opensource.org/license/mit)	Data-driven powers, conditions, actions, and modifier systems adapted into biome-origin logic ⚡📜
[Stamina For Tweakers](https://www.curseforge.com/minecraft/mc-mods/stamina-for-tweakers)	[murphy-slaw](https://www.curseforge.com/members/murphy_slaw/projects)	[MIT](https://opensource.org/license/mit)	Activity-based stamina depletion, exertion cost, recovery modes, and configurable fatigue models 🏃💨
[Tired](https://www.curseforge.com/minecraft/mc-mods/tired)	[Mrbysco](https://www.curseforge.com/members/mrbysco/projects)	[MIT](https://opensource.org/license/mit)	Sleep timing, sleep schedule, configurable sleep-period concepts, and rest pressure 😴🌙
[You May Rest Now](https://www.curseforge.com/minecraft/mc-mods/you-may-rest-now)	[JamCoreModding](https://github.com/JamCoreModding) / [Jamalam](https://www.curseforge.com/members/jamalam360/projects)	[MIT](https://opensource.org/license/mit)	Sleep safety concepts based on whether nearby monsters can pathfind to the player 🛏️🧟‍♂️🛡️

---

## ⚠️🔍 Reviewed But Not Included in Group 1 Credits

These projects were discussed or reviewed during design, but they are **not currently treated as Group 1 source bases**.

Project / Concept	Current Decision
[Cold Sweat](https://www.curseforge.com/minecraft/mc-mods/cold-sweat)	Removed from Immersive EGO. No Cold Sweat dependency or code adaptation is planned. ❄️🚫
[Encumbered](https://modrinth.com/project/gmVuWKLX)	Not used as a Group 1 source. The verified Modrinth project is MPL-2.0 and Fabric-oriented rather than the MIT NeoForge 1.21.1 base required for this scope. EGO encumbrance will be original. 🎒⚖️
[Salt’s Animal Farm](https://modrinth.com/mod/salts-animal-farm)	Not included as a Group 1 source by current scope decision. EGO shelter and exposure systems will remain original unless this source is explicitly adopted later. 🐄🏠
[Train’s Tweaks](https://www.curseforge.com/minecraft/mc-mods/trains-tweaks) / `Zzz`	Not included as a Group 1 source by current scope decision. EGO sleep hooks will remain original except for concepts credited to [Tired](https://www.curseforge.com/minecraft/mc-mods/tired) and [You May Rest Now](https://www.curseforge.com/minecraft/mc-mods/you-may-rest-now). 🚂💤
[Body Health System](https://modrinth.com/mod/body-health-system)	Not included as a source base. Its localized body-part health, medical items, and treatment systems are broader than Group 1’s target scope. EGO pain and recovery systems will remain lightweight and original. 🩹🫀
[Survival Needs](https://modrinth.com/mod/survival-needs)	Not included. Hygiene, bladder, amusement, and social needs are outside Group 1. Social systems belong to the future society and colonist layer. 🚿🎭👥

---

## ⚖️🛡️ Asset Policy

**Immersive EGO does not copy or redistribute assets from credited projects.**

- **[Apothic Attributes](https://www.curseforge.com/minecraft/mc-mods/apothic-attributes)** and **[Apotheosis](https://www.curseforge.com/minecraft/mc-mods/apotheosis)** assets remain inside their respective installed mods. 💎🧩
- **Immersive EGO** will use original icons, textures, models, sounds, branding, GUI resources, and language files. 🎨🔧
- Any adaptation of **[MIT-licensed](https://opensource.org/license/mit)** code must preserve applicable copyright and license notices in `THIRD_PARTY_NOTICES.md`. 📜✅
- Any interaction with **[MariesLib](https://modrinth.com/mod/marieslib)** must respect its **[LGPL-3.0-only](https://spdx.org/licenses/LGPL-3.0-only.html)** license and keep **[MariesLib](https://modrinth.com/mod/marieslib)** as a separate dependency. 🧩⚖️
- No claim of official affiliation, endorsement, sponsorship, or partnership is made with any credited project, author, contributor, or team. 🚫🤝

---

## 🧾🙏 Suggested CurseForge Credit Text

Special thanks and credit to the mod authors whose work informed **Immersive EGO’s Group 1 design**:

---

## 📜 Final Attribution Notice

**Immersive EGO** is an independent, unofficial project. ⚙️🌍

All credited projects, authors, contributors, trademarks, assets, and original brands remain the property of their respective owners.
Credits are provided for transparency, respect, dependency clarity, license compliance, and design attribution. 🙏📚⚖️

**No official affiliation, endorsement, or partnership is implied.** 🚫🤝

Immersive EGO is an original project and does not redistribute assets from these mods.

Project / Concept	Current Decision
[Cold Sweat](https://www.curseforge.com/minecraft/mc-mods/cold-sweat)	Removed from Immersive EGO. No Cold Sweat dependency or code adaptation is planned. ❄️🚫
[Encumbered](https://modrinth.com/project/gmVuWKLX)	Not used as a Group 1 source. The verified Modrinth project is MPL-2.0 and Fabric-oriented rather than the MIT NeoForge 1.21.1 base required for this scope. EGO encumbrance will be original. 🎒⚖️
[Salt’s Animal Farm](https://modrinth.com/mod/salts-animal-farm)	Not included as a Group 1 source by current scope decision. EGO shelter and exposure systems will remain original unless this source is explicitly adopted later. 🐄🏠
[Train’s Tweaks](https://www.curseforge.com/minecraft/mc-mods/trains-tweaks) / `Zzz`	Not included as a Group 1 source by current scope decision. EGO sleep hooks will remain original except for concepts credited to [Tired](https://www.curseforge.com/minecraft/mc-mods/tired) and [You May Rest Now](https://www.curseforge.com/minecraft/mc-mods/you-may-rest-now). 🚂💤
[Body Health System](https://modrinth.com/mod/body-health-system)	Not included as a source base. Its localized body-part health, medical items, and treatment systems are broader than Group 1’s target scope. EGO pain and recovery systems will remain lightweight and original. 🩹🫀
[Survival Needs](https://modrinth.com/mod/survival-needs)	Not included. Hygiene, bladder, amusement, and social needs are outside Group 1. Social systems belong to the future society and colonist layer. 🚿🎭👥