Map assets

A map asset describes a map: its name, author, teams, music and the environments it can be played in. It doesn’t hold the blocks, which are in the Minecraft world.

{
  "mapEffects": [
    {
      "effectType": "map_name",
      "uuid": "e0a5dbed-c794-4485-a35b-a359ed5b5ff0",
      "position": { "x": -106.5, "y": 38.0, "z": 628.5 },
      "mapName": "Brittany"
    },
    {
      "effectType": "author",
      "uuid": "d671e517-c9a0-4523-aff3-85b2d4d6c8f3",
      "position": { "x": -105.0, "y": 38.0, "z": 628.5 },
      "author": "Your Name"
    }
  ],
  "environments": {
    "default": {
      "name": "default",
      "mapEffects": [],
      "mapEffectTemplates": [
        {
          "template": "tmp_weather_european",
          "overrides": {
            "position": { "x": -102.0, "y": 38.0, "z": 630.0 }
          }
        }
      ]
    }
  }
}

Fields

Field	Required	Default	Description
environments	Yes		The map’s environments, by name.
mapEffects	No	None	Effects that apply in every environment, such as the map’s name.

Map attributes

A map’s name, author, teams and music are set by map effects in the top-level mapEffects list:

effectType	Field	Default if missing
map_name	mapName	Custom
author	author	Unknown
teams	alliesTeam, axisTeam	bf:us_airborne, bf:ger_wehrmacht
music_set	musicSet	europe

Caution

Keep mapName the same as the file name. The in-game tools save a map under this name, and game assets are saved pointing at it. A file called Brittany.json needs the name Brittany.

Environments

An environment is one version of the map, such as day or night, and holds the effects for that version: time of day, weather, sounds and so on. A map needs at least one. When a match starts, one environment is picked at random.

A campaign mission can pick its environment instead, with environment in its game asset.

Field	Required	Default	Description
name	Yes		The environment’s name. Use the same value as its key in environments.
mapEffects	No	None	Map effects defined directly in this environment.
mapEffectTemplates	No	None	Effect templates placed in this environment.

Creating a map

/assets create maps MyMap Your Name
/assets save-all

This creates MyMap.json with a default environment and its name and author set. Then point a game at it:

/assets edit games dom_mymap map MyMap

Editing a map

Command (after /assets edit maps <name>)	What it does
author <author>	Sets the author.
musicSet <set>	Sets the music set.
teams set <team> <nation> <skin>	Sets the Allies or Axis team.
environment list	Lists the environments.
environment add <environment>	Adds an empty environment.
environment remove <environment>	Removes an environment. The last one can’t be removed.

Run /assets save-all afterwards, as these commands don’t save by themselves.

To place effects in the world, use /bf edit inside a match. It pauses the match, switches you to creative and gives you the map effect wands. Changes made with the wands save straight away. See Map effects.