{"id":36954658,"url":"https://github.com/thatfactory/alma","last_synced_at":"2026-01-13T13:00:54.076Z","repository":{"id":88897421,"uuid":"366502350","full_name":"thatfactory/alma","owner":"thatfactory","description":"The ALMA Game Engine 👾","archived":false,"fork":false,"pushed_at":"2025-12-08T12:26:54.000Z","size":433,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-12-10T13:04:07.649Z","etag":null,"topics":["apple-ecosystem","game-development","game-engine","games"],"latest_commit_sha":null,"homepage":"","language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/thatfactory.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2021-05-11T20:15:41.000Z","updated_at":"2025-12-08T12:26:57.000Z","dependencies_parsed_at":"2025-12-10T13:04:12.109Z","dependency_job_id":null,"html_url":"https://github.com/thatfactory/alma","commit_stats":null,"previous_names":["thatfactory/alma"],"tags_count":7,"template":false,"template_full_name":null,"purl":"pkg:github/thatfactory/alma","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thatfactory%2Falma","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thatfactory%2Falma/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thatfactory%2Falma/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thatfactory%2Falma/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/thatfactory","download_url":"https://codeload.github.com/thatfactory/alma/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thatfactory%2Falma/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28385798,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-13T12:01:30.995Z","status":"ssl_error","status_checked_at":"2026-01-13T12:00:09.625Z","response_time":56,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["apple-ecosystem","game-development","game-engine","games"],"created_at":"2026-01-13T13:00:24.949Z","updated_at":"2026-01-13T13:00:54.052Z","avatar_url":"https://github.com/thatfactory.png","language":"Swift","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![swift-version](https://img.shields.io/badge/swift-6.2-ea7a50.svg?logo=swift\u0026logoColor=white)](https://developer.apple.com/swift/)\n[![xcode-version](https://img.shields.io/badge/xcode-26.2-50ace8.svg?logo=xcode\u0026logoColor=white)](https://developer.apple.com/xcode/)\n[![spm-ready](https://img.shields.io/badge/spm-ready-b68f6a.svg?logo=gitlfs\u0026logoColor=white)](https://developer.apple.com/documentation/xcode/swift-packages)\n[![platforms](https://img.shields.io/badge/platforms-iOS%20%7C%20iPadOS%20%7C%20macOS%20%7C%20Mac%20Catalyst%20%7C%20tvOS%20%7C%20visionOS-lightgrey.svg?logo=apple\u0026logoColor=white)](https://en.wikipedia.org/wiki/List_of_Apple_operating_systems)\n[![license](https://img.shields.io/badge/license-MIT-67ac5b.svg?logo=googledocs\u0026logoColor=white)](https://en.wikipedia.org/wiki/MIT_License)\n[![release](https://github.com/thatfactory/alma/actions/workflows/release.yml/badge.svg)](https://github.com/thatfactory/alma/actions/workflows/release.yml)\n\n# ALMA 👾\n## Goal\nTo help developers in creating games for the Apple ecosystem without having to rewrite the core elements.\n\n### Vision\nThe image below illustrates the project's high-level vision.  \nWhile specific details may evolve over time, the core concept will remain.\n\n```mermaid\n---\nconfig:\n  class:\n    hideEmptyMembersBox: true\n  look: classic\n  theme: base\n---\nclassDiagram\ndirection TB\n\tnamespace CoreSystems {\n        class World {\n\t        Day/Night\n\t        Snow/Rain\n\t        Biomes/Vegetation\n\t        Physics\n        }\n\n        class Input {\n\t        Controllers\n\t        Touch\n\t        Voice\n        }\n\n        class Behavior {\n\t        Characters\n\t        NPCs\n\t        Bosses\n\t        AI\n        }\n\n        class Progress {\n\t        Save management\n\t        Achievements\n\t        Leaderboards\n\t        XP\n        }\n\n        class Sound {\n        }\n\n        class Utilities {\n        }\n\n        class StateMachine {\n        }\n\n\t}\n\tnamespace SupportingSystems {\n        class GCOverseer {\n\t        GameControllerObserver\n        }\n\n        class VirtualPad {\n\t        VirtualGameController\n        }\n\n        class SpeechRecognizer {\n\t        ProvidesSpeechRecognition\n        }\n\n        class GKProxy {\n\t        AppleGameKitWrapper\n        }\n\n        class AppLogger {\n\t        AppleLoggerWrapper\n        }\n\n        class CSKScene {\n\t        AppleSKSceneWrapper\n        }\n\n        class Device {\n\t        ProvidesDeviceInfo\n        }\n\n        class PermissionChecker {\n\t        ManagesPermissions\n        }\n\n        class CGKStateMachine {\n\t        AppleGKStateWrapper\n        }\n\n\t}\n    class `Game 🎮` {\n    }\n\n    class ALMA {\n    }\n\n    `Game 🎮` --\u003e ALMA\n    ALMA --\u003e World\n    ALMA --\u003e Input\n    ALMA --\u003e Behavior\n    ALMA --\u003e Progress\n    ALMA --\u003e Sound\n    ALMA --\u003e Utilities\n    ALMA --\u003e StateMachine\n    Input --\u003e GCOverseer\n    Input --\u003e VirtualPad\n    Input --\u003e SpeechRecognizer\n    Progress --\u003e GKProxy\n    Utilities --\u003e AppLogger\n    Utilities --\u003e CSKScene\n    Utilities --\u003e Device\n    Utilities --\u003e PermissionChecker\n    StateMachine --\u003e CGKStateMachine\n\n    class `Game 🎮`:::White\n\tclass ALMA:::Yellow\n\tclass World:::Rose\n\tclass Input:::Sky\n\tclass Behavior:::Peach\n\tclass Progress:::Ash\n\tclass Sound:::Laranja\n\tclass Utilities:::Green\n\tclass StateMachine:::Blue\n\tclass GCOverseer:::Sky\n\tclass VirtualPad:::Sky\n\tclass SpeechRecognizer:::Sky\n\tclass GKProxy:::Ash\n\tclass AppLogger:::Green\n\tclass CSKScene:::Green\n\tclass Device:::Green\n\tclass PermissionChecker:::Green\n\tclass CGKStateMachine:::Blue\n\t\n\n\tclassDef White :,stroke:#000000,fill:#FFF9C4,color:#000000,stroke:#000000,fill:#FFF9C4,color:#000000,stroke:#000000,fill:#FFF9C4,color:#000000,stroke:#000000,fill:#FFF9C4,color:#000000,stroke:#000000,fill:#FFF9C4,color:#000000,stroke:#000000,fill:#FFF9C4,color:#000000,stroke:#000000,fill:#FFF9C4,color:#000000,stroke:#000000,fill:#FFF9C4,color:#000000,fill:#FFFFFF,color:#000000,fill:#FFFFFF,color:#000000,stroke:#000000,fill:#FFFFFF,color:#000000\n\tclassDef Yellow :,fill:#FFF9C4,color:#000000,fill:#FFF9C4,color:#000000,fill:#FFF9C4,color:#000000,fill:#FFF9C4,color:#000000,fill:#FFF9C4,color:#000000\n\tclassDef Rose :,stroke-width:1px,stroke-dasharray:none,stroke:#FF5978,fill:#FFDFE5,color:#8E2236\n\tclassDef Sky :,stroke-width:1px,stroke-dasharray:none,stroke:#374D7C,fill:#E2EBFF,color:#374D7C,stroke-width:1px,stroke-dasharray:none,stroke:#374D7C,fill:#E2EBFF,color:#374D7C,stroke-width:1px,stroke-dasharray:none,stroke:#374D7C,fill:#E2EBFF,color:#374D7C,stroke-width:1px,stroke-dasharray:none,stroke:#374D7C,fill:#E2EBFF,color:#374D7C\n\tclassDef Peach :,stroke-width:1px,stroke-dasharray:none,stroke:#FBB35A,fill:#FFEFDB,color:#8F632D\n\tclassDef Ash :,stroke-width:1px,stroke-dasharray:none,stroke:#999999,fill:#EEEEEE,color:#000000,stroke-width:1px,stroke-dasharray:none,stroke:#999999,fill:#EEEEEE,color:#000000\n\tclassDef Laranja :,fill:#FFE0B2,stroke:transparent,color:#000000,fill:#FFE0B2,stroke:transparent,color:#000000\n\tclassDef Pine :,stroke-width:1px,stroke-dasharray:none,stroke:#254336,fill:#27654A,color:#FFFFFF,stroke-width:1px,stroke-dasharray:none,stroke:#254336,fill:#27654A,color:#FFFFFF,stroke-width:1px,stroke-dasharray:none,stroke:#254336,fill:#27654A,color:#FFFFFF,stroke-width:1px,stroke-dasharray:none,stroke:#254336,fill:#27654A,color:#FFFFFF,stroke-width:1px,stroke-dasharray:none,stroke:#254336,fill:#27654A,color:#FFFFFF\n\tclassDef Blue :,fill:#BBDEFB,color:#000000,stroke:#2962FF,fill:#BBDEFB,color:#000000,stroke:#2962FF,fill:#BBDEFB,color:#000000,stroke:#2962FF,fill:#BBDEFB,color:#000000,stroke:#2962FF,fill:#BBDEFB,color:#000000,stroke:#2962FF,fill:#BBDEFB,color:#000000,stroke:#2962FF,fill:#BBDEFB,color:#000000,stroke:#2962FF,fill:#BBDEFB,color:#000000,stroke:#2962FF\n\tclassDef Green :,stroke:#000000,fill:#C8E6C9,color:#000000,stroke:#000000,fill:#C8E6C9,color:#000000\n```\n\n### Current Relationships\nHere's a snapshot of the current implementation, which lacks any interfaces for interaction (at the time being):\n\n```mermaid\n---\nconfig:\n  class:\n    hideEmptyMembersBox: true\n  look: classic\n  theme: base\n---\nclassDiagram\ndirection TB\n\tnamespace CoreSystems {\n        class Input {\n        } \n        class Utilities {\n        }\n        class StateMachine {\n        }\n\t}\n\tnamespace SupportingSystems {\n        class GCOverseer {\n        }\n        class AppLogger {\n        }\n        class CSKScene {\n        }\n        class Device { \n        }\n        class CGKStateMachine {\n        }\n\t}\n\n    class ALMA {\n    }\n\n    ALMA --\u003e Input\n    ALMA --\u003e Utilities\n    ALMA --\u003e StateMachine\n    Input --\u003e GCOverseer\n    Utilities --\u003e AppLogger\n    Utilities --\u003e CSKScene\n    Utilities --\u003e Device\n    StateMachine --\u003e CGKStateMachine\n\n\tclass ALMA:::Yellow\n\tclass Input:::Sky\n\tclass Utilities:::Green\n\tclass StateMachine:::Blue\n\tclass GCOverseer:::Sky\n\tclass AppLogger:::Green\n\tclass CSKScene:::Green\n\tclass Device:::Green\n\tclass CGKStateMachine:::Blue\n\n\tclassDef White :,stroke:#000000,fill:#FFF9C4,color:#000000,stroke:#000000,fill:#FFF9C4,color:#000000,stroke:#000000,fill:#FFF9C4,color:#000000,stroke:#000000,fill:#FFF9C4,color:#000000,stroke:#000000,fill:#FFF9C4,color:#000000,stroke:#000000,fill:#FFF9C4,color:#000000,stroke:#000000,fill:#FFF9C4,color:#000000,stroke:#000000,fill:#FFF9C4,color:#000000,fill:#FFFFFF,color:#000000,fill:#FFFFFF,color:#000000,stroke:#000000,fill:#FFFFFF,color:#000000\n\tclassDef Yellow :,fill:#FFF9C4,color:#000000,fill:#FFF9C4,color:#000000,fill:#FFF9C4,color:#000000,fill:#FFF9C4,color:#000000,fill:#FFF9C4,color:#000000\n\tclassDef Rose :,stroke-width:1px,stroke-dasharray:none,stroke:#FF5978,fill:#FFDFE5,color:#8E2236\n\tclassDef Sky :,stroke-width:1px,stroke-dasharray:none,stroke:#374D7C,fill:#E2EBFF,color:#374D7C,stroke-width:1px,stroke-dasharray:none,stroke:#374D7C,fill:#E2EBFF,color:#374D7C,stroke-width:1px,stroke-dasharray:none,stroke:#374D7C,fill:#E2EBFF,color:#374D7C,stroke-width:1px,stroke-dasharray:none,stroke:#374D7C,fill:#E2EBFF,color:#374D7C\n\tclassDef Peach :,stroke-width:1px,stroke-dasharray:none,stroke:#FBB35A,fill:#FFEFDB,color:#8F632D\n\tclassDef Ash :,stroke-width:1px,stroke-dasharray:none,stroke:#999999,fill:#EEEEEE,color:#000000,stroke-width:1px,stroke-dasharray:none,stroke:#999999,fill:#EEEEEE,color:#000000\n\tclassDef Laranja :,fill:#FFE0B2,stroke:transparent,color:#000000,fill:#FFE0B2,stroke:transparent,color:#000000\n\tclassDef Pine :,stroke-width:1px,stroke-dasharray:none,stroke:#254336,fill:#27654A,color:#FFFFFF,stroke-width:1px,stroke-dasharray:none,stroke:#254336,fill:#27654A,color:#FFFFFF,stroke-width:1px,stroke-dasharray:none,stroke:#254336,fill:#27654A,color:#FFFFFF,stroke-width:1px,stroke-dasharray:none,stroke:#254336,fill:#27654A,color:#FFFFFF,stroke-width:1px,stroke-dasharray:none,stroke:#254336,fill:#27654A,color:#FFFFFF\n\tclassDef Blue :,fill:#BBDEFB,color:#000000,stroke:#2962FF,fill:#BBDEFB,color:#000000,stroke:#2962FF,fill:#BBDEFB,color:#000000,stroke:#2962FF,fill:#BBDEFB,color:#000000,stroke:#2962FF,fill:#BBDEFB,color:#000000,stroke:#2962FF,fill:#BBDEFB,color:#000000,stroke:#2962FF,fill:#BBDEFB,color:#000000,stroke:#2962FF,fill:#BBDEFB,color:#000000,stroke:#2962FF\n\tclassDef Green :,stroke:#000000,fill:#C8E6C9,color:#000000,stroke:#000000,fill:#C8E6C9,color:#000000\n```\n\n## Integration\n### Xcode\nUse Xcode's [built-in support for SPM](https://developer.apple.com/documentation/xcode/adding_package_dependencies_to_your_app).\n\n*or...*\n\n### Package.swift\nIn your `Package.swift`, add `ALMA` as a dependency:\n```swift\ndependencies: [\n    .package(\n        url: \"https://github.com/thatfactory/alma\",\n        from: \"0.1.0\"\n    )\n]\n```\n\nAssociate the dependency with your target:\n```swift\ntargets: [\n    .target(\n        name: \"YourTarget\",\n        dependencies: [\n            .product(\n                name: \"ALMA\",\n                package: \"alma\"\n            )\n        ]\n    )\n]\n```\n\nRun: `swift build`\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthatfactory%2Falma","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fthatfactory%2Falma","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthatfactory%2Falma/lists"}