Pokud jste administrátorem serveru Discord, pravděpodobně jste již narazili na potřebu přidat roli účastníkovi. Role vám umožňují organizovat hierarchii na serveru a dávat účastníkům různá oprávnění a přístup k určitým kanálům a příkazům. Tato příručka vám ukáže, jak používat discord.py-populární Knihovna pro vytváření Discord robotů v Pythonu-pro přidání rolí účastníkům.
Než začneme, ujistěte se, že jste nainstalovali discord.py. to lze provést provedením příkazu pip install discord.py v příkazovém řádku vašeho operačního systému.
Po instalaci discordu.py budete muset vytvořit robota na vývojářském portálu Discord, abyste získali Token potřebný k autorizaci vašeho robota na serveru. Přejděte na https://discord.com/developers/applications a přihlaste se ke svému účtu Discord. Poté vytvořte novou aplikaci kliknutím na tlačítko "Nová aplikace".
Instalace a konfigurace discord.py
1. Instalace Pythonu
Před zahájením práce s discord.py, ujistěte se, že máte v počítači nainstalovaný Python. Můžete si jej stáhnout z oficiálních stránek Pythonu a nainstalovat do počítače podle pokynů na webu.
2. Instalace discord.py
Po instalaci Pythonu musíte nainstalovat discord.py.. Chcete-li to provést, otevřete příkazový řádek nebo terminál a spusťte následující příkaz:
- pip install discord.py
3. Vytvoření aplikace Discord a získání tokenu
Pro vytvoření robota v discord.py budete potřebovat Token. K tomu je nutné vytvořit novou aplikaci na webu vývojářů Discordu a získat její Token. Postupujte podle následujících kroků:
- Přejděte na vývojářský Web Discord a přihlaste se ke svému účtu.
- Vytvořte novou aplikaci kliknutím na tlačítko "Nová aplikace".
- Zadejte název aplikace a klikněte na tlačítko "Create".
- V postranní nabídce vyberte kartu " Bot "a klikněte na tlačítko"Add Bot".
- V části " Token "klikněte na tlačítko" Copy " a uložte výsledný Token na bezpečné místo.
4. Připojení robota k serveru Discord
Aby se Bot mohl připojit k serveru Discord, musíte vygenerovat odkaz pro připojení. Postupujte podle následujících kroků:
- V postranní nabídce přejděte na kartu "OAuth2".
- V části " Scopes "vyberte" bot "a v části" Bot Permissions " nakonfigurujte potřebná práva pro svého robota.
- Zkopírujte odkaz, který se zobrazí níže, a otevřete jej na nové kartě prohlížeče.
- Vyberte server, ke kterému chcete robota připojit, a klikněte na tlačítko "Přihlásit se".
5. Psaní kódu robota
Nyní, když je váš bot nakonfigurován a připojen k serveru Discord, můžete napsat kód pro jeho funkčnost. Podívejte se na dokumentaci discord.py pro podrobnější informace o vytváření týmů a implementaci požadovaných funkcí.
Zde je příklad jednoduchého kódu pro vytvoření robota pomocí discord.py:
import discordfrom discord.ext import commandsbot = commands.Bot(command_prefix='!')@bot.eventasync def on_ready():print(f'Bot is ready')@bot.command()async def hello(ctx):await ctx.send("Hello, World!")bot.run('TOKEN')Zde importujeme potřebné moduly, vytvoříme objekt robota, nastavíme předponu příkazů a definujeme dvě funkce: on_ready() a hello().
Funkce hello () je příkaz, který lze volat na serveru Discord pomocí předpony "!"a jména týmu "hello". Tento příkaz odešle zprávu " Hello, World!"do stejného kanálu, kde byla přivolána.
Na konci kódu spustíme robota přenosem tokenu do metody run (). Nahraďte 'TOKEN' vlastním tokenem, který jste zkopírovali v kroku 3.
Nyní můžete svého robota spustit a otestovat jeho funkčnost na serveru Discord.
Vytvoření serveru v Discordu
Chcete-li vytvořit server v Discordu, postupujte podle následujících kroků:
| Krok 1: | Spusťte Discord a přihlaste se ke svému účtu, nebo si vytvořte nový, pokud jej ještě nemáte. |
| Krok 2: | Na domovské obrazovce Discordu klikněte na tlačítko" vytvořit server " v levém horním rohu. |
| Krok 3: | Vyberte typ serveru, který chcete vytvořit. Můžete si vybrat "veřejné" nebo "osobní" podle vašich preferencí. |
| Krok 4: | Zadejte název svého serveru. Vymyslete jedinečný a popisný název, aby ostatní uživatelé mohli pochopit, o čem bude váš server. |
| Krok 5: | Kliknutím na tlačítko" Vytvořit " dokončíte vytvoření serveru. |
| Krok 6: | Gratuluji! Úspěšně jste vytvořili svůj server na discordu. Nyní jej můžete přizpůsobit, přidat kanály, pozvat účastníky a další. |
Vytvoření serveru v Discordu je jednoduchý a rychlý proces. Udělejte svůj server jedinečným a naplňte jej zajímavým obsahem, abyste si užili nejvíce zábavy při komunikaci s ostatními lidmi!
Připojení robota k serveru
Než přidáte roli účastníkovi, musíte robota připojit k serveru Discord. To lze provést následujícími kroky:
- Vytvořte aplikaci na stránkách vývojářů Discordu. Chcete-li to provést, přejděte na odkaz https://discord.com/developers/applications, přihlaste se, klikněte na tlačítko "Nová aplikace" a zadejte název aplikace.
- Vytvořte robota. V nabídce vlevo vyberte kartu " Bot "a poté"Add Bot". Poté klikněte na tlačítko " Yes, do it!".
- Dejte botovi potřebná povolení. V části "Bot Permissions" nastavte požadovaná oprávnění pro svého robota. Pokud chcete, aby váš robot mohl ovládat role, zaškrtněte políčko naproti rozlišení "manage Roles".
- Vygenerujte Token přístup k vašemu botovi. Přejděte na stránku dolů do části " Token "a kliknutím na tlačítko" Copy " zkopírujte Token.
- Připojte robota k serveru. Vraťte se na stránku vašeho Discord serveru. V části "OAuth2" vyberte požadovaná oprávnění pro svého robota a zkopírujte vygenerovaný odkaz. Otevřete tento odkaz v prohlížeči a ze seznamu vyberte server. Klikněte na tlačítko" Authorize " a pomocí všech kroků potvrďte přidání robota na server.
Váš robot bude nyní viditelný v seznamu účastníků serveru a bude mít všechna potřebná oprávnění pro práci s rolemi a dalšími funkcemi.
Získání tokenu pro robota
- Přejděte na oficiální stránky Discordu a vytvořte novou aplikaci kliknutím na odkaz https://discord.com/developers/applications..
- Klikněte na tlačítko" Nová aplikace " a zadejte název pro vaši aplikaci (název může být jakýkoli).
- Na stránce aplikace přejděte na kartu "Bot" a klikněte na "Add Bot".
- V části " Token "klikněte na tlačítko" Copy " pro kopírování tokenu.
- Je důležité ponechat Token na bezpečném místě, protože je to citlivá informace a neměla by být zveřejněna třetí stranou.
Po úspěšném získání tokenu jej budete moci použít k autorizaci vašeho robota a provádění různých operací pomocí rozhraní Discord API.
Vytváření a konfigurace rolí
Chcete-li na serveru vytvořit novou roli, otevřete nastavení serveru a vyberte kartu role. Klikněte na tlačítko" Vytvořit roli " a zadejte název, barvu a nastavení oprávnění pro novou roli.
Název role: Dejte nové roli srozumitelný a popisný název, aby ostatní členové mohli snadno pochopit její účel.
Barva role: Vyberte barvu z navrhovaného seznamu nebo zadejte hexadecimální barevný kód. To pomůže vizuálně zvýraznit roli.
Oprávnění a nastavení: Role mají mnoho nastavení. Můžete například povolit nebo zakázat účastníkům s touto rolí možnost odesílat zprávy do určitých textových kanálů nebo se připojit k určitým hlasovým kanálům. Můžete také nastavit možnost zmínky o roli nebo ochranu před zmínkou.
| Výsada | Popis |
|---|---|
| Řízení rolí | Možnost přiřadit a odebrat role ostatním účastníkům |
| Správa kanálů | Možnost vytvářet a upravovat kanály |
| Správa přezdívek | Možnost změnit Přezdívky ostatních členů serveru |
| Správa emotikonů | Možnost Přidat a odstranit emotikony na serveru |
Po vytvoření role ji můžete přiřadit členům serveru. Chcete-li to provést, přejděte na kartu "Členové", vyberte příslušného člena a klikněte na tlačítko "přiřadit roli". Vyberte požadovanou roli ze seznamu a klikněte na tlačítko Použít.
Přiřazení role účastníkovi
Přiřadit roli účastníkovi pomocí discord.py,, je třeba provést určité kroky. V první řadě je třeba se ujistit, že bot má práva na změnu rolí účastníků. K tomu je třeba v nastavení serveru udělit botovi příslušná oprávnění.
Poté je nutné získat objekt účastníka, který potřebuje přiřadit roli. To lze provést pomocí metod poskytovaných discord.py, jako je get_user () nebo get_member ().
Po obdržení objektu účastníka je třeba získat objekt role, který má být přiřazen. K tomu lze použít metodu get_role () nebo find (), která jako argument předá název role nebo její ID.
Po obdržení objektu role lze k přidání této role účastníkovi použít metodu add_roles (). Tato metoda přijímá jeden nebo více objektů rolí jako argumenty.
Po provedení všech těchto kroků bude role úspěšně přidělena účastníkovi. Bude mít přístup k privilegiím a příležitostem nastaveným pro tuto roli na serveru Discord.
Přiřazování rolí účastníkům serveru je mocným nástrojem pro organizaci příkazů a řízení přístupu. Discord.py poskytuje praktické metody pro provádění tohoto úkolu a umožňuje vám vytvořit flexibilní systém rolí na serveru.
Příklad kódu pro přiřazení role účastníkovi:
member = message.authorrole = discord.utils.get(member.guild.roles, name="Название Роли")await member.add_roles(role)V tomto příkladu kódu message.autor obdrží objekt účastníka, který zprávu odeslal, discord.utils.get() obdrží objekt role se zadaným názvem a add_roles () přidělí tuto roli účastníkovi.
Nastavení přístupových práv rolí
V discord.py možnost nastavení přístupových práv pro vytvořené role. To umožňuje objasnit, jaké činnosti mohou účastníci s určitou rolí provádět.
Ke konfiguraci přístupových práv rolí se používá metoda discord.Permissions() . Tato metoda přijímá několik parametrů, jako jsou: create_instant_invite, kick_members, ban_members, administrator, manage_channels a další.
Níže je uveden příklad kódu, který ukazuje, jak nakonfigurovat přístupová práva pro roli:
import discord# Создаем клиент Discordclient = discord.Client()# Определяем рольrole_permissions = discord.Permissions(create_instant_invite=False,kick_members=True,ban_members=True,administrator=False,manage_channels=True)# Создаем роль с настройками прав доступаasync def create_role():guild = discord.utils.get(client.guilds, name="My Guild")new_role = await guild.create_role(name="Admin", permissions=role_permissions)print(f"Создана новая роль: ")V tomto příkladu vytvoříme klienta Discord a definujeme objekt discord.Permissions () s určitými přístupovými právy. Poté vytvoříme roli pomocí metody create_role () a předáme nastavení přístupových práv v parametru permissions .
Po spuštění tohoto kódu by se v konzoli měla objevit zpráva o vytvoření nové role se zadanými přístupovými právy.
Nyní máme roli s určitými přístupovými právy, kterou lze přiřadit účastníkovi pomocí metody add_roles() . To umožní účastníkovi s touto rolí provádět pouze činnosti, pro které jsou nastavena přístupová práva.
V další části se podíváme na to, jak přidat roli účastníkovi pomocí discord.py..