https://github.com/banghuazhao/space-charge
A fast-paced, vertical platformer iOS game built with SpriteKit. Jump, dodge, and collect as you ascend through space!
https://github.com/banghuazhao/space-charge
admob app-store apple arcade casual-game cocoapods demo-app game-development indie-game ios localization mobile-game multilingual open-source physics platformer spritekit swift tilt-controls xcode
Last synced: 8 months ago
JSON representation
A fast-paced, vertical platformer iOS game built with SpriteKit. Jump, dodge, and collect as you ascend through space!
- Host: GitHub
- URL: https://github.com/banghuazhao/space-charge
- Owner: banghuazhao
- License: mit
- Created: 2025-07-14T07:29:42.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2025-07-14T08:41:18.000Z (8 months ago)
- Last Synced: 2025-07-14T11:30:47.856Z (8 months ago)
- Topics: admob, app-store, apple, arcade, casual-game, cocoapods, demo-app, game-development, indie-game, ios, localization, mobile-game, multilingual, open-source, physics, platformer, spritekit, swift, tilt-controls, xcode
- Language: Swift
- Homepage: https://apps.apple.com/us/app/space-jumper-squid-adventure/id1516635884
- Size: 16.9 MB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Space Charge
[](LICENSE)
[](https://developer.apple.com/ios/)
[](https://swift.org/)
A fast-paced, vertical platformer iOS game built with SpriteKit. Jump, dodge, and collect as you ascend through space!
[](https://apps.apple.com/us/app/space-jumper-squid-adventure/id1516635884)
## Table of Contents
- [Screenshots](#screenshots)
- [Features](#features)
- [Technical Details & Compatibility](#technical-details--compatibility)
- [Installation](#installation)
- [Dependencies](#dependencies)
- [License](#license)
- [Author](#author)
---
## Screenshots
---
## Features
- **Vertical Platformer Gameplay:** Jump from platform to platform, avoid hazards, and collect coins and power-ups.
- **Physics-based Movement:** Responsive controls using device tilt (CoreMotion) and smooth animations.
- **Multiple Game States:** Includes waiting, playing, and game over states.
- **Dynamic Obstacles:** Breakable platforms, lava, bombs, and more.
- **Score Tracking:** Real-time score and best score tracking with persistent storage.
- **Sound & Music:** Engaging sound effects and background music.
- **Ad Integration:** Google Mobile Ads for monetization.
- **Multilingual Support:** Localized for multiple languages using Localize-Swift.
---
## Technical Details & Compatibility
- **Architecture:**
- Built with [SpriteKit](https://developer.apple.com/spritekit/) for 2D game rendering and physics.
- Follows a Model-View-Controller (MVC) structure for scene and UI management.
- **Localization:**
- Supports English, Simplified Chinese, and Traditional Chinese via [Localize-Swift](https://github.com/malcommac/Localize-Swift).
- **Ad Integration:**
- Uses [Google Mobile Ads SDK](https://developers.google.com/admob/ios/download) for banner and interstitial ads.
- **Device Support:**
- Universal app: runs on iPhone and iPad.
- Portrait orientation only.
- **Deployment Target:**
- Minimum iOS version: **11.0**
- **Swift Version:**
- Written in **Swift 5.0**
- **Tested On:**
- iPhone 8, iPhone 12, iPad (simulators and real devices)
- Xcode 12 and above
- **Known Limitations:**
- No Android or macOS support.
- Requires device with accelerometer for optimal experience.
- Some features (ads, music) may require network or permissions.
---
## Installation
1. **Clone the repository:**
```bash
git clone https://github.com/banghuazhao/space-charge.git
cd space-charge
```
2. **Install dependencies:**
Ensure you have [CocoaPods](https://cocoapods.org/) installed, then run:
```bash
pod install
```
3. **Open the project:**
Open `Space Charge.xcworkspace` in Xcode.
4. **Build & Run:**
Select your target device or simulator and hit Run (▶️) in Xcode.
---
## Dependencies
- [SpriteKit](https://developer.apple.com/spritekit/) (Apple framework)
- [Google-Mobile-Ads-SDK](https://developers.google.com/admob/ios/download)
- [Localize-Swift](https://github.com/malcommac/Localize-Swift)
- [SnapKit](https://github.com/SnapKit/SnapKit)
- [Then](https://github.com/devxoul/Then)
- [SwiftyButton](https://github.com/TakefiveInteractive/SwiftyButton)
All dependencies are managed via CocoaPods (see `Podfile`).
---
## License
This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.
---
## Author
[Banghua Zhao](https://github.com/banghuazhao)