XPTeleport - Server-Side XP Teleportation Mod

A lightweight, server-side-only Minecraft teleportation mod built for NeoForge 1.21.1. It acts as a complete server-side replacement for standard essentials mods without requiring patch work or client-side mods.

This mod introduces distance-based experience (XP) costs, click-to-teleport waypoint interceptions, stand-still anti-abuse warmup checks, OP bypasses, and player-to-player XP level trading.

Known issue: /rtp does not work properly

---

Features

• 100% Server-Side: Players can connect using vanilla clients; no mods are required on the player's computer.
• Distance-Based XP Cost (Logarithmic): Uses a dynamic logarithmic curve calibrated to charge 5 levels per 100 blocks, capping at 30 levels at the world border.
• Anti-Abuse Warmup: Teleportation requires players to stand still and take no combat damage for 3 seconds, displaying a countdown on their action bar HUD.
• Zero Cooldowns by Default: Continuously teleport without command delay (fully configurable).
• Xaero's Minimap Waypoint Integration: Intercepts shared waypoints in player chat and appends a clickable gold [Teleport] button.
• Vanilla /tp Redirection: Intercepts coordinate-based tp requests from players and redirects them to a prompt showing the XP cost and requiring a [CONFIRM] click.
• OP Exemption: Operators (OP level 2+) pay 0 XP levels and teleport instantly (bypassing warmup checks).
• XP Trading Commands: /xpgive and /xprequest allow players to safely trade or request XP levels directly from their bars.

---

File and Storage Architecture

To keep files organized and easy to back up, the mod saves files in distinct structures:

Player Homes

• Path: <your_world_save_folder>/xpteleport/homes/<player-uuid>.json
• Purpose: Player-specific locations set using /sethome. By keeping them inside the world save folder, your players' homes are automatically backed up when copying or backing up the world, and reset cleanly if you change worlds.

Server Warps

• Path: config/xpteleport/warps.json
• Purpose: Global warps set by server administrators. Keeping them inside the config/ directory ensures warps survive even if the active world save is wiped or changed.

Main Configuration File

• Path: config/xpteleport.json
• Purpose: Holds all customizable settings, messages, and mathematical coefficients. Migrates automatically on launch.

---

Configuration (config/xpteleport.json)

The config file is generated automatically on launch with help comments explaining each setting:

{
  "costs": {
    "tpa": 10,
    "tpahere": 10,
    "tpaccept": 10,
    "home": 10,
    "warp": 10,
    "spawn": 10,
    "rtp": 10,
    "wild": 10,
    "back": 10,
    "xaero_tp": 30
  },
  "messages": {
    "insufficient_xp": "§cYou do not have enough XP levels to teleport! (Cost: %s levels, Current: %s levels)",
    "xp_deducted": "§aTeleportation successful! Deducted %s XP levels.",
    "confirm_prompt": "§eYou are about to teleport to [%s, %s, %s] for %s XP levels."
  },
  "redirect_tp_to_xtp": true,
  "max_homes": 5,
  "rtp_min_range": 50,
  "rtp_max_range": 500,
  "distance_based_xp": true,
  "use_logarithmic_cost": true,
  "base_teleport_cost": -19.3,
  "log_multiplier": 5.28,
  "xaero_multiplier": 3.0,
  "blocks_per_level": 500,
  "cross_dimension_cost": 15,
  "warmup_seconds": 3,
  "cooldown_seconds": 0,
  "show_ops_on_leaderboard": false
}

---

Commands Reference

XP Leaderboard

• /xp leaderboard (alias: /xpteleport leaderboard): Displays a chat leaderboard showing the top 10 players on the server ranked by total experience points. (By default, OP players are hidden unless "show_ops_on_leaderboard": true is enabled in configuration).

XP Trading

• /xpgive <player> <levels> (alias: /xpg): Gives XP levels from your bar to another player. (OPs can give infinite levels without losing XP).
• /xprequest <player> <levels> (alias: /xpr): Sends a request to another player. They can click [ACCEPT] or [DENY] in chat to process the trade.
• /xprequest accept / /xprequest deny (aliases: /xpr accept / /xpr deny): Accept/Deny active XP request.

Teleportation

• /tpa <player> / /tpahere <player>: Coordinate requests to/from players.
• /tpaccept / /tpdeny / /tpcancel: Accept, deny, or cancel active TPA requests.
• /sethome [name] / /home [name] / /delhome [name] / /listhomes: Personal warp points.
• /warp <name> / /listwarps / /setwarp <name> / /delwarp <name>: Global server warps.
• /spawn / /back: Basic utilities.
• /rtp (alias: /wild): Teleports to random safe coordinates clamped to the active World Border.
• /xtp <coords> / /xtp confirm: Custom coordinates confirmation endpoint.

Administration

• /xpteleport info: Shows credits. (Usable by all players).
• /xpteleport reload: Reloads configuration and warps from disk. (Requires OP level 2).
• /xpteleport change: Toggles standard /tp redirection. (Requires OP level 2).
• /xpteleport help: Displays all available commands. (Usable by all players).