Resources

Everything you need to know when creating adventure maps for the AtePlant Archive.

Map Making Guidelines

Everything you need to know to create and submit a map for the AtePlant Archive.

Priority 1: Gameplay

The number one priority is that the gameplay is high-effort, fun, and creative. Your map will not be accepted if it does not meet all three of these criteria. These will be judged loosely, especially the fun part.

If your map requires a plugin, script, resource pack, or command blocks that are necessary to how the map is played or enjoyed, you must ask @AtePlant or open a ticket in support before you start building so it can be approved. If you need to make a plugin, datapack, or resource pack for your map but do not know how to make one, just tell @AtePlant or open a ticket in support.

Priority 2: Build Quality

The build should be good. This does not mean your map requires a build to be accepted. Floating parkour with some pixel art in the sky is totally fine. However, anything that is built should be high effort.

Do not use any existing map on this server as a frame-of-reference for quality. See the mapper wiki for potential mechanics you could use in your maps.

What Does Mapper Rank Do?

With Mapper rank, you get ownership of a plot on the server. A plot is a 500x500 world where you can build maps on, and it gives you access to building tools like WorldEdit, HeadDatabase (/hdb), Banner Maker (/mb), and other tools. Plots also have the capability to run specific gameplay mechanics; see the mapper wiki for the current list of supported mechanics.

How To Get Mapper Rank

Make a post in Discord showing videos or pictures of builds, parkour, or gameplay you have created, and additional proof is appreciated. If your builds or gameplay seem high quality, you will receive Mapper rank in the Discord and receive a plot in game.

AteScript

AteScript is the server's custom Minecraft scripting language parsed and executed by a server plugin. The AtePlant Archive uses Mutiverse-Core where each map gets their own world; However, DataPacks work on a per-dimension basis. In order to alleviate this issue, AteScript was created to replicate the behaviour of DataPacks while also having the events you find in Spigot API. The compiler for AteScript is public, so you are able to test your scripts on a local server.

Script Structure

Every script file is named after its purpose and ends in .atescript. Each script declares a trigger, a world, and then its logic. The following header fields are required at the top of every script:

Variables

$player is automatically set to the player who triggered the script. Additional variables are available depending on the trigger used. This is clarified in the Triggers section below.

Logic & Commands

Logic Statements

Use endif to conditionally end the script.

• 1Syntax: endif <variable> <operator> <value>
• 2Use is / isnot to check if a value is or isn't equal to something.

endif $btype isnot CHISELED_RESIN_BRICKS
/give $player cyan_wool 1

Console Commands

Run any command directly on the console by prefixing it with /. Variables like $player are substituted inline. Also clarify the origin of the command: Use /minecraft:give ... if you are using a base-Minecraft give command, Use /Essentials:give if you are using the EssentialsX give command.

/minecraft:gamemode creative $player

Data Storage

Persist data to a player using the * prefix. Data is stored in persistent data containers and survives across sessions.

Triggers

Triggers define what event causes the script to run. Set the trigger at the top of the script with $trigger <name>.

Examples

These examples are all from the map Darker Bramble.

$trigger onEffectAdd
$world DarkerBramble
endif $var isnot SLOW_FALLING
/musicplayer play $player outerwildsp1.nbs true

$trigger onPostPracticeStart
$world DarkerBramble
/minecraft:give $player purple_wool[can_place_on=[{blocks:purple_glazed_terracotta}]] 64
/minecraft:give $player cyan_wool[can_place_on=[{blocks:cyan_glazed_terracotta}]] 64
/minecraft:give $player copper_hoe[custom_name=[{"text":"Ghost Matter Harvester","bold":true,"italic":false,"color":"dark_aqua"}],lore=[[{"text":"Used to destroy ","italic":false,"color":"white"},{"text":"O","italic":false,"color":"gold"},{"text":"r","italic":false,"color":"gold"},{"text":"a","italic":false,"color":"gold"},{"text":"nge","italic":false,"color":"gold"},{"text":" ","italic":false,"color":"gold"},{"text":"Ghost","italic":false,"color":"gold"}],[{"text":"Matter","italic":false,"color":"gold"},{"text":" temporarily (3s)","italic":false,"color":"white"}]],can_break=[{blocks:resin_block},{blocks:chiseled_resin_bricks}],tool={rules:[{blocks:[resin_block,chiseled_resin_bricks],speed:999f}]},unbreakable={},tooltip_display={hidden_components:[attribute_modifiers]}]
/minecraft:give $player iron_hoe[custom_name=[{"text":"Ghost Matter Harvester","bold":true,"italic":false,"color":"light_purple"}],lore=[[{"text":"Used to destroy ","italic":false,"color":"white"},{"text":"Gray Ghost","italic":false,"color":"gray"}],[{"text":"Matter","italic":false,"color":"gray"},{"text":" temporarily (1s)","italic":false,"color":"white"}]],can_break=[{blocks:pale_moss_block},{blocks:chiseled_tuff}],tool={rules:[{blocks:[pale_moss_block,chiseled_tuff],speed:999f}]},unbreakable={},tooltip_display={hidden_components:[attribute_modifiers]}]

$trigger onCheckpointUse
$world DarkerBramble
/minecraft:clear $player minecraft:purple_wool
/minecraft:clear $player minecraft:cyan_wool

$trigger onPlateActivate
$world DarkerBramble
endif $btype isnot MANGROVE_PRESSURE_PLATE
/minecraft:clear $player minecraft:purple_wool
/minecraft:clear $player minecraft:cyan_wool

Tools

All server-specific tools to help with mechanics and helpful mods to make map-making easier. Commands listed are ones you can use in AteScripts. If your map requires a plugin with a different mechanic/function then:

• 1If it is simple, try to make it using an AteScript.
• 2If it is complex, let AtePlant know through dms or #support to see if that idea is possible, and it will be made for you if so.

Block Triggers

Server Tools

World Settings