TtgcBot

TtgcBot for Discord for RP (JDR) on The Tale of Great Cosmos and even more useful features

View on GitHub

TtgcBot

forthebadge made-with-python

Generic badge GitHub license Generic badge Generic badge
Generic badge Generic badge Generic badge Generic badge Generic badge Generic badge Generic badge Generic badge Generic badge

TtgcBot is a bot for Discord made at the beginning for RP (JDR) on The Tale of Great Cosmos universe (French Website here). But, today the bot is having many useful tools and features such as Keeprole system that allow leaving member to keep their roles after joining again your server, warn users that doesn’t follow your rules, and more things (list of commands below). The bot is developed in Python 3 using discord.py lib and use also a postgresql 9 database.

Invite link

you can invit him from a server with command /invite
Also available on The Tale of Great Cosmos discord


Table of content

  1. Contribute to translation
  2. Command Help
     2.1. How it works
     2.2. Basic commands
     2.3. Fun commands
     2.4. Moderation commands
     2.5. Keeprole commands (Administrator only)
     2.6. Vocal commands (Premium user only)
     2.7. NSFW commands (NSFW channels only)
     2.8. RP/JDR commands
      2.8.1. Main commands
      2.8.2. Character commands
      2.8.3. Global commands
      2.8.4. GM/MJ commands
      2.8.5. Skill commands
      2.8.6. Pet commands
      2.8.7. Map commands
      2.8.8. Inventory commands
      2.8.9. Finalize commands
     2.9. Bot Management (Bot Manager only)

Contribute to translation

TtgcBot supports currently only two languages (English and French), if you want that the bot support more languages you can contribute by creating your own translation in a language file ! Follow the steps and rules given below to contribute to translation :

  1. Create a new file named as following : the language code in uppercasse (EN for English for example) and with the extension .lang
  2. Begin to write your file and respect coding rules below :
    • # is used to defined a comment line and must only placed at the beginning of the line to work
    • A line is equal to a key/value couple corresponding at a single message of the bot
    • Here is the correct format of a line : key=value
    • Write only translation as value for each key existing in other languages files (use EN.lang file as reference for having all the keys)
    • Use \n as new line character and you can also keep discord formatting
    • Use brackets {} to define a missing value that will be replaced by a result during execution of the command. For example : Who are you ? I'm {} means that the {} will be replaced by the name of a person when the command would be executed.
    • Put the same number of {} for a value as the number of {} for the same value in the reference file (EN.lang)
  3. Commit and put the language file in the Lang directory
  4. Wait for validation….
  5. You have successful contributed to bot translation ! Congratulations !

Command Help

How it works

The commands work following this example : /example <arg> [optional] [opt1/opt2]
The / refers to the prefix on your server by default /, but if you have changed it, use your own prefix
<arg> is an argument and must be provided (without < and >) when you call the command
[optional] is an optional argument and could be or not provided (without [ and ])
[opt1|opt2] is an optional argument and if it’s provided, it could only be one of the 2 options (opt1 or opt2)
(name1|name2) same as above, but used for commands group names instead. You can use the name1 or name2 for each subcommands.
[,...] means that you can pass as many as you want parameters of the same type
There are also some features (commands) reserved for some users, it will be precised for each of them.
Each commands must be used on servers only, else they won’t work.
Bot is casse insensitive, you can use uppercasse like lowercase for calling commands
For some commands there are alliases avalaible wich will be given for each commands having it

Basic commands

Fun commands

Moderation commands

Keeprole commands (Administrator only)

Keeprole system allow you to set roles that will be automatically reassigned to member when they leave with theese roles and join again your server

Vocal commands (Premium user only)

NSFW commands (NSFW channels only)

RP/JDR commands

Main commands

Character commands

Global commands

GM/MJ commands

Skill commands

Pet commands

Map commands

Inventory commands

Finalize commands

Bot Management (Bot Manager only)