https://github.com/eleev/15-puzzle

🧩 iOS game - classic 15 Puzzle game [Swift + SpriteKit].
https://github.com/eleev/15-puzzle

game gameplaykit ios spritekit swift

Last synced: 3 months ago
JSON representation

🧩 iOS game - classic 15 Puzzle game [Swift + SpriteKit].

• Host: GitHub
• URL: https://github.com/eleev/15-puzzle
• Owner: eleev
• License: mit
• Created: 2019-02-15T14:35:56.000Z (over 6 years ago)
• Default Branch: master
• Last Pushed: 2020-06-04T15:13:10.000Z (over 5 years ago)
• Last Synced: 2025-05-12T17:12:07.808Z (5 months ago)
• Topics: game, gameplaykit, ios, spritekit, swift
• Language: Swift
• Homepage:
• Size: 15.7 MB
• Stars: 22
• Watchers: 2
• Forks: 2
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# 15-puzzle [![Awesome](https://cdn.rawgit.com/sindresorhus/awesome/d7305f38d29fed78fa85652e3a63e154dd8e8829/media/badge.svg)](https://github.com/sindresorhus/awesome)

[![Language](https://img.shields.io/badge/language-Swift_5.0-orange.svg)]()

[![Framework](https://img.shields.io/badge/framework-SpriteKit-red.svg)]()

[![License](https://img.shields.io/badge/license-MIT-blue.svg)]()

**Last Update: 06/April/2019.**

![](logo-15_puzzle.png)

### If you like the project, please give it a star ⭐ It will show the creator your appreciation and help others to discover the repo.

# ✍️ About

🧩 Classic 15 Puzzle game for iOS.

# 📺 Demo 

Please wait while the `.gif` files are loading...

 

# 🕹 Controls

- **Swipe** anywhere to move the cells

- **Tap** ↶ button to shuffle the cells

- When you solve the puzzle, you will see the corresponding overlay dialog

- When time exceeds (01:00:00 / 1 hour) or the number of moves will reach it's maximum (10.000) the game will be over

# 👻 Features

- [x] Supports both `iPhone` & `iPad`

- [x] Moves counter

- [x] Timer

- [x] Solution validator

- [x] Rendering backend implemented on top of `SpriteKit`

- [x] Shuffling

- [x] Haptic Feedback for supported devices

- [x] Minimal supported `iOS` deployment target is `11.0`

# ⏱ Futher Improvements / Current Limitations

- [ ] Only **portrait** mode 

- [ ] Game **timer** works even when the app is in background (for a while). Ideally it needs to be paused/resumed when entering/resuming the app

- [ ] Missing **unit tests** coverage, despite the possibility to test most of the code

- [ ] Ideally, the in-game state needs to be modelled by **state machines** (`playing`, `shuffling`, `game over` and `puzzle solved` states, and when **solver** is implemented a new state for `solving` needs to be modelled as well)

- [ ] Missing **solver**: can be implemented by using `A*` or `BFS` algorithms. Since it's an `NP-complete` algorithm, it needs to be carefully designed and tested (performance implications)

- [ ] Add **macOS** target

# 👨‍💻 Author 

[Astemir Eleev](https://github.com/jVirus)

# 🔖 Licence

The project is available under the [MIT licence](https://github.com/jVirus/ios-15-puzzle/blob/master/LICENSE)

The project uses assets from [kenney.nl](https://kenney.nl) under [CC0 1.0 Universal (CC0 1.0)

Public Domain Dedication licence](https://creativecommons.org/publicdomain/zero/1.0/)