AutomaticGiveEvent 1.01

AutomaticGiveEvent - Automatic Item Drop Events

What is AutomaticGiveEvent?

AutomaticGiveEvent is a specialized Minecraft plugin that creates engaging item drop events where configured items fall from the sky at a designated location. Players compete to collect these items, with the plugin tracking statistics on items collected per player.

Feature:

Event Management System

• Multiple Event Profiles: Create unlimited different event configurations, each with unique names, item sets, and spawn locations
• Custom Item Sets: Configure any Minecraft items to drop during events, with customizable quantities and drop rates
• GUI-Based Setup: Intuitive in-game interface for creating and editing events without editing config files
• Flexible Scheduling: Run events on-demand with customizable durations
  
  

Auto Event Start

• Player-Count Triggered Events: Events now automatically start when a configurable number of players are online
• Time-Scheduled Events: Set specific times (10:00, 15:00, 20:00, etc.) for events to trigger each day
• Smart Limitations: Configure daily event limits and minimum cooldown periods between events
• Countdown Control: Customize countdown duration for each automatic event type

Drop Mechanics

• Customizable Drop Height: Set how high above the ground items will spawn
• Adjustable Drop Rate: Configure how frequently items fall with the drop-interval-ticks setting
• Items Per Drop: Control how many items fall in each drop cycle
• Drops Per Item: Set how many copies of each configured item should fall during the event

Player Experience

• Countdown System: Configurable countdown with server-wide announcements
• Teleportation: Players can use /evento to teleport directly to the event location
• Visual Effects: Optional firework displays with customizable colors enhance the event atmosphere
• Clear Messaging: Fully customizable messages for event start, countdown, and completion

Statistics Tracking

• Item Collection Counter: Tracks how many items each player collects during an event
• Player Rankings: Automatically ranks players based on items collected
• Persistent Data: Statistics are saved between server restarts in a dedicated stats.yml file
• Top Players List: Access data about the top-performing players

Integration Capabilities

• PlaceholderAPI Support: Display event statistics in other plugins with these placeholders:
  • %fernasdrop_collected% - Items collected by the player
  • %fernasdrop_position% - Player's position in the ranking
  • %fernasdrop_top_1% through %fernasdrop_top_5% - Names of top players
  • %fernasdrop_top_1_count% through %fernasdrop_top_5_count% - Item counts for top players
  • %fernasdrop_last_event% - Name of the last event that ran

Commands

• /event create <name> - Create a new event
• /event edit <name> - Edit an existing event's items
• /event delete <name> - Delete an existing event
• /event list - List all available events
• /event run <name> [duration] - Start an event with optional duration
• /event setpoint <name> - Set the spawn point for an event
• /evento - Teleport to the active event (for players)

Permissions

• fernasevent.admin - Access to all admin commands
• fernasevent.teleport - Permission to use the teleport command

PlaceholderAPI Integration

The plugin offers the following placeholders:

• %fernasdrop_collected% - Number of items collected by the player
• %fernasdrop_position% - Player's position in the ranking
• %fernasdrop_top_1% - Name of the player in first position
• %fernasdrop_top_1_count% - Number of items collected by the player in first position
• %fernasdrop_top_2% through %fernasdrop_top_5% - Names of players in 2nd-5th positions
• %fernasdrop_top_2_count% through %fernasdrop_top_5_count% - Item counts for 2nd-5th positions
• %fernasdrop_last_event% - Name of the last event that ran

Configuration

The plugin offers extensive configuration options:

settings:

countdown:

enabled: true

duration-seconds: 120

teleport-command-enabled: true

drop-height: 20

drop-interval-ticks: 5

items-per-drop: 2

drops-per-item: 1

fireworks:

enabled: true

colors:

• '#FF0000'
• '#00FF00'
• '#0000FF'
• '#FFFF00'
• '#FF00FF'
• '#00FFFF'

messages:

countdown-start: '#ff0000Event &8〢 &7A #00b2ffGive Event &7will start in #ff0000{time}. &7Use #00b2ff/Event &7to go to the #ff0000Give Event!'

countdown-update: '#ff0000Event &8〢 &7A #00b2ffGive Event &7will start in #ff0000{time}. &7Use #00b2ff/Event &7to go to the #ff0000Give Event!'

countdown-last-seconds: '#ff0000Event &8〢 &7A #00b2ffGive Event &7will start in #ff0000{time}. &7Use #00b2ff/Event &7to go to the #ff0000Give Event!'

event-start:

• '&f'
• '#ff0000&l➤ #00b2ff&lGive Event Started!'
• '&f'
• '#ff0000Look for items falling from the sky!'
• '&f'

event-end:

• '&f'
• '#ff0000&l➤ #00b2ff&lEvent Ended!'
• '&f'
• '#ff0000Thank you for participating!'
• '&f'

event-teleport: '#ff0000Event &8〢 &7You have been teleported to the #00b2ffGive Event!'

event-teleport-not-running: 'Event &8〢 &7There is no event currently running!'

How It Works

1. Administrators create events with custom item sets using the in-game GUI
2. When an event is started, a countdown begins with server-wide announcements
3. Players can teleport to the event location using /evento
4. After the countdown, items begin falling from the sky at the designated location
5. Players compete to collect as many items as possible
6. Statistics track how many items each player collects
7. When the event ends, a completion message is displayed

Compatibility

• Requires Server 1.21 or higher
• Optional dependency: PlaceholderAPI (for placeholder support)
• Works with any server size, from small communities to large networks

Future Plans

• Support fo All Version
• Multilanguage System
• More Page for Gui items
• Reward system for top collectors

This plugin is perfect for server owners looking to create engaging community events, reward active players, or simply add some excitement to their server. The automatic nature of the events means administrators can set them up once and run them with minimal effort, while the statistics system adds a competitive element that keeps players coming back for more.

Support

If you encounter any issues, have questions, or need assistance with the FernasAutomaticEvent plugin, please don't hesitate to reach out for support:

Discord Support

For the fastest response and direct assistance, contact me on Discord:

• Discord Username: Fernas99

I'm happy to help with:

• Installation issues
• Configuration questions
• Feature requests
• Bug reports
• Custom modifications

Support Policy

• All support inquiries are handled personally
• Most questions are answered within 24 hours
• Detailed step-by-step guidance is provided when needed
• Bug fixes are prioritized and addressed promptly

When contacting for support, please include:

1. Your server version
2. Plugin version
3. Any error messages from the console
4. A description of the issue you're experiencing

Your satisfaction with the plugin is my top priority, and I'm committed to ensuring you have the best possible experience with AutomaticGiveEvent on your server.