Citymoon DynamicsCitymoon Dynamics
Services
Developers
Pricing
Docs
Forums
Contact
Sign InSign Up

Documentation

Citymoon Dynamics
Minecraft
DisBan
authentication.ymlconfig.ymldiscord.ymllang.ymlantileak.ymlPermissions
Discord
Web Services
Ulises Licenses
Glossary
Glossary

discord.yml

The discord.yml file configures the Discord bot, including bot token, guild settings, channels, commands, synchronization roles, tickets, appeals, and logging.

Bot Configuration

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"

Guild Configuration

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'

Command Configuration

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'

Appeal Types

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

Appeals Configuration

appeals

Console commands executed when appeals are accepted or denied.

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

Tickets Configuration

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'

Claim Configuration

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

Discord Messages

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}**."
Citymoon DynamicsCitymoon Dynamics

Advanced solutions for digital infrastructure. Specialists in Minecraft, Discord, and Web Development.

Related services

  • Ulises Licenses
  • Freewings Discord Bot
  • ResistanceCore Plugin

More

  • Rymbo
  • Vulcan + Grim | Prime AC Configuration
  • DisBan | Sync and appeals made easier

Navigation

  • Services
  • Impact
  • Contact

Legal

  • Privacy
  • Terms
  • Cookies
  • Refunds

© (2026) 2025-2030 Citymoon Dynamics (citymoon.org). All rights reserved.

An international service, made in Uruguay