DiscordAvatarBot
Discord bot for generating Minecraft player avatars
DiscordAvatarBot
A Spigot/Paper plugin that integrates a Discord bot for generating Minecraft player avatars.
- Discord Integration - Use !av <username> command in Discord to generate player avatars - High-Quality Avatars - Generates bust-style Minecraft skin renders via tabavatars.net API - Cooldown System - Configurable cooldown to prevent spam - Channel Restriction - Limit avatar commands to specific Discord channels - Avatar-Only Mode - Create clean avatar galleries by auto-deleting non-bot messages - Customizable Embeds - Configure colors, titles, descriptions, and messages
Requirements - Java 17 or higher - Spigot/Paper 1.17.x or higher - Discord Bot Token (Requirements)
Installation - Download the latest release from the Releases page - Place the JAR file in your server's plugins folder - Start/restart your server - Edit plugins/DiscordAvatarBot/config.yml with your bot token and server ID - Restart the server
Configuration
Spoiler
```
============================================
Discord Avatar Bot Configuration
============================================
==================== BOT SETTINGS ====================
Your Discord Bot Token
Get it from: https://discord.com/developers/applications
bot-token: "YOUR_BOT_TOKEN_HERE"
Your Discord Server ID (Guild ID)
Right-click on your server icon and click "Copy ID" (Developer Mode must be enabled)
server-id: "YOUR_SERVER_ID_HERE"
Bot status message (what the bot shows as "Playing")
bot-status: "Looking for !av <username> for avatars"
==================== CHANNEL SETTINGS ====================
Channel ID where avatar commands can be used
Leave empty ("") to allow in all channels
Example: "1234567890123456789"
allowed-channel-id: ""
Avatar-Only Channel Mode
When enabled, ALL user messages in the allowed channel get deleted
Only the bot's avatar embeds will remain - creates a clean avatar gallery!
Set to true to enable, false to disable
avatar-only-channel: false
==================== COOLDOWN SETTINGS ====================
Enable or disable cooldown (true/false)
Set to false to allow unlimited avatar requests
cooldown-enabled: true
Cooldown time in hours (only works if cooldown-enabled is true)
Set to 0 for no cooldown
cooldown-hours: 24
==================== CUSTOMIZABLE MESSAGES ====================
Use {username} for player name, {hours} for remaining cooldown time
Use {user} for Discord user mention
Embed title
embed-title: "Player Avatar"
Embed description (shown below title)
Use {username} for the player name
embed-description: "Player: `{username}`"
Embed color (hex format)
embed-color: "#5865F2"
Footer text (main line)
embed-footer: "Avatar generated by tabavatars.net API"
Note field title
note-title: "ℹ️ Note"
Note field content (shown for premium skin warning)
note-content: "If you see an invalid skin, it's because this username doesn't have a premium Minecraft account. Some players use offline mode with custom skins."
Show the note field (true/false)
show-note: true
==================== ERROR MESSAGES ====================
No username provided
error-no-username: "❌ Usage: `!av <username>`"
User is on cooldown
Use {hours} for remaining time
error-cooldown: "⏰ You're on cooldown! You can request another avatar in {hours} hours.nPlease don't spam the chat with avatars!"
Failed to generate avatar
error-generation-failed: "❌ Failed to generate avatar. Please check the username."
General error
error-general: "❌ An error occurred while generating the avatar. Please try again later."
Private message rejection
error-dm-blocked: "❌ I don't accept private messages!"
Wrong channel message (when user uses command in wrong channel)
Leave empty to silently ignore
Use {channel} for the allowed channel mention
error-wrong-channel: ""
==================== SUCCESS MESSAGES ====================
Message shown after successful avatar generation (optional)
Leave empty for no message
Use {username} for player name, {user} for Discord user mention
success-message: ""
==================== LOGGING SETTINGS ====================
Enable or disable console logging when avatars are generated
Set to false to disable "Avatar generated for user X by Y" messages
console-logging: true
Logo URL for embed footer (must be PNG/JPG - Discord doesn't support SVG)
logo-url: "https://tabavatars.net/assets/images/discordbot.png"
```
Commands - !av <username> Generate an avatar for the specified Minecraft username
report bugs here: https://discord.gg/CppU73Ba2c