# ⭐ Starbound Ruins  
### A Celestial Adventure Mod for Minecraft

**Starbound Ruins** is a large-scale adventure and exploration mod where ancient structures from a forgotten cosmic civilization begin crashing into the Overworld.  
Fragments of starships, floating ruins, astral dungeons and dimensional anomalies slowly reshape the world, inviting players into a mysterious journey across the universe’s past.

Uncover the fate of the **Starbound**, harness their lost technology, and face the beings awakened by their return.

---

## 📥 Installation

Installing **Starbound Ruins** is extremely simple:

1. **Download the installer file**  

2. **Run the .msi**  
The installer automatically:
- Creates a new **Starbound Ruins** version inside your Minecraft directory  
- Installs all mod files and dependencies  
- Configures everything so you don't need to touch your folders manually

3. **Open your Minecraft launcher**  
(Works on Prism, PolyMC, MultiMC, GDLauncher, or the official launcher)

4. Select the profile/version:
Starbound Ruins

5. Click **Play** and enjoy the adventure.

No additional setup required.

---

## 🌌 Lore Overview

Long before the first villagers walked the Overworld, an ancient galactic race known only as the **Starbound** ruled countless worlds.  
When their empire collapsed, massive fragments of their cities and warships were scattered through space — lost for millennia.

Now, these ruins are falling back into the Minecraft world.

Celestial machines reactivate.  
Astral creatures emerge from dormant stasis.  
Rifts open to forgotten micro-dimensions.  
And you… are the first living being to step inside these ruins in thousands of years.

Your goal is not only to survive — but to understand what truly happened to the Starbound civilization.

---

## ✨ Features

### 🌠 Skyfallen Ruins  
Procedurally generated celestial structures drop throughout the world.  
Each ruin contains:
- Randomized layouts  
- Traps and puzzles  
- Lore tablets  
- Unique Starbound technology  
- Mini-boss encounters

### 🌟 Star Rifts  
Hidden rifts warp you to micro-dimensions filled with:
- Gravity-shifted arenas  
- Cosmic storms  
- Astral fauna  
- Exotic materials and special loot

Each rift is unique every time you enter.

### 🪐 Cosmic Affinity System  
Collect **Star Essence** to unlock abilities such as:
- Low-gravity leaps  
- Mid-air dashes  
- Astral shield bursts  
- Void step (short-range teleport)

Every ability affects combat, mobility, and exploration.

### 👾 New Mobs  
Encounter cosmic entities awakened by the falling ruins:
- **Nebula Wisp** — floats through walls, drops spectral powder  
- **Celestial Guardian** — heavy melee unit protecting shrines  
- **Gravity Beast** — manipulates gravity wells around players  
- **Starlit Seer** — ranged caster using astral projectiles

### 🛡️ New Gear & Tools  
Craft equipment infused with star energy:
- **Starforged Blades** — deal bonus damage when airborne  
- **Cosmic Pickaxe** — breaks clusters of stone instantly  
- **Gravity Armor** — reduces fall damage, grants mid-air float  
- **Astral Staff** — casts small gravitational fields

### 👑 Boss Fights  
Face multi-phase bosses such as:
- **The Riftbound Colossus**  
- **Astral Devourer**  
- **The Celestial Sovereign**

Defeating a boss permanently increases your Affinity tier.

---

## 🚀 Why Play Starbound Ruins?

- Built for **adventurers**, **explorers** and **lore enjoyers**  
- Rich atmosphere and worldbuilding  
- Unique reward curve and progression  
- Replayable dungeons and rifts  
- No grindy systems — everything is meaningful  
- Works with most exploration-focused modpacks  

This is a mod for players who want **mystery**, **challenge**, and a sense of discovering a world larger than Minecraft itself.

---

## 🧰 Requirements

- Minecraft 1.20+  
- Java 17+  
- 4GB RAM (recommended 6GB+)  
- Any compatible launcher

---

## 🛠️ Support & Issues

If you find bugs, feel free to open an issue or send feedback.  
Your suggestions help make the mod better.

---

## 🔒 License

Starbound Ruins is provided for personal and experimental use only.  
Redistribution or commercial use without permission is prohibited.

---

**Prepare to explore the galaxies lost to time.**