كيفية إنشاء بوت بايثون على ديسكورد باستخدام أوامر سلاشر

إن بناء بوت باستخدام مكتبة discord.py يمكن أن يكون تجربة مثيرة ومفيدة للمطورين. تتضمن هذه العملية استخدام "التروس" (Cogs) لتنظيم الكود وأوامر الشرطة المائلة (Slash Commands) لجعل التفاعل مع البوت أكثر سهولة ومرونة. في هذا المقال، سنستعرض كيفية إنشاء بوت Discord باعتماد هذه المفاهيم.

ما هي Cogs في discord.py؟

تعتبر Cogs وحدة تنظيمية في برمجة بوتات Discord باستخدام مكتبة discord.py، حيث تتيح لك توزيع الأوامر والأحداث في ملفات منفصلة. يسهل ذلك من إدارة الكود، خاصةً عند التعامل مع بوت كبيرة تتضمن العديد من الأوامر. مثلاً، يمكنك إنشاء Cog خاص للأوامر المتعلقة بالألعاب وآخر للترحيب بالدخول إلى السيرفر.

إعداد بيئة العمل

قبل أن نبدأ في كتابة الكود، تأكد من أنك قد قمت بتثبيت مكتبة discord.py. يمكنك القيام بذلك عبر تنفيذ الأمر التالي في سطر الأوامر:

pip install discord.py

بعد تثبيت المكتبة، يمكنك إنشاء هيكل مجلد بوتك. على سبيل المثال، يمكنك إعداد المجلدات كالتالي:

my_bot/
  ├── bot.py
  └── cogs/
      └── example_cog.py

إنشاء البوت الخاص بك

ثم، يمكنك البدء في كتابة الكود الأساسي في bot.py. إليك نموذجاً بسيطاً:

import discord
from discord.ext import commands
intents = discord.Intents.default()
bot = commands.Bot(command_prefix='!', intents=intents)
@bot.event
async def on_ready():
    print(f'Logged in as {bot.user}')
bot.run('YOUR_BOT_TOKEN')

إنشاء Cogs

الآن، دعنا ننشئ Cog جديدة تحتوي على بعض الأوامر. افتح ملف example_cog.py في مجلد cogs وأضف التعليمات البرمجية التالية:

from discord.ext import commands
class ExampleCog(commands.Cog):
    def __init__(self, bot):
        self.bot = bot
    @commands.command()
    async def hello(self, ctx):
        await ctx.send('Hello!')
def setup(bot):
    bot.add_cog(ExampleCog(bot))

لا تنس إضافة الكود المعالج في bot.py لتحميل الـ Cogs:

for filename in os.listdir('./cogs'):
    if filename.endswith('.py'):
        bot.load_extension(f'cogs.{filename[:-3]}')

تنفيذ أوامر الشرطة المائلة

أوامر الشرطة المائلة (Slash Commands) تتيح طريقة جديدة للتفاعل مع البوت. لإضافتها إلى البوت الخاص بك، عليك استخدام مكتبة discord-py-slash-command. يمكنك تثبيتها باستخدام:

pip install discord-py-slash-command

إليك كيفية إضافة أمر شرطة مائلة:

from discord_slash import SlashCommand
slash = SlashCommand(bot, sync_commands=True)
@slash.slash(name="ping")
async def _ping(ctx):
    await ctx.send(content="Pong!")

بهذا الشكل، ستتمكن من استخدام أوامر الشرطة المائلة في بوتك.

استنتاج

بعد أن تناولنا في هذا المقال كيفية بناء بوت باستخدام discord.py مع التروس وأوامر الشرطة المائلة، يصبح من الواضح أن تعلم هذه التقنيات يمكن أن يفتح آفاق جديدة لتطوير بوتات فعالة وممتعة على Discord. إذا كنت تبحث عن بناء بوت فعال، يُعتبر استخدام Cogs وأوامر الشرطة المائلة خطوة مهمة.

بهذه الطريقة، تصبح تجربة المستخدم أفضل وأكثر سهولة، مما سيساعد في جذب المزيد من المستخدمين إلى خادمك. سواء كنت مطوراً مبتدئاً أو لديك خبرة في تطوير بوتات Discord، فإن اتباع هذه النصائح سيمكنك من بناء بوت يحقق احتياجاتك.