CosmicFrontier

Cosmic Frontier* is a portrait-orientation space shooting (STG) casual mobile game. Players pilot a星际 starfighter through the cosmos, fending off wave after wave of alien invaders. The game features both **Chapter Mode** and **Endless Mode**, along with a rich arsenal of weapon upgrades, power-ups, and progression systems designed for quick, on-the-go sessions.

---

## 2. Game Modes

### 2.1 Chapter Mode
- 4 chapters are currently available (Chapter 5 and beyond are not yet open).
- Each chapter consists of multiple enemy waves.
- Clear a chapter to unlock the next one.
- The final wave of each chapter is a Boss fight — defeat the Boss to complete the chapter.
- Chapters cleared beyond wave 5 allow you to use the **Wave Skip** feature to jump directly to a previously cleared wave.

### 2.2 Endless Mode
- **Unlock condition**: Clear Chapter 2.
- **Daily limit**: 2 attempts per day.
- Enemies and obstacles are randomly generated in infinite waves with escalating difficulty.
- A Boss appears every 10 waves (3 Boss tiers, progressively stronger).
- Enemy level increases by +15 per wave; Boss level increases by +8 per wave.
- Experience gain gradually decreases (from 100% down to 15%) as waves progress.

---

## 3. Controls

- **Movement**: Touch and drag anywhere on the screen — your starfighter follows your finger.
- **Attacking**: Automatic firing — no manual shooting required.
- **Pause**: Tap the pause button on the HUD to pause the game.
- **Revive**: When defeated, you may:
- Instantly revive by spending 10 gems.
- Revive by watching a 30-second video ad.
- Decline revival and end the run.

---

## 4. Ship System

### 4.1 Main Weapon (Primary Ship)
- Starts at level 1; can be upgraded in ATK, HP, critical rate, and more.
- Special attributes can be unlocked: bullet penetration, bullet tracking, extended bullet duration, and bullet ricochet.

### 4.2 Deputy Weapon (Wingmen)
- Two wingmen (left and right) follow the main ship and fire automatically.
- Each can be upgraded in **ATK level** and **Firepower level**.
- Firepower level improves attack speed and bullet count.
- New deputy weapons are unlocked by clearing chapters.

### 4.3 Support Units
- Summoned auxiliary units that inherit the main ship's HP and ATK.
- Automatically revived at the start of each wave.

---

## 5. Power-Up System (29 Types)

Defeated enemies drop various power-ups. Collect them for temporary bonuses:

| Category | Items | Effect |
|----------|-------|--------|
| Collection | EXP orb | Gain experience points |
| Recovery | HP restore, HP regen | Restore health |
| Stat Boost | ATK up (big/small), ATK speed up (big/small), HP max up, crit chance up, crit damage up, life leech | Temporarily boost combat stats |
| Bullet Mode | Spread, straight, oblique, gatling | Change bullet firing pattern |
| Special | Shield, resurgence (auto-revive on death), bloodlust (heal on kill), burn (damage over time), instant kill, frenzy, weapon strengthen, remould, debris spread, and more | Various special combat effects |

---

## 6. Combat Attributes

| Attribute | Description |
|-----------|-------------|
| HP | Current health; game over when it reaches zero |
| HP Max | Maximum health cap |
| ATK | Damage dealt per attack |
| Attack Interval | Attack frequency; lower is faster |
| Move Speed | Ship movement speed |
| Crit Chance | Probability of landing a critical hit |
| Crit Damage | Bonus damage multiplier on critical hits |
| Leech Chance | Probability of restoring HP on attack |
| Leech Amount | HP restored per leech proc |
| Bullet Count | Number of bullets fired per attack |
| Bullet Pierce | Bullets can penetrate multiple enemies |
| Bullet Tracking | Bullets automatically home in on enemies |
| Bullet Ricochet | Bullets bounce off targets after impact |

---