First steps

• Place the plugin file in your server's plugins folder.
• To create models, use https://bdengine.app/
• In the model editor, use Export to Minecraft -> Summon #1 copy, Summon #2 copy, etc. Do not copy the remove commands.
• Open the airdrops.yml file in the plugins/MagicAirdrios folder and paste the command(s) into the commands section.
• Edit the airdrop according to the comments in the configuration
• Configure the config.yml file to suit your preferences.
• You can add your own translation to the plugin in language.yml
• Type /ma reload to reload the configurations
• ready

See full plugin documentation - https://psyrioty.gitbook.io/magicairdrops-wiki

OTHER
To use the plugin, first load the chunks.
The plugin supports WorldGuard and its flags, as well as PlaceholdersAPI. Furthermore, the plugin uses its own placeholder system.

Plaseholders

• {activate_time} - displays the time remaining to survive in the event;
• {airdrop_name} - Displays the event name;
• {airdrop_x} - displays the X coordinate of the event;
• {airdrop_y} - displays the Y coordinate of the event;
• {airdrop_z} - displays the Z coordinate of the event;
• {airdrop_world} - displays the name of the event world;
• {x} - displays the X coordinate of the player or location command_executer;
• {y} - displays the Y coordinate of the player or location command_executer;
• {z} - displays the Z coordinate of the player or location command_executer;
• {world} - displays the name of the world of the player's location or command_executor;
• {player_name} - displays the player's nickname;

PlaceholderAPI
Currently only outputs in interaction commands
Commands

• Use /ma or /magicairdrops as a base;
• /ma create loot <id> <name> - creates loot with a specific id and name. Example: "/ma create pirate_chest #E9967APirate chest";
• /ma open loot <id> - opens loot for editing by ID;
• /ma reload - reloads configurations, some actions require a full server restart;
• /ma summon - triggers a random event;
• /ma summon <id> - calls an event by its id;
• /ma list - shows a list of active events;
• /ma remove <id> - deletes an active event.

For other plugins
To interact with other plugins, such as MythicMobs, ItemsAdder, ExecutableItems, and MythicDungeons, you can use placeholders.
Interaction examples:

• md play halloween {player_name} - You can make a model of the portal, so the player will enter the portal by right-clicking on it;
• iagive {player_name} candy_wrapper 1
• ei give {player_name} candy_wrapper 1

CommandExecutor examples:

• mm m spawn halloween_pumpkin 1 {world},{x},{y},{z} - will spawn a custom mob at CommandExecutor coordinates;
• summon minecraft:skeleton {x} {y} {z} - will spawn a skeleton at CommandExecutor coordinates;
• execute in minecraft:the_nether run summon minecraft:skeleton {x} {y} {z} - if you want to spawn in the nether;
• execute in minecraft:the_end run summon minecraft:skeleton {x} {y} {z} - if you want to spawn in the end.

Permissions

• magicairdrops.admin - gives permission to use all commands.

Commercial License
You are allowed to use this plugin only on servers for which you have purchased a license.
Redistribution or sale of this jar file is prohibited without author's written permission.
Decompiling, reverse-engineering, or modifying this plugin without author's consent is strictly prohibited.