🚀 WeaponMaker 1.5.2 - Teams, Halos e more! Update

This release bumps the plugin version to 1.5.2, introducing three advanced cosmetic halos—including a complex multi-layered Summoning/Magic Circle where nested layers rotate in opposite directions when animated—full command aliases, custom bullet speed and range physics settings, and brand new GUI preview capabilities for particles and sounds!

---

💥 Custom Bullet Speed & Range Physics (NEW!)

We have expanded the shooting engine to support genuine 3D flying bullet physics and customizable travel ranges:

1. Bullet Speed (bullet_speed):
   • Real-time Projectile Flying: Allows weapons to shoot real flying projectile particles instead of instant hitscans!
   • 0 (Default): Instant hitscan (traditional immediate damage).
   • 1 to 1000: Bullet travel speed. 1 is extremely slow (1 block/second), while 1000 is hyper-fast (1000 blocks/second / 50 blocks/tick).
   • Command: /weaponmaker edit <id> bullet_speed <0-1000> or /wm edithand bullet_speed <0-1000>
2. Bullet Range (bullet_range):
   • Max Block Travel Limit: Limits how far a bullet can travel before disappearing (stopping particle trails and preventing far-away hits).
   • 300 (Default): Standard range of 300 blocks.
   • 0: Infinite range.
   • 1 to 20000 blocks limit.
   • Command: /weaponmaker edit <id> bullet_range <0-20000> or /wm edithand bullet_range <0-20000>

Both parameters are fully integrated into tab auto-completion and auto-suggestions.

---

🛠️ Direct Editor Redirection (/weaponmaker editorhand)

• Direct Access: Fixed /weaponmaker editorhand not opening the GUI directly on the held weapon. It now skips the main menu and goes straight to the specific weapon's editor interface.

---

⚒️ Upgrade Chain State Persistence & Visibility Fixes

• Unlinking Fix: Resolved a major state persistence bug in the Upgrade Chain Editor. Right-clicking an upgrade stage to unlink it now correctly resets its upgradeFrom property to "NONE". Unlinked weapons will now instantly reappear in the main menu!
• Upgrade Chain Protection: In-game direct chat commands like /weaponmaker edit <id> now explicitly block editing upgrade-chain weapons. This ensures upgrade progression trees cannot be edited or modified out of order.
• Improved Auto-suggestions: Tab completion in /weaponmaker commands continues to dynamically filter out upgrade stages to keep your console completely clutter-free.

---

⚙️ Redstone Toggle & Reorganized Edit Menu Grid

• Editor Visibility Toggle (Redstone Block): Added a new Redstone Block button in the Weapon Edit Menu (Slot 22). Clicking this button toggles the visibility of the weapon on the main screen of /weaponmaker editor. This gives you full control over which weapons are displayed in the main selection list!
• Compact & Symmetric Layout: Moved the Upgrade Editor (Nether Star) button from slot 42 to slot 31. This aligns it perfectly next to the other edit buttons, creating a perfect rectangular 3x4 layout for clean visual aesthetics.

---

💫 Rotation Animation Speed (1-50)

• Customizable Speed: The /weaponmaker halo_rotate_animate command has been enhanced. It now accepts an optional rotation speed parameter from 1 to 15:
  • 1: Extremely slow rotation.
  • 5 (Default): The fluid standard speed.
  • 15: Hyper-fast rotation.
  • Usage: /weaponmaker halo_rotate_animate <id> <true|false> [speed (1-15)]
• In-game Property: You can edit the rotation speed directly using /weaponmaker edit <id> halo_speed <1-15> or /weaponmaker edithand halo_speed <1-15> with full tab completions.
• Full Compatibility: Existing weapons default to speed 5, ensuring zero breakages or config changes.

---

🖱️ Interactive GUI Picker Menus (New Preview Feature!)

We have revolutionized the User Experience (UX) inside our selection pickers:

1. Particle Picker:
   • Left Click: Plays an instant particle preview (a burst of 20 particles) around the player so you can test visual effects in real time without closing the menu!
   • Right Click: Saves and applies the selected particle to the weapon, returning you to the main menu.
   • Lore Tooltip: Clean grey lines are shown on each firework star: Click Sinistro: Anteprima Click Destro: Applica
2. Sound Picker:
   • Left Click: Plays an audio preview of the selected sound at the player's location.
   • Right Click: Saves and applies the sound to the weapon.
   • Lore Tooltip: Displays the same helpful Left/Right click instructions.

---

⌨️ Command Aliases registered

• Added complete command aliases! You can now execute any WeaponMaker command using these shortcuts:
  • /wm <commands>
  • /wpm <commands>
  • /weaponm <commands>
  • /wmkr <commands>

---

🌀 18 Advanced Cosmetic Halos (3 New Shapes Added!)

We have expanded the geometric particle engine to support 18 distinct shapes, adding:

16. MOON (The Moon) 🌙 (Deeply Closed & Wrapping!)
    • Perfect Crescent Moon: Rebuilt the Moon shape to match reference pictures. It now wraps deeply into a gorgeous closed profile (sweeping a wide $246^\circ$ arc) with two thin ends folding inwards beautifully for a realistic, clean, and elegant crescent moon silhouette without overlapping lines.
17. SUN (The Sun) ☀️
    • A bright central ring radiating 8 solar rays outwards in a symmetric pattern.
18. MAGIC_CIRCLE (The Magic Circle) 🔮
    • Multi-layered Summoning Circle: Features 3 nested layers that rotate dynamically at different speeds and in opposite directions:
      • Outer Circle: Rotates clockwise at normal speed (1.0x).
      • Middle Star/Octagram: A beautiful 8-pointed star that rotates counter-clockwise (-1.2x).
      • Inner Circle: A compact inner ring that rotates clockwise at double speed (2.0x).
      • When halo_animated is set to false, the magic circle remains frozen as a beautifully aligned, symmetric summoning crest.
19. PENTAGRAM_CIRCLE (The Pentagram Circle combo) 🔯
    • A gorgeous multi-layered design:
      • Outer Ring: Rotating clockwise at normal speed (1.0x).
      • Inner Pentagram (5-pointed star): A star pattern rotating counter-clockwise (-1.2x).
20. RUNIC_SHIELD (The Runic Shield Aura) 🛡️
    • A complex triple-layered aura:
      • Outer Ring: Rotating clockwise at 0.8x speed.
      • Middle Diamond/Square: A geometric shield outline rotating counter-clockwise at -1.2x speed.
      • Inner Ring: A fast core rotating clockwise at double speed (2.0x).

All shapes can be chosen in-game using /weaponmaker halo_geometric <id> <SHAPE> or /weaponmaker edit <id> halo_shape <SHAPE> with full auto-completion support.

---

⚡ Extended Halo Animation Speed

• High-Precision Tuning: Raised the limit for halo animation speed (halo_speed and /weaponmaker halo_rotate_animate) from 1-15 to 1-50!
• Granular Control: Speed 1 is ultra-slow for peaceful glowing orbs, and 50 provides lightning-fast mystical frequencies for hyper-charged relics.

---

🎇 Dynamic & Static Particle Variants (halo_type)

• Dynamic HEX Potion Effects: The dynamic particle options supporting full HEX coloring now include DUST, DUST_COLOR_TRANSITION, and ENTITY_EFFECT (representing Spigot's unified potion particle for 1.21.1).
• Universal Static Particles: You can now enter any valid Minecraft Spigot particle name as your halo_type! The plugin will auto-detect and spawn it as a gorgeous static effect (e.g. FLAME, SOUL_FIRE_FLAME, WITCH, PORTAL, HAPPY_VILLAGER, HEART, GLOW, SNOWFLAKE), falling back gracefully to customized color dust if an invalid name is input.

---

☠️ Simplified Death Messages

• Shorthand Format: Writing custom death messages is now easier than ever! Instead of writing the full <victim> has been vaporized by <killer>, you can now just write the central part: " has been vaporized by " or " è stato eliminato da ".
• Automatic Wrapping & Spacing: The plugin will automatically place the victim's name at the beginning and the killer's name at the end, ensuring that exactly one single space is placed between the names and the central message to avoid duplicate or lack of spacing!
• Backward Compatibility: Original explicit <victim> and <killer> tags are still fully supported and replaced as usual.

---

👥 Custom Team System (/wm teams)

• Teammate Friendly-Fire Prevention: We have introduced a fully persistent, customizable in-house Team System to prevent teammates from damaging each other!
• Projectile Pass-through: When friendly fire is disabled for a team, fired bullets and projectiles (including flying particle physics and hitscans) will pass smoothly through teammates without dealing any damage or wasting ammunition, creating a high-end, competitive combat experience.
• Commands & Configuration:
  • /wm teams create <team_name>: Create a new team. The creator automatically joins their team upon creation!
  • /wm teams delete <team_name>: Delete an existing team.
  • /wm teams invite <player>: Send an invitation to an online player. Invites last exactly 2 minutes (120 seconds) before expiring and notifying both parties.
  • /wm teams accept: Accept a pending invitation. Once accepted, a chat broadcast notifies the server that the player has joined the team!
  • /wm teams decline / /wm teams deny: Reject a pending invitation.
  • /wm teams add <team_name> <player>: Force a player into a team.
  • /wm teams remove <player>: Force the removal of a player from any team.
  • /wm teams friendlyfire <team_name> <true|false>: Enable or disable friendly fire for the team (default is false).
  • /wm teams color <team_name> <color|HEX>: Set a custom team color! Supports standard color names (RED, BLUE, YELLOW, LIME, GREEN, PURPLE, MAGENTA, GOLD, AQUA, WHITE) and custom hex strings (e.g. #FF5555).
  • /wm teams glow <team_name>: Toggle a glowing outline around all team members! The glowing outline dynamically matches the custom team color, mapped using a 3D Euclidean distance algorithm against Vanilla's 16 scoreboard colors!
  • /wm teams join <team_name>: Join a team.
  • /wm teams leave: Leave your current team.
  • /wm teams list: List all teams, their color, glow state, friendly fire state, and all online/offline members.
• Data Persistence: Teams are fully serialized and saved automatically to teams.yml in the plugin data folder.
• Tab Completer: Fully integrated with complete command suggestions for team names, subcommands, custom colors, and online players!

---

🎨 Interactive Color Picker GUI & Dynamic Previews (NEW!)

We have drastically refined the Halo customization experience:

1. Interactive Color Picker Menu:
   • 17 Color Dyes: Slot 20 in the Halo Config menu now opens a dedicated selettore a icone with 17 beautiful color dyes (RED, ORANGE, YELLOW, LIME, GREEN, AQUA, TEAL, BLUE, NAVY, PURPLE, FUCHSIA, MAROON, OLIVE, WHITE, SILVER, GRAY, BLACK). Clicking any dye instantly applies that color and disables RGB ✨ for immediate visibility!
   • HEX Customizer (Name Tag): Click to type any custom HEX color (e.g. #FF5555) in chat.
   • Seamless Back-navigation: Cancelling or completing chat inputs inside the Color Picker now returns you directly to the Color Picker GUI instead of the parent main menus.
2. Dynamic Halo-colored Previews:
   • In the Particle Picker menu, left-clicking on DUST, DUST_COLOR_TRANSITION, or ENTITY_EFFECT (colored potion bubbles) plays a player-centered preview colored with the weapon's active haloColor or dynamic HSB ✨! This lets you see exactly how the particle will look with your chosen weapon color before applying it!
3. Symmetric Main Menu RGB Integration:
   • RGB ✨ Toggle (Glowstone Dust): Now placed directly on the main "Configura Halo: " menu (Slot 21). Click to instantly toggle the RGB ✨ on or off!
   • Velocità RGB ✨ (Redstone Lamp): Now placed as a dedicated button directly on the "Configura Halo: " menu (Slot 23). Click to set the custom speed (0-10) in chat!
   • This leaves the Color Picker GUI 100% clean and focused purely on choosing static dyes and custom HEX inputs without overlapping.

---

⚡ Non-linear Quadratic Rotation Speed (1-50) (NEW!)

• Wide Precision Scale: Redesigned the rotation speed algorithm! Instead of simple linear increments, the speed now scales quadratically (0.1 * hSpeed * hSpeed):
  • Ultra-peaceful Orbit (speed = 1): Takes exactly 62.8 seconds to perform a single complete orbit. Perfect for peaceful low-energy shields and slow halos!
  • Default standard (speed = 5): Takes exactly 2.5 seconds for a full rotation (exactly matches the classic default speed value).
  • Hyper-mystical Frequencies (speed = 50): Orbiting at a hyper-fast rate of 40 rotations per second! Provides a mesmerizing lightning frequency for powerful cosmic relics!

---

🥊 Universal Bare-Punch Friendly Fire Block (NEW!)

• Total Protection: The teammate friendly fire block has been extended to all forms of direct player-to-player damage!
• Punch Friendly Fire: If friendly fire is disabled for a team, players can no longer damage or punch their teammates with their bare hands, swords, or tools, ensuring complete team protection during intense skirmishes.