AppleHillsProduction/docs/airplane_abilities_unity_quickstart.md

Airplane Abilities - Unity Setup Quick Reference

⚡ Fast setup guide for in-engine configuration

---

🎯 7 Steps to Complete Setup

1️⃣ CREATE ABILITIES (3 assets)

Project Window → Right-Click → Create → AppleHills → Airplane → Abilities

Asset	Name	Cooldown	Key Values
Jet	JetAbility	5s	Speed: 15, Angle: 0
Bobbing	BobbingAbility	3s	Jump: 10, Speed Reduction: 0.7
Drop	DropAbility	4s	Force: 20, Distance: 5

✅ Assign icon sprites to each

---

2️⃣ CREATE AIRPLANE TYPES (3 assets)

Project Window → Right-Click → Create → AppleHills → Airplane → Airplane Type

Type	Name	Display Name	Ability
Jet	JetPlaneType	"Jet Plane"	JetAbility
Bobbing	BobbingPlaneType	"Bobbing Plane"	BobbingAbility
Drop	DropPlaneType	"Drop Plane"	DropAbility

✅ Assign prefabs and preview sprites

---

3️⃣ BUILD SELECTION UI

Hierarchy Path: Canvas/AirplaneSelectionPanel

AirplaneSelectionPanel (+ AirplaneSelectionUI component)
├── TitleText ("Choose Your Airplane")
├── JetPlaneButton
├── BobbingPlaneButton
├── DropPlaneButton
└── ConfirmButton

Component Setup:

• Assign 3 button references
• Assign 3 airplane type assets
• Selected Color: Yellow
• Normal Color: White
• ✅ Start inactive

---

4️⃣ BUILD ABILITY BUTTON

Hierarchy Path: Canvas/GameplayUI/AbilityButton

AbilityButton (+ AirplaneAbilityButton component)
├── Background (Image)
├── AbilityIcon (Image - dynamic)
├── CooldownFill (Image - Radial 360)
└── CooldownText (TextMeshPro - optional)

Component Setup:

• Assign Button, Icon, Fill, Text
• Ready: White, Cooldown: Gray, Active: Yellow
• ✅ Start inactive

---

5️⃣ WIRE GAME MANAGER

GameObject: AirplaneGameManager

New References:

• Selection UI → AirplaneSelectionPanel
• Ability Button → AbilityButton

✅ Verify existing references still assigned

---

6️⃣ UPDATE SETTINGS

Asset: AirplaneSettings (existing)

New Field:

• Default Airplane Type → Assign JetPlaneType

---

7️⃣ TEST IN PLAY MODE

Quick Test:

1. ▶️ Play
2. Selection UI appears
3. Click airplane → Confirm
4. Airplane spawns at slingshot
5. Launch and use ability
6. Button shows cooldown

✅ If all works, you're done!

---

🎨 UI LAYOUT TIPS

Selection Panel Position:

• Center screen
• Width: 80% of screen
• Background: Semi-transparent dark
• Buttons: Horizontal layout, equal spacing

Ability Button Position:

• Bottom-right corner
• Size: 80x80 pixels
• Margin: 20px from edges
• Z-order: On top of everything

---

⚡ FAST TESTING

Test Jet (Hold):

1. Launch airplane
2. Click and hold ability button
3. Airplane flies straight
4. Release → Stops

Test Bobbing (Tap):

1. Launch airplane
2. Tap ability button
3. Airplane jumps up
4. Wait for cooldown
5. Tap again

Test Drop (Tap):

1. Launch airplane
2. Tap ability button
3. Airplane drops down
4. Stops after distance

---

🐛 COMMON ISSUES

Problem	Fix
Selection UI doesn't show	Check it's assigned in GameManager
Button doesn't appear	Check airplane has ability assigned
Hold doesn't work	Check InputManager exists in scene
Airplane doesn't spawn	Check TypeData has prefab assigned
Cooldown doesn't show	Check Fill image is assigned and Radial 360

---

📱 MOBILE TESTING

1. Build to device
2. Test touch hold (Jet ability)
3. Test tap (Bobbing/Drop)
4. Verify button size is thumb-friendly
5. Check cooldown is visible

---

✅ COMPLETE CHECKLIST

Settings:

• Configured all 3 airplane types in settings
• Assigned all prefabs and sprites
• Set default airplane type

UI:

• Built selection UI panel
• Built ability button UI
• Assigned button references (NO type assets!)
• Assigned GameManager references

Testing:

• Selection UI appears and works
• Tested Jet ability (hold)
• Tested Bobbing ability (tap)
• Tested Drop ability (tap)
• All cooldowns work
• No console errors

When all checked → Ship it! 🚀

---

🎉 ADVANTAGES

✅ NO ScriptableObject assets to create!
✅ Everything in one settings file
✅ Faster setup (3 steps vs 7)
✅ Easier to maintain
✅ Collapsible Inspector sections
✅ Runtime ability creation from config