💎 DiamondRainPRO Plugin 💎

DiamondRainPRO is an extended version of the free DiamondRain plugin.
In DiamondRainPRO, visual and sound effects have been added, along with the ability to include other valuable items in the diamond rain and select the number of players affected by the event.

Features​

 Configurable item drops: The number of diamonds and/or other valuable items falling is set by the admin in the configuration (up to 100 items).
 Visual and sound effects: Added enhanced effects for a more immersive experience.
 Multiple players targeting: Choose how many players will experience the diamond rain. Players are randomly selected.
 Customizable drop rates: The rain can include not only diamonds but also other valuables such as gold, emeralds, and netherite, with adjustable drop rates.

Commands​

TEST ALL OUR PLUGINS HERE
SERVER: javarangers.falixsrv.me:22707 >
(PLEASE NOTE, server version 1.21.4)

Permissions​

Configuration​

The plugin settings can be found in config.yml:

# Configuration for DiamondRainPro plugin
settings:
total-number-jewelry: 10 # Number of diamonds that can fall during the rain event (max meaning 100).
area-size: 20 # The radius around the player where diamonds can randomly spawn.
item-despawn-time: 1200 # Time (in ticks) before the dropped diamonds despawn (1 second = 20 ticks)
number-players: 1 # Number of payers for whom the diamond rain will be launched (min meaning 1, players will be randomly selected)

# Customizable drop rates
item-distribution:
enable: true # Enable the customizable drop rates feature
drop-rates:
diamond: 50 # 50% of the total number of items (max-jewelry) will definitely be diamonds (min meaning 50%).
gold: 20 # 20% of the total number of items (max-jewelry) will definitely be gold.
emerald: 20 # 20% of the total number of items (max-jewelry) will definitely be emerald.
netherite: 10 # 10% of the total number of items (max-jewelry) will definitely be netherite.

Items Distribution Example:​

 50% Diamonds (but at least 50% must be diamonds)
 20% Gold
 20% Emeralds
 10% Netherite
The percentage distribution can be easily adjusted by the admin in the config file.

Boundary Values and Configuration Limits​

When setting up DiamondRainPRO, it is important to ensure that all configuration values stay within acceptable limits. The plugin enforces several boundary conditions to prevent errors and unexpected behavior. Below are the key limitations and their reasons:

1. Total Drop Rate Must Be Exactly 100%

• The sum of all item drop rates (diamonds, gold, emeralds, netherite) must equal exactly 100%.
• If the total drop rate is not 100%, the plugin will log an error and refuse to start.

1. Total Number of Jewelry Items

• The total number of jewelry items (total-number-jewelry) must be greater than 0 and not exceed the maximum allowed limit.
• If this value is negative or exceeds the server's maximum limit, the plugin will warn the admin.

1. Minimum Diamond Percentage

• The diamond drop rate must be at least 50% to ensure diamonds remain the primary item in the event.
• If this value drops below 50%, a warning will be issued.

1. Number of Players

• The event must affect at least one player (number-players >= 1).
• A warning will be issued if this value is set lower than 1.

1. Area Size Cannot Be Negative

• The radius (area-size) in which items spawn must be zero or greater.
• A negative value would cause errors in spawn calculations.

1. Item Despawn Time Cannot Be Negative

• The time (in ticks) before dropped items disappear (item-despawn-time) must be zero or greater.
• A negative value would prevent item despawning from functioning correctly.

1. Drop Rate Percentages Cannot Be Negative

• Each drop rate (diamonds, gold, emeralds, netherite) must be zero or greater.
• A negative percentage would be invalid and cause issues in item distribution calculations.
• These limits ensure that DiamondRainPRO functions smoothly without unintended behavior. If any of these values are set incorrectly, the plugin will warn the admin and request a configuration update.

Installation​

1. Stop your Minecraft server.
2. Copy the DiamondRainPro.jar file to your server's plugins folder.
3. Start the server.
4. The configuration file will be automatically created.

Usage Guide​

1. Grant the required permission to admins: diamondrain.admin
2. Use /diamondrainpro start to create a diamond rain around a random player.
3. Players can collect the falling diamonds and other valuable items.
4. Items that fall over water or lava will create glass platforms to land on.
5. Items will disappear after the configured time.

Notes​

• The plugin automatically creates glass platforms over liquids.
• Only server administrators can start the diamond rain.
• Configuration can be reloaded without restarting the server using /diamondrainpro reload.
• The target player is randomly selected from all online players.

Troubleshooting​

If diamonds aren't spawning:

 Check if you have admin permissions.
 Verify the configuration file is properly formatted.
 Make sure there are players online.
 Check the server console for any error messages.

Support​

If you encounter any issues or have suggestions:

 Check the configuration file for errors.
 Verify permissions are set correctly.
 Look for error messages in the server console.
 Contact the plugin developer with detailed information about the problem.
Happy diamond hunting! 

Disclaimer: These images are illustrative and do not represent actual in-game graphics. The final appearance may vary based on Minecraft's visual style and server settings.