NebulaCore | Ultimate BungeeCord Suite v.1.1

# =============================================================
#       NebulaCore - Auto Broadcast Configuration
# =============================================================
# AVAILABLE VARIABLES:
# {global_prefix} - Displays the prefix defined in 'settings.prefix'
# {player}        - Name of the player receiving the message.
# {prefix}        - LuckPerms prefix (Rank) of the player.
# {server}        - Current server where the player is located.
# {online}        - Total players across the entire network (Proxy).
# {max_players}   - Maximum player limit of the Proxy.
# {click_message} - Placeholder where the clickable link will be inserted.
# =============================================================
# SYSTEM INFORMATION:
# * The broadcast system will skip lines that don't use {click_message}
#   for the clickable logic, sending them as standard text instead.
# * Intervals are handled in seconds.
# * Colors are supported using the '&' symbol.
# =============================================================

settings:
  # Enable or disable the automatic messaging system
  enabled: true
  # Time in seconds between each broadcast (e.g., 300 = 5 minutes)
  interval: 300
  # If true, picks a random announcement. If false, follows the order.
  random: false
  # Global prefix used when the {global_prefix} variable is present
  prefix: "&5&lNEBULA &8» "

# Announcement list:
# Each entry represents a unique broadcast message.
announcements:
  discord:
    lines:
      - "&8&m---------------------------------------------------"
      - "{global_prefix}&7Hello &f{prefix}{player}&7! Welcome to the network."
      - "&7Be part of our growing community to receive leaks,"
      - "&7updates, and exclusive giveaways. {click_message}"
      - "&8&m---------------------------------------------------"
    # Text that replaces the {click_message} variable
    click-message: "&b&l[JOIN OUR DISCORD]"
    # The URL that will open when a player clicks the text above
    click-url: "https://discord.gg/nebula"
    # Information displayed when hovering over the clickable text
    hover-text: "&dClick to open our &bOfficial Discord"

  store:
    lines:
      - "&8&m---------------------------------------------------"
      - "{global_prefix}&e&lSEASONAL SALE &8» &fLimited time only!"
      - "&7Support the server and unlock exclusive ranks, crates,"
      - "&7and cosmetics. Get up to &a50% OFF &7at our {click_message}"
      - "&8&m---------------------------------------------------"
    click-message: "&6&lWEBSTORE"
    click-url: "https://store.nebula.com"
    hover-text: "&fClick to visit the &6Nebula Shop"

  vote:
    lines:
      - "&8&m---------------------------------------------------"
      - "{global_prefix}&7Enjoying your stay on &b{server}&7?"
      - "&7Help us reach the top of the lists and earn rewards!"
      - "&7You can start by {click_message} &7right now."
      - "&7Total Online: &d{online}&f/&d{max_players}"
      - "&8&m---------------------------------------------------"
    click-message: "&a&lVOTING HERE"
    click-url: "https://topg.org/minecraft-servers/"
    hover-text: "&aClick here to claim your &fVote Crate Key!"

  rules:
    lines:
      - "&8&m---------------------------------------------------"
      - "{global_prefix}&c&lNEBULA RULES &8» &7Keep it fair!"
      - "&7Please respect all players and staff members."
      - "&7Make sure to read our {click_message} &7to avoid bans."
      - "&8&m---------------------------------------------------"
    click-message: "&e&l[SERVER RULES]"
    click-url: "https://nebula.com/rules"
    hover-text: "&eClick to read the rules!"

# =============================================================
#       NebulaCore - Custom Commands Configuration
# =============================================================
# AVAILABLE VARIABLES:
# {player}       - Name of the player executing the command.
# {prefix}       - LuckPerms prefix of the player.
# {server}       - Name of the server where the player is located.
# {online}       - Total number of players online across the network.
# {max_players}  - The network's maximum player capacity (slots).
# =============================================================

custom-commands:
  discord:
    # Leave empty "" to allow all players to use the command
    permission: ""
    aliases:
      - "dc"
      - "community"
    message:
      - "&9&lDISCORD &8» &fHey &b{player}&f, join our community:"
      - "&bhttps://discord.gg/nebula"
  web:
    # Permission required to use this command
    permission: "nebulacore.commands.web"
    aliases:
      - "forum"
      - "site"
    message:
      - "&e&lWEB &8» &fVisit our official website at &awww.nebula.com"
  store:
    permission: ""
    aliases:
      - "shop"
      - "donate"
    message:
      - "&a&lSTORE &8» &fSupport the network here, &b{prefix}{player}&f:"
      - "&ehttps://store.nebula.com"
  profile:
    permission: ""
    message:
      - "&7&m--------------------------------------"
      - "&eYour Network Profile:"
      - " &8» &7Name: &f{player}"
      - " &8» &7Rank: &f{prefix}"
      - " &8» &7Current Server: &b{server}"
      - " &8» &7Network Load: &a{online}/{max_players}"
      - "&7&m--------------------------------------"

# ==========================================
#             MOTD Settings
# ==========================================
motd:
  enabled: true
 
  # Timer Settings for countdowns
  timer:
    # Toggle the {timer} placeholder globally
    enabled: true
    # Target date in format: YYYY-MM-DD HH:MM:SS
    date: "2026-06-01 18:00:00"
    # Display format for the {timer} variable
    # Placeholders: {d} (days), {h} (hours), {m} (minutes), {s} (seconds)
    format: "&b{d}d {h}h {m}m"
    # Message shown when the countdown reaches zero
    finished: "&a&lWE ARE ONLINE!"

  # List of MOTDs for normal mode (Randomly selected on each ping)
  normal:
    - line1: "&5&lNebula Network &8| &f1.8 - 1.20"
      line2: "    &eGrand Opening in: {timer}"
    - line1: "&5&lNebula Network &8| &a&lNEWS"
      line2: "    &fVisit our official store: &bstore.nebula.com"
    - line1: "&5&lNebula Network &8| &6&lDouble XP"
      line2: "    &eThe event is active throughout the weekend!"

  # MOTD settings when Whitelist/Maintenance is ON
  maintenance:
    line1: "&5&lNebula Network &8| &cMaintenance Mode"
    line2: "    &4&lWe are currently working on improvements!"
    # The text shown in the player count hover (top right corner)
    protocol-name: "&4Maintenance"

  # Player count and slot settings
  players:
    max-enabled: true
    max-count: 1000
    fake-count-enabled: false
    fake-count-extra: 1

# ==========================================
#        NebulaCore - Global Settings
# ==========================================

# ==========================================
#          Anti-Spam Settings
# ==========================================
# Anti-Spam protection for Global Chat
anti-spam:
enabled: true
cooldown: 3

# ==========================================
#          Chat Filter Settings
# ==========================================
# Chat filter for blacklisted words
censor:
enabled: true
replacement: "****"
bypass-permission: "nebulacore.chatcensor.bypass"
words:
- "fuck"
- "nigger"
- "shit"
- "bitch"
- "hacker"
  # Notification System for Staff
notifications:
enabled: true
permission: "nebulacore.staff.notify.censor"
    # Placeholders: {prefix}, {player}, {message}
format: "&c&lCENSOR &8» {prefix}{player} &7tried to say: &f{message}"

# ==========================================
#        Chat Transformer (Auto-Replace)
# ==========================================
chat-replace:
enabled: true
bypass-permission: "nebulacore.chat.bypass"
partial-match: true
case-sensitive: false
  # Notification System for Staff
notifications:
enabled: true
permission: "nebulacore.staff.notify.replace"
    # Placeholders: {prefix}, {player}, {original}, {replaced}
format: "&b&lREPLACE &8» {prefix}{player} &7toxic detected: &f\"{original}\" &8-> &a\"{replaced}\""
mappings:
"this server sucks": "what a nice server"
"this is a terrible server": "what a nice server"
"admin is stupid": "admin is helpful"
"mods are useless": "mods are doing their best"
"server is trash": "server is great"
"i hate this server": "i really enjoy this server"
"worst server ever": "best server ever"
"your server is bad": "your server is awesome"
"laggy server": "smooth server"
"toxic community": "friendly community"

# ==========================================
#        Command Blocker (Security)
# ==========================================
command-blocker:
enabled: true
  # Permission to bypass the block
bypass-permission: "nebulacore.admin.bypass"
  # Message shown when a command is blocked
message: "&cError: &fUnknown or restricted command."
  # Notification System for Staff
notifications:
enabled: true
permission: "nebulacore.staff.notify.blocker"
    # Placeholders: {prefix}, {player}, {command}
format: "&6&lSECURITY &8» {prefix}{player} &7tried to use: &f/{command}"
  # List of commands to block (without /)
blocked-commands:
- "pl"
- "plugins"
- "ver"
- "version"
- "about"
- "icanhasbukkit"
- "me"
- "say"
- "execute"
- "bukkit:pl"
- "bukkit:plugins"
- "bukkit:ver"
- "bukkit:version"
- "bukkit:about"
- "bukkit:help"
- "bukkit:?"
- "?"

# ==========================================
#             MOTD Settings
# ==========================================
motd:
enabled: true

  # Timer Settings for countdowns
timer:
    # Toggle the {timer} placeholder globally
enabled: true
    # Target date in format: YYYY-MM-DD HH:MM:SS
date: "2026-06-01 18:00:00"
    # Display format for the {timer} variable
format: "&b{d}d {h}h {m}m"
    # Message shown when the countdown reaches zero
finished: "&a&lWE ARE ONLINE!"

  # List of MOTDs for normal mode (Randomly selected on each ping)
normal:
- line1: "&5&lNebula Network &8| &f1.8 - 1.20"
line2: "    &eGrand Opening in: {timer}"
- line1: "&5&lNebula Network &8| &a&lNEWS"
line2: "    &fVisit our official store: &bstore.nebula.com"
- line1: "&5&lNebula Network &8| &6&lDouble XP"
line2: "    &eThe event is active throughout the weekend!"

  # MOTD settings when Whitelist/Maintenance is ON
maintenance:
line1: "&5&lNebula Network &8| &cMaintenance Mode"
line2: "    &4&lWe are currently working on improvements!"
    # The text shown in the player count hover (top right corner)
protocol-name: "&4Maintenance"

  # Player count and slot settings
players:
max-enabled: true
max-count: 1000
fake-count-enabled: false
fake-count-extra: 1

# ==========================================
#          Staff Chat Settings
# ==========================================
staff-chat:
enabled: true
permission: "nebulacore.staffchat"
input-symbol: "#"
format: "&9[Staff] {prefix}{player} &7({server})&8: &f{message}"
toggle-command:
name: "sc"
aliases:
- "a"
- "staffchat"
notifications:
enabled: true

# ==========================================
#          SocialSpy Settings
# ==========================================
social-spy:
enabled: true
permission: "nebulacore.socialspy"
command: "socialspy"
aliases:
- "spy"
format: "&b&lSPY &8» &7{prefix_sender}{sender} &8-> &7{prefix_receiver}{receiver}: &f{message}"

# ==========================================
#          HelpOp Settings
# ==========================================
helpop:
permission-send: ""
permission-receive: "nebulacore.helpop.receive"
format: "&6&lHELPOP &8» &7{prefix}{player} &7({server})&8: &f{message}"
cooldown: 30

# ==========================================
#       Private Messaging Settings
# ==========================================
messaging:
bypass-permission: "nebulacore.msg.bypass"
toggle-command:
name: "togglemsg"
aliases:
- "msgtoggle"
- "tmsg"

# ==========================================
#          Command Customization
# ==========================================

lobby-command:
enabled: true
name: "lobby"
target: "Lobby"
permission: ""
aliases:
- "hub"
- "back"

ping-command:
enabled: true
name: "ping"
permission: ""
aliases:
- "latency"
- "ms"

find-command:
enabled: true
name: "find"
permission: "nebulacore.find"
aliases:
- "whereis"
- "search"

alert-command:
enabled: true
name: "alert"
permission: "nebulacore.alert"
aliases:
- "broadcast"
- "bc"

stafflist-command:
enabled: true
name: "stafflist"
  # Permission to execute the command
permission: "nebulacore.stafflist"
  # Permission required for a staff member to appear in the list
visible-permission: "nebulacore.staff"
aliases:
- "sl"
- "staffs"

glist-command:
enabled: true
name: "glist"
permission: "nebulacore.glist"
hide-empty: false
aliases:
- "gcount"
- "listall"

shop-command:
enabled: true
name: "bstore"
permission: "nebulacore.bstore"
url: "https://store.yourserver.com"
packages:
VIP:
display-name: "&a&lVIP"
broadcast-item: "the &a&lVIP rank"
VIP+:
display-name: "&2&lVIP+"
broadcast-item: "the &a&lVIP+ rank"

whitelist-settings:
command: "bwhitelist"
permission: "nebulacore.whitelist"
aliases:
- "bwl"

# ==========================================
#    NebulaCore - Language Configuration
# ==========================================
# INSTRUCTIONS:
# * Use '&' for color codes.
# * To DISABLE the global prefix, set it to ""
# * If you use a prefix, remember to add a space at the end.
# ==========================================

prefix: "&5&lNebulaCore &8» "
no-permission: "&cYou do not have permission to perform this action."
only-players: "&cThis command can only be executed by players."
reload-success: "&aAll configurations and messages have been reloaded!"

# Lobby & Alias Command Messages
lobby:
  disabled: "&cThe lobby command is currently disabled."
  connecting: "&7Connecting to &b{target}&7..."
  already-connected: "&cYou are already connected to this lobby!"
  no-target: "&cNo destination server found."
  server-not-found: "&cThe destination server &e{server} &cis offline."

# Ping Command Messages
ping:
  self: "&7Your current latency is &b{ping}ms&7."
  other: "&7The latency of &e{player} &7is &b{ping}ms&7."

# Find Command Messages
find:
  usage: "&cUsage: /find <player>"
  found: "&7Player &e{player} &7is currently at &b{server}&7."
  player-not-found: "&cPlayer not found."

# Alert Command Messages
alert:
  usage: "&cUsage: /alert <message>"
  format: "&4&lALERT &8» &f{message}"

# GList Messages
glist:
  header:
    - "&7&m--------------------------------------"
  server-format: " &8» &b{server}&8: &f{players} players"
  footer:
    - ""
    - "&eTotal players online&8: &6{total}"
    - "&7&m--------------------------------------"

# Server Alias Messages
aliases:
  connecting: "&7Redirecting you to &b{target}&7..."
  already-connected: "&cYou are already connected to this server!"
  server-offline: "&cThe destination &e{server} &cis currently unavailable."

# Staff System Messages
staffchat:
  enabled: "&aStaffChat mode enabled. You no longer need to use the prefix."
  disabled: "&cStaffChat mode disabled. Back to global chat."

staff:
  join: "&9[Staff] &a{prefix}{player} &ejoined the network."
  left: "&9[Staff] &c{prefix}{player} &eleft the network."
  move: "&9[Staff] &d{prefix}{player} &emoved to &b{server}&e."
  list-header:
    - "&7&m--------------------------------------"
  list-title:
    - "&eOnline Staff Members&8:"
  list-format: " &8» &b{prefix}{player} &7({server})"
  list-footer:
    - "&7&m--------------------------------------"
  no-staff: "&cThere are no staff members online."

# Private Messaging System
messaging:
  usage: "&cUsage: /msg <player> <message>"
  player-not-found: "&cPlayer not found."
  cannot-msg-self: "&cYou cannot send messages to yourself."
  no-reply: "&cYou have no one to reply to."
  send-format: "&7[me -> {prefix_receiver}{receiver}] &f{message}"
  receive-format: "&7[{prefix_sender}{sender} -> me] &f{message}"
  toggle-on: "&aYou have enabled private messages."
  toggle-off: "&cYou have disabled private messages."
  target-disabled: "&cThat player has private messages disabled."

# SocialSpy Messages
socialspy:
  enabled: "&aSocialSpy enabled. You can now see private messages."
  disabled: "&cSocialSpy disabled. You will no longer see private messages."

# HelpOp Messages
helpop:
  usage: "&cUsage: /helpop <message>"
  sent: "&aYour request has been sent to the staff online."
  cooldown: "&cPlease wait {seconds}s before sending another help request."

# Whitelist System
whitelist:
  enabled: "&aGlobal whitelist has been enabled."
  disabled: "&cGlobal whitelist has been disabled."
  player-added: "&7Player &b{player} &7has been &aadded &7to the whitelist."
  player-removed: "&7Player &b{player} &7has been &cremoved &7from the whitelist."
  already-in: "&e{player} is already on the whitelist."
  not-in: "&c{player} is not on the whitelist."
  usage: "&cUsage: /"
  list-format: "&5Whitelist: &f{players}"
  help-header: "&9&l{command} &7| &bHelp"
  help-lines:
    - " &e/{cmd} on/off &8- &fToggle status"
    - " &e/{cmd} add/remove <name> &8- &fManage players"
    - " &e/{cmd} list/preview &8- &fInfo"
    - " &e/{cmd} reload &8- &fReload configs"
  kick-message:
    - "&b&lNEBULA NETWORK"
    - ""
    - "&cThe server is currently under &4maintenance&c."
    - "&6Please try again later!"
    - ""
    - "&eDiscord&8: &fdiscord.gg/link"

# Anti-Spam System
antispam:
  wait-message: "&cPlease wait {seconds}s before sending another message."
  no-repetition: "&cPlease do not repeat the same message!"

# Shop & Broadcast Settings
shop:
  disabled: "&cThe shop command is currently disabled."
  usage: "&cUsage: /shop <package> <player>"
  invalid-package: "&cInvalid package. Available: {options}"
  hover-text: |
    &a&lCLICK HERE TO VISIT!
    &7Store: &fstore.yourserver.com
  click-hint: " &e&lClick here to open the store!"
  broadcast:
    - ""
    - " &b&l★ STORE PURCHASE ★"
    - ""
    - " &f{player} &7just bought &b{package}&7!"
    - " &eGet yours at: &bstore.yourserver.com"
    - " {click_message}"

• /nebulacore reload (alias: /nc reload)
Reloads all configuration files, messages, and active tasks.
Permission: nebulacore.admin

• /bwhitelist <on/off/add/remove/list/reload> (alias: /bwl)
Manages the global network maintenance mode and allowed player list.
Permission: nebulacore.whitelist

• /msg <player> <message> (aliases: /tell, /w, /whisper)
Sends a private message to a player anywhere on the network.
Permission: none

• /reply <message> (alias: /r)
Quickly replies to the last person who messaged you.
Permission: none

• /togglemsg (alias: /msgtoggle, /tmsg)
Enables or disables receiving private messages.
Permission: none

• /socialspy (alias: /spy)
Toggles the ability to see all private messages sent on the proxy.
Permission: nebulacore.socialspy

• /sc (aliases: /a, /staffchat)
Toggles staff chat mode or sends a message to staff members.
Permission: nebulacore.staffchat

• /stafflist (alias: /sl, /staffs)
Displays a list of online staff members, their server, and rank.
Permission: nebulacore.stafflist

• /helpop <message> (alias: /report)
Sends a priority request or report to all online staff. Permission: none (to send) / nebulacore.helpop.receive (to receive)

• /alert <message> (aliases: /broadcast, /bc)
Sends a global, aesthetic announcement to every player on the network.
Permission: nebulacore.alert

• /bstore <package> <player> (alias: /bshop)
Broadcasts a network-wide interactive announcement for shop purchases.
Permission: nebulacore.bstore

• /find <player> (aliases: /whereis, /search)
Locates which server a specific player is currently connected to.
Permission: nebulacore.find

• /glist (aliases: /gcount, /listall)
Shows a breakdown of players connected to each server and total online count.
Permission: nebulacore.glist

• /lobby (aliases: /hub, /back)
Sends the player to the designated main lobby server.
Permission: none (configurable)

• /ping [player] (aliases: /latency, /ms)
Displays your current latency or the latency of another player.
Permission: none (configurable)

• /<custom_command> (defined in commands.yml)
Custom info commands (e.g., /discord, /web, /store) with multi-line support.
Permission: Configurable per command

• /<alias_command> (defined in aliases.yml)
Shortcuts to connect directly to specific servers (e.g., /survival, /skyblock).
Permission: none

Permissions:

Bypass Message Toggle: nebulacore.msg.bypass
SocialSpy Access: nebulacore.socialspy
Receive Staff Notifications: nebulacore.staffchat
Staff Visibility (for list): nebulacore.staff
Anti-Spam / Censor Bypass: nebulacore.antispam.bypass / nebulacore.chatcensor.bypass / nebulacore.chat.bypass
Command Blocker Bypass: nebulacore.admin.bypass (Bypasses security command restrictions)
Staff Security Alerts: nebulacore.staff.notify.blocker (Receive notifications for blocked commands)
Staff Censor Alerts: nebulacore.staff.notify.censor (Receive notifications for censored words)
Staff Replace Alerts: nebulacore.staff.notify.replace (Receive notifications for word mapping/replacements)