First steps

• Place the plugin file in your server's plugins folder.
• To create models, use link.
• 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

Documentation

See full plugin documentation - link.

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.