Synergy - Documentation: Using MapEdit

Synergy Documentation

Documentation: Using MapEdit

MapEdit Configuration Files

These files can be used to set console variables for specific levels and change the level's entity data without modifying the BSP file.
These files are to be placed into the "maps" directory under Synergy, with the ".edt" extension.

File Format

NOTE: the following MapEdit file is not entirely valid. You must supply valid values for each key in your own file.
"<myMapName>" should be replaced with the actual name of the map this file is for.


"<myMapName>"
{
	"console"
	{
		"sk_plr_dmg_crowbar" "500"
	}

	"entity"
	{
		"create" // this entry will create a new entity
		{
			"classname" "entityClassName"
			"origin" "0 0 0"

			"values"
			{
				"keyName" "keyValue"
			}
		}

		"delete" // this entry will Delete an existing entity
		{
			"classname" "entityClassName"
			"origin" "0 0 0"

			"targetname" "entityTargetName"
		}

		"edit" // This entry will Edit an existing entity
		{
			"classname" "entityClassName" 
			"origin" "0 0 0"

			"targetname" "entityTargetName"

			"values"
			{
				"keyName" "keyValue"
			}
		}
	}
}

Creating a mapEdit Config File

The "console" key group is used to set console variables that will affect the specific level only.
Variables set in this manner, will be reset upon level change.
You may put as many as you wish in here, however there should typically be no more than 10.

The "entity" key group is used to modify the entity data for the level.
Each key within the "entity" group can either be "create", "delete" or "edit" - other names are not valid.

The "create" key will add a new entity to the level.
You may insert a "values" key group within the "create" key to add additional keys. (For example, "target" "elevator_floor_1_call_button".)

The "delete" key will remove the entity you specify. This key type does not support the "values" key group.

The "edit" key will only modify existing keys for the specified entity. You can not add new keys with this method.
You must use the "values" key group with the "edit" key to specify which entity data key to modify and the value.

To select entities to remove or edit, you may:

use "classname" alone: to select ALL entities in the level with specified class.
use "classname" with "origin": to select entity of class at specified origin.
use "targetname" alone: to select ALL entities with the specified name.
use "targetname" with "origin": to select entity with specified name at origin

NOTE: maximum number of keys you may put into the "values" key group is 64.

NOTE: these files are automatically downloaded to clients when they connect to a server running the map that uses this file.