nova64 0.2.4 → 0.2.6

package/dist/examples/strider-demo-3d/fix-game.sh

@@ -0,0 +1,53 @@
+#!/bin/bash
+# Fix the Shadow Ninja 3D game
+
+echo "🔧 Fixing Shadow Ninja 3D Platformer..."
+echo ""
+
+# Navigate to game directory
+cd "$(dirname "$0")"
+
+# Backup old code
+if [ -f "code.js" ]; then
+    echo "📦 Backing up old code.js to code-old.js..."
+    cp code.js code-old.js
+fi
+
+# Replace with fixed version
+if [ -f "code-fixed.js" ]; then
+    echo "✅ Installing fixed version..."
+    cp code-fixed.js code.js
+    echo "   ✓ Game code updated!"
+else
+    echo "❌ Error: code-fixed.js not found!"
+    exit 1
+fi
+
+# Create models directory
+echo ""
+echo "📁 Setting up models directory..."
+mkdir -p ../../../public/models
+echo "   ✓ Created /public/models/"
+
+echo ""
+echo "🎮 Game fixed successfully!"
+echo ""
+echo "📝 Next steps:"
+echo "   1. Refresh your browser"
+echo "   2. Test the game - it should work properly now!"
+echo "   3. (Optional) Download GLB models from:"
+echo "      - https://poly.pizza"
+echo "      - https://kenney.nl/assets"
+echo "      - http://quaternius.com/assets.html"
+echo "   4. Place models in public/models/ folder"
+echo "   5. Enable USE_GLB_MODELS in code.js"
+echo ""
+echo "🎯 The game now has:"
+echo "   ✓ Proper collision detection"
+echo "   ✓ Coyote time (150ms grace period)"
+echo "   ✓ Jump buffering (100ms window)"
+echo "   ✓ Progressive level design"
+echo "   ✓ Clear visual feedback"
+echo "   ✓ Smooth camera following"
+echo ""
+echo "Happy gaming! 🎮"

package/dist/examples/super-plumber-64/README.md

@@ -0,0 +1,128 @@
+# 🍄 SUPER PLUMBER 64
+
+A Super Mario 64 inspired 3D platformer for Nova64!
+
+## 🎮 Features
+
+### Mario-Like Mechanics
+
+- **Triple Jump System** - Jump three times in quick succession for higher jumps
+- **Ground Pound** - Press Down + Jump in mid-air for a powerful slam
+- **Smooth Movement** - Analog stick support with camera-relative controls
+- **3D Platforming** - Navigate colorful floating platforms
+
+### Collectibles
+
+- **Coins** (Yellow) - Spinning gold coins worth 10 points each (15 total)
+- **Stars** (Orange) - Bobbing power stars worth 100 points each (3 total)
+
+### Level Design
+
+- 11 interconnected platforms at various heights
+- Multiple paths to explore
+- High platform requires skilled jumping
+- Hidden areas with extra collectibles
+
+## 🕹️ Controls
+
+### Keyboard
+
+- **Arrow Keys** or **WASD** - Move
+- **Space** or **Z** - Jump
+- **Down + Jump** (in air) - Ground Pound
+- **Q** / **E** - Rotate Camera
+
+### Gamepad
+
+- **Left Stick** - Move (analog)
+- **A Button** - Jump
+- **Right Stick** - Rotate Camera
+- **D-pad Down + A** (in air) - Ground Pound
+
+## 🎯 Objectives
+
+1. **Collect all 15 Coins** - Explore every platform
+2. **Collect all 3 Stars** - Find the hidden power stars
+3. **Master the triple jump** - Reach the highest platforms
+
+## 🌟 Special Moves
+
+### Triple Jump
+
+1. **First Jump** - Normal height
+2. **Second Jump** - Higher (press jump again quickly)
+3. **Third Jump** - HIGHEST! (press jump one more time)
+
+_Tip: You have 0.5 seconds between jumps to maintain the combo!_
+
+### Ground Pound
+
+1. Jump into the air
+2. Press **Down + Jump** together
+3. Slam down at high speed
+4. Bounce on landing
+
+_Tip: Great for reaching lower platforms quickly!_
+
+## 🏆 Scoring
+
+- Each Coin: **10 points**
+- Each Star: **100 points**
+- Maximum Score: **450 points** (150 from coins + 300 from stars)
+
+## 🎨 Visual Features
+
+- **Bloom Effects** - Shiny collectibles glow
+- **Colorful Platforms** - Each platform has unique colors
+- **Smooth Animations** - Coins spin, stars bob
+- **Sky & Fog** - Beautiful sky gradient with atmospheric fog
+- **3rd Person Camera** - Follows player smoothly
+
+## 🚀 Technical
+
+- **Resolution**: 640×360 (Nintendo 64 style)
+- **Frame Rate**: 60 FPS target
+- **Physics**: Custom gravity and collision system
+- **Camera**: 3rd person with manual rotation
+- **Respawn**: Fall off? You'll respawn at spawn!
+
+## 🎬 Getting Started
+
+1. Open `index.html` in a modern browser
+2. Use arrow keys to move around
+3. Press Space to jump
+4. Jump quickly 3 times for a triple jump!
+5. Collect all coins and stars
+
+## 🐛 Known Features
+
+- Platforms are simple boxes (retro aesthetic!)
+- No enemies (pure platforming challenge)
+- Camera can be manually rotated with Q/E
+- Fall detection respawns you at start
+
+## 💡 Tips
+
+1. **Practice triple jumping** - It's essential for high platforms
+2. **Use ground pound** - Helps you land precisely
+3. **Explore everywhere** - Coins are on all paths
+4. **Rotate camera** - Find the best viewing angle
+5. **The highest star** requires a running triple jump from a nearby platform
+
+## 🎮 Inspired By
+
+- **Super Mario 64** - Movement mechanics, triple jump
+- **Banjo-Kazooie** - Collectible hunting
+- **Crash Bandicoot** - Platform layout
+
+## 📝 Credits
+
+Built with **Nova64 Fantasy Console**
+
+- 3D Graphics: Three.js backend
+- Post-Processing: Bloom effects
+- Input: Keyboard + Gamepad support
+
+---
+
+**Now get out there and collect those stars! 🌟**