DiscordAvatarBot

DiscordAvatarBot

Discord bot for generating Minecraft player avatars

68 downloads 0 followers

A Spigot/Paper plugin that integrates a Discord bot for generating Minecraft player avatars.

  • Discord Integration - Use !av 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

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 Generate an avatar for the specified Minecraft username

report bugs here: https://discord.gg/CppU73Ba2c

No gallery available for this project.

Version Minecraft Loader Download

DiscordAvatarBot 1.0.3

1.0.3

1.17, 1.17.1, 1.18, 1.18.1, 1.18.2, 1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11
bukkit, paper, purpur, spigot
Download