Introduction

TypicalWaypoint is an operator tool for creating named server waypoints and showing them to selected players. It does not expose public player self-service commands in the current command surface; the active command root requires waypoint.admin.

Waypoints are stored globally by name. A waypoint records its location and the item model id used for the visible indicator. Visibility is tracked per player while the server is running, so staff choose which players see each waypoint with /waypoint show and /waypoint hide.

What players see

When a waypoint is visible to a player and the player is outside the arrival radius, the client receives a client-side item display mounted as a passenger. The display is translated from the player’s eye position toward the waypoint direction, so it behaves like an on-screen directional marker.

When the player reaches the configured arrival radius, the following indicator is removed and a placed display is spawned at the waypoint location. If the player leaves the arrival area, the placed display is removed and the mounted indicator returns.

Main operator jobs

• Install the plugin jar and PacketEvents on a Paper/Folia-compatible server.
• Configure the license key and ensure bStats has a non-empty serverUuid.
• Create waypoints and assign texture ids where needed.
• Build and distribute the generated resource pack.
• Keep messages and behavior aligned through the generated YAML configs.