{"id":19492670,"url":"https://github.com/toshydev/netrunner","last_synced_at":"2025-09-14T13:07:22.568Z","repository":{"id":183405426,"uuid":"670082207","full_name":"toshydev/netRunner","owner":"toshydev","description":"Real-world \u0026 real-time cyberpunk exploration multiplayer game","archived":false,"fork":false,"pushed_at":"2023-12-29T13:28:44.000Z","size":2681,"stargazers_count":34,"open_issues_count":5,"forks_count":0,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-04-04T03:11:24.414Z","etag":null,"topics":["cyberpunk","exploration","full-stack","game","location-based","mongodb","react","spring-boot","spring-security","vite","webapp"],"latest_commit_sha":null,"homepage":"https://snekworld.org","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/toshydev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null},"funding":{"github":"toshydev"}},"created_at":"2023-07-24T08:56:46.000Z","updated_at":"2025-01-20T23:02:27.000Z","dependencies_parsed_at":"2023-12-29T14:28:35.066Z","dependency_job_id":"662f2603-5d6d-4460-9dc0-b5e194ad405a","html_url":"https://github.com/toshydev/netRunner","commit_stats":null,"previous_names":["toshydev/netrunner"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/toshydev%2FnetRunner","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/toshydev%2FnetRunner/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/toshydev%2FnetRunner/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/toshydev%2FnetRunner/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/toshydev","download_url":"https://codeload.github.com/toshydev/netRunner/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250890144,"owners_count":21503441,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["cyberpunk","exploration","full-stack","game","location-based","mongodb","react","spring-boot","spring-security","vite","webapp"],"created_at":"2024-11-10T21:22:29.679Z","updated_at":"2025-04-25T20:30:28.072Z","avatar_url":"https://github.com/toshydev.png","language":"Java","funding_links":["https://github.com/sponsors/toshydev"],"categories":[],"sub_categories":[],"readme":"[![Visitors](https://api.visitorbadge.io/api/visitors?path=https%3A%2F%2Fgithub.com%2Ftoshydev%2FnetRunner\u0026labelColor=%23343a40\u0026countColor=%23ff004f\u0026style=flat\u0026labelStyle=lower)](https://visitorbadge.io/status?path=https%3A%2F%2Fgithub.com%2Ftoshydev%2FnetRunner)\n\n# Netwalker\n\n![netwalker_showcase_8 4 2](https://github.com/toshydev/netRunner/assets/91165689/086c1db8-2cb6-487a-bcd9-c254c9867b0f)\n\n\nNetwalker is a unique real-world exploration game set in a cyberpunk-inspired universe. Players venture into the real world, utilizing their GPS positions to conquer nodes representing real-world landmarks and locations. In this multiplayer online game, players establish territorial control by connecting conquered nodes, generating in-game currency, and strategically upgrading nodes to increase resistance against rival players. Engaging in real-time multiplayer interactions, players can enter each other's territories to absorb credits and strengthen their dominance in the futuristic cityscape.\n\n## Used Technologies, Frameworks, and Libraries:\n- Frontend: React with Vite, Axios, Zustand, Mapbox, Leaflet, Emotion, Material-UI, Geolib\n- Backend: Spring Boot with Spring Security, Spring Reactive Web, Spring Validation, MongoDB + MongoDB Atlas\n- Testing: JUnit, AssertJ, Mockito, MockMvc, Flapdoodle\n- Deployment: GitHub Actions for CI/CD, Docker, AWS, Raspberry Pi\n\n## Game Mechanics:\n1. **Real-World Exploration:** Netwalker utilizes players' GPS positions to allow them to explore the real world, conquering nodes at specific real-world locations and landmarks.\n\n2. **Territory Control:** Players establish territorial control by connecting conquered nodes, forming a network that generates in-game currency based on the player's real-world exploration. (update coming soon)\n\n3. **Resistance Upgrades:** Players can invest in node upgrades, boosting their resistance to attacks from other players. Upgraded nodes provide enhanced defense for the player's territory.\n\n4. **Real-Time Multiplayer:** Netwalker offers real-time multiplayer interactions, enabling players to engage with each other's territories. Players can enter rival territories to absorb credits and strengthen their own holdings.\n\n5. **User Authentication:** Players must register and log in to access the game's features. Spring Security ensures secure user authentication and management.\n\n6. **Customizable Protagonist:** Players can personalize their in-game character, choosing the appearance, and theme to create a unique identity in the cyberpunk universe. (coming soon)\n\n## Current State of the Project:\n![netwalker_showcase_9 1 1](https://github.com/toshydev/netRunner/assets/91165689/9e7279a3-e970-4f5e-aeff-07b1c405515d)\n\n\nNetwalker is currently under development, with the frontend designed using React, Vite, and Mapbox with Leaflet to integrate the cyberpunk-themed interface with real-world map exploration based on players' GPS positions. The backend relies on Spring Boot, Spring Security, Spring Reactive Web, Spring Validation and MongoDB Atlas to handle real-time multiplayer interactions, node data, and user profiles effectively. Comprehensive testing, utilizing JUnit, AssertJ, Mockito, and MockMvc, ensures stable and reliable gameplay.\n\nThe game mechanics focus on real-world exploration, territorial control, and resistance upgrades. Real-time multiplayer functionality is being developed, allowing players to interact with each other's territories and engage in credit absorption during territorial encounters.\n\nThe project's CI/CD pipeline, powered by GitHub Actions and Docker, facilitates automated testing and deployment to various environments, including Amazon, and self-hosted servers.\n\nAs development continues, Netwalker aims to provide an immersive experience, enabling players to explore the real world through the lens of a cyberpunk universe, strategize their territorial control, and engage in thrilling multiplayer encounters within the futuristic cityscape.\n\nJoin our [![Join Discord](https://img.shields.io/badge/Discord-7289DA?style=plastic\u0026logo=discord\u0026logoColor=white)](https://discord.gg/7EJQP7TS) community.\n\n## How it started\n![netwalker_API](https://github.com/toshydev/netRunner/assets/91165689/c7aa2c0f-5622-4819-a24e-255801b400cf)\n\n![netwalker_wireframes](https://github.com/toshydev/netRunner/assets/91165689/cbec104c-7d1b-48d4-9f25-b37e960e40d4)\n\n---\n\n[![SonarCloud](https://sonarcloud.io/images/project_badges/sonarcloud-orange.svg)](https://sonarcloud.io/summary/new_code?id=netRunner_backend)\n\nBackend:\n\n[![Lines of Code](https://sonarcloud.io/api/project_badges/measure?project=netRunner_backend\u0026metric=ncloc)](https://sonarcloud.io/summary/new_code?id=netRunner_backend)\n[![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=netRunner_backend\u0026metric=alert_status)](https://sonarcloud.io/summary/new_code?id=netRunner_backend)\n[![Coverage](https://sonarcloud.io/api/project_badges/measure?project=netRunner_backend\u0026metric=coverage)](https://sonarcloud.io/summary/new_code?id=netRunner_backend)\n[![Maintainability Rating](https://sonarcloud.io/api/project_badges/measure?project=netRunner_backend\u0026metric=sqale_rating)](https://sonarcloud.io/summary/new_code?id=netRunner_backend)\n[![Security Rating](https://sonarcloud.io/api/project_badges/measure?project=netRunner_backend\u0026metric=security_rating)](https://sonarcloud.io/summary/new_code?id=netRunner_backend)\n[![Vulnerabilities](https://sonarcloud.io/api/project_badges/measure?project=netRunner_backend\u0026metric=vulnerabilities)](https://sonarcloud.io/summary/new_code?id=netRunner_backend)\n[![Technical Debt](https://sonarcloud.io/api/project_badges/measure?project=netRunner_backend\u0026metric=sqale_index)](https://sonarcloud.io/summary/new_code?id=netRunner_backend)\n\nFrontend:\n\n[![Lines of Code](https://sonarcloud.io/api/project_badges/measure?project=netRunner_frontend\u0026metric=ncloc)](https://sonarcloud.io/summary/new_code?id=netRunner_frontend)\n[![Maintainability Rating](https://sonarcloud.io/api/project_badges/measure?project=netRunner_frontend\u0026metric=sqale_rating)](https://sonarcloud.io/summary/new_code?id=netRunner_frontend)\n[![Security Rating](https://sonarcloud.io/api/project_badges/measure?project=netRunner_frontend\u0026metric=security_rating)](https://sonarcloud.io/summary/new_code?id=netRunner_frontend)\n[![Vulnerabilities](https://sonarcloud.io/api/project_badges/measure?project=netRunner_frontend\u0026metric=vulnerabilities)](https://sonarcloud.io/summary/new_code?id=netRunner_frontend)\n[![Technical Debt](https://sonarcloud.io/api/project_badges/measure?project=netRunner_frontend\u0026metric=sqale_index)](https://sonarcloud.io/summary/new_code?id=netRunner_frontend)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftoshydev%2Fnetrunner","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftoshydev%2Fnetrunner","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftoshydev%2Fnetrunner/lists"}