Installation

1. Download the latest snplayerwarps-v* release from Sn-Releases.
2. Place the .jar file into your server's plugins/ folder, next to SnLib.jar.
3. Start the server once. SnPlayerWarps creates the shared license file plugins/.Sn-License/license.yml.
4. Paste your Sn license key into that file, replacing the placeholder line.
5. Restart the server. SnPlayerWarps validates the key at startup and then enables.

Dependencies

Requirements: Java 21+, Paper 1.20.x (1.20.4 or newer) or 1.21.x.

First boot

SnPlayerWarps writes every file it needs on first boot:

plugins/
  .Sn-License/
    license.yml            your bundle key, shared by every Sn bundle plugin
  SnPlayerWarps/
    config.yml             warps, visits, browser, sponsors, limits, currencies, islands
    lang/
      messages_en.yml      every line the plugin sends
    guis/
      browse.yml           the warp browser
      warp-picker.yml      one owner's warps, when a visit names several
      sponsor-select.yml   picks the warp to feature in a sponsor slot
      confirm-sponsor.yml  confirms a sponsor slot purchase
      my-warps.yml         your warps (and staff view of another owner's)
      warp-manage.yml      manages one warp
      confirm-delete.yml   confirms a warp deletion
      bans.yml             the players banned from your warps

With database.type: sqlite (the default) the database file lives in the same folder. Nothing is written to data files: warps, sponsor slots and queued refunds all live in the database.

Before players use it

• Point the sponsor currency at a currency you actually have. The shipped sponsor.currency is okicoins, a command-backed example that reads %sncredits_balance% and runs SnCredits commands. On a server without SnCredits, set it to money (Vault) or declare your own currency. See Configuration.
• Check the costs. limits.costs.create, move and rename ship at 0 (free), paid in money when you raise them.
• Set the warp limit. limits.default-warps is 1. Grant snplayerwarps.limit.<n> to ranks that may own more. See Permissions.

Island setup

The island rules work with SnSuperiorSkyblock or SuperiorSkyblock2 (the islands: block of config.yml). With islands.require-island: true, warps can only be created on an island you belong to.

With islands.privilege-check: true (the default), you also need the PLAYER_WARPS privilege of your island role to create or move a warp there. SnPlayerWarps registers the privilege itself. Two steps are yours, in the island plugin's own files:

1. Add PLAYER_WARPS to island-roles.ladder.member.permissions in its config.yml, so every member has it by default. Higher roles inherit it.
2. Add a player_warps entry under permissions: in its menus/permissions.yml. Copy an existing entry such as build and change its item and texts. Without it, island owners cannot toggle the privilege in /is permissions.

The console reminds you of both steps at every start while the privilege check is on. To rely on island membership alone, set islands.privilege-check: false.