teleport-categories.json

The list behind Teleportation Menu, Teleport Categories. Coming from vMenu Legacy, this is the teleport half of the old locations.json. The blip half is now blips.json.

Format

[
  {
    "name": "City",
    "description": "City locations",
    "locations": [
      {
        "name": "Legion Square",
        "description": "",
        "position": { "x": 197.78, "y": -934.75, "z": 30.69 },
        "heading": 141.93
      }
    ]
  }
]

Field	Meaning
`name`	Shown in the menu. Required on categories and locations.
`description`	Shown under the row. Optional.
`locations`	The locations in the category.
`position`	Where the player lands. Required.
`heading`	Which way the player faces, in degrees. Optional. Without it the player keeps facing the way they were.

The order in the file is the order in the menu.

Staff with the Manage permission get four extra rows:

Row	What it does
Create Category	Asks for a name and a description.
Create Position	Saves where you stand and the way you face, in the open category.
Delete Category	Removes a category and every location in it.
Delete Position	Removes one location.

Every change is written to the file and sent to every player straight away. Names must be unique, within a category for locations.

Permissions

Permission	What it allows
`vMenu.Enhanced.Menus.TeleportMenu.Category`	Seeing and using the categories.
`vMenu.Enhanced.Menus.TeleportMenu.Manage`	Adding and removing categories and locations. Staff only by default.

Errors

Console message	Cause
`No config/teleport-categories.json found...`	The file is missing. The menu starts empty.
`config/teleport-categories.json could not be parsed...`	Broken JSON. The menu starts empty.
`... has to hold a list of categories...`	The file is not a list `[ ]`.
`Skipping a category in ...: it has no name.`	A category without `name`.
`Skipping a location in '...': it has no name.`	A location without `name`.
`Skipping '...' in '...': it has no position.`	A location without `position`.

Read at server start. Restart the resource after editing the file by hand.