{"id":30732410,"url":"https://github.com/pskinnertech/runnar","last_synced_at":"2026-02-10T21:31:39.085Z","repository":{"id":305256611,"uuid":"1021120089","full_name":"PSkinnerTech/RunnAR","owner":"PSkinnerTech","description":"A multiplayer AR running game - a Gauntlet AI project","archived":false,"fork":false,"pushed_at":"2025-07-19T01:58:01.000Z","size":29719,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-09-03T17:11:24.966Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Objective-C++","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/PSkinnerTech.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}},"created_at":"2025-07-16T23:20:46.000Z","updated_at":"2025-07-19T01:58:04.000Z","dependencies_parsed_at":"2025-07-19T06:51:40.744Z","dependency_job_id":null,"html_url":"https://github.com/PSkinnerTech/RunnAR","commit_stats":null,"previous_names":["pskinnertech/runnar"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/PSkinnerTech/RunnAR","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PSkinnerTech%2FRunnAR","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PSkinnerTech%2FRunnAR/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PSkinnerTech%2FRunnAR/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PSkinnerTech%2FRunnAR/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/PSkinnerTech","download_url":"https://codeload.github.com/PSkinnerTech/RunnAR/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PSkinnerTech%2FRunnAR/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29317955,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-10T20:44:44.282Z","status":"ssl_error","status_checked_at":"2026-02-10T20:44:43.393Z","response_time":65,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: 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":[],"created_at":"2025-09-03T17:06:30.984Z","updated_at":"2026-02-10T21:31:39.077Z","avatar_url":"https://github.com/PSkinnerTech.png","language":"Objective-C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"# RunnAR - AR Orienteering Runner Game\n\nAn immersive AR orienteering challenge that combines JROTC-inspired navigation principles with cutting-edge augmented reality technology. Navigate to control points using digital compass and mini-map tools in real-world outdoor environments.\n\n![Unity](https://img.shields.io/badge/Unity-2022.3%20LTS-blue)\n![ARKit](https://img.shields.io/badge/ARKit-6.0+-green)\n![Platform](https://img.shields.io/badge/Platform-iOS-lightgrey)\n![License](https://img.shields.io/badge/License-MIT-yellow)\n\n## Overview\n\nRunnAR transforms outdoor spaces into competitive orienteering courses using augmented reality. Players navigate to virtual control points using only compass bearings and terrain awareness—no GPS breadcrumbs—encouraging real navigation skills like those taught in JROTC programs.\n\n### Key Features\n\n- **Real-World AR Navigation**: 5 persistent control points spawned in football field-sized areas\n- **Authentic Tools**: Digital compass and mini-map HUD (no direct GPS paths)\n- **Competitive Timing**: Beat personal bests with ghost replay system\n- **Physical Gameplay**: Encourages real movement and terrain awareness\n- **Multiplayer Ready**: 1v1 recapture mode planned (MVP is single-player)\n- **Cross-Platform**: iPhone 15 Pro Max MVP, XREAL One port planned\n\n## Game Mechanics\n\n### Single-Player MVP Mode\n- Navigate to 5 AR control points using compass and map\n- Collect any 3 out of 5 points to win\n- Beat your personal best times\n- Ghost replay shows your optimal path\n- Escalating difficulty (distance and terrain complexity)\n\n### Planned 1v1 Mode\n- Shared AR sessions via Lightship\n- Tug-of-war recapture mechanics\n- First to control 3/5 points wins\n- Strategic positioning and route planning\n\n### JROTC-Inspired Elements\n- Sequential navigation to control points\n- Timed events with penalties for errors\n- Map and compass-only navigation (no GPS assistance)\n- Code verification at each checkpoint\n- Leadership and skill-building focus\n\n## Technical Stack\n\n- **Engine**: Unity 2022.3 LTS/6\n- **AR Framework**: Niantic Lightship ARDK 3.13.0\n- **AR Foundation**: 6.0+\n- **Target Platform**: iOS 15.0+ (iPhone 15 Pro Max optimized)\n- **Persistence**: Lightship Persistent Anchors + GPS hybrid\n- **Networking**: Lightship Shared AR (for multiplayer)\n- **Storage**: PlayerPrefs (MVP), Firebase (planned)\n\n## Architecture\n\n### Core Components\n- **Checkpoint Spawner**: Manages 5 persistent AR control points\n- **Navigation System**: Digital compass and mini-map HUD\n- **Timing Engine**: Per-leg and total run timers with penalties\n- **Collection Mechanics**: Code verification and capture system\n- **Progression System**: Personal bests and ghost replay\n\n### Safety Features\n- AR tracking quality monitoring\n- Boundary detection via Lightship semantics\n- \"Invalid path\" penalties (through buildings/water)\n- Auto-pause on poor conditions\n\n## Getting Started\n\n### Prerequisites\n- Unity 2022.3 LTS or 6\n- iOS development setup (Xcode, Apple Developer account)\n- iPhone 15 Pro Max (or compatible ARKit device)\n- Lightship developer account and API key\n\n### Installation\n\n1. **Clone the repository**\n   ```bash\n   git clone https://github.com/PSkinnerTech/RunnAR.git\n   cd RunnAR\n   ```\n\n2. **Open in Unity**\n   - Open Unity Hub\n   - Add project from disk\n   - Select the RunnAR folder\n\n3. **Install Dependencies**\n   - Window \u003e Package Manager\n   - Add from Git URL: `https://github.com/niantic-lightship/ardk-upm.git`\n   - Install AR Foundation 6.0+, TextMeshPro, Input System\n\n4. **Configure Lightship**\n   - Get API key from [lightship.dev](https://lightship.dev)\n   - Lightship \u003e Settings \u003e Enter API key\n   - Enable Niantic Lightship SDK in XR Plug-in Management\n\n5. **iOS Setup**\n   - Project Settings \u003e Player \u003e iOS\n   - Set Bundle Identifier\n   - Add required Usage Descriptions:\n     - Camera: \"AR navigation\"\n     - Location: \"Checkpoint locating\"\n     - Compass: \"Digital compass\"\n\n### Building and Running\n\n1. **Prepare Test Data**\n   - Create `Assets/Resources/Points.json` with 5 GPS coordinates\n   - Use the format from `docs/PRD.md` Task 1\n\n2. **Build to Device**\n   - File \u003e Build Settings \u003e iOS\n   - Build and Run to connected iPhone\n   - Test outdoors for GPS accuracy\n\n## Project Structure\n\n```\nRunnAR/\n├── Assets/\n│   ├── Samples/               # Lightship ARDK samples\n│   ├── Resources/\n│   │   └── Points.json        # Control point coordinates\n│   ├── Scripts/\n│   │   ├── CheckpointSpawner.cs\n│   │   ├── ARCompass.cs\n│   │   └── MiniMap.cs\n│   └── Prefabs/\n│       └── CheckpointPrefab\n├── docs/\n│   ├── PRD.md                 # Product Requirements Document\n│   └── GAME_MECHANICS.md      # Detailed game design\n└── README.md\n```\n\n## Development Roadmap\n\n### Phase 1: MVP (Complete)\n- [x] Project setup with Lightship ARDK\n- [x] Basic scene duplication from VPS samples\n- [x] GitHub repository setup\n\n### Phase 2: Core Mechanics (In Progress)\n- [x] Checkpoint spawning with persistent anchors\n- [x] Navigation HUD (compass + mini-map)\n- [x] Timing and scoring system\n- [x] Collection mechanics with code verification\n- [x] Personal best tracking\n\n### Phase 3: Polish \u0026 Testing\n- [x] Device testing and optimization\n- [ ] Safety features and boundary detection\n- [ ] Ghost replay system\n- [ ] UI/UX improvements\n\n### Phase 4: Multiplayer Extension\n- [ ] 1v1 shared AR implementation\n- [x] Recapture mechanics\n- [ ] Lobby and matchmaking\n\n### Phase 5: Platform Expansion\n- [ ] XREAL One port for hands-free play\n- [ ] Performance optimizations\n- [ ] Advanced terrain detection\n\n## Educational Context\n\nThis project was developed as part of the [Gauntlet AI](https://gauntletai.com) cohort program, designed to showcase innovative AR/AI applications while honoring JROTC training principles. The game serves as both a technical demonstration and a team-building activity for hiring partners.\n\n### Learning Objectives\n- Real-world AR development with Lightship ARDK\n- GPS/AR hybrid positioning systems\n- Multiplayer AR synchronization\n- Mobile game optimization\n- JROTC leadership and navigation skills\n\n## Contributing\n\nThis project is primarily for demonstration and educational purposes. For suggestions or collaboration opportunities:\n\n1. Fork the repository\n2. Create a feature branch (`git checkout -b feature/amazing-feature`)\n3. Commit your changes (`git commit -m 'Add amazing feature'`)\n4. Push to the branch (`git push origin feature/amazing-feature`)\n5. Open a Pull Request\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## About\n\n**Created by Patrick Skinner** | PSkinnerTech\n\nA Gauntlet AI project - pushing the boundaries of what an AI Engineer is capable of.\n\n### Connect\n- Twitter: [@PSkinnerTech](https://x.com/PSkinnerTech)\n- LinkedIn: [Patrick A. Skinner](https://linkedin.com/in/patrickaskinner/)\n- Website: [patrickskinner.tech](https://patrickskinner.tech)\n- Gauntlet AI: [@joingauntletai](https://x.com/joingauntletai) | [gauntletai.com](https://gauntletai.com)\n\n## Acknowledgments\n\n- **Niantic Lightship Team** for ARDK documentation and samples\n- **Gauntlet AI Cohort** for testing and feedback\n- **JROTC Programs** for navigation and leadership inspiration\n- **Unity Community** for AR development tutorials and best practices\n\n---\n\n*\"Navigate with purpose. Lead with precision. Run with AR.\"*\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpskinnertech%2Frunnar","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpskinnertech%2Frunnar","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpskinnertech%2Frunnar/lists"}