MyPure | Server Purifier & Optimizer v1.0.0

# =============================================================
# MyPure — Purify your server. One plugin to silence the noise.
# Author: fvl1s
# =============================================================

# Global plugin settings
general:
  # The global prefix used in all system messages. Supports MiniMessage (HEX/Gradients).
  prefix: "<aqua>MyPure <white>| "
  # List of worlds where the plugin's modules will be active.
  # Use ["all"] to enable functionality across every world on the server.
  enabled-worlds:
    - "all"

# -------------------------------------------------------------
# MODULE 1: QUIET CORE
# -------------------------------------------------------------
quiet-core:
  # Customizes the message shown when a player enters a non-existent command.
  unknown-command:
    # If true, the default "Unknown command" message will be replaced.
    enabled: true
    # The message sent to the player. Supports MiniMessage.
    message: "<prefix><red>Unknown command. Use /help for assistance."

  # [PAID FEATURE]
  # Advanced Tab-Complete Filter to hide specific commands from players and groups in the TAB menu.
  # Available in paid version (@RForever2).
  tab-complete-filter: false

# -------------------------------------------------------------
# MODULE 2: PHYSICS & PROTECTION
# -------------------------------------------------------------
physics:
  # Prevents blocks from being destroyed by TNT or Creeper explosions.
  explosion-protection: true
  # Stops fire from spreading to neighboring blocks and prevents blocks from burning away.
  fire-spread-stop: true
  # Prevents players, mobs, and animals from trampling farmland (crops).
  crop-trample-protection: true

  # Automatically teleports players to a safe location when falling into the void.
  void-save:
    # If true, falling below Y=0 will trigger a teleport.
    enabled: true
    # The destination for the teleport. Format: "world_name:x:y:z"
    spawn-location: "world:0:100:0"

  # [PAID FEATURE]
  # Extended physics control including per-flag protection for regions and specialized event blocking.
  # Available in paid version (@RForever2).
  extended-physics: false

# -------------------------------------------------------------
# MODULE 3: SOCIAL SILENCE
# -------------------------------------------------------------
social:
  connection-messages:
    # Completely removes vanilla "Player joined the game" and "Player left the game" messages.
    # This logic is non-intrusive and will not conflict with custom join/quit plugins.
    disable-default-join-quit: true

  advancements:
    # Hides the global chat notification when a player earns an achievement/advancement.
    hide-messages: true
    # [PAID FEATURE]
    # Hide advancement "Toasts" (the sliding icons in the top-right corner of the player's screen).
    # Available in paid version (@RForever2).
    hide-toasts: false

  death-messages:
    # Select the filtering mode for player death messages.
    # options: global (hide all), filtered (hide specific types), none (standard behavior).
    mode: "filtered"

    # List of damage causes to be hidden if 'filtered' mode is enabled.
    # Available types: CONTACT, ENTITY_ATTACK, PROJECTILE, SUFFOCATION, FALL, FIRE,
    # FIRE_TICK, MELTING, LAVA, DROWNING, BLOCK_EXPLOSION, ENTITY_EXPLOSION,
    # VOID, LIGHTNING, SUICIDE, STARVATION, POISON, MAGIC, WITHER,
    # FALLING_BLOCK, THORNS, DRAGON_BREATH, CUSTOM, FLY_INTO_WALL,
    # HOT_FLOOR, CRAMMING, DRYOUT, FREEZE, SONIC_BOOM.
    hidden-types:
      - "FALL"
      - "VOID"
      - "FIRE"
      - "DROWNING"
      - "LAVA"

# -------------------------------------------------------------
# MODULE 4: PERFORMANCE & CLEANER
# -------------------------------------------------------------
performance:
  # [PAID FEATURE]
  # Anti-Mob-Lag: Advanced optimization for entity AI and automatic removal of stuck mobs.
  # Available in paid version (@RForever2).
  anti-mob-lag: false

  # AUTOMATIC ENTITY CLEANER
  # Regularly clears specific entities from the world to maintain server performance.
  auto-cleaner:
    # If true, the automated cleanup task will run on the specified interval.
    enabled: true
    # Time in seconds between cleanup cycles (e.g., 600 = 10 minutes).
    interval: 600

    # List of entity types to target during cleanup.
    # Common types: ITEM (dropped items), ARROW, TRIDENT, EXPERIENCE_ORB.
    entities-to-clear:
      - "ITEM"
      - "ARROW"

    # List of materials or entity types that are immune to cleanup.
    # If an item material is listed here (e.g., DIAMOND), it will not be deleted even if it's on the ground.
    blacklist:
      - "DIAMOND"
      - "NETHERITE_INGOT"
      - "VILLAGER"
      - "ARMOR_STAND"

    notifications:
      # Enable countdown alerts and final reports in the global chat.
      enabled: true
      # Seconds remaining before cleanup to send a warning message.
      times: [30, 10, 5]
      # Message sent during countdown. Placeholders: <prefix>, <time>.
      warning-message: "<prefix><white>Ground items will be cleared in <aqua><time><white> seconds."
      # Message sent after a successful cleanup. Placeholders: <prefix>, <count>.
      final-message: "<prefix><green>Cleanup complete! Removed <white><count><green> entities."
      # Message broadcasted when a cleanup is manually triggered by a user or console.
      # Placeholders: <prefix>, <author>.
      manual-trigger: "<prefix><white>Manual cleanup initiated by <aqua><author><white>..."

# -------------------------------------------------------------
# MESSAGES & LOCALIZATION
# -------------------------------------------------------------
messages:
  # Standard response when a user lacks the required permission node.
  no-permission: "<prefix><red>You do not have permission to perform this action."
  # Response sent after the /mypure reload command completes successfully.
  reload-success: "<prefix><green>Configuration reloaded successfully."
  # Default help message explaining command usage.
  usage: "<prefix><white>Usage: <aqua>/mypure <reload|clean>"