Sky Lock Assault

A top-down online web browser game built with Godot 4.5

Combat airplane web game with fuel management, multiple weapons, multi-level, and adjustable difficulty.

This is a dedicated Godot v4.5 game dev project on Windows 10 64-bit OS. We'll be learning game dev here, starting with a simple main menu and expanding to core mechanics like player controls, enemy AI, and assaults in the sky. The repo is open-source at SkyLockAssault.

You can play this game on Itch.io

Project Overview

• Godot Version: 4.5 stable (or compatible).
• OS: Windows 10 64-bit.
• Tools:
  • Docker Desktop v4.45 for local testing
  • GitHub Desktop v3.5 for repo management
  • PyCharm 2024.1.7 (Community Edition) for file editing
  • Windows PowerShell for running Docker commands
• Goal: Build a playable top-down shooter with web deployment in mind—export to HTML5/Web, test locally, deploy to itch.io.

Game Assets

• Empire State Font
• Pixel Planes Assets Pack
• Assets Free Laser Bullets Pack 2020
• Csaba Felvegi aka "chabull" free assets collection, see here
• Pixabay: royalty free stock

• Music:
  • Battle Epic by Hot_Dope
  • Retro laser 1 by Driken5482

Documentation

1. Guide to Implementing Versioning
2. Godot v4.5 Docs
3. Development Guide
4. Local CI Pipeline for Godot Project using Docker
5. Docker Local Test Server
6. Setup Instructions
7. Signing Setup for GitHub Desktop
8. BOTS:
   • Dependabot
   • Snyk
   • Sourcery AI
   • IMGBOT
   • Release Drafter
   • Close Stale Issues and PRs
   • AllContributors GitHub App

Roadmap

Here's a high-level plan for upcoming features. Contributions welcome!

• v0.2: Completed Foundations - Project import, Docker local testing, basic input actions, top-down movement, main menu, quit handling for browser, HTML5 export and testing, GitHub Actions CI/CD to Itch.io (complete).
• v0.3: Expansion - Add levels, weapons, player feedback integration.
• v0.4: Post-MVP Refinements - Performance optimization, audio polish, bug fixes.
• v0.5: Ongoing Development - Feedback gathering, minor updates, release tagging.
• Future: Multiplayer elements, AI enemies, mobile export (post-launch based on community input).

Contributing

Pull requests welcome for mechanics like enemy AI, levels, or web optimizations! Fork the repo and submit your ideas. See CONTRIBUTING for guidelines (create if needed).

Player Feedback

We value your input to improve Sky Lock Assault! Share your thoughts via:

• Itch.io Comments – Discuss gameplay, bugs, or suggestions directly on the game's page.

Security

For details on reporting vulnerabilities and our disclosure process, see SECURITY.md.

Play Instructions

• In Godot Editor: Open the project > Press F5 to run the main scene (main_menu.tscn). Use keyboard/mouse for navigation.
• Local Web Testing: After exporting to HTML5 (see Setup), cd to infra/ in PowerShell > docker compose up -d > Open http://localhost:9090 in browser. Click "Run game" iframe; use fullscreen for immersion (ignore desktop console warnings).
• Online on itch.io:
  1. Visit ikostan.itch.io/sky-lock-assault
  2. Click "Run game".
• The game supports browser play; mobile-friendly with landscape orientation.

For learning: Test quit handling (platform-specific) and log levels in options menu during play.

Current features

• Main menu scene with buttons (Start, Resume, Options, Quit).
• Placeholder game level for future mechanics and game testing.
• Options menu with log level settings, accessible from main and pause menus.
• Pause menu with buttons (Main Menu, Options, Resume).
• Player scene with CharacterBody2D, ShaderBody, CollisionShape, and FuelTimer.
• Fade-in animations for main menu UI panels.
• Fuel system including fuel level progress bar.
• Basic weapon system.
• Difficulty settings.
• Game controls input remapping.
• Fuel management (timer-based depletion only).
• Basic adjustable difficulty (affects fire rate and fuel depletion only).
• Basic sound effects & background music.
• Airplane Rotor Sound (Stereo SFX) + Rotor Animation
• Audio Buses & Panning (L/R Split)
• Options Menu: Rotors Volume Slider
• Multi-Thread support enabled

Features Roadmap

• Current:
  • Main menu with Start/Resume/Options/Quit;
  • placeholder game level;
  • fade-in animations;
  • web export/testing with Docker.
  • itch.io CI/CD integration.
• Planned:
  • Fuel management (timer-based depletion/refuel);
  • multiple weapons (guns/missiles with switching);
  • multi-level progression;
  • adjustable difficulty (enemy spawn rates);
  • enemy AI (pathing/assaults); scoring/HUD.
  • Scrolling Background to Main Scene for Flying Over Terrain.
• Future Milestones:
  • Mobile exports,
  • audio,
  • particle effects,

Track progress via Milestones.

Known Issues

• Harmless console warning on desktop fullscreen (NotSupportedError for orientation lock—ignored as non-fatal; doesn't affect gameplay).
• Placeholder level lacks mechanics—work in progress.
• Report new issues on GitHub.

How to Contribute

• Fork the repo and create a branch for your changes.
• Follow GDScript best practices; test in editor and web export.
• Open a Pull Request with details.
• See CONTRIBUTING.md for full guidelines.
• Join the Discussions: Chat about ideas, ask questions on web exports, or suggest features at GitHub Discussions.

Contributors