DuckyZones

DuckyZones v2.0 - Complete Region System Rework

In v2.0, DuckyZones has been completely rebuilt into a much more advanced region management and protection system. This update introduces a new priority-based flag system, a complete in-game region management GUI, region selection tools, AFK reward zones, PlaceholderAPI integration, a public developer API, and dozens of new region controls inspired by advanced protection plugins.

Important: DuckyZones v2.0 contains major configuration and compatibility changes. Existing server owners should back up their current files and review the new config.yml structure before updating.

------------------------------------------------------------------------

Major New Features

Complete Region Flag System

- Added a completely new typed region flag system. - Each region can now contain its own flags section. - Flags support multiple value types: states, booleans, numbers, text, material lists, entity lists, locations, game modes, and weather values. - Region flags are grouped into categories for easier management. - Added support for resolving flags in overlapping regions. - Flags from regions with a higher priority take precedence. - Added source and priority tracking for resolved flag values.

zones:
  spawn:
    priority: 100
    flags:
      pvp: DENY
      build: DENY
      greeting: "&aWelcome to %region%!"

------------------------------------------------------------------------

Protection Flags

Added extensive control over player interactions and region protection.

Block Protection

- build - block-break - block-place - block-break-deny - block-break-allow - block-place-deny - block-place-allow

Interaction Protection

- use - chest-access - use-anvil - use-dripleaf - permit-workbenches - inventory-craft - villager-trade - sleep - respawn-anchors - lighter - item-frame-rotation

Entity and Vehicle Protection

- damage-animals - ride - vehicle-place - vehicle-destroy - entity-painting-destroy - entity-item-frame-destroy - disable-collision

Additional Protection

- pvp - tnt - block-trampling - frosted-ice-form - firework-damage - pistons ------------------------------------------------------------------------

Mob, Fire & Explosion Flags

Added new controls for mobs, explosions, fire, and entity-based world damage. - creeper-explosion - enderdragon-block-damage - ghast-fireball - other-explosion - fire-spread - enderman-grief - snowman-trails - ravager-grief - mob-damage - mob-spawning - deny-spawn - wither-damage - mob-entry

Mob Entry Protection

- Regions can now prevent mobs from entering. - Mobs attempting to enter a protected region are pushed back. - Knockback strength, vertical force, and cooldown are configurable globally.

region-flags:
  mob-entry:
    knockback-strength: 0.6
    knockback-y: 0.15
    cooldown-ms: 250

------------------------------------------------------------------------

Natural World Flags

Added control over natural world processes inside regions. - lava-fire - lightning - water-flow - lava-flow - snow-fall - snow-melt - ice-form - ice-melt - frosted-ice-melt - mushroom-growth - leaf-decay - grass-growth - mycelium-spread - vine-growth - rock-growth - sculk-growth - crop-growth - soil-dry - coral-fade - copper-fade ------------------------------------------------------------------------

Movement & Region Entry Flags

Added advanced control over entering, leaving, and teleporting through regions. - entry - exit - exit-via-teleport - exit-override - entry-deny-message - exit-deny-message - notify-enter - notify-leave - greeting - greeting-title - farewell - farewell-title - enderpearl - chorus-fruit-teleport - teleport - spawn - teleport-message - player-count-limit - player-count-limit-message

Player Count Limit

- Regions can now limit the number of players allowed inside at one time. - A custom message can be displayed when the limit is reached. - Overlapping regions respect the new priority system. ------------------------------------------------------------------------

Gameplay Flags

Added new controls for player gameplay, inventory usage, damage, commands, hunger, health, and items. - item-pickup - item-drop - exp-drops - deny-message - invincible - fall-damage - game-mode - time-lock - weather-lock - natural-health-regen - natural-hunger-drain - heal-delay - heal-amount - heal-min-health - heal-max-health - feed-delay - feed-amount - feed-min-hunger - feed-max-hunger - blocked-cmds - allowed-cmds - disable-completely - disable-throw - villager-trade - disable-collision - permit-workbenches - inventory-craft

Complete Item Restrictions

flags:
  disable-completely:
    - MACE
    - FIREWORK_ROCKET
    - TRIDENT

Thrown Item Restrictions

The new disable-throw flag can block eggs, snowballs, potions, tridents, and other supported projectile materials. ------------------------------------------------------------------------

Miscellaneous Flags

- send-chat - receive-chat - potion-splash - pistons ------------------------------------------------------------------------

Region Priority System

- Every region can now have a configurable priority. - Higher-priority regions override lower-priority regions when their areas overlap. - The system resolves each flag independently. - Added support for identifying the primary region, all regions at a location, the source region of a resolved flag, and the priority used to resolve it. ------------------------------------------------------------------------

In-Game Region Management

Region Selector Tool

- Left-click a block to set position 1. - Right-click a block to set position 2. - Selections are stored separately for each administrator. - Regions can be created directly from the selected cuboid.

Region Management GUI

- View all configured regions. - Open the management panel for a selected region. - Edit region priority. - Browse flag categories. - Change flag values from the GUI. - Enter text and numeric values through chat input.

New Commands

/duckyzones selector
/duckyzones pos1
/duckyzones pos2
/duckyzones create <name>
/duckyzones manage <name>
/duckyzones gui
/duckyzones reload

------------------------------------------------------------------------

AFK Reward Zones

- Any region can be configured as an AFK zone. - Supports multiple independent rewards per region. - Each reward can use its own interval and chance. - Supports permission-based chance overrides. - Supports multiple console commands per reward. - Displays countdowns through BossBars and the ActionBar.

zones:
  afk:
    afk-zone:
      enabled: true
      actionbar-format: "&eRewards: {rewards}"
      rewards:
        reward1:
          interval: 60
          chance: 10.0
          permission-chances:
            "duckyzones.afk.vip": 50.0
            "duckyzones.afk.premium": 75.0
          bossbar-format: "&eReward 1 in {time}"
          commands:
            - "give %player% diamond 1"

------------------------------------------------------------------------

PlaceholderAPI Integration

- Added PlaceholderAPI as a soft dependency. - DuckyZones now registers its own duckyzones expansion. - PlaceholderAPI placeholders can be used inside configured DuckyZones messages. - Added global, location-based, region-specific, and flag-specific placeholders.

Player Location Placeholders

```text %duckyzones_region_count% %duckyzones_current_region% %duckyzones_primary_region% %duckyzones_current_regions% %duckyzones_regions% %duckyzones_current_region_count% %duc