Realms Map Guidelines

Last updated: December 3rd, 2018

Table of Contents

  1. Atlas
  2. General Info
  3. Minigames
  4. World templates
  5. Adventures
  6. Experiences
  7. Inspiration
  8. Titles
  9. Links
  10. Advertising
  11. Easter eggs
  12. Capes

These guidelines are intended to help current or prospective creators in submitting content that will be accepted to Minecraft Realms.


  • Atlas is the site that allows creators to upload content. First-time creators without access to Atlas can submit content for consideration at the Realms subreddit. Be sure to include the world download, as well as an album of images and/or video trailer, as appropriate. If you are given access to Atlas, you can log in at
  • Maps that are uploaded via Atlas are automatically put onto the test version of Realms. Upon approval, a map is published to the normal version of Realms.
  • You can edit details of a map submission while it is being tested. Once a map is published to Realms, you can no longer edit the map, but you can submit an updated version.
  • Mapmakers must follow the publishing agreement and the Minecraft EULA.
  • Creators should not include references to, or representations of, legal or illegal drugs, pornography, tobacco products or paraphernalia, or alcohol products.

General info

  • Realms is a Minecraft server for 1-10 concurrent players. A slot is reserved for the owner, so it's possible to join your own Realm as an 11th player. The invite list (whitelist) holds up to 5000 players.
  • View distance is 10.
  • When considering player behavior (such as allowing configuration of minigame settings), keep in mind that many realms are comprised of small groups of players who may know each other. In other words, it won’t always be as chaotic or anonymous as a public server.
  • Any minigame or adventures designed for a single player should be able to handle several players logging in. A map designed for more than one player should indicate that more players are needed, should a single player attempt to start it. The map should also be able, to the best of your ability, handle players logging in and out, or dropping their connection.
  • The maximum allowed size of resourcepacks is 50 MB.
  • Before submitting, consider what makes your submission different from other existing Realms content. Realms trials are available to all players, so it may be beneficial to explore the maps that are on Realms already.
  • Advancements were introduced in Minecraft version 1.12. In default gameplay, players will receive a toast notification for new recipes when picking up items or completing a task required for an advancement. These should not show up for custom minigames or adventures that do not require survival mechanics. Disable vanilla advancements and recipes by replacing the root of all advancements with an impossible achievement or recipe.
  • Remove or disable any commands or tools used for creating or testing your submission. Any "back door" admin commands built into maps, designed to give the creator an advantage in multiplayer games or otherwise, may cause the map to be removed. Depending on the nature of the commands or tools, a map removed in this way may make the creator ineligible to submit maps in the future.


  • Minigames are a self-contained, repeatable, cooperative or competitive game within Minecraft.
  • Minigames are gamemode 0, difficulty 1. Mobs, villagers, hostile spawns are all on. Force gamemode is off.
  • These games are meant to be played and reset continuously. If the server is inactive, and no one is online, a minigame map will reset. If you need the map to be preserved between play sessions, you may want to submit it as an adventure.
  • Your lobby should be clean and clear, and have a way to start the game quickly. Additional options are fine, but shouldn’t slow down the ability to jump into the game too much.
  • Where it makes sense, games should not artificially limit the starting condition to 2+ people. Some games are still fun with one player, especially score-based games.
  • Where it makes sense, make sure to add configuration options. A game that goes to 25 kills may be appropriate with ten players, but may drag on and force players to manually quit in a two player game.
  • In a minigame, no one has operator permissions, except the owner which is an operator with level 0 in order to be able to get in to the server when it's full, and settings cannot be changed. Control panels normally designed to be used by operators may need to be updated to allow any player to use them.

World templates

We are currently accepting world templates only from creators who have previously been published on Realms.
  • A world template is a way for players to start a new Minecraft survival game with something extra such as a fortified village, a mystic monastery, or a glacial fortress.
  • We are currently accepting world templates that are around 500x500 blocks in size. These are intended to transform a player's starting survival experience, but not be so large that one couldn't leave the area after a minute or two of running.
  • To get an idea of the kind of quality, density of play area, and depth of features that we're looking for, check out The Lost Civilization and Raider's Refuge via the links here or from the content library on Realms.
  • Templates must blend into the naturally-generating terrain and keep generating terrain outside of the template.
  • Where appropriate (such as a starting home's interior), light up your builds so that hostile mobs don’t spawn where they shouldn’t.
  • Your map should be free of command blocks and mostly free of elements that would not occur naturally within the game. Text is rarely needed in world templates. Let your build convey your ideas, rather than signs or books. If you'd like to create a custom map with those elements, consider creating an adventure map.


  • Adventures are designed to be played from start to finish, with a definite goal in mind. They do not reset automatically like a minigame; they save your progress as you complete the map.
  • You’ll need to set users to the proper game mode upon joining.


  • Experiences is a loosely-defined label for content that may not fit in other categories. In it, a player might be an observer or explorer, lacking a goal that you're actively working towards completing.
  • Some maps that start as experiences could easily end up as an adventure or a minigame. Consider an elytra map where you fly from the top of the world to the bottom. The addition of a points system or a timer could cause this to be a minigame, or the addition of goals and a story could turn it into an adventure.


  • Inspiration is a category designed to inspire others to create new things in Minecraft. A map in this category might otherwise go into Experiences were it not geared toward encouraging new and exciting builds.


  • We allow creators to use many different names that we consider suitable for the game and do not violate the terms of service or map publishing agreement.
  • Creators may not name their map by simply using a genre title (Spleef is not allowed, but Castle Spleef is allowed), by referencing content that is not allowed (for example, Machine Gun Blood Blitz), or including the word "Minecraft".
  • Published maps may not share the same name. Look at existing content on Minecraft Realms to ensure that you don't choose a name that already exists. You may want to make your name distinct enough so that it cannot easily be confused with an existing map name.
  • To give your map title a sense of uniqueness, we suggest that you do not use mine, craft, block, cube, pixel, and other over-used words.
  • Creators may include a website link and a trailer link in their submission to Atlas. This is displayed to players during map selection.
  • Links must be as direct as possible. Do not route players through URL shorteners, including sites such as AdFly or Bitly. You may append a query string to your URL.
  • Creators may not link to external programs such as Discord. These resources are better suited to be accessed through your website.
  • The website link is so that players can find out more about you and your work. A link to a website and portfolio, social media page, or video channel page should go here. This feature is optional, though we suggest that you include a Twitter link at minimum so that players can connect with you and leave feedback about the map.
  • The video link is provided so that you can link directly to a video trailer or preview of your content. This is so that potential players can get an idea of what your map is all about. It is for the player's benefit, not necessarily the creator. If you do not have a video preview of your creation, you may not link to other types of content here.


  • You are allowed to advertise yourself and your contributors in-game, excluding world templates. This is often done in the form of links to YouTube, Twitter, etc.
  • Limited and tasteful advertising inside of adventures, if it makes sense (you might not have an ad in an immersive fantasy world, but you might have end credits for something like a challenge parkour map).
  • Limited and tasteful advertising in minigames. Don’t abuse the subtitles or boss bar, don’t spam people with many rotating messages, etc. Feel free to get creative, just don’t annoy the player and overwhelm your creation.
  • You may not advertise for companies or other players, unless you have permission from us (an example might be The Heist, which prominently features the GameBand product).
  • Please do not advertise servers.
  • Don’t double up on ads (linking your youtube channel in a sign, in a hologram, in the boss bar, all at once).

Easter eggs

  • They’re great. Don’t overdo it; make them fun and not just inside jokes for your build team. Consider your wider audience.
  • Easter egg features are great too, just make sure that they’re properly developed (example: allowing someone to fly behind the scenes of a minigame, but giving them creative mode instead of spectator, possibly allowing them to break the game).
  • To save us time and surprise while reviewing, please list hidden areas or features of your submission.


  • As a thank you for submitting maps to Realms, you can earn a Realms Mapmaker cape after meeting certain criteria.
  • For each world template published, you earn 2 points. An inspiration map earns you 3 points. Finally, minigames, adventures, and experiences each earn 4 points. A total of 8 points is required to earn a cape.
  • You must be listed as a primary creator on the maps that have been published to Realms. If a map is submitted by a group, up to three people can be listed as a primary creator. Credit for these individuals is counted at the time the map is published; you cannot retroactively add new members to earn a cape for someone.
  • Maps are accepted based on a number of criteria, including the quality of the submission, how many submissions have been received recently, availability of staff to review maps, or if we need more of that type of map.
  • Realms Mapmaker capes are not given out automatically, and are contingent upon you being in good standing with the community, and your published maps following the Realms Map Publishing Agreement.
  • We're under no obligation to provide capes, but will do our best to use them as a reward for submitting multiple pieces of content to Realms. Please don't see submitting maps as an easy way to get a cape. Having maps approved and published may take months, and they'll need to be of excellent quality. Asking for a cape or spamming the Realms team about a submission is a sure way to become ineligible for a cape.
  • Maps that are commissioned by Mojang, that are featured on Realms, are not eligible for cape credit.