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 |

---