Skip to content

Discord bot for handling economy on discord servers

License

Notifications You must be signed in to change notification settings

Stax124/Trinity-V2

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

17 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Contributors Forks Stargazers Issues MIT License LinkedIn


Logo

Trinity V2

Powerful discord bot for handling economy and wars for Discord servers
Report Bug · Request Feature

Table of Contents
  1. About The Project
  2. Getting Started
  3. Commands
  4. Contributing
  5. License
  6. Contact

About The Project

Trinity is a discord bot that changes your server to both an economy and a roleplay server (if you choose to use it). Filled with fully operational battle mechanics, quests, items to horde, shop and leveling system, you will be ready to trade, conquer and raid your opponents.

This bot allows you to hot-swap all of the modules on the fly, and it is also fully customizable. Feel free to take advantage of the features and add your own.

(back to top)

Built With

(back to top)

Getting Started

To get this bot up and running, follow these steps.

Prerequisites

  • python (3.9 tested, might run on older versions)
    sudo apt install python3 pip3

Installation

  1. Clone the repo
    git clone https://github.com/Stax124/Trinity-V2
  2. Install requirements
    pip3 install -r requirements.txt
  3. Enter your Discord API token (optionally, pass it as an argument on runtime with --token your_token_here)
    export TRINITY="your_token_here"
  4. Run the bot
    python3 main.py [-h] [-l {DEBUG,INFO,WARNING,ERROR,CRITICAL}] [-f FILE] [--token TOKEN]

(back to top)

Commands

Extensions

load <cog: string> - Loads extension
reload <cog: string> - Reloads extension
reload-all - Reloads all extensions
unload <cog: string> - Unloads extension

(back to top)

Battle

attack <player_manpower: int> - Automatized battle system
manpower - Show manpower of user

(back to top)

Config

config <path: str> [path: str]... - Output config as browsable directory
config-load - loads config file for current server
config-save - saves config file for current server
set <path: str> [path: str]... { = | < | > } <value> - Change values in config ("<" = subtraction | ">" = addition). You rather know what ya doin! (This can break the config when you do it wrong)

(back to top)

Essentials

autorole <role: discord.Role> - Set default role for new members
limits - Shows upgrade limits for your account
members - Show all members
purge <number: int> - Delete messages from channel
role - Shows your roles
roles - Shows all roles
roll <sides: int> - Roll a dice
time - shows time as bot sees it (for timezone purposes)
upgrades - Shows the current number of upgrades bought

(back to top)

Expeditions

add-expedition [-h] [--manpower MANPOWER] [--level LEVEL] [--chance CHANCE] [--common COMMON] [--uncommon UNCOMMON] [--rare RARE] [--epic EPIC] [--legendary LEGENDARY] [--xp XP] [--description DESCRIPTION] name cost hours - Adds new expedition
expedition <name: str> - Starts selected expedition
expeditions - Shows all expeditions
remove-expedition <name: str> - Removes selected expedition

(back to top)

Fallback

fallback-load - Loads fallback config

(back to top)

Income

add-income <role: discord.Role> <value: integer>
income - Shows your income
income-calc <population: int> - Calculates income from population number
income-lb - Shows the income leaderboard (aliases: l, lb, leaderboard)
remove-income <role: discord.Role> <value: integer> - Remove income from role

(back to top)

Inventory

add-player-item UNION[str, discord.Member] [--income INCOME] [--income_percent INCOME_PERCENT] [--discount DISCOUNT] [--discount_percent DISCOUNT_PERCENT] [--description DESCRIPTION] name {common,uncommon,rare,epic,legendary,event} {helmet,weapon,armor,leggins,boots,artefact} - Adds new item to player's inventory
equip <item: str> - Equips item
equiped - Shows all equiped items
inventory - Shows your "Realy useful" items in your inventory
recycle <item: str> - Recycles item from your inventory
recycle-all <rarity: str> - Recycles all items of selected rarity
remove-player-item <user: Union[str, discord.Member]> <item: str> - Removes item from player's inventory
unequip <item: str> - Unequips item

(back to top)

Management

ban <user: discord.Member> - Bans selected user
kick <user: discord.Member> - Kicks selected user

(back to top)

Money

add-money <user: discord.Member> <value: integer> - Adds money to user
balance - Shows your balance
buy <type: str> <value: int> - Spend money to make more money
leaderboard - Shows how poor you are
pay <user: discord.Member> <value: int> - Self-explanatory
remove-money <user: discord.Member> <value: integer> - Removes money from user
reset-money <user: discord.Member> - Resets user's balance
shop - Shows all items that you are too poor to buy

(back to top)

Owner

asyncs-on-hold - Show active async jobs that are in queue
eval - Evaluates code
exec - Executes code
shutdown - Shuts down the bot
tclear - Clears terminal screen
update - Updates the bot (requires git and no modifications done)

(back to top)

Player

level - Shows your level and xp progress
levelup <skill: str> [value: int = 1] - Levels up a skill
skillpoints - Shows number of your skillpoints remaining
talents - Shows your skills

(back to top)

PlayerShop

player-buy <user: discord.Member> <item: str> - Buys item from player
player-retrieve <item: str> - Removes listing and puts item back to your inventory
player-sell <price: int> <item: str> - Puts item on sale
player-shop <player: discord.Member> - Shows all items player is selling

(back to top)

Settings

add-item [--maxupgrade MAXUPGRADE] [--income INCOME] [--manpower MANPOWER] [--require REQUIRE] name cost - Adds item to database
deltatime <value: int> -  Sets time between work commands
pause - Pauses everything (except unpause)
version - Shows current version of bot

(back to top)

Work

work - What are you doing, make some money!

(back to top)

Contributing

Contributions are what makes 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!

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

(back to top)

License

See LICENSE for more information.

(back to top)

Contact

Tomáš Novák - tamoncz@gmail.com

Project Link: https://github.com/Stax124/Trinity-V2

(back to top)

Releases

No releases published

Packages

No packages published