mafiagg 1.0.3
MafiaggBot
Usage
pip install -U mafiagg
pip install -U python-dotenv
python-dotenv lets you pass a .env file with your mafia.gg credentials
MAFIA_USERNAME=username
MAFIA_PASSWORD=password
Example
from mafiagg.client import Bot
from mafiagg.credential_manager import CredentialManager
from sys import exit
auth = CredentialManager()
bot = Bot(auth=auth, command_prefix="$")
try:
bot.run()
except KeyboardInterrupt:
exit(0)
When you run the bot for the first time, it will download some metadata it a ./data/ folder.
Features
Rooms
List rooms
Make private/public
Become player/spectator
Do afk check
Do afk check
Do ready check
Edit room options
Rename room
Create new room
Only create room when game end
Decks
Get deck by name
Set deck by name
Use random deck
Setups
Get setup by name
Set setup by code
Set setup by name
Get current setup code
Roles
Get role by name
Cleanup role descriptions, alignment with validator
Commands
Custom command names
Command docs
Bot Client
Authentication
Help command
Formatted / multi-message help command
Host only commands
Host can add admins
Tasklist
Do not allow creation of new room unless game is over
Lookup in game Items
Edit room options
Implement conversion of role dictionary to setup codes
Return character info (for decks in next message)
Better commands (sub-commands!)
Better doc strings using decorators
Join other rooms on request
Allow for super().__init__ calls
Gracefully end session (end event loops, close websocket connection)
When exiting alls DELETE on user-session (cookie invalidation)
Development
Clone the repo
git clone https://github.com/blacksmithop/MafiaggBot
cd MafiaggBot
Install the dependencies
python3 -m pip install -r requirements.txt
For personal and professional use. You cannot resell or redistribute these repositories in their original state.
There are no reviews.