kroxy 0.1.0

A professional Discord utility library by @kroxy

kroxy

A professional Discord utility library by @kroxy.

Install

pip install kroxy

Modules

kroxy.discord

Module	Description
api	Async Discord REST API client
commands	Slash & prefix command builders
utils	Embed builder, mentions, timestamps, permissions
antinuke	Anti-nuke protection with rate-limit tracking
checkers	Permission & role checks with hierarchy validation
giveaway	Full-featured weighted giveaway system
music	Queue-based music player state manager

kroxy.website (coming soon)

---

Quick Examples

Anti-Nuke

from kroxy.discord import AntiNuke

antinuke = AntiNuke(whitelist=[OWNER_ID])

async def punish(action, user_id, guild):
    print(f"NUKE DETECTED: {action} by {user_id}")

antinuke.on_trigger = punish
antinuke.punishment = "ban"

# In your event handler:
await antinuke.on_member_ban(user_id=some_user_id, guild=guild)

Giveaway

from kroxy.discord.giveaway import GiveawayManager

manager = GiveawayManager()

async def on_giveaway_end(giveaway, winners):
    print(f"Winners of {giveaway.prize}: {winners}")

manager.on_end = on_giveaway_end

giveaway = await manager.create(
    prize="Discord Nitro",
    host_id=123456789,
    channel_id=987654321,
    guild_id=111111111,
    duration=3600,     # 1 hour
    winner_count=2,
)

Embed Builder

from kroxy.discord import Utils

embed = Utils.build_embed(
    title="Hello from kroxy!",
    description="This is a professional embed.",
    color=0x5865F2,
    fields=[{"name": "Field", "value": "Value", "inline": True}],
    footer="kroxy library",
    timestamp=True,
)

Slash Command

from kroxy.discord.commands import SlashCommand, Option

@SlashCommand.decorator(
    name="ping",
    description="Check bot latency",
)
async def ping(interaction):
    await interaction.response.send_message("Pong!")

Music Player

from kroxy.discord.music import MusicPlayerManager, Track

manager = MusicPlayerManager()
player = manager.get_or_create(guild_id=111111111, channel_id=222222222)

track = Track(
    title="My Song",
    url="https://youtube.com/...",
    stream_url="https://...",
    duration=240,
    requester_id=123456789,
)
player.queue.add(track)
await player.play_next()

---

License

MIT © kroxy