Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/toshydev/netrunner

Real-world & real-time cyberpunk exploration multiplayer game
https://github.com/toshydev/netrunner

cyberpunk exploration full-stack game location-based mongodb react spring-boot spring-security vite webapp

Last synced: about 2 months ago
JSON representation

Real-world & real-time cyberpunk exploration multiplayer game

Host: GitHub
URL: https://github.com/toshydev/netrunner
Owner: toshydev
License: gpl-3.0
Created: 2023-07-24T08:56:46.000Z (over 1 year ago)
Default Branch: main
Last Pushed: 2023-12-29T13:28:44.000Z (12 months ago)
Last Synced: 2023-12-29T14:28:32.686Z (12 months ago)
Topics: cyberpunk, exploration, full-stack, game, location-based, mongodb, react, spring-boot, spring-security, vite, webapp
Language: Java
Homepage: https://snekworld.org
Size: 2.56 MB
Stars: 27
Watchers: 3
Forks: 0
Open Issues: 5
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md

Awesome Lists containing this project

README

        [![Visitors](https://api.visitorbadge.io/api/visitors?path=https%3A%2F%2Fgithub.com%2Ftoshydev%2FnetRunner&labelColor=%23343a40&countColor=%23ff004f&style=flat&labelStyle=lower)](https://visitorbadge.io/status?path=https%3A%2F%2Fgithub.com%2Ftoshydev%2FnetRunner)

# Netwalker

![netwalker_showcase_8 4 2](https://github.com/toshydev/netRunner/assets/91165689/086c1db8-2cb6-487a-bcd9-c254c9867b0f)

Netwalker 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.

## Used Technologies, Frameworks, and Libraries:

- Frontend: React with Vite, Axios, Zustand, Mapbox, Leaflet, Emotion, Material-UI, Geolib

- Backend: Spring Boot with Spring Security, Spring Reactive Web, Spring Validation, MongoDB + MongoDB Atlas

- Testing: JUnit, AssertJ, Mockito, MockMvc, Flapdoodle

- Deployment: GitHub Actions for CI/CD, Docker, AWS, Raspberry Pi

## Game Mechanics:

1. **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.

2. **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)

3. **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.

4. **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.

5. **User Authentication:** Players must register and log in to access the game's features. Spring Security ensures secure user authentication and management.

6. **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)

## Current State of the Project:

![netwalker_showcase_9 1 1](https://github.com/toshydev/netRunner/assets/91165689/9e7279a3-e970-4f5e-aeff-07b1c405515d)

Netwalker 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.

The 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.

The 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.

As 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.

Join our [![Join Discord](https://img.shields.io/badge/Discord-7289DA?style=plastic&logo=discord&logoColor=white)](https://discord.gg/7EJQP7TS) community.

## How it started

![netwalker_API](https://github.com/toshydev/netRunner/assets/91165689/c7aa2c0f-5622-4819-a24e-255801b400cf)

![netwalker_wireframes](https://github.com/toshydev/netRunner/assets/91165689/cbec104c-7d1b-48d4-9f25-b37e960e40d4)

---

[![SonarCloud](https://sonarcloud.io/images/project_badges/sonarcloud-orange.svg)](https://sonarcloud.io/summary/new_code?id=netRunner_backend)

Backend:

[![Lines of Code](https://sonarcloud.io/api/project_badges/measure?project=netRunner_backend&metric=ncloc)](https://sonarcloud.io/summary/new_code?id=netRunner_backend)

[![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=netRunner_backend&metric=alert_status)](https://sonarcloud.io/summary/new_code?id=netRunner_backend)

[![Coverage](https://sonarcloud.io/api/project_badges/measure?project=netRunner_backend&metric=coverage)](https://sonarcloud.io/summary/new_code?id=netRunner_backend)

[![Maintainability Rating](https://sonarcloud.io/api/project_badges/measure?project=netRunner_backend&metric=sqale_rating)](https://sonarcloud.io/summary/new_code?id=netRunner_backend)

[![Security Rating](https://sonarcloud.io/api/project_badges/measure?project=netRunner_backend&metric=security_rating)](https://sonarcloud.io/summary/new_code?id=netRunner_backend)

[![Vulnerabilities](https://sonarcloud.io/api/project_badges/measure?project=netRunner_backend&metric=vulnerabilities)](https://sonarcloud.io/summary/new_code?id=netRunner_backend)

[![Technical Debt](https://sonarcloud.io/api/project_badges/measure?project=netRunner_backend&metric=sqale_index)](https://sonarcloud.io/summary/new_code?id=netRunner_backend)

Frontend:

[![Lines of Code](https://sonarcloud.io/api/project_badges/measure?project=netRunner_frontend&metric=ncloc)](https://sonarcloud.io/summary/new_code?id=netRunner_frontend)

[![Maintainability Rating](https://sonarcloud.io/api/project_badges/measure?project=netRunner_frontend&metric=sqale_rating)](https://sonarcloud.io/summary/new_code?id=netRunner_frontend)

[![Security Rating](https://sonarcloud.io/api/project_badges/measure?project=netRunner_frontend&metric=security_rating)](https://sonarcloud.io/summary/new_code?id=netRunner_frontend)

[![Vulnerabilities](https://sonarcloud.io/api/project_badges/measure?project=netRunner_frontend&metric=vulnerabilities)](https://sonarcloud.io/summary/new_code?id=netRunner_frontend)

[![Technical Debt](https://sonarcloud.io/api/project_badges/measure?project=netRunner_frontend&metric=sqale_index)](https://sonarcloud.io/summary/new_code?id=netRunner_frontend)