discord.yml

El archivo discord.yml configura el bot de Discord, incluyendo token de bot, configuración de guild, canales, comandos, sincronización de roles, tickets, apelaciones y logs.

Configuración del Bot

bot.enabled

Enables or disables the Discord bot functionality.

bot: enabled: false

bot.token

Your Discord bot token from the Discord Developer Portal.

token: 'YOUR_BOT_TOKEN_HERE'

bot.presence

Bot presence status and activity. Available placeholders: %total_synced_players%, %online_players%, %total_tickets%, %server_name%, %plugin_version%. Activity types: PLAYING, WATCHING, LISTENING, COMPETING. Statuses: ONLINE, IDLE, DO_NOT_DISTURB, INVISIBLE.

bot:
  presence:
    enabled: true
    interval: 30
    statuses:
      - activity: "Managing %total_synced_players% synced accounts"
        activity-type: "WATCHING"
        status: "ONLINE"
      - activity: "%online_players% players online"
        activity-type: "PLAYING"
        status: "ONLINE"
      - activity: "Use /sync to link your account"
        activity-type: "PLAYING"
        status: "IDLE"

Configuración del Servidor

guild.id

Your Discord server ID.

guild: id: 'YOUR_GUILD_ID_HERE'

Channel Configuration

channels

Discord channel IDs for various bot functions.

channels:
  panel: 'PANEL_CHANNEL_ID'
  tickets: 'TICKET_CATEGORY_ID'
  appeals: 'APPEAL_CATEGORY_ID'
  logs: 'LOG_CHANNEL_ID'
  sync-log: 'SYNC_LOG_CHANNEL_ID'

Configuración de Comandos

commands

Commands executed when ranks are added or removed. The plugin automatically detects and uses available APIs (LuckPerms, AquaCore, Phoenix) when possible.

commands:
  add-rank: 'lp user {player} parent add {rank}'
  remove-rank: 'lp user {player} parent remove {rank}'

commands.sync-direction

Sync direction: MC_TO_DC (Minecraft rank to Discord role), DC_TO_MC (Discord role to Minecraft rank), BOTH (bidirectional).

sync-direction: 'DC_TO_MC'

Panel Configuration

panel.embed

Embed configuration for the support panel.

panel:
  embed:
    title: '🛡️ Support Center'
    description: |
      Welcome! Select one of the options below to open a ticket.

      📩 **Support** - General help & questions
      ⚖️ **Appeal** - Request unban, unmute or similar
      🚨 **Report** - Report a player
    color: '5865F2'
    thumbnail: ''

panel.buttons

Button configuration for the support panel. Colors: primary (Blue), secondary (Grey), success (Green), danger (Red).

panel:
  buttons:
    support:
      label: 'Support'
      emoji: '📩'
      style: 'primary'
      action: 'SUPPORT'
      modal-title: '📩 Open Support Ticket'
      modal-input-label: 'Describe your issue'
      modal-input-placeholder: 'Explain what you need help with...'
    appeal:
      label: 'Appeal'
      emoji: '⚖️'
      style: 'DANGER'
      action: 'APPEAL'
    report:
      label: 'Report'
      emoji: '🚨'
      style: 'SECONDARY'
      action: 'REPORT'

Role Synchronization

roles

Synchronization roles. If a player has one, the plugin will give the other.

roles:
  admin: 'DISCORD_ROLE_ID'
  moderator: 'DISCORD_ROLE_ID'
  vip: 'DISCORD_ROLE_ID'

Staff Operations

staff-operations

Discord role IDs for various staff operations.

staff-operations:
  claim:
    - 'DISCORD_ROLE_ID'
  accept-appeal:
    - 'DISCORD_ROLE_ID'
  deny-appeal:
    - 'DISCORD_ROLE_ID'
  manage-members:
    - 'DISCORD_ROLE_ID'

Tipos de Apelación

appeal-types

Configuration for different types of appeals with commands executed on accept/deny.

appeal-types:
  unban:
    label: '🔓 Unban Request'
    description: 'I want to be unbanned'
    command: 'pardon {player}'
    deny-command: ''
  unmute:
    label: '🔇 Unmute Request'
    description: 'I want to be unmuted'
    command: 'unmute {player}'
    deny-command: ''
  unwarn:
    label: '⚠️ Remove Warning'
    description: 'I want a warning removed'
    command: 'warns remove {player} last'
    deny-command: ''
  other:
    label: '❓ Other'
    description: 'Another type of sanction'
    command: ''
    deny-command: ''

Configuración de Apelaciones

appeals

Console commands executed when appeals are accepted or denied.

appeals:
  console-command-on-accept: 'pardon {player}'
  console-command-on-deny: ''

Configuración de Tickets

tickets

Configuration for different ticket types.

tickets:
  support:
    embed-title: '📩 Support Ticket'
    embed-color: '5865F2'
    console-command-on-close: ''
  report:
    embed-title: '🚨 Player Report'
    embed-color: 'FEE75C'
    console-command-on-close: ''
  appeal:
    embed-title: '⚖️ Ban Appeal'
    embed-color: 'ED4245'

Configuración de Reclamación

claim

Configuration for ticket claiming. Available formats: random (TK-XXXXXX), type_player (appeal-playername), custom (with placeholders type, player_name, random).

claim:
  embed-title: '🎫 Ticket Claimed'
  embed-description: 'This ticket has been claimed by {staff_name}. They will assist you shortly.'
  embed-color: '57F287'
ticket-id:
  format: 'random'
  custom-format: '{type}-{player_name}-{random}'

Max Tickets Configuration

max-tickets

Limits the number of tickets a user can create. Subtype ALL counts all tickets together, ONLY_CATEGORY counts tickets separately per category.

max-tickets:
  enabled: true
  subtype: 'ALL'
  max-all: 3
  max-per-category:
    support: 2
    appeal: 1
    report: 2

Sync Configuration

sync.reminders

Enables sync reminders for players who haven't linked their account.

sync:
  reminders:
    enabled: true

sync.rewards

Automatically rewards players when they sync their account.

sync:
  rewards:
    enabled: true
    limit: 1
    commands:
      - 'eco give {player} 1000'
      - 'give {player} diamond 1'

sync.unsync-embed

Embed configuration for unsync confirmation.

sync:
  unsync-embed:
    title: '⚠️ Unsync Confirmation'
    description: 'Are you sure you want to unlink your Minecraft account? This action cannot be undone.'
    color: 'FEE75C'
  unsync-btn-confirm: 'Confirm Unlink'
  unsync-btn-cancel: 'Cancel'
  unsync-success-embed:
    title: '♻️ Unlinked Successfully'
    description: 'Your Discord account has been unlinked from **{player}**.'
    color: '00FFFF'
  unsync-cancelled-embed:
    title: '✅ Cancelled'
    description: 'Unsync operation cancelled.'
    color: '57F287'

Logs Configuration

logs

Enable or disable logging for various events.

logs:
  sync: true
  unsync: true
  ticket-open: true
  ticket-close: true
  appeal-accepted: true
  appeal-denied: true

Mensajes de Discord

messages

Error and success messages shown in Discord.

messages:
  ticket-not-found: '❌ Ticket `{ticket_id}` not found or already closed.'
  no-claim-roles: '❌ No claim roles configured in discord.yml.'
  no-permission-claim: '❌ You do not have permission to claim tickets.'
  already-claimed: '❌ This ticket has already been claimed by <@{user}>.'
  claim-success: '✅ Ticket claimed successfully.'
  no-appeal-roles: '❌ No {operation} roles configured in discord.yml.'
  no-permission-appeal: '❌ You do not have permission to {operation}.'
  appeal-not-found: '❌ Appeal `{ticket_id}` not found or already resolved.'
  ticket-already-open: '❌ You already have an open ticket. Please close it before opening a new one.'
  ticket-already-open-short: '❌ You already have an open ticket.'
  close-embed:
    title: '🔒 Ticket Closed - #{ticket_id}'
    description: 'Closed by **{user}**.'
    color: '808080'
  appeal-embed:
    accept-title: '✅ Appeal Accepted - #{ticket_id}'
    deny-title: '❌ Appeal Denied - #{ticket_id}'
    accept-description: "**{player}**'s appeal has been accepted by **{user}**."
    deny-description: "**{player}**'s appeal has been denied by **{user}**."