Перейти к содержимому
Mineforgian

DuckyZones

DuckyZones is a simple Minecraft plugin that lets you define custom zones for events, protection, or gameplay features using region selection tools.

Загрузки
149
Подписчики
7
Обновлён
3 мая 2025 г.
Лицензия
GPL-3.0-only

Опубликован 17 апреля 2025 г.

🧩 DuckyZones

Create custom zones with powerful rules and effects in your Minecraft world!
Highly configurable, efficient, and perfect for custom maps, events, or gameplay control.


📦 Description

DuckyZones allows you to define specific rectangular areas (zones) in your world where certain rules and effects apply.
Whether you're building PvP arenas, adventure maps, or controlled environments — this plugin gives you full control over player behavior inside defined areas.


⚙️ Features

  • 🔲 Create custom zones with two corners
  • 🌍 Per-zone world support
  • ❌ Block specific items or effects inside a zone
  • ✅ Require specific items or effects to enter
  • 🪂 Disable Elytra inside zones (auto-removes Elytra from player)
  • 🧪 Apply potion effects automatically in a zone
  • 🚫 Custom denial messages for rule violations
  • 💬 Configurable denial titles, subtitles, sounds, and more
  • 📛 Support for per-zone access restrictions using permissions
  • 🔃 Easy reload support without restarting the server
  • 🗂️ Simple config.yml layout
  • ☕ Built with Java 16, supports Minecraft 1.16.5 → 1.21+

🛡️ Permissions

Permission Node Description
duckyzones.zone.<zone> Grants access to a specific zone
duckyzones.zone.<zone>.bypass Bypass all restrictions (effects, items, etc.) in zone
duckyzones.zones.bypass Global bypass for all zones
duckyzones.reload Allows reloading the plugin using /duckyzones reload
duckyzones.update Allows receiving update notifications about new plugin versions

These permissions allow finer control over who can enter specific zones, ignore restrictions, or have special access.


🛠️ Configuration

📁 config.yml

# List of Items (1.21.5) : https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Material.html
# List of Effects (1.21.5) : https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/potion/PotionEffectType.html
zones:
  spawn: # Zone name
    world: world # World where zone is
    corner1: world,100,64,100 # First Zone Corner
    corner2: world,110,70,110 # Second Zone Corner
    elytra-disabled: false # Should be elytra disabled in that zone? This will remove the elytra from the player
    elytra-disabled-message: "Elytra is disabled in this zone!"
    blocked-items: # Player with these items in inventory cannot enter the zone
      - TNT
      - ENDER_PEARL
    blocked-effects: # Player with these effects cannot enter the zone, after leaving it they will disappear separator; means the power of the effect, e.g. SPEED;1 = Speed 1 in the game, if you want to block all powers of effect, you must do ;-1
      - SPEED;-1
      - INVISIBILITY;1
    required-items: # Only Player with these items in inventory can enter the zone
      - DIAMOND
      - TOTEM_OF_UNDYING
    required-effects: # Only Players with these effects can enter the zone, after leaving it they will disappear separator; means the power of the effect, e.g. SPEED;1 = Speed 1 in the game, if you want to block all powers of effect, you must do ;-1
      - NIGHT_VISION;1
    zone-effects: # Effects that will be applied after entering the zone, after leaving it they will disappear separator; means the power of the effect, e.g. SPEED; 1 = Speed 1 in the game
      - STRENGTH;2
    min-health: 5.0 # Players who do not have this number of hearts cannot enter
    max-health: 20.0 # Players who have this number of hearts or more cannot enter
    min-level: 5 # Players who do not have this amount of exp level cannot enter
    max-level: 100 # Players who have this amount of exp level or more cannot enter
    deny-message: "&cYou can't enter this area!" # Players who are unable to enter the zone will receive this message in chat when trying to enter
    zone-teleport-back-command: "spawn %player%" # The command that will be executed when the player enters the zone e.g. through teleportation, to call the player's nickname, just type %player%
    entry-deny-title: "&cEntrance prohibited &4✖" # Title that will appear on the screen when a player tries to enter the zone without meeting the requirements
    entry-deny-subtitle: "%reason%" # SubTitle that will appear on the screen when a player tries to enter the zone without meeting the requirements
    entry-deny-actionbar: "&eGet away from the zone!" # ActionBar that will appear on the screen when a player tries to enter the zone without meeting the requirements
    entry-deny-bossbar: "&4Entrance to the zone blocked!" # BossBar that will appear on the screen when a player tries to enter the zone without meeting the requirements
    entry-deny-sound: ENTITY.VILLAGER.NO # Sound that will play on the screen when a player tries to enter the zone without meeting the requirements

Ченджлог

1.1Релиз26.1, 26.1.1, 26.1.2 · 3 мая 2025 г.

📦 DuckyZones - Changelog v1.1

🚀 New Features & Improvements

🔒 Permissions System Expansion

  • Added more granular permission checks:
    • duckyzones.zone.<zone>.bypass
    • duckyzones.zones.bypass
    • duckyzones.zone.<zone>

🧹 Effect Cleanup Fix

  • Fixed an issue where zone effects were not correctly removed when leaving a zone.

📁 Configuration Improvements

  • ⚙️ Slightly changed how required-effects, blocked-effects, and blocked-items are defined in zones.yml.
  • Cleaner loading of effect/item data for better error handling and consistency.

🪄 General Code Cleanup

  • Codebase refactored for clarity and better performance.
  • Reduced unnecessary zone recalculations to avoid lag.

🦆 Thank you for using DuckyZones! Control your world with precision.

1.0Релиз1.21.3, 1.21.4, 1.21.5 · 1 мая 2025 г.

📦 DuckyZones v1.0 – First Public Release 🎉

The first official release of DuckyZones – a flexible, lightweight region management system for Minecraft servers!


✨ Features

  • 🗺️ Define custom zones using two corners
  • 🌍 Multi-world support
  • ❌ Block specific items and potion effects inside zones
  • ✅ Require specific items or effects to enter a zone
  • 🪂 Optional Elytra disabling – automatically removes Elytra when entering the zone
  • ❤️ Health and experience level restrictions per zone
  • 🧪 Automatically apply potion effects inside zones
  • 💬 Custom deny messages when entry conditions aren't met
  • 🔁 In-game config reloading with /duckyzones reload

🛠️ Command

/duckyzones reload

Reloads the plugin configuration without restarting the server.


🔑 Permissions

duckyzones.reload - Permission to use /duckyzones reload

duckyzones.update - Permission to see Update info in-game

duckyzones.zone. - Permission to enter specific zone

duckyzones.zone..bypass - Permission to bypass all restrictions to enter specific zone

duckyzones.zones.bypass - Permission to bypass all restrictions to enter any zone


🧾 Configuration

Zones are defined in config.yml like this:

# List of Items (1.21.5) : https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Material.html
# List of Effects (1.21.5) : https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/potion/PotionEffectType.html
zones:
  spawn: # Zone name
    world: world # World where zone is
    corner1: world,100,64,100 # First Zone Corner
    corner2: world,110,70,110 # Second Zone Corner
    elytra-disabled: false # Should be elytra disabled in that zone? This will remove the elytra from the player
    elytra-disabled-message: "Elytra is disabled in this zone!"
    blocked-items: # Player with these items in inventory cannot enter the zone
      - TNT
      - ENDER_PEARL
    blocked-effects: # Player with these effects cannot enter the zone
      - SPEED
      - INVISIBILITY
    required-items: # Only Player with these items in inventory can enter the zone
      - DIAMOND
      - TOTEM_OF_UNDYING
    required-effects:  # Only Player with these effects can enter the zone
      - NIGHT_VISION
    zone-effects: # Effects that will be applied after entering the zone, after leaving it they will disappear separator; means the power of the effect, e.g. SPEED;1 = Speed 2 in the game
      - SPEED;1
      - NIGHT_VISION;0
    min-health: 5.0 # Players who do not have this number of hearts cannot enter
    max-health: 20.0 # Players who have this number of hearts or more cannot enter
    min-level: 5 # Players who do not have this amount of exp level cannot enter
    max-level: 100 # Players who have this amount of exp level or more cannot enter
    deny-message: "&cYou can't enter this area!" # Players who are unable to enter the zone will receive this message in chat when trying to enter
    zone-teleport-back-command: "spawn %player%" # The command that will be executed when the player enters the zone e.g. through teleportation, to call the player's nickname, just type %player%
    entry-deny-title: "&cEntrance prohibited &4✖" # Title that will appear on the screen when a player tries to enter the zone without meeting the requirements
    entry-deny-subtitle: "%reason%" # SubTitle that will appear on the screen when a player tries to enter the zone without meeting the requirements
    entry-deny-actionbar: "&eGet away from the zone!" # ActionBar that will appear on the screen when a player tries to enter the zone without meeting the requirements
    entry-deny-bossbar: "&4Entrance to the zone blocked!" # BossBar that will appear on the screen when a player tries to enter the zone without meeting the requirements
    entry-deny-sound: ENTITY.VILLAGER.NO # Sound that will play on the screen when a player tries to enter the zone without meeting the requirements

Комментарии

Загружаем…