discord.yml

Le fichier discord.yml configure le bot Discord, y compris le token du bot, les paramètres du serveur, les canaux, les commandes, la synchronisation des rôles, les tickets, les appels et les logs.

Configuration du 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"

Configuration du Serveur

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'

Configuration des Commandes

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'

Types d'Appel

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: ''

Configuration des Appels

appeals

Console commands executed when appeals are accepted or denied.

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

Configuration des 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'

Configuration de Réclamation

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

Messages 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}**."