Mafia Online API

:exclamation: WORK IN PROGRESS :exclamation:

NodeJS module with a set of useful methods to interact with Mafia Online API from dotapp (Vladimir Tokarev).

This library is heavily based on work of @Zakovskiy, props to him for reverse-engineering such a horrible thing as Mafia Online API, which I tried to do myself back in August, 2021.

TypeScript supported!

Features

• [x] TypeScript
• [x] JSDoc
• [x] Ban error handler
• [x] REST API: Sign up, email verification
• [x] Disconnection handler
• [x] Tested with Jest
• [x] Examples
• [x] Sign in with email/nickname&password or token&userid
• [x] Global chat subscription
• [x] Rooms monitoring

Install

npm i mafiaonline.js

Use

import MafiaOnlineAPI from 'mafiaonline.js'

const mafiaOnlineAPI = new MafiaOnlineAPI({ email: '[email protected]', password: 'pythonsucks228' })

Documentation

See API reference at docs/api-reference.md

Examples

Examples can be found under examples dir

If you want to make a global-chat bot, see examples/examples.md#global-chat-bot

Caveats

• REST API is subject of rate limiting, which is not connected to TCP rate limiting. You should treat both servers are separate. In REST API, seconds left until rate limit unban is declared in "data" field. Methods of REST API are tagged with @see ## REST API in JSDoc documentation
• Bans are expanded on all accounts using same IP-address and deviceID
• IP-addresses are collected and linked to account starting from sign up and each time you do any action