디스코드 봇 만들기#15슬래시 명령어 그룹(Group)으로 명령어 정리하기! (파이썬 예제)

/설정 보기          ← 그룹 + 하위 명령어 (2단)
/설정 알림 켜기     ← 그룹 + 하위 그룹 + 하위 명령어 (3단)

pip install -U discord.py

# discord.py 2.x
import discord
from discord import app_commands
from discord.ext import commands

intents = discord.Intents.default()
bot = commands.Bot(command_prefix="!", intents=intents)

# 1) 그룹(폴더) 만들기
인사 = app_commands.Group(name="인사", description="인사 명령어 모음")

# 2) 그룹에 하위 명령어 붙이기
@인사.command(name="안녕", description="반갑게 인사해요")
async def hello(interaction: discord.Interaction):
    await interaction.response.send_message("안녕하세요! 👋")

# 3) 그룹을 봇에 등록하기
bot.tree.add_command(인사)

# discord.py 2.x
class Settings(app_commands.Group, name="설정", description="서버 설정 명령어 모음"):

    @app_commands.command(name="환영채널", description="환영 메시지를 보낼 채널을 지정해요")
    @app_commands.describe(채널="환영 메시지를 보낼 텍스트 채널")
    async def welcome_channel(self, interaction: discord.Interaction, 채널: discord.TextChannel):
        config["welcome"] = 채널.id
        await interaction.response.send_message(
            f"✅ 환영 채널을 {채널.mention} 로 설정했어요!", ephemeral=True
        )

bot.tree.add_command(Settings())

# discord.py 2.x
class Settings(app_commands.Group, name="설정", description="서버 설정 명령어 모음"):

    # 그룹 속 그룹: /설정 알림 ...
    알림 = app_commands.Group(name="알림", description="알림 기능을 켜고 꺼요")

    @알림.command(name="켜기", description="알림을 켜요")
    async def alarm_on(self, interaction: discord.Interaction):
        await interaction.response.send_message("🔔 알림을 켰어요!")

    @알림.command(name="끄기", description="알림을 꺼요")
    async def alarm_off(self, interaction: discord.Interaction):
        await interaction.response.send_message("🔕 알림을 껐어요!")

# discord.py 2.x / Python 3.8+
import discord
from discord import app_commands
from discord.ext import commands

TOKEN = "여기에_봇_토큰"

intents = discord.Intents.default()
bot = commands.Bot(command_prefix="!", intents=intents)

# 서버별 설정을 담아둘 임시 저장소 (봇을 끄면 사라져요! 저장은 #14편 참고)
config = {}

def get_config(guild_id):
    """서버별 설정 dict를 가져오고, 없으면 기본값으로 만들어요."""
    return config.setdefault(
        guild_id, {"welcome": None, "greeting": "어서 오세요!", "alarm": False}
    )

class Settings(app_commands.Group, name="설정", description="서버 설정 명령어 모음"):

    @app_commands.command(name="환영채널", description="환영 메시지를 보낼 채널을 지정해요")
    @app_commands.describe(채널="환영 메시지를 보낼 텍스트 채널")
    async def welcome_channel(self, interaction: discord.Interaction, 채널: discord.TextChannel):
        get_config(interaction.guild_id)["welcome"] = 채널.id
        await interaction.response.send_message(
            f"✅ 환영 채널을 {채널.mention} 로 설정했어요!", ephemeral=True
        )

    @app_commands.command(name="인사말", description="환영 인사말 문구를 바꿔요")
    @app_commands.describe(문구="새 환영 인사말")
    async def greeting(self, interaction: discord.Interaction, 문구: str):
        get_config(interaction.guild_id)["greeting"] = 문구
        await interaction.response.send_message(
            f"✅ 인사말을 바꿨어요: {문구}", ephemeral=True
        )

    @app_commands.command(name="보기", description="현재 서버 설정을 확인해요")
    async def show(self, interaction: discord.Interaction):
        c = get_config(interaction.guild_id)
        channel = f"<#{c['welcome']}>" if c["welcome"] else "미설정"
        embed = discord.Embed(title="⚙️ 현재 서버 설정", color=0x5865F2)
        embed.add_field(name="환영 채널", value=channel, inline=True)
        embed.add_field(name="인사말", value=c["greeting"], inline=True)
        embed.add_field(name="알림", value="켜짐 🔔" if c["alarm"] else "꺼짐 🔕", inline=True)
        await interaction.response.send_message(embed=embed, ephemeral=True)

    # ── 그룹 속 그룹: /설정 알림 켜기·끄기 ──
    알림 = app_commands.Group(name="알림", description="알림 기능을 켜고 꺼요")

    @알림.command(name="켜기", description="알림을 켜요")
    async def alarm_on(self, interaction: discord.Interaction):
        get_config(interaction.guild_id)["alarm"] = True
        await interaction.response.send_message("🔔 알림을 켰어요!", ephemeral=True)

    @알림.command(name="끄기", description="알림을 꺼요")
    async def alarm_off(self, interaction: discord.Interaction):
        get_config(interaction.guild_id)["alarm"] = False
        await interaction.response.send_message("🔕 알림을 껐어요!", ephemeral=True)

bot.tree.add_command(Settings())

@bot.event
async def on_ready():
    synced = await bot.tree.sync()
    print(f"✅ {bot.user} 로 로그인! 슬래시 명령어 {len(synced)}개를 동기화했어요.")

bot.run(TOKEN)

# discord.py 2.x
MY_GUILD = discord.Object(id=내_서버_ID)

@bot.event
async def on_ready():
    bot.tree.copy_global_to(guild=MY_GUILD)
    await bot.tree.sync(guild=MY_GUILD)   # 내 서버에는 즉시 반영!