303 lines
6.2 KiB
Markdown
303 lines
6.2 KiB
Markdown
# AeThex Tutorials
|
|
|
|
Step-by-step guides to master AeThex Engine features.
|
|
|
|
---
|
|
|
|
## Getting Started
|
|
|
|
### [Your First Game - Multiplayer Pong](FIRST_GAME_TUTORIAL.md) ⭐ START HERE
|
|
**Time:** 30 minutes | **Difficulty:** Beginner
|
|
Build real-time multiplayer Pong with cloud saves. Learn the basics of AeThex's killer features.
|
|
|
|
**What you'll learn:**
|
|
- 3-line multiplayer setup
|
|
- Cloud save integration
|
|
- Room codes for easy matchmaking
|
|
- Studio IDE workflow
|
|
|
|
---
|
|
|
|
## Tutorial Series
|
|
|
|
### Game Basics
|
|
|
|
#### 1. Single-Player Platformer (Coming Soon)
|
|
**Time:** 45 minutes | **Difficulty:** Beginner
|
|
Classic platformer with jumping, enemies, and checkpoints.
|
|
|
|
**Features:**
|
|
- Player movement & physics
|
|
- Enemy AI
|
|
- Local saves
|
|
- Scene management
|
|
|
|
#### 2. Top-Down Shooter (Coming Soon)
|
|
**Time:** 60 minutes | **Difficulty:** Intermediate
|
|
Action shooter with shooting mechanics and waves.
|
|
|
|
**Features:**
|
|
- Shooting & aiming
|
|
- Wave spawner system
|
|
- Health & damage
|
|
- Score tracking
|
|
|
|
---
|
|
|
|
### Multiplayer Games
|
|
|
|
#### 3. Co-op Dungeon Crawler (Coming Soon)
|
|
**Time:** 90 minutes | **Difficulty:** Intermediate
|
|
2-4 player dungeon exploration with loot and combat.
|
|
|
|
**Features:**
|
|
- Room-based multiplayer
|
|
- Player synchronization
|
|
- Shared progression
|
|
- Combat mechanics
|
|
|
|
#### 4. Battle Royale Basics (Coming Soon)
|
|
**Time:** 120 minutes | **Difficulty:** Advanced
|
|
Create a mini battle royale with shrinking zones.
|
|
|
|
**Features:**
|
|
- Large player counts
|
|
- Zone mechanics
|
|
- Loot spawning
|
|
- Elimination tracking
|
|
|
|
---
|
|
|
|
### Cloud Features
|
|
|
|
#### 5. User Authentication System (Coming Soon)
|
|
**Time:** 30 minutes | **Difficulty:** Beginner
|
|
Add email, guest, and OAuth login to your game.
|
|
|
|
**Features:**
|
|
- Email/password auth
|
|
- Guest accounts
|
|
- Google OAuth
|
|
- User profiles
|
|
|
|
#### 6. Cloud Saves & Cross-Platform Play (Coming Soon)
|
|
**Time:** 45 minutes | **Difficulty:** Intermediate
|
|
Build a game that syncs progress across devices.
|
|
|
|
**Features:**
|
|
- Save/load system
|
|
- Conflict resolution
|
|
- Auto-save
|
|
- Cross-device play
|
|
|
|
#### 7. Leaderboards & Rankings (Coming Soon)
|
|
**Time:** 30 minutes | **Difficulty:** Beginner
|
|
Global and friend leaderboards for competitive games.
|
|
|
|
**Features:**
|
|
- Score submission
|
|
- Global rankings
|
|
- Friend filters
|
|
- Time periods (daily/weekly/all-time)
|
|
|
|
---
|
|
|
|
### AI Integration
|
|
|
|
#### 8. In-Game AI Assistant (Coming Soon)
|
|
**Time:** 45 minutes | **Difficulty:** Intermediate
|
|
Add an AI helper that gives hints and generates content.
|
|
|
|
**Features:**
|
|
- Context-aware hints
|
|
- Code generation
|
|
- NPC dialogue generation
|
|
- Quest suggestions
|
|
|
|
#### 9. AI-Powered NPCs (Coming Soon)
|
|
**Time:** 60 minutes | **Difficulty:** Advanced
|
|
Create NPCs with dynamic dialogue using AI.
|
|
|
|
**Features:**
|
|
- Procedural dialogue
|
|
- Personality systems
|
|
- Context awareness
|
|
- Quest generation
|
|
|
|
---
|
|
|
|
### Analytics & Monetization
|
|
|
|
#### 10. Player Analytics (Coming Soon)
|
|
**Time:** 30 minutes | **Difficulty:** Beginner
|
|
Track player behavior and optimize your game.
|
|
|
|
**Features:**
|
|
- Event tracking
|
|
- Funnels
|
|
- Retention metrics
|
|
- Custom properties
|
|
|
|
#### 11. In-App Purchases (Coming Soon)
|
|
**Time:** 45 minutes | **Difficulty:** Intermediate
|
|
Monetize with cosmetics and power-ups.
|
|
|
|
**Features:**
|
|
- Item shop
|
|
- Purchase flow
|
|
- Receipt validation
|
|
- Inventory system
|
|
|
|
---
|
|
|
|
### Studio & Workflow
|
|
|
|
#### 12. Studio IDE Advanced Features (Coming Soon)
|
|
**Time:** 30 minutes | **Difficulty:** Intermediate
|
|
Master the Studio IDE for faster development.
|
|
|
|
**Features:**
|
|
- Live reload
|
|
- Remote debugging
|
|
- Collaboration tools
|
|
- Asset hot-swapping
|
|
|
|
#### 13. Continuous Deployment (Coming Soon)
|
|
**Time:** 45 minutes | **Difficulty:** Advanced
|
|
Auto-deploy to Steam, itch.io, and mobile stores.
|
|
|
|
**Features:**
|
|
- Build pipelines
|
|
- Multi-platform exports
|
|
- Version management
|
|
- Automated testing
|
|
|
|
---
|
|
|
|
## Tutorial Structure
|
|
|
|
Each tutorial follows this format:
|
|
|
|
1. **Prerequisites** - What you need to know
|
|
2. **Setup** - Project initialization
|
|
3. **Core Mechanics** - Build the game
|
|
4. **AeThex Features** - Add cloud/multiplayer/AI
|
|
5. **Polish** - Effects, UI, audio
|
|
6. **Testing** - Play and debug
|
|
7. **Next Steps** - How to expand
|
|
|
|
**Time estimates** include:
|
|
- Following along typing code
|
|
- Testing at checkpoints
|
|
- Basic debugging
|
|
|
|
---
|
|
|
|
## Quick Reference
|
|
|
|
### By Difficulty
|
|
|
|
**Beginner:**
|
|
- Multiplayer Pong ✅
|
|
- Single-Player Platformer
|
|
- User Authentication
|
|
- Player Analytics
|
|
|
|
**Intermediate:**
|
|
- Top-Down Shooter
|
|
- Co-op Dungeon Crawler
|
|
- Cloud Saves
|
|
- In-Game AI Assistant
|
|
- In-App Purchases
|
|
- Studio IDE Features
|
|
|
|
**Advanced:**
|
|
- Battle Royale Basics
|
|
- AI-Powered NPCs
|
|
- Continuous Deployment
|
|
|
|
### By Time
|
|
|
|
**Under 30 min:**
|
|
- Multiplayer Pong (30 min) ✅
|
|
|
|
**30-60 min:**
|
|
- Single-Player Platformer (45 min)
|
|
- User Authentication (30 min)
|
|
- Cloud Saves (45 min)
|
|
- Leaderboards (30 min)
|
|
- In-Game AI Assistant (45 min)
|
|
- Player Analytics (30 min)
|
|
- Studio IDE (30 min)
|
|
|
|
**60+ min:**
|
|
- Top-Down Shooter (60 min)
|
|
- Co-op Dungeon Crawler (90 min)
|
|
- Battle Royale (120 min)
|
|
- AI-Powered NPCs (60 min)
|
|
- In-App Purchases (45 min)
|
|
- Continuous Deployment (45 min)
|
|
|
|
### By Feature
|
|
|
|
**Multiplayer:**
|
|
- Multiplayer Pong ✅
|
|
- Co-op Dungeon Crawler
|
|
- Battle Royale Basics
|
|
|
|
**Cloud Services:**
|
|
- User Authentication
|
|
- Cloud Saves
|
|
- Leaderboards
|
|
- Player Analytics
|
|
|
|
**AI:**
|
|
- In-Game AI Assistant
|
|
- AI-Powered NPCs
|
|
|
|
**Monetization:**
|
|
- In-App Purchases
|
|
|
|
**Workflow:**
|
|
- Studio IDE Features
|
|
- Continuous Deployment
|
|
|
|
---
|
|
|
|
## Contributing Tutorials
|
|
|
|
Want to write a tutorial? See [CONTRIBUTING.md](../../engine/CONTRIBUTING.md) for guidelines.
|
|
|
|
**Tutorial checklist:**
|
|
- ✅ Clear learning objectives
|
|
- ✅ Time estimate (tested)
|
|
- ✅ Prerequisites listed
|
|
- ✅ Working code samples
|
|
- ✅ Troubleshooting section
|
|
- ✅ Next steps suggestions
|
|
|
|
---
|
|
|
|
## Getting Help
|
|
|
|
**Stuck on a tutorial?**
|
|
- Check the [API Reference](../API_REFERENCE.md)
|
|
- Review [GDScript Basics](../GDSCRIPT_BASICS.md)
|
|
- Ask in [Discord](https://discord.gg/aethex)
|
|
- Search [docs.aethex.io](https://docs.aethex.io)
|
|
|
|
**Found a bug in tutorial?**
|
|
- Report on [GitHub Issues](https://github.com/aethex/engine/issues)
|
|
- Include tutorial name and step number
|
|
|
|
---
|
|
|
|
## Next Steps
|
|
|
|
After completing tutorials:
|
|
- Read [Architecture Overview](../ARCHITECTURE_OVERVIEW.md) *(coming soon)*
|
|
- Explore [Advanced Topics](../ADVANCED_TOPICS.md) *(coming soon)*
|
|
- Build your own game!
|
|
- Share in the [Community Showcase](https://aethex.io/showcase)
|
|
|
|
Happy building! 🚀
|