Regalor Elementals ✨ Custom skills for your server. -----
Grant Unique Elemental Powers to Your Players!
✨ Regalor Elementals ✨
Grant Unique Elemental Powers to Your Players!
Grant Unique Elemental Powers to Your Players!
Introduction
Hey there, server admins! Welcome to Regalor Elementals, a flexible plugin designed to spice up your Minecraft server by allowing you to create completely custom elemental powers. Imagine items that let players shoot fireballs , turn invisible , fly through the air ️, or even call down lightning ⚡️! This plugin provides the framework for you to define these powers through simple configuration files.
Players receive a random power when they first need one (using `/rsobtain`) and can use their unique item to unleash cool abilities, complete with cooldowns, costs, and effects!
Features
- ✨ Highly Customizable Powers: Define abilities via easy-to-understand YAML files. No coding needed!
- Custom Items: Control the name, material, lore, and even CustomModelData of power items.
- ⏳ Cooldown System: Prevent ability spam with configurable cooldowns shown on a Boss Bar.
- ❤️ Resource Costs: Make abilities cost XP Levels or Player Health for balance.
- Effects & Sounds: Add particle effects and sounds for ability activation feedback.
- Random Assignment: Players get a random power using `/rsobtain` if they don't have one.
- ️ Item Protection: Power items are protected from dropping, being placed, moved into chests/armor slots, or lost on death (returns on respawn).
- ️ Admin Control: Reload configs and change player powers easily.
Installation
- Download the RegalorElementals-X.X.X.jar file.
- Stop your server.
- Place the .jar file into your server's plugins/ directory.
- Start your server.
- The plugin will generate config.yml and an empty powers/ folder inside plugins/RegalorElementals/.
- Start creating your awesome powers inside the powers/ folder!
⚙️ Configuration (config.yml)
This file is located in plugins/RegalorElementals/config.yml.
- debug-mode
Set to `true` to see detailed logs in the console, useful for troubleshooting power loading or errors. Keep `false` for normal use.
Code (YAML):debug-mode : false - registered-powers
A list of power filenames (without `.yml`) that the plugin should load from the `powers/` folder. The plugin will only recognize powers listed here.
Code (YAML):registered-powers :
- "infernos"
- "aerol"
- "shield"
- "stormbringer"
# Add more power file names here - received-powers
⚠️ Do not edit manually! The plugin stores player power assignments here. - Inventory Full Messages
Customize the title/subtitle shown when a player tries to obtain an item but their inventory is full.
Code (YAML):messages:
inventory-full-title : "&cInventory Full!"
inventory-full-subtitle : "&eClear space to receive item!"
Creating Custom Powers (`powers/` folder)
This is the core of the plugin! Each unique power is defined by its own `.yml` file inside `plugins/RegalorElementals/powers/`. For example, a power named "Infernos" would be configured in `plugins/RegalorElementals/powers/infernos.yml`, and you must add `"infernos"` to the `registered-powers` list in `config.yml`.
Let's break down the configuration options for a power file:
Defines how the power item looks.
- display-name: The item's name. Use `&` for color codes.
Code (YAML):display-name : "&6&lInfernos" - material: The item's type. Use Bukkit Material names.
Code (YAML):material : NETHER_STAR - custom-model-data: (Optional) ID for resource packs. Defaults to `0`.
Code (YAML):custom-model-data : 1001 - lore: List of description lines below the name. Use `&` for colors.
Code (YAML):lore :
- "&eHarness the power of the nether."
- "&7Right-click to unleash a fireball!"
- ""
- "&cCooldown : %cooldown% seconds"
Controls the power's mechanics.
- spawn-chance: Weight for random assignment (`/rsobtain`). Higher = more common. `0` disables random assignment.
Code (YAML):spawn-chance : 3 - cooldown: Seconds to wait after using the ability. `0` for no cooldown.
Code (YAML):cooldown : 5 - post-flight-cooldown: Only for `flight` ability type. Cooldown in seconds *after* flight ends before flying again.
Code (YAML):post-flight-cooldown : 10
Optionally require resources to use the ability.
- use-xp-cost: `true` or `false`. Does the ability cost XP levels?
Code (YAML):use-xp-cost : true - xp-cost-levels: Number of XP *levels* required if `use-xp-cost` is `true`.
Code (YAML):xp-cost-levels : 1 - use-health-cost: `true` or `false`. Does the ability cost health?
Code (YAML):use-health-cost : true - health-cost: Amount of health (half-hearts) cost if `use-health-cost` is `true`. `2.0` = 1 full heart. Won't kill the player.
Code (YAML):health-cost : 4.0 # Costs 2 hearts
Feedback when the ability activates.
- activation-sound: Sound name from Bukkit Sound Enum (e.g., `ENTITY_PLAYER_LEVELUP`). `NONE` to disable.
Code (YAML):activation-sound : ENTITY_GHAST_SHOOT - activation-sound-volume: Sound volume (e.g., `1.0`).
Code (YAML):activation-sound-volume : 1.0 - activation-sound-pitch: Sound pitch (e.g., `1.0`). <1=deeper, >1=sharper.
Code (YAML):activation-sound-pitch : 0.8 - activation-particle: Particle name from Bukkit Particle Enum (e.g., `FLAME`). `NONE` to disable.
Code (YAML):activation-particle : FLAME - activation-particle-count: Number of particles.
Code (YAML):activation-particle-count : 25 - activation-particle-offset-x / y / z: Random spread distance.
Code (YAML):activation-particle-offset-x : 0.5
activation-particle-offset-y : 0.5
activation-particle-offset-z : 0.5 - activation-particle-speed: Particle speed/extra data.
Code (YAML):activation-particle-speed : 0.1 - activation-particle-color: Data for specific particles.
For `REDSTONE`: `"R,G,B"` (e.g., `"255,165,0"` for orange).
For `BLOCK_CRACK`, `ITEM_CRACK`: Material name (e.g., `"DIRT"`).
Leave empty `""` otherwise.
Code (YAML):activation-particle-color : "" # Not needed for FLAME
The core action of the power.
- type: The main type of ability. Choose one:
`effect`, `projectile`, `flight`, `instamine`, `lightning`, `none` - Settings for type: effect
`effect`: PotionEffectType name (e.g., `SPEED`, `INVISIBILITY`). Also supports `HERO_OF_THE_VILLAGE`.
`duration`: Effect duration in seconds.
`level`: Effect level (1 = Level I, 2 = Level II, etc.).
Code (YAML):ability:
type : effect
effect : SPEED
duration : 10
level : 2 - Settings for type: projectile
`projectile-type`: EntityType name (e.g., `FIREBALL`, `ARROW`, `WITHER_SKULL`).
`speed`: Speed multiplier (1.0 = normal).
`damage`: Arrow damage or explosion power.
`ignite`: `true`/`false`. Ignites targets (Fireball) or makes Wither Skull charged (blue).
`knockback`: Knockback strength (mainly for arrows).
`duration`: (For potion arrows like `POISON_ARROW`) Effect duration in seconds.
`level`: (For potion arrows) Effect level (1 = Level I, etc.).
Code (YAML):ability:
type : projectile
projectile-type : POISON_ARROW
speed : 1.2
damage : 5.0
ignite : false
knockback : 0
duration : 5 # Poison duration
level : 1 # Poison I - Settings for type: flight
`duration`: Flight duration in seconds.
Code (YAML):ability:
type : flight
duration : 15 - Settings for type: instamine
`duration`: Duration of Haste effect in seconds (use a large number like 99999 for 'permanent' while holding/active).
`level`: Haste level (3+ usually needed for true instamine).
Code (YAML):ability:
type : instamine
duration : 30
level : 3 - Settings for type: lightning
`range`: Max distance in blocks to target the lightning strike.
`damage`: (Informational) Standard lightning damage is ~5. This isn't used directly by default strike.
Code (YAML):ability:
type : lightning
range : 60
damage : 5.0 - Settings for type: none
No additional settings needed. The item just triggers sounds/particles on right-click.
Customize player feedback text.
- actionbar-message: Shown above hotbar when using.
- cooldown-message: Shown when ability is on cooldown. Use `%seconds%`.
- bossbar-title: Text on the cooldown Boss Bar. Use `%power%`.
- ability-used-message: Shown when ability succeeds. Use `%power%`.
- not-enough-xp-message: Shown if lacking XP. Use `%required%`.
- not-enough-health-message: Shown if lacking health. Use `%required%` (shows hearts).
- no-target-message: Shown for targeted abilities (like `lightning`) if no target is found.
- flight-start-message: (For `flight` type) Shown when flight starts. Use `%duration%`.
- flight-end-message: (For `flight` type) Shown when flight ends.
- post-flight-cooldown-message: (For `flight` type) Shown if trying to fly during post-flight cooldown. Use `%seconds%`.
Code (YAML):messages:
actionbar-message : "&eUsing &6&l%power%&e..."
cooldown-message : "&c%power% Cooldown! &7(%seconds%s)"
bossbar-title : "&6&l%power% &cCooldown"
ability-used-message : "&aUsed %power%!"
not-enough-xp-message : "&cNot enough XP Levels! Need %required%."
not-enough-health-message : "&cNot enough Health! Need %required% hearts."
no-target-message : "&cNo target in range!"
flight-start-message : "&aFlight active for %duration% seconds!"
flight-end-message : "&cFlight ended."
post-flight-cooldown-message : "&cCannot fly yet! Wait %seconds%s."
Commands & Permissions
- /rshelp - Displays the help message. (No permission)
- /rsobtain - Gives you your assigned power item, or assigns a random one if you don't have one yet. Checks for inventory space. (No permission)
- /rsrebirth <power_name> - [Admin] Changes your currently assigned power to the specified one. Clears old item.
Permission: `regalor.admin.rebirth` (Default: OP) - /rsreload - [Admin] Reloads `config.yml` and all power files from the `powers/` directory.
Permission: `regalor.admin.reload` (Default: OP)
Support & Contact
This plugin is developed by SrCodex of the LSSupportTeam.
- Creator Discord: SrCodex
- Development Team: LSSupportTeam on GitHub
If you encounter bugs or have suggestions, feel free to reach out!
Have fun creating awesome powers!
Resource Information
Author:
----------
Total Downloads:
33
First Release:
May 7, 2025
Last Update:
May 7, 2025
Category:
---------------
All-Time Rating:
0 ratings
Version
-----
Released:
--------------------
Downloads:
------
Version Rating:
----------------------
-- ratings