DayzMapsLoader

Project is to allow users to download maps for the game DayZ from two different map providers: Ginfo and Xam. The downloaded maps are of high quality and can be used to create different stuff. Also personal library of knowledge.

UNLICENSE License

Stars

View Code on GitHub

Ecosystems: React, sql-server, TypeScript

About The Project

This Github pet project is an application built with Domain-Driven Design (DDD) architecture and modern development patterns. It has a server component built using ASP.NET Core and a client component built using React.

The main purpose of this project is to allow users to download maps for the game DayZ from two different map providers: Ginfo and Xam. The downloaded maps are of high quality and can be used to create posters, cups, or other stuff.

This repository is also a small personal library of knowledge.

Built With

Architecture

The concept of a Clean Architecture pattern has been around for over a decade and was initially conceived by Robert Martin. The keyword from Uncle Bob is Interchangeable. In the image below, everything on the blue circle is interchangeable, e.g., the UI can be swapped out from React to Angular, or the database can be migrated from MSSQL to Oracle, and nothing in the underlying layers needs to change.

The concept of having all your interfaces (Infrastructure and Application) in one project, will make it easier to Unit Test and mock.

Solution Structure

Web Api

Public components

Wpf

Built using pattern MVVM pattern with modern approaches.

Getting Started

This is an example of how you may give instructions on setting up your project locally. To get a local copy up and running follow these simple example steps.

Prerequisites

This is an example of how to list things you need to use the software and how to install them.

npm
```
npm install npm@latest -g
```
Dotnet ef
```
dotnet tool install dotnet-ef -g
```

Installation

Clone the repo

git clone https://github.com/SaintZet/DayzMapsLoader.git

Install NPM packages
```
npm install
```

Add a appsettings.json with connection string to DayzMapsLoader.Presentation.WebApi

  "ConnectionStrings": {
 "DefaultConnection": "Server = YourServer; DataBase=DayzMapLoader; User id= YourUserID; password= YourPassword; Integrated Security=True; TrustServerCertificate=True;"
 }

At this point you can have EF create database and create schema from the migration .NET CLI:

dotnet ef database update --startup-project ../DayzMapsLoader.Presentation.WebApi --project ../DayzMapsLoader.Infrastructure

Usage

At the moment you can install the latest version of the product to start the server and get all the necessary maps. You know what to do with them.

You can create a fork and expand the repository, for example

create a desktop client
change image processing algorithms
add functionality that is useful to you
other

Take some techniques and approaches to your projects.

And of course - to contribute to the development of the project, help with existing issues or create a new one, improve the algorithm, or change something else!

Roadmap

Provide archive(web) and byte array(desktop) with
- selected map
- selected map in parts
- all maps by specific provider
Options for select a map
- provider (GInfo e.g.)
- name (Chernarus e.g)
- type
  - satellite
  - topographic
  - tourist
- zoom level
- version
- image quality
- image extension
Desctop client on WPF
Web client on React (in the process)
Hosting server and client
Improve performance - store images on the server and just download them when changed something (e.g version map).

See the open issues for a full list of proposed features (and known issues).

Contributing

Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!