Skip to content
TypicalWaypoint

Installation

Requirements

  • Java 25.
  • Paper/Folia 26.2 or 26.3 server.
  • PacketEvents installed as a server plugin, matching snapshot 2.14.0-20260919.033014-1 (the 2.14.0-SNAPSHOT line with 26.3 support). PacketEvents is not bundled in TypicalWaypoint; older builds do not provide the required 26.3 protocol support.
  • A valid TypicalWaypoint license key.
  • bStats config at plugins/bStats/config.yml with a non-empty serverUuid.

Install

  1. Stop the server.
  2. Put the TypicalWaypoint jar in plugins/.
  3. Put PacketEvents in plugins/ if it is not already installed.
  4. Start the server once so TypicalWaypoint can generate its config files.
  5. Stop the server and edit plugins/TypicalWaypoint/license-config.yml.
  6. Replace the placeholder license-key value with the real license key.
  7. Confirm plugins/bStats/config.yml exists and contains a non-empty serverUuid.
  8. Start the server again.

TypicalWaypoint verifies the license during plugin load. Startup fails when the license key is blank, still set to %%_TYPICAL_LIC_%%, or when the bStats server UUID cannot be read.

Generated files

On first valid startup, the plugin writes configs under plugins/TypicalWaypoint/:

  • main-config.yml
  • license-config.yml
  • message-config.yml
  • data/waypoint-data-config.yml
  • waypoints/waypoint_circle.png
  • shaders/core/, shaders/typicalwp_26_1_2/core/, shaders/typicalwp_26_2/core/, and shaders/typicalwp_26_3/core/
  • build.zip and build/ after resource-pack generation

The plugin retains its Paper 26.2 API baseline. CommandAPI 12.0.0 uses its default Paper fallback to the 26.2 adapter on 26.3; validate command registration, selectors, and execution on your server before accepting the upgrade. Licensed live startup and client rendering on 26.2/26.3 have not yet been validated for this change.

License cache

Online verification creates and updates a signed offline cache at plugins/TypicalWaypoint/license-cache.json. If the license service is temporarily unavailable later, startup can continue only when this signed cache is valid.