An acclaimed costume designer and software engineer wakes up from a blackout to an eerily familiar scene. But, something isn’t quite… right…. Traverse through a dream-like, constantly changing bedroom and office and get out as quickly as you can. Can you make it out and figure out what’s going on?
- 🕹 Works with Game Center: Challenge your friends and earn achievements!
- 🍎 Designed for macOS: Written completely in Swift, SpriteKit, and GameplayKit!
- ⚙️ Configurable: Customize keyboard shortcuts and other preferences with ease!
- 📖 Open source: Licensed under Mozilla Public License v2.0!
The primary objective of this project is to take the concepts from CS440: Principles of Artificial Intelligence and build a better understanding of agents and apply these concepts by implementing and comparing agents in a video game.
More information on the objective of this repository can be found in the design proposal.
|🟢||September 21, 2020||Working Game|
|❎||October 19, 2020||Adding Apple’s agents with GameplayKit*|
|🔴||November 9, 2020||Adding custom agents and beating Apple|
|🔴||November 16, 2020||Final presentation and cleanup|
Details on these milestones can be found on the Milestones page on GitHub.
*Due to the nature of the strategists with GameplayKit’s AIs, it is impossible to complete this milestone. Currently, the goal is to use Random Network Distillation to get the AI agent to make a move.
- Xcode 12.2* or higher
- macOS 10.15.6 (Catalina) or higher
- KeyboardShortcuts (added when cloning)
- GBMKUtils (added when cloning)
- (Optional, but recommended) SwiftLint
- Clone the Xcode project and ensure that dependencies are install with the Swift Package Manager.
- In the project settings, change the bundle identifier to your own bundle identifier (See Game Center, In-App Purchases).
- Run the Game scheme to build the project in Xcode.
To make a release version, click on the destination (“My Mac”) and select “Any Mac (Apple Silicon, Intel)”, then go to Product › Archive.
*The release version of Xcode 12.0 and the GM seed are not compatible with this project due to the macOS 11 SDK not being present. To build with Xcode 12.0, you will need to comment out code for GKAccessPoint and GKLeaderboards.
The Costumemaster integrates with Game Center to allow players to earn achievements, challenge others, and rank in the leaderboards for the best scores on levels (scoring system similar to what AI agents use). Game Center is a service that requires an Apple Developer account and an app registered in App Store Connect with the bundle identifier of the game. To test Game Center achievements, make sure that you update the build identifier in the project to the app’s identifier in App Store Connect and make sure that the achievements with the IDs listed in GameAchievements.swift in the Achievements list of the Game Center section.
To access features like the new access point and leaderboard submission, ensure that Xcode includes at least the macOS 11.0 SDK.
The Costumemaster also integrates with StoreKit to provide in-app purchase support for DLC content such as “Watch Your Step!”. In-app purchases require an Apple Developer account with an app registered in App Store Connect with the bundle identifier of the game. In-app purchases will need to be configured with the IDs listed in IAPManager.PurchaseableContent in App Store Connect.
This project includes support for SwiftLint, a utility that enforces recommended Swift styling practices. While it is not required to install SwiftLint to build the project, it is highly recommended. The project, during build, will do the following with SwiftLint:
- Resolve any quick, auto-correctable fixes with
- Run the linter on all source files and present warnings/errors in Xcode after running.
The following practices are also being implemented with SwiftLint:
- Lines should be no longer than 120 characters long, similar to PEP8 standards with Python.
- Function body length will be ignored.
- Bodies for types should not exceed 400 lines (warnings issued at 250 lines).
- Files should not exceed 1000 lines (warnings issued at 500 lines).
- When possible, avoid making a filtered list and iterating over it; use the
for x in x where yformat instead.
Documentation is handled by Jazzy, a documentation generator provided by Realm. Follow the instructions to build the documentation:
bundle installto install the dependencies needed. In some cases, you may need to set parameters for installing sqlite3 or for installing the Xcode Command Line Tools.
docs_build.shto build the docs.
© 2020 Marquis Kurt. All rights reserved. Game Center, the Game Center logo, SF Symbols, and macOS are registered trademarks of Apple Inc. Music written by Kai Engel.