Skip to content

Latest commit

 

History

History
206 lines (157 loc) · 8.1 KB

README.md

File metadata and controls

206 lines (157 loc) · 8.1 KB
Raw

Tibia Stalker

Tibia Stalker is a ASP.NET Web Api that helps players to detect other characters of their enemy.

Web Api

You can check out https://tibia.bieda.it/

Table of Contents

General Information

Dear Tibia Players !

  • Have you ever been killed or cheated by some noob character and you want revenge on his main character ?

  • Now it's possible! Application gives opportunity to find all characters of that player. Just type your suspect character name and it gives you list of most possible other characters.

Important!

  • You have to remember that application does not have 100% sure of other character match, it is only sugestion based on propability. The more player plays, the more likely result will be close to true.

Technologies Used

  • ASP.NET Core 7.0
  • C# 11.0
  • EF Core 7.0
  • Postgres - version 16
  • RabbitMq
  • SignalR
  • TestContainers - documentation here
  • BenchmarkDotNet
  • Dapper
  • Moq
  • Serilog
  • Seq - documentation here , license here
  • Swagger - documentation here
  • Xunit
  • MediatR
  • FluentAssertions
  • Autofac
  • Docker
  • Polly

Features

List the ready features here:

  • All data analyser mechanism with optimization data storage, also work if character changed name or was traded

Endpoints:

  • GET/health - health check.
  • GET/api/tibia-stalker/v1/characters/{characterName} - returns character details with 10 most scores possible other character names.
  • GET/api/tibia-stalker/v1/characters (params (string)searchText,(int)page,(int)pageSize) - returns list of character names based on a fragment of the name, sorted in ascending order.
  • GET/api/tibia-stalker/v1/characters/prompt (params (string)searchText,(int)page,(int)pageSize) - returns list of character names starts at fragment of the name, sorted in ascending order.
  • GET/api/tibia-stalker/v1/worlds (params (bool?)isAvailable) - returns filtered worlds.

Life Time Character Tracker:

Track your enemies whether is online or not.

To track specific character use WebSockets to connect with:

{baseUrl}/characters-track-hub

Ones you connected send message:

{"protocol":"json","version":1}�

Now join to group to track enemy sending:

{"arguments":["your_enemy_character_name"],"target":"JoinGroup","type":1}�

To stop tracking one character just send message

{"arguments":["your_enemy_character_name"],"target":"LeaveGroup","type":1}�

or disconnect connection to stop tracking all enemies.

Try with Postman. Example here

Screenshots

Swagger Api view

Character Controller

Example result

Setup

Project require

  1. SDK version 7.0.x or higher ( instruction for Windows/Linux/macOS here )
  2. ASP.NET Core Runtime version 7.0.x or higher ( instruction for Windows/Linux/macOS here )
  3. Clone repository git clone https://github.com/TibiaStalker/tibiastalker-api.git
  4. Seq enviroment on Windows here or docker container here
  5. Your own Postgres Database
  6. RabbitMq enviroment or docker container
  7. Create database in Postgres and configure appsettings.json or if you have Development enviroment copy appsettings.Development-template.json change file name to appsettings.Development.json and input your secrets
  8. Configure launchSettings.json

Usage

  1. Firstly you need to build project - go into repo directory, open CMD and type (dotnet build)
  2. Than dotnet publish -c Release -o /app
  3. Next you should firstly run TibiaStalker.Api to add all migrations - go into ./app, open CMD and type dotnet TibiaStalker.Api.dll
  4. Last step is to configure cron on your machine with periods as below:
  • CharacterAnalyser - (dotnet CharacterAnalyser.dll) - ones per day
  • WorldScanSeeder - (dotnet WorldScanSeeder.dll) - minimum ones per 5 min
  • DbCleaner - (dotnet DbCleaner.dll) - ones per day/week
  • WorldSeeder - (dotnet WorldSeeder.dll) - best practise ones per day
  • ChangeNameDetector - (dotnet ChangeNameDetector.dll) - best practise ones per month

Also 2 projects should run all the time:

  • TibiaStalker.Api.dll - (dotnet TibiaStalker.Api.dll)
  • RabbitMqSubscriber.dll - (dotnet RabbitMqSubscriber.dll)

Development

Want to contribute? Great!

To fix a bug, enhance an existing module or add something new, follow these steps:

  • Fork the repo
  • Create a new branch (git checkout -b feature/<new_feature_or_improve_name>)
  • Make the appropriate changes in the files
  • Add changes to reflect the changes made
  • Commit your changes (git commit -am 'Add xxx feature')
  • Push to the branch (git push origin feature/<new_feature_or_improve_name>)
  • Create a Pull Request

Docker Usage

  1. Firstly pull image
  2. Create database in Postgres
  3. Than create and configure file .env with environment variables as here
  4. Than open CMD and run container docker run --env-file .env -p <port1>:80 --network <seq_container_network> --name tibia-stalker-api -d --memory 200m --restart always ghcr.io/tibiastalker/tibia-stalker-api:latest dotnet TibiaStalker.Api.dll
  5. And docker run --env-file .env -p <port2>:80 --network <seq_container_network> --name tibia-rabbit-mq-subscriber -d --restart always ghcr.io/tibiastalker/tibia-stalker-api:latest dotnet RabbitMqSubscriber.dll
  6. Last step is to configure cron on your machine with periods as below:
  • docker run --env-file .env -p <port3>:80 --network <seq_container_network> --name tibia-character-analyser --rm -d --memory 200m ghcr.io/tibiastalker/tibia-stalker-api:latest dotnet CharacterAnalyser.dll) - ones per day
  • docker run --env-file .env -p <port4>:80 --network <seq_container_network> --name tibia-world-scan-seeder --rm -d ghcr.io/tibiastalker/tibia-stalker-api:latest dotnet WorldScanSeeder.dll) - minimum ones per 5 min
  • docker run --env-file .env -p <port5>:80 --network <seq_container_network> --name tibia-db-cleaner --rm -d ghcr.io/tibiastalker/tibia-stalker-api:latest dotnet DbCleaner.dll) - ones per day/week
  • docker run --env-file .env -p <port6>:80 --network <seq_container_network> --name tibia-world-seeder --rm -d ghcr.io/tibiastalker/tibia-stalker-api:latest dotnet WorldSeeder.dll) - best practise ones per day
  • docker run --env-file .env -p <port7>:80 --network <seq_container_network> --name tibia-change-name-detector --rm -d --memory 200m ghcr.io/tibiastalker/tibia-stalker-api:latest dotnet ChangeNameDetector.dll) - best practise ones per month

Create Docker Image:

  • Go into Actions section on Github
  • Than Deploy
  • Than Run workflow
  • Choose branch and input version of the Docker image

Project Status

Project is: still in progress .

Room for Improvement

To do:

  • Add autorization and autentication
  • Kubernetes
  • Frontend

License

You can check out the full license here

This project is licensed under the terms of the MIT license.

Created by @kamiljanek GitHub