Skip to content
TypicalWaypoint

Operating and Troubleshooting

Startup fails before enable

Check license setup first:

  • plugins/TypicalWaypoint/license-config.yml must contain a real license key.
  • plugins/bStats/config.yml must exist.
  • plugins/bStats/config.yml must contain a non-empty serverUuid.
  • The server must be able to reach the license endpoint at least once before offline cache fallback can work.

If online verification has succeeded before, TypicalWaypoint can use plugins/TypicalWaypoint/license-cache.json during temporary license-service failures.

Commands missing

Confirm the plugin started and CommandAPI loaded during startup. Also confirm the sender has waypoint.admin. The command roots are /waypoint and /wp.

Displays do not appear

Check these items:

  • PacketEvents is installed and loaded before TypicalWaypoint.
  • The target player is online.
  • Staff ran /waypoint show <name> <target>.
  • The player is in the same world as the waypoint.
  • The waypoint still exists in /waypoint list.
  • The player has the generated resource pack applied if custom visuals are expected.

Unknown item model

The optional texture id for /waypoint set must exist in the current generated model id set. Add the PNG under plugins/TypicalWaypoint/waypoints/, run /waypoint pack, then try the command again.

Resource-pack build fails

Check the error text from /waypoint pack or /waypoint reload.

  • Invalid PNG files are rejected.
  • Duplicate sanitized texture ids are rejected.
  • Shader files must start with #version.
  • The zip output path cannot be inside plugins/TypicalWaypoint/build/.
  • Parent directories for the zip output must be writable by the server process.

Config changes do not apply

Run:

/waypoint reload

Reload also rebuilds the resource pack. For manual edits to waypoint data, stop the server before editing data/waypoint-data-config.yml.