🛠️ 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

%duckyzones_region_count%
%duckyzones_current_region%
%duckyzones_primary_region%
%duckyzones_current_regions%
%duckyzones_regions%
%duckyzones_current_region_count%
%duckyzones_highest_priority%
%duckyzones_priority%
%duckyzones_world%

Flag Placeholders

%duckyzones_flag_<flag-id>%
%duckyzones_flag_source_<flag-id>%
%duckyzones_flag_priority_<flag-id>%

Region-Specific Placeholders

%duckyzones_region_<region-id>_id%
%duckyzones_region_<region-id>_priority%
%duckyzones_region_<region-id>_world%
%duckyzones_region_<region-id>_flags%
%duckyzones_region_<region-id>_flag_count%
%duckyzones_region_<region-id>_volume%
%duckyzones_region_<region-id>_flag_<flag-id>%

🔧 Public Developer API

Added a new public API for external plugins and custom integrations.

import pl.barpad.duckyzones.api.DuckyZonesApi;
import pl.barpad.duckyzones.api.DuckyZonesProvider;

DuckyZonesApi api = DuckyZonesProvider.get();
boolean insideRegion = api.isInsideRegion(player.getLocation());

String currentRegion = api.getPrimaryRegionAt(player.getLocation())
        .map(region -> region.getId())
        .orElse("");

The API is also available through Bukkit Services Manager.

🔧 Internal Improvements

Reorganized listeners into dedicated protection, combat, explosion, mob, natural, gameplay, piston, GUI, and selection listeners.
Added separate services for flag resolution, block actions, item restrictions, messages, player tracking, tick processing, Elytra restrictions, mob entry, chat input, placeholders, GUI, and selection.
Improved command permission registration and command map error handling.
Added JUnit 5 testing support.
Updated Gradle wrapper to 9.6.1.
Added proper shutdown handling for tasks, API services, placeholders, AFK rewards, mob tracking, and player-region processing.

🌍 Compatibility Changes

☕ Java Requirement

Java 16 → Java 21

🎮 Minecraft Requirement

Minecraft 1.16.5+ → Minecraft 1.21.11+

🔗 Optional Dependencies

Added PlaceholderAPI support as a soft dependency.
Added VaultAPI to the project dependencies for integration support.

⚠️ Required Configuration Migration

DuckyZones v2.0 introduces a significantly expanded configuration structure.

Before updating:

Back up your existing config.yml.
Back up all configured zone data.
Generate or obtain the new v2.0 default configuration.
Transfer your existing zone coordinates and legacy restrictions.
Add region priorities and flags using the new format.
Configure region-flags.mob-entry if mob-entry protection will be used.
Configure AFK reward sections for any AFK zones.
Verify all materials, effects, sounds, and game modes against Minecraft 1.21.11.

⚠️ Directly using an old v1.1 configuration without reviewing it is not recommended.

📦 Version

Updated plugin version to 2.0

📌 Summary

DuckyZones v2.0 is a complete rebuild of the plugin's region system.

The update adds a powerful priority-based flag engine, dozens of protection and gameplay flags, region overlap resolution, a management GUI, selection commands, AFK reward zones, PlaceholderAPI integration, a public developer API, mob-entry knockback, player limits, custom messages, item restrictions, and extensive controls over combat, movement, mobs, explosions, natural processes, crafting, commands, health, hunger, chat, and world behavior.

This version also updates the technical requirements to Java 21 and Minecraft 1.21.11+.

⚠️ Server owners upgrading from DuckyZones v1.1 should treat v2.0 as a major migration and carefully update their configuration before starting the plugin.

DuckyZones

DuckyZones 2.0

Список изменений