Player Warps

Oxygen comes with permission controlled Player Warps by default.

Player Warps let players create and manage warps organised by categories, that other players can access via a nice GUI. Players are limited to a certain number of player warps based on a permission node, similar to their home limit. Server owners can configure Oxygen's Player Warps feature under /config/Oxygen/pwarp_config.json.

Player Warps Config

{
  "categories": [
    {
      "id": "platform",
      "name": "<red>Platforms",
      "item": {
        "id": "minecraft:grass_block"
      }
    },
    {
      "id": "farm",
      "name": "<light_purple>Farms",
      "item": {
        "id": "minecraft:wheat"
      }
    },
    {
      "id": "arena",
      "name": "<blue>Arenas",
      "item": {
        "id": "minecraft:diamond_sword"
      }
    },
    {
      "id": "shop",
      "name": "<gold>Shops",
      "item": {
        "id": "minecraft:gold_ingot"
      }
    },
    {
      "id": "other",
      "name": "<gray>Other",
      "item": {
        "id": "minecraft:cobweb"
      }
    }
  ],
  "pwarpGui": "player_warps",
  "warpNameValidation": "^[a-zA-Z0-9_-]{1,16}$",
  "warpTpDelay": 0.0
}

The default Player Warps config looks like this, it defines five Player Warp categories. It also defines the Player Warp GUI, and the regex new names are validated against (max 16 characters, no spaces, only letters/numbers/dashes/underscores by default). "warpTpDelay" sets a delay before teleporting the player to the player warp (in seconds).

The Player Warps menu in-game

The Player Warps GUI is fully configurable, and comes with a nice default seen above. The config file corresponding with above screenshot is here:

{
  "id": "player_warps",
  "gui_type": "G9X4",
  "title": "<gold>Player Warps",
  "gui": [
    "#########",
    "##X#X#X##",
    "###X#X###",
    "#########"
  ],
  "keys": {
    "#": "defaultFillItem",
    "X": "defaultElementFillItem"
  }
}

Clicking on a category icon will bring the player to a list of warps marked under that category.

The "Other" category is the default for new Player Warps.

Visit stats are shown, alongside the owner. At the moment, all player warp icons are just the owners head.