디스코드 봇 만들기 #3 - Slash Command에 서브 커맨드(Subcommand) 넣기!

안녕하세요 Mojangcam입니다 😎 이번엔 좀 더 고급 기능! Slash Command를 그룹으로 묶는 서브 커맨드 기능을 알아볼 거예요!

예를 들어…

/user info → 유저 정보 보기
/user ban → 유저 차단

이런 식으로 하나의 명령어 그룹 안에 여러 개의 기능을 넣는 거죠!

🧩 서브 커맨드? 이게 뭐야?

서브 커맨드는 /명령어 서브명령어 형태로 사용하는 구조입니다. 기능이 많은 봇일수록 깔끔하게 정리할 수 있어서 정말 유용해요!

🧑‍💻 예제 코드

Python

import discord
from discord.ext import commands
from discord import app_commands

class UserCommandGroup(app_commands.Group):
    def __init__(self):
        super().__init__(name="user", description="유저 관련 명령어 모음!")

    @app_commands.command(name="info", description="유저 정보를 확인합니다.")
    async def info(self, interaction: discord.Interaction, user: discord.User):
        await interaction.response.send_message(f"{user.name}님의 ID는 {user.id}입니다.")

    @app_commands.command(name="ban", description="유저를 차단합니다.")
    async def ban(self, interaction: discord.Interaction, user: discord.User, reason: str):
        await interaction.response.send_message(f"{user.name}님을 '{reason}' 이유로 차단했습니다!")

intents = discord.Intents.default()
bot = commands.Bot(command_prefix="!", intents=intents)
bot.tree.add_command(UserCommandGroup())   # 그룹은 sync() 전에 먼저 등록!

@bot.event
async def on_ready():
    await bot.tree.sync()
    print(f"✅ {bot.user} 봇이 준비되었습니다!")

bot.run("YOUR_TOKEN")

🚀 사용 예시

/user info user:@홍길동 → 홍길동님의 ID는 1234567890입니다.
/user ban user:@홍길동 reason:욕함 → 홍길동님을 '욕함' 이유로 차단했습니다!

🎁 보너스 꿀팁

그룹 이름은 name="...", 설명은 description="..." 으로 정할 수 있어요!
그룹 안에 명령어를 추가할 때는 @app_commands.command() 데코레이터를 사용합니다.
실제 서버에서 관리자 기능, 게임 명령어, 설정 명령어 등 묶어서 만들 때 완전 좋아요!

📌 마무리

서브 커맨드는 기능이 많아질수록 필수! 명령어를 깔끔하게 묶어서 봇이 훨씬 정돈된 느낌을 줍니다.

다음에는…

버튼, 셀렉트 메뉴(SelectMenu) 같은 UI 구성 요소 넣는 방법 알려드릴게요! 😎