Vonix Server Utilities — Movement & Teleportation

All player homes, warps, and teleportation return locations are persisted directly to the local SQLite database (config/vonix_server_utilities/data.db).

1. Player Homes System

Players can set, list, and teleport to personal named coordinates.

Commands

/sethome [name] — Saves the player’s current location. If no name is specified, the home is named home.
/home [name] — Teleports to the specified home.
/delhome <name> — Deletes a saved home.
/homes — Lists all registered homes for the player.

Home Limits & Configuration

The maximum number of homes permitted per player is controlled via config/vonix_server_utilities.properties:

max_homes=5

When a player attempts to create a home exceeding this limit, the command fails with a friendly notification indicating that the limit has been reached.

2. Server Warps

Warps provide global points of interest accessible to all players:

/setwarp <name> — Creates a public warp at the operator’s position (Requires vsu.admin.warp or Op 3).
/delwarp <name> — Permanently removes a warp (Requires vsu.admin.warp or Op 3).
/warp <name> — Teleports the player to the warp destination.
/warps — Displays a clickable or paginated list of all active warps.

3. TPA Request Lifecycle

VSU implements safe, bidirectional peer-to-peer teleportation requests:

[Requester]                                      [Target Player]
     │                                                  │
     ├─── /tpa TargetPlayer ───────────────────────────>│ "Steve wants to teleport to you"
     │                                                  │
     │<── /tpaccept ────────────────────────────────────┤ "Accepting request..."
     │                                                  │
[Teleport Executed]                                [Position Unchanged]

/tpa <player> — Request to teleport to another player’s position.
/tpahere <player> — Request that another player teleports to you.
/tpaccept — Accepts the most recent pending incoming request.
/tpdeny — Denies the pending request.

Timeout Configuration

Requests automatically expire if unanswered within the configured window:

tpa_timeout_seconds=120

4. Back & Death Origins

VSU maintains separate tracking for routine teleport origins and player death locations:

/back — Returns you to your previous position immediately prior to your last teleport (e.g. after using /home or /spawn).
/backdeath — Returns you to the exact coordinates of your most recent death.

Persistent Recovery

In VSU 2.0.1+, normal teleport locations and death locations are saved in distinct rows within SQLite. If the server restarts unexpectedly, player death return locations are preserved upon re-joining.

Delay tuning in vonix_server_utilities.properties:

death_back_delay_seconds=0

5. Administrative Teleportation

Staff operators can move players and manage coordinates directly:

/tp <target> — Teleport self to player.
/tp <player> <destination> — Teleport one player to another.
/tphere <player> — Forcefully teleport target player to you.
/tpall — Teleport all currently connected players to your location.
/tppos <x> <y> <z> [world] — Teleport directly to exact spatial coordinates.
/setspawn — Set global world spawn at your current coordinates.