oaexploits

Key Features and Configurations

Key Features

1. /oaexploitsgui Command Features:

   • Ban and Unban GUI: Intuitive GUIs for banning and unbanning players with player heads for easy identification. Includes confirmation messages for admins and prevents self-banning.

2. Illegal Items Management:

   • Detects and removes illegal items from inventories and containers.

3. Chunk Limiter:

   • Sets limits for specific items within each chunk to prevent excessive block placement.

4. Command Control:

   • Blocks specific commands and allows a whitelist of permitted commands.

5. Customizable Notifications:

   • Sends customizable messages to players when they interact with illegal items.

6. /stats Command:

   • Provides comprehensive world statistics for admins and players.

7. Admin Alerts:

   • Sends alerts to admins when players interact with illegal items.

8. Deop on Leave:

   • Automatically deops players upon leaving the server, with optional teleportation and messages.

9. Logging and Debugging:

   • Logs illegal item actions with configurable log levels and debug mode.

10. Wither Spawn Sound Alert:

    • Plays a sound for all players within a configurable radius when a Wither is spawned.

11. Clear Withers in Chunk:

    • Allows admins to clear all Withers in a chunk using the GUI.

Configuration (config.yml)

Spoiler

config-version: 1.3.81

# Illegal items configuration
illegal-items:
  blocks:
    - CHAIN_COMMAND_BLOCK
    - COMMAND_BLOCK
    - COMMAND_BLOCK_MINECART
    - REPEATING_COMMAND_BLOCK
    - BEDROCK
    - BARRIER
    - STRUCTURE_BLOCK
    - STRUCTURE_VOID
    - NETHER_PORTAL
    - LIGHT
    - END_PORTAL_FRAME
    - END_PORTAL
    - SPAWNER
  items:

discord-alerts:
  webhook-url: "YOUR_DISCORD_WEBHOOK_URL" # Replace with your actual Discord webhook URL

# define the radius on how far the wither-spawn sound should be
wither-sound:
  radius: 20
  sound: ENTITY_WITHER_SPAWN
  volume: 1.0
  pitch: 1.0

# Chunk limiter configuration
chunk-limiter:
  limits:
    CHEST: 400
    TRAPPED_CHEST: 400
    TNT: 200
  messages:
    block-limit-exceeded: You cannot place more than {limit} {block} blocks in this chunk.

# Command whitelist configuration
command-whitelist:
  enabled: true
  commands:
    - help
    - vote
    - joindate
    - kill
    - discord
    - togglechat
    - toggleconnectionmsgs
    - toggletells
    - togglewhispering
    - toggleprivatemsgs
    - ignore
    - ignorelist
    - ignorehard
    - toggledeathmsg
    - dmt
    - worldstats
    - playtime
    - stats
    - tps
    - msg
    - whisper
    - w
    - m
    - t
    - pm
    - tell
    - r
    - reply
    - last
    - kill
    - shop
    - skin

# Command blacklist configuration
command-blacklist:
  enabled: true
  commands:
    - op
    - deop
    - plugins
    - pl
    - bukkit:plugins
    - bukkit:pl
    - bukkit:?
    - bukkit:help
    - .plugins

# Additional configurations
additional-configs:
  check-interval: 10 # Time in seconds between periodic checks
  inventory-scan-depth: 3 # Depth of inventory scanning, affects how many nested inventories are checked

removal-options:
  remove-illegal-items: true
  clean-shulkers-on-place: true
  notify-player-on-illegal-placement: true

messages:
  illegal-item-placement:
    title: "&cIllegal Block!"
    subtitle: "&cThis is an illegal item!"
  illegal-item-interaction:
    title: "&cIllegal Item!"
    subtitle: "&cYou tried to interact with an illegal item: %item%"
  illegal-item-movement:
    title: "&cIllegal Item!"
    subtitle: "&cContainer tried to move an illegal item: %item%"
  illegal-item-removal:
    title: "&cIllegal Items Removed!"
    subtitle: "&cIllegal items were removed from your inventory."
  admin-alert: "&c%player% tried to interact with an illegal item: %item%"

# Maximum levels for enchantments
max_enchantment_levels:
  PROTECTION: 4
  FIRE_PROTECTION: 4
  FEATHER_FALLING: 4
  BLAST_PROTECTION: 4
  PROJECTILE_PROTECTION: 4
  RESPIRATION: 3
  AQUA_AFFINITY: 1
  THORNS: 3
  DEPTH_STRIDER: 3
  FROST_WALKER: 2
  BINDING_CURSE: 1
  SHARPNESS: 5
  SMITE: 5
  BANE_OF_ARTHROPODS: 5
  KNOCKBACK: 2
  FIRE_ASPECT: 2
  LOOTING: 3
  SWEEPING_EDGE: 3
  EFFICIENCY: 5
  SILK_TOUCH: 1
  UNBREAKING: 3
  FORTUNE: 3
  POWER: 5
  PUNCH: 2
  FLAME: 1
  INFINITY: 1
  LUCK_OF_THE_SEA: 3
  LURE: 3
  LOYALTY: 3
  IMPALING: 5
  RIPTIDE: 3
  CHANNELING: 1
  MULTISHOT: 1
  PIERCING: 4
  QUICK_CHARGE: 3
  MENDING: 1
  VANISHING_CURSE: 1

# Enchantment settings
enchantment_settings:
  revert_items: true
  notify_player: false
  log_illegal_items: true

# Enchantment messages
enchantment_messages:
  illegal_item: "&aAn item in your inventory had illegal enchantments and has been reverted to a legal state."
  log_illegal_item: "&eIllegal enchantment detected on item: &c%item% &efrom player: &c%player%"
  admin_alert: "&c%player% tried to interact with an illegal item: %item%"

deop-on-leave:
  enabled: true  # Set to false to disable deop on leave
  whitelist:
    players:
      - "AdminPlayer1"
      - "AdminPlayer2"
  teleport:
    world: "world"
    x: 0.0
    y: 64.0
    z: 0.0
    yaw: 0.0
    pitch: 0.0
  message: "&cYou have been deopped, your inventory cleared, and you have been teleported to the spawn point."
  title:
    main: "&cDeopped"
    subtitle: "&cYou have been deopped and teleported to the spawn point."
    fade-in: 20  # Duration in ticks (1 second = 20 ticks)
    stay: 60  # Duration in ticks
    fade-out: 20  # Duration in ticks

# Admin alerts configuration
admin-alerts:
  enabled: true
  permission: oaexploits.alerts
  cooldown: 60 # seconds between alerts to avoid spam

# Logging settings configuration
log-settings:
  log-illegal-item-actions: true
  log-file: logs/oaexploits.log
  log-level: WARNING

# Debug mode configuration to see what commands people are executing
debug-mode: false

For any issues or support, please visit the OaExploits Discord. Leave a review of the plugin on Spigot and let us know what you think!