ByteClansDiscord is an official addon for ByteClans that delivers real-time Discord webhook notifications for clan events
It integrates directly with ByteClans event system and dispatches a webhook every time something happens in a clan — a new clan is created, a member joins or leaves, ownership is transferred, or a clan is disbanded.
It integrates directly with ByteClans event system and dispatches a webhook every time something happens in a clan — a new clan is created, a member joins or leaves, ownership is transferred, or a clan is disbanded.
If you need help, join the Discord server.
What is ByteClansDiscord?
ByteClansDiscord hooks into ByteClans event system and dispatches fully customizable Discord webhooks on clan activity.
Each event has its own webhook URL, toggle, and component layout — configured entirely through webhooks.yml.
Messages are built using Discord's Components V2, with support for containers, text displays, separators, and player skin thumbnails.
Each event has its own webhook URL, toggle, and component layout — configured entirely through webhooks.yml.
Messages are built using Discord's Components V2, with support for containers, text displays, separators, and player skin thumbnails.
Key Features
- Per-event webhook: Each clan event has its own webhook URL and can be enabled or disabled independently.
- Components V2: Messages are built with Discord's latest component system — containers, text displays, separators, and thumbnails.
- Player skin thumbnails: Display the player's skin inside the webhook using a configurable URL with placeholder support.
- Full markdown support: Text components support Discord markdown natively.
- Placeholders: Every event exposes its own set of placeholders — clan name, player name, UUID, member count, and more.
- Async dispatch: Webhooks are sent asynchronously — no server thread blocking.
- No hardcoded messages: Every text, color, and component is configured through webhooks.yml.
Installation
- Make sure ByteClans is installed and running.
- Download the latest ByteClansDiscord release.
- Place the .jar file into your server's plugins/ folder.
- Start your server — webhooks.yml will be generated automatically.
- Fill in your webhook URL for each event and configure the components to your liking.
- Restart your server.
