DiscordLevelingCard

A library with Rank cards for your discord bot.

Downloads: 69

card preview

card1

card2

card3 same as card2 but with background

installation

for pypi version

pip install discordlevelingcard

for github developement version

pip install git+https://github.com/krishsharma0413/DiscordLevelingCard

How To Use

If you don't provide path then the method will return bytes which can directly be used in discord.py/disnake/pycord/nextcord 's File class.

Example

since no path was provided, it returns bytes which can directly be used in discord.py and its fork's File class.

from disnake.ext import commands
from DiscordLevelingCard import RankCard, Settings
import disnake

client = commands.Bot()
# define background, bar_color, text_color at one place
card_settings = Settings(
    background="url or path to background image",
    text_color="white",
    bar_color="#000000"
)

@client.slash_command(name="rank")
async def user_rank_card(ctx, user:disnake.Member):
    await ctx.response.defer()
    a = RankCard(
        settings=card_settings,
        avatar=user.display_avatar.url,
        level=1,
        current_exp=1,
        max_exp=1,
        username="cool username"
    )
    image = await a.card1()
    await ctx.edit_original_message(file=disnake.File(image, filename="rank.png")) # providing filename is very important

Documentation

RankCard class

__init__ method

RankCard(
    settings: Settings,
    avatar:str,
    level:int,
    current_exp:int,
    max_exp:int,
    username:str,
    rank: Optional[int] = None
)

• settings - Settings class from DiscordLevelingCard.

• avatar - avatar image url.

• level - level of the user.

• current_exp - current exp of the user.

• max_exp - max exp of the user.

• username - username of the user.

• rank - rank of the user. (optional)

Settings class

__init__ method

Settings(
    background: Union[PathLike, BufferedIOBase, str],
    bar_color: Optional[str] = 'white',
    text_color: Optional[str] = 'white',
    background_color: Optional[str]= "#36393f"

)

• background - background image url or file-object in rb mode.

  • 4:1 aspect ratio recommended.

• bar_color - color of the bar [example: "white" or "#000000"]

• text_color - color of the text [example: "white" or "#000000"]

• background_color - color of the background [example: "white" or "#000000"]

card1 method

RankCard.card1()

returns - bytes which can directly be used within discord.File class.

card2 method

RankCard.card2()

returns - bytes which can directly be used within discord.File class.

card3 method

RankCard.card3()

returns - bytes which can directly be used within discord.File class.

please star the repository if you like it :D