UltraMafia

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #ai #llm #go #docker #java #windows #kubernetes #pytorch #mcp #open-source

(★ 11)

The first OpenSource Mafia Bot!

UltraMafia Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

UltraMafia
==========
The first OpenSource Mafia Bot! Now only Russian version, but we are working on i8n!
## General info
This repository contains Open Source implementation of "Mafia" game bot. The bot currently works with Telegram.   
We plan to add other social platforms in the future.  
You are welcome with your ideas and contrubutions.
## Dependencies
This project depends on: 
 - [EFCore](https://github.com/dotnet/efcore) - used to presist game data.
 - [MySQL EFCore driver from Pomelo](https://github.com/PomeloFoundation/Pomelo.EntityFrameworkCore.MySql) - used as EFCore data provider.
 - [Telegram.Bot](https://github.com/TelegramBots/Telegram.Bot) - OpenSource library to interact with Telegram Bot API.
## How to Run?
### From sources
This project developed on C# and builds under .NET Core 3.1. To run project, set settings by updating `settings.json`. Settings info available after this section.
### With Docker
You can get our images from [Docker Hub](https://hub.docker.com/u/dotnetnomads) or just `docker pull dotnetnomads/ultra-mafia-bot`.
If you want setup development environment use `docker-compose up` in project folder.
You can change setting by setting environment variables, sample from `docker-compose.yml`:
```
environment: 
      "mafia_Db__Host": "mysql"
      "mafia_Db__User": "root"
      "mafia_Db__Password": "root"
      "mafia_Db__DbName": "ultra-mafia"
      "mafia_Frontend__Token": "place-your-token"
      "mafia_Frontend__BotUserName": "place-your-bot-username"
      "mafia_Game__DevelopmentMode": "true"
```
### Settings description
```json
{
  "Db": {
    "Host": "<databse-host, eg. localhost>",
    "Port": 3306,
    "User": "<databse-user, eg. root>",
    "Password": "<database-password, eg. root>",
    "DbName": "UltraMafia"
  },
  "Frontend": {
    "Token": "<bot-token, get it from BotFather>",
    "BotUserName": "<bot-username, get it also from BotFather>"
  },
  "Game": {
    "MinGamerCount": 4,
    "DevelopmentMode": false
  }, 
  "Serilog": { 
        "MinimumLevel": "Information"
   }
}
```
where: `MinGamerCount` - minimal count of gamers required to start, `DevelopmentMode` - in this mode, bot skip checking like: multiple registration, self voting.
## Development

### Development conventions
   In progress... :)
### Creating database migration
If you have new changes in models, just create new migration with a following command inside the `UltraMafia.DAL` project directory:
`dotnet ef --startup-project ../UltraMafia/ migrations  add <migrationName>`, where `<migrationName>` is the name of new migration.

UltraMafia

UltraMafia Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

UltraMafia

UltraMafia Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README