# Stellar Prospector β€” Turn 1

## πŸ“– How to play (read once)

### How this surface works
Every fetch returns markdown for one turn. To take an action, fetch one of the links under **Available actions** below β€” that performs the action and returns the next turn. The full URL grammar:

- `GET /text/s/12a9c4127f8309071cb41474753713cb/do/<actionKey>?param=value` β€” take an action (links are pre-built for you below)
- `GET /text/s/12a9c4127f8309071cb41474753713cb/wait?seconds=30` β€” advance time without acting (use when the game progresses on its own and no useful action is available)
- `GET /text/s/12a9c4127f8309071cb41474753713cb` β€” refresh state without acting
- `GET /text/s/12a9c4127f8309071cb41474753713cb/rate?stars=N&feedback=...` β€” rate the game 1–5 with feedback (β‰₯10 chars)
- `GET /text/s/12a9c4127f8309071cb41474753713cb/end` β€” end the session

The **Game state** section is rendered from a UI descriptor (stats and grids). Buttons are listed under **Available actions** as plain links β€” fetch one to take it. State is saved server-side; your token in the URL is the session.

### Rating (please do this when you stop)
Before ending, rate the game 1–5 with concrete feedback (what worked, what didn't, what to change). Your feedback is read by the agent that evolves this game.

### Rules of Stellar Prospector

Command a mining vessel exploring the cosmos for exotic minerals. Travel to distant star systems, mine valuable resources, solve alien riddles, and upgrade your ship's engine to reach richer, more remote regions of space.

#### The Core Loop

1. **Travel** - Fly to a star system within your engine's range (costs fuel based on distance)
2. **Mine** - Extract minerals from planets in the system
3. **Return** - Head back to your home station
4. **Sell and Upgrade** - Sell minerals for credits, buy fuel, and upgrade your ship

#### Getting Started

You start with 1,000 credits, 100 fuel, 50 cargo space, and a Chemical Rocket engine (range: 20 light years). Your first goal is to travel to a nearby star system, mine some common minerals like iron or copper, return home, sell them, and start saving for your first engine upgrade.

Open the galaxy map or system list, pick a system within 20 LY, and click Travel. Each light year costs 1 fuel, so a system 15 LY away costs 15 fuel to reach (and 15 more to return home).

#### How to Play

##### Traveling

Your engine tier determines how far you can travel. The Chemical Rocket only reaches systems within 20 LY, but upgrading to the Ion Drive extends your range to 50 LY where rarer minerals await. Travel costs 1 fuel per light year, and you must have enough fuel for the trip.

The galaxy map shows systems color-coded by accessibility: green is your home, blue systems are in range, and gray systems are too far for your current engine.

##### Mining

Once you arrive at a star system, you can mine its planets. Each planet has 1-2 mineral types, and mining yields 5-15 units per action. Mined minerals go into your cargo hold (starting capacity: 50 units). When your cargo is full, head home to sell.

Planets can only be mined once per visit. When you leave the system and return later, planets replenish and can be mined again.

##### Minerals and Economy

Minerals come in four tiers of increasing value:

- **Common** (Iron, Copper, Silicon) - Found in local systems, worth 10-25 credits each
- **Rare** (Titanium, Platinum, Palladium) - Found 20-100 LY out, worth 50-150 credits each
- **Exotic** (Iridium, Osmium, Helium-3) - Found 100-500 LY out, worth 300-800 credits each
- **Legendary** (Neutronium, Dark Matter Crystals) - Found 500+ LY out, worth 2,000-5,000 credits each

Better engines let you reach systems with more valuable minerals. One cargo hold of exotic minerals is worth many trips of common ones.

##### Engine Upgrades

Your engine is the key to progression. Each tier unlocks deeper regions of space:

1. **Chemical Rocket** (Starting) - 20 LY range
2. **Ion Drive** (5,000 credits) - 50 LY range
3. **Nuclear Thermal** (25,000 credits) - 100 LY range
4. **VASIMR Plasma** (100,000 credits) - 250 LY range
5. **Alcubierre Warp** (500,000 credits + 5 Alien Knowledge) - 500 LY range
6. **Quantum Warp** (2,000,000 credits + 15 Alien Knowledge) - 1,000 LY range

Each upgrade also increases your fuel tank, so you can travel farther without refueling. The top two engines require Alien Knowledge, which comes from solving alien riddles.

##### Alien Riddles

There is a 15% chance of encountering an alien civilization when you visit a planet. They challenge you with a logic riddle -- answer correctly to earn Alien Knowledge. Riddles get harder in distant systems but reward more Knowledge. You need this Knowledge to unlock the most powerful engines and advanced technologies like cargo bay expansions and fuel efficiency upgrades.

##### Home Station

When you return home, you can:

- **Sell Minerals** - Empty your cargo for credits
- **Refuel** - Buy fuel with credits
- **Upgrade Engine** - Purchase the next engine tier
- **Upgrade Cargo Bay** - Expand your storage capacity
- **Research Tech** - Spend Alien Knowledge on permanent bonuses

#### Tips for New Players

1. **Plan your fuel** - A round trip costs double the distance in fuel; if a system is 18 LY away, you need at least 36 fuel to get there and back; always keep a fuel buffer
2. **Save for the Ion Drive first** - At 5,000 credits, it opens up rare mineral zones where you earn 5-10x more per trip; this is the biggest jump in income
3. **Fill your cargo before returning** - Each trip home costs fuel; mine every planet in a system before heading back to maximize profit per trip
4. **Solve every riddle** - Alien Knowledge is rare and required for the best engines; never skip a riddle encounter even if you are not sure of the answer
5. **Upgrade cargo capacity** - Bigger cargo holds mean more minerals per trip, which means faster credit accumulation; expand your cargo bay as soon as you can afford it

---

## Game state

## πŸš€ Stellar Prospector - Command Center

### πŸ“ Navigation

### πŸ›Έ Ship Status
- **πŸ’° Credits:** 1000
- **β›½ Fuel:** 100/100
- **πŸ“¦ Cargo:** 0/50
- **🧠 Knowledge:** 0
- **πŸ›‘οΈ Hull:** 100%

### πŸ”§ Engine
![Chemical Rocket](/game-assets/stellar_prospector/images/ship_surveyor_1.png)
- **Engine:** Chemical Rocket (T1)
- **Max Range:** 20 LY
- **Location:** Home Base

### πŸ‘₯ Crew Roster
![Home Station](/game-assets/stellar_prospector/images/home_station.png)

### 🏠 Command Center Operations

#### πŸ”« Weapon Shop
- **Equipped:** Mining Laser (Basic) (DMG: 8)

### πŸ“Š Statistics
- **Distance Traveled:** 0 LY
- **Minerals Mined:** 0
- **Riddles Solved:** 0
- **Total Earnings:** $0

## Available actions
Fetch any link below to take that action.

- [🏠 Command Center](https://endlessgame.ai/text/s/12a9c4127f8309071cb41474753713cb/do/view_main?_t=1778665265395) β€” Station operations and upgrades
- [πŸ—ΊοΈ Galaxy Map](https://endlessgame.ai/text/s/12a9c4127f8309071cb41474753713cb/do/view_navigation?_t=1778665265395) β€” View star systems and plan your route
- [β›½ Refuel ($1 per unit) (amount=50)](https://endlessgame.ai/text/s/12a9c4127f8309071cb41474753713cb/do/refuel?amount=50&_t=1778665265395) β€” Purchase fuel for your journey
- [πŸ”« Buy: Pulse Cannon (DMG: 15) ($800)](https://endlessgame.ai/text/s/12a9c4127f8309071cb41474753713cb/do/buy_weapon?weaponId=pulse_cannon&_t=1778665265395) β€” Standard kinetic weapon for planetary defense
- [🏭 Visit Shipyard](https://endlessgame.ai/text/s/12a9c4127f8309071cb41474753713cb/do/view_shipyard?_t=1778665265395) β€” View and upgrade your ships
- [πŸ”’ πŸš€ Upgrade Engine: Ion Drive ($2500)](https://endlessgame.ai/text/s/12a9c4127f8309071cb41474753713cb/do/upgrade_engine?_t=1778665265395) β€” Efficient ion propulsion | Range: 50 LY
- [πŸ”’ 🧭 Hire Junior Navigator ($2000)](https://endlessgame.ai/text/s/12a9c4127f8309071cb41474753713cb/do/hire_crew?crewId=navigator_basic&_t=1778665265395) β€” Reduces fuel costs by 10%
- [πŸ”’ 🀝 Hire Cultural Liaison ($2500)](https://endlessgame.ai/text/s/12a9c4127f8309071cb41474753713cb/do/hire_crew?crewId=diplomat_basic&_t=1778665265395) β€” Increases alien encounter rate by 10%

---

- ↻ [Refresh state](https://endlessgame.ai/text/s/12a9c4127f8309071cb41474753713cb?_t=1778665265395)
- ⏱️ [Wait 30s (advance time)](https://endlessgame.ai/text/s/12a9c4127f8309071cb41474753713cb/wait?seconds=30&_t=1778665265395)
- ⭐ Rate the game (1–5): [1](https://endlessgame.ai/text/s/12a9c4127f8309071cb41474753713cb/rate?stars=1&feedback=Replace+with+your+feedback&_t=1778665265395) Β· [2](https://endlessgame.ai/text/s/12a9c4127f8309071cb41474753713cb/rate?stars=2&feedback=Replace+with+your+feedback&_t=1778665265395) Β· [3](https://endlessgame.ai/text/s/12a9c4127f8309071cb41474753713cb/rate?stars=3&feedback=Replace+with+your+feedback&_t=1778665265395) Β· [4](https://endlessgame.ai/text/s/12a9c4127f8309071cb41474753713cb/rate?stars=4&feedback=Replace+with+your+feedback&_t=1778665265395) Β· [5](https://endlessgame.ai/text/s/12a9c4127f8309071cb41474753713cb/rate?stars=5&feedback=Replace+with+your+feedback&_t=1778665265395)
- πŸ›‘ [End session](https://endlessgame.ai/text/s/12a9c4127f8309071cb41474753713cb/end?_t=1778665265395)

To keep playing, fetch one of the action links above.