Thunder RTP Plugin

In-Depth Description: Thunder RTP is a cutting-edge Minecraft plugin designed for Spigot, paper servers, aimed at enhancing player engagement through a unique quarry system. This plugin allows players to create and join quarries based on various game modes, facilitating dynamic gameplay experiences that cater to different player preferences. With its advanced teleportation mechanics and robust management features, Thunder RTP is an essential tool for server administrators looking to foster a vibrant and interactive community.

Feature Highlights:

1. Dynamic Quarry System:
   
   • Players can create and join quarries in multiple game modes: DUAL (2 players), SQUAD (4 players), HEXA (6 players), and OCTA (8 players).
   • Each mode is designed with specific player capacities and gameplay dynamics, ensuring a tailored experience for every participant.
2. Force Teleportation:
   • Admins can force teleport players to designated locations, enhancing gameplay flexibility and allowing for quick adjustments during events or emergencies.
   • This feature is particularly useful for managing player interactions and ensuring a smooth gaming experience.
3. Intelligent Safe Landing Mechanics:
   
   • The plugin includes advanced teleportation features that ensure players land safely, with options for water placement to mitigate fall damage.
   • This functionality enhances player satisfaction by reducing the risk of accidental deaths upon teleportation.
4. Extensive Customization Options:
   
   • Server owners can customize gameplay settings, sound effects, action bar messages, and more through a comprehensive configuration system.
   • This flexibility allows for a personalized experience that aligns with the server's theme and player preferences.
5. User -Friendly Command Interface:
   
   • Thunder RTP provides a range of intuitive commands for players and administrators, including commands for joining quarries, listing available quarries, and managing player interactions.
   • The user-centric design enhances accessibility and engagement, making it easy for players to navigate the plugin's features.
6. Real-Time Action Bar Notifications:
   
   • Players receive timely updates through action bar messages, keeping them informed about quarry status, player counts, and other critical information without cluttering the chat interface.
   • This feature enhances communication and player awareness, contributing to a more immersive experience.
7. Robust Player Management System:
   
   • The plugin efficiently manages player interactions within quarries, ensuring that players are promptly notified of join and leave events.
   • Thunder RTP maintains an accurate quarry state, fostering a dynamic and engaging environment for all participants.

Installation Instructions:

1. Download the Plugin:
   
   • Visit the SpigotMC page for Thunder RTP and download the latest version of the plugin (JAR file).
2. Install the Plugin:
   
   
   • Place the downloaded JAR file into the plugins folder of your Spigot server.

1. Start the Server:
   
   • Launch your Spigot server. The plugin will automatically be loaded, and necessary configuration files will be generated.
2. Configure the Plugin:
   
   • Navigate to the plugins/ThunderRTP directory to find the configuration files.
   • Open the config.yml file to customize settings such as game modes, sound effects, and action bar messages according to your server's needs.
3. Permissions Setup:
   
   • Ensure that you configure permissions for players and admins in your permissions management plugin (e.g., PermissionsEx, LuckPerms) to control access to various commands and features.
4. Restart the Server:
   
   • After making any changes to the configuration, restart your server to apply the new settings.
5. Enjoy the Plugin:
   
   • Players can now start using the Thunder RTP features! Encourage them to explore the quarry system and enjoy the enhanced gameplay experience.

Thunder RTP Command List
Player Commands:

1. /join <mode> [player_name]
   
   • Description: Join a quarry of the specified mode. Optionally, you can join another player's quarry by specifying their name.
   • Modes Available: DUAL, SQUAD, HEXA, OCTA.
   • Example: /join SQUAD or /join HEXA PlayerName
2. /leavequarry
   
   • Description: Leave your current quarry.
   • Example: /leavequarry
3. /quarries
   
   • Description: List all available quarries that players can join.
   • Example: /quarries

Admin Commands:

1. /forcetp <player> <quarry_owner/id>
   
   • Description: Force teleport a specified player to a quarry owned by another player or identified by ID.
   • Example: /forcetp PlayerName OwnerName
2. /forcechange <player> <quarry_type>
   
   • Description: Change the quarry type of a specified player to the given quarry type.
   • Available Types: DUAL, SQUAD, HEXA, OCTA.
   • Example: /forcechange PlayerName SQUADlayers and administrators to effectively utilize its features.

Permissions List
Player Permissions:

1. thunderrtp.join
   
   • Description: Allows players to join a quarry.
2. thunderrtp.leave
   
   • Description: Allows players to leave their current quarry.
3. thunderrtp.list
   
   • Description: Allows players to list available quarries.

Admin Permissions:

1. thunderrtp.forcetp
   
   • Description: Allows admins to force teleport players to a quarry.
2. thunderrtp.forcechange
   
   • Description: Allows admins to change the quarry type of a specified player.
3. thunderrtp.admin
   
   • Description: Grants all administrative permissions related to the Thunder RTP plugin.

Placeholders List
Placeholders are used within messages and configurations to dynamically display information. Here are some common placeholders used in the Thunder RTP plugin:

1. %player%
   
   • Description: Represents the name of the player involved in the action (e.g., joining a quarry, leaving a quarry).
2. %quarry_owner%
   
   • Description: Represents the name of the owner of the quarry.
3. %mode%
   
   • Description: Represents the game mode of the quarry (e.g., DUAL, SQUAD, HEXA, OCTA).
4. %current%
   
   • Description: Represents the current number of players in the quarry.
5. %max%
   
   • Description: Represents the maximum capacity of the quarry.
6. %remaining%
   
   • Description: Represents the number of remaining force teleports available for a quarry.
7. %id%
   
   • Description: Represents the unique ID of the quarry.

Usage Notes:

• Ensure that permissions are properly configured in your permissions management plugin to control access to commands and features.
• Placeholders can be used in configuration files, messages, and action bar notifications to provide dynamic feedback to players.

This list of permissions and placeholders will help you manage access control and customize messages within the Thunder RTP plugin effectively.