A Spigot\/Paper plugin that integrates a Discord bot for generating Minecraft player avatars.<\/p>\n
– Discord Integration – Use !av **Requirements** **Installation** **Configuration**<\/p>\n “` # ==================== BOT SETTINGS ====================<\/p>\n # Your Discord Bot Token # Your Discord Server ID (Guild ID) # Bot status message (what the bot shows as “Playing”) # ==================== CHANNEL SETTINGS ====================<\/p>\n # Channel ID where avatar commands can be used # Avatar-Only Channel Mode # ==================== COOLDOWN SETTINGS ====================<\/p>\n # Enable or disable cooldown (true\/false) # Cooldown time in hours (only works if cooldown-enabled is true) # ==================== CUSTOMIZABLE MESSAGES ==================== # Embed title # Embed description (shown below title) # Embed color (hex format) # Footer text (main line) # Note field title # Note field content (shown for premium skin warning) # Show the note field (true\/false) # ==================== ERROR MESSAGES ====================<\/p>\n # No username provided # User is on cooldown # Failed to generate avatar # General error # Private message rejection # Wrong channel message (when user uses command in wrong channel) # ==================== SUCCESS MESSAGES ====================<\/p>\n # Message shown after successful avatar generation (optional) # ==================== LOGGING SETTINGS ====================<\/p>\n # Enable or disable console logging when avatars are generated # Logo URL for embed footer (must be PNG\/JPG – Discord doesn’t support SVG) “`<\/p>\n<\/details>\n **Commands** report bugs here: https:\/\/discord.gg\/CppU73Ba2c<\/p>\n","protected":false},"excerpt":{"rendered":" Discord bot for generating Minecraft player avatars<\/p>\n","protected":false},"featured_media":57375,"template":"","meta":{"_minecraft_slug":"discordavatarbot","_minecraft_project_id":"FZkadrZZ","_minecraft_author":"Duka","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":26,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"discordavatarbot.zip","_minecraft_size_bytes":9969189,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T22:20:50.746174Z","_minecraft_date_created":"2026-02-07T06:34:35.026847Z","_minecraft_date_modified":"2026-02-04T04:44:50.650327Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/discordavatarbot","_minecraft_icon_attachment_id":57375,"_minecraft_imported_at":"2026-06-03T03:51:12+00:00","_minecraft_import_hash":"ac67fd24ab8be0025c424e7463dbe0de","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,127,128,129],"mod_loader":[130,132,133,134],"minecraft_version":[49,50,51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-57374","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_loader-bukkit","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-17","minecraft_version-1-17-1","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n– High-Quality Avatars – Generates bust-style Minecraft skin renders via tabavatars.net API
\n– Cooldown System – Configurable cooldown to prevent spam
\n– Channel Restriction – Limit avatar commands to specific Discord channels
\n– Avatar-Only Mode – Create clean avatar galleries by auto-deleting non-bot messages
\n– Customizable Embeds – Configure colors, titles, descriptions, and messages<\/p>\n
\n– Java 17 or higher
\n– Spigot\/Paper 1.17.x or higher
\n– Discord Bot Token (https:\/\/discord.com\/developers\/applications)<\/p>\n
\n– Download the latest release from the Releases page
\n– Place the JAR file in your server’s plugins folder
\n– Start\/restart your server
\n– Edit plugins\/DiscordAvatarBot\/config.yml with your bot token and server ID
\n– Restart the server <\/p>\nSpoiler<\/summary>\n
\n# ============================================
\n# Discord Avatar Bot Configuration
\n# ============================================<\/p>\n
\n# Get it from: https:\/\/discord.com\/developers\/applications
\nbot-token: “YOUR_BOT_TOKEN_HERE”<\/p>\n
\n# Right-click on your server icon and click “Copy ID” (Developer Mode must be enabled)
\nserver-id: “YOUR_SERVER_ID_HERE”<\/p>\n
\nbot-status: “Looking for !av
\n# Leave empty (“”) to allow in all channels
\n# Example: “1234567890123456789”
\nallowed-channel-id: “”<\/p>\n
\n# When enabled, ALL user messages in the allowed channel get deleted
\n# Only the bot’s avatar embeds will remain – creates a clean avatar gallery!
\n# Set to true to enable, false to disable
\navatar-only-channel: false<\/p>\n
\n# Set to false to allow unlimited avatar requests
\ncooldown-enabled: true<\/p>\n
\n# Set to 0 for no cooldown
\ncooldown-hours: 24<\/p>\n
\n# Use {username} for player name, {hours} for remaining cooldown time
\n# Use {user} for Discord user mention<\/p>\n
\nembed-title: “Player Avatar”<\/p>\n
\n# Use {username} for the player name
\nembed-description: “**Player:** `{username}`”<\/p>\n
\nembed-color: “#5865F2”<\/p>\n
\nembed-footer: “Avatar generated by tabavatars.net API”<\/p>\n
\nnote-title: “\u2139\ufe0f Note”<\/p>\n
\nnote-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.”<\/p>\n
\nshow-note: true<\/p>\n
\nerror-no-username: “\u274c Usage: `!av
\n# Use {hours} for remaining time
\nerror-cooldown: “\u23f0 You’re on cooldown! You can request another avatar in **{hours} hours**.nPlease don’t spam the chat with avatars!”<\/p>\n
\nerror-generation-failed: “\u274c Failed to generate avatar. Please check the username.”<\/p>\n
\nerror-general: “\u274c An error occurred while generating the avatar. Please try again later.”<\/p>\n
\nerror-dm-blocked: “\u274c I don’t accept private messages!”<\/p>\n
\n# Leave empty to silently ignore
\n# Use {channel} for the allowed channel mention
\nerror-wrong-channel: “”<\/p>\n
\n# Leave empty for no message
\n# Use {username} for player name, {user} for Discord user mention
\nsuccess-message: “”<\/p>\n
\n# Set to false to disable “Avatar generated for user X by Y” messages
\nconsole-logging: true<\/p>\n
\nlogo-url: “https:\/\/tabavatars.net\/assets\/images\/discordbot.png”<\/p>\n
\n– !av