BeastTokens – DiscordSRV Extension
Send beautiful Discord embed notifications for every
shop buy/sell in BeastTokens — with
per-shop channels,
per-shop embed styling, emojis, colors, titles, and more!
What This Extension Does
This extension adds
advanced Discord notifications for
buy and
sell events from BeastTokens shops.
✔ Global OR per-shop settings
✔ Optional per-shop channels
✔ Fully customizable embeds
✔ Colors, emojis, titles, timestamps
✔ Relative time (2 minutes ago) support
✔ Automatic fallback when a setting isn’t defined
✔ Simple plug-and-play installation
✔ Zero performance impact
Requirements
• A Spigot server (any version BeastTokens supports)
•
BeastTokens plugin
• DiscordSRV installed & connected to your Discord server
• Java 8+ (recommended Java 17+)
1. Download
Download the latest BeastTokens-DiscordSRV-Extension.jar from the SpigotMC "Downloads" section.
2. Install
Place the .jar file into:
Code (Text):
/plugins/BeastTokens/extensions/
If the extensions folder doesn’t exist → create it manually.
3. Restart Server
The extension will:
✔ Register itself in BeastTokens
✔ Generate config.yml
✔ Hook into DiscordSRV
⚙️ Configuration Overview
Your config (generated on first startup):
Code (YAML):
shop-settings:
enabled
: true
channel
:
"GLOBAL_CHANNEL_ID"
embed:
color:
buy
:
"#00FF00"
sell
:
"#FF0000"
emoji:
buy
:
""
sell
:
""
item
:
""
amount
:
""
money
:
""
relative-time
: true
title:
buy
:
"Item Bought"
sell
:
"Item Sold"
enabled:
buy
: true
sell
: true
shops:
Example:
embed:
color:
buy
:
"#88FF88"
sell
:
"#FF8888"
emoji:
buy
:
""
sell
:
""
item
:
""
amount
:
""
money
:
""
relative-time
: false
title:
buy
:
"Example Shop - Purchase"
sell
:
"Example Shop - Sold"
enabled:
buy
: true
sell
: true
How Overrides Work
Global Settings (shop-settings)
Used
if no shop-specific settings exist.
Per-Shop Settings (shop-settings.shops.NAME)
Override global behavior for that shop.
Priority order (highest → lowest):
1️⃣ Shop-specific buy-channel / sell-channel
2️⃣ Shop-specific channel
3️⃣ Global buy-channel / sell-channel
4️⃣ Global channel
If none of the above exist → the message is skipped.
️ Example Discord Output
• Custom color bars
• Shop-specific emojis
• Relative timestamps
• Clean layout
❗ Troubleshooting
“Discord channel not configured”
→ You didn’t define a channel for that shop or the global channel.
Messages not sending
→ Check DiscordSRV is running and linked
→ Make sure channel IDs are correct
→ Ensure the bot has permission to send embeds
❤️ Support
If you need help, you can: