VoidFall 2.0

VoidFall is a powerful and highly customizable plugin that triggers various actions for players based on specific events. From movement across coordinates to interactions with regions, VoidFall brings dynamic and engaging experiences to your server!

🌟 Features

• 🎯 Event-Based Triggers: Set up actions for a wide range of events:

  • World Triggers: Execute actions when players reach specified Y-coordinates.
    • Floor mode: When a player descends below a specific Y-level.
    • Roof mode: When a player ascends above a specific Y-level.
  • Region Triggers: React when players enter or leave regions.
  • Player State Triggers: Execute actions on join, quit, death, and respawn events.

• ⚡ Flexible Actions: Trigger a variety of actions when an event occurs:

  • Run commands as console or player.
  • Send messages:
    • Messages to the player.
    • Broadcasts to all online players.
  • Play sounds (to individual players or all players).
  • Display visual messages:
    • Titles (screen center).
    • ActionBars (above the hotbar).
  • Apply potion effects to players.
  • Teleport players to a specific location with precise control over X, Y, Z, yaw, and pitch.
  • Set the player’s gamemode (Survival, Creative, Adventure, or Spectator).

• 🎲 Random Action Selection: Define multiple actions and choose whether to execute all or only a random one.

• 🌈 Advanced Text Customization: Customize messages with advanced colorizers to support different formats:

  • LEGACY: Basic & color codes with hex support (&#).
  • LEGACY_ADVANCED: Extended &## format for more readability. (works fatser than LEGACY)
  • MINIMESSAGE: For advanced styling using <color></color> tags.
  • VANILLA: Basic & color codes.

• 📊 Placeholders Support: Integrates with PlaceholderAPI and supports internal placeholders like:

  • %player% - Player's name.
  • %world% - World name.
  • %world_display_name% - Custom display name of the world (configured in messages).
  • %region% - Name of the region where the event is triggered.

• 🔄 Update System:

  • Built-in update checker to notify you of new versions.
  • Optional auto-update functionality to keep the plugin up-to-date automatically.

• ⚙️ Dynamic Listener Registration: Optimized to register only the necessary listeners, minimizing performance overhead.

📜 Commands and Permissions

• /voidfall reload Reloads the plugin configuration.

  • Permission: voidfall.reload

• /voidfall update Downloads the latest allowed version of the plugin.

  • Usage: Console-only command.

🛠 Requirements

1. Java version: Plugin requires Java 11 or higher.

2. Region Triggers:

   • Requires the WorldGuardEvents plugin.

🌐 Examples

• Teleport a player to a spawn point when they fall below Y=0:

  worlds:
    world:
      floor:
        executing-height: 0
        execute-commands:
          - '[CONSOLE] spawn %player%'
  
  

• Welcome players with a title when they join the server:

  player:
    on-server-join:
      random: false
      execute-commands:
        - '[TITLE] &aWelcome;&fEnjoy your stay!;10;40;20'
        - '[ACTIONBAR] &6Thanks for vesiting us again'
  
  

• Send broadcast to all online players the the player has entered or leaved the server:

  player:
    on-server-join:
      random: false
      execute-commands:
        - '[BROADCAST] &2[+] &f%player% joined'
    on-server-leave:
      random: false
      execute-commands:
        - '[BROADCAST] &4[-] &f%player% leaved'