EssentialsTP - PMMPCore Plugin

EssentialsTP Plugin (Click for More)

EssentialsTP is a comprehensive teleportation plugin for PMMPCore Framework that brings full location management to Minecraft Bedrock. Set homes, warps, spawn points, and manage teleport requests with cooldowns and optional economy integration.

What Does This Plugin Do?

EssentialsTP extends PMMPCore Framework with complete teleportation management, allowing players to set personal homes, global warps, server spawns, and send teleport requests to other players. Features cooldowns, per-dimension spawn points, and optional economy costs for teleportation services.

⚠️ Requirements

Requirement	Status	Details
❌ PMMPCore Framework	Required	This plugin cannot work without PMMPCore Framework installed.
✅ Server Owner	Recommended	Designed for server administrators, not casual players.

Key Features

• ✅ Player Homes: Set and teleport to multiple named homes per player.
• ✅ Global Warps: Server-wide teleportation points created by admins.
• ✅ Per-Dimension Spawn: Separate spawn points for each dimension (overworld, nether, end).
• ✅ Teleport Requests: TPA and TPAHere request system with accept/deny/cancel.
• ✅ Back Command: Teleport back to your previous location.
• ✅ Cooldown System: Configurable cooldowns per teleport type to prevent spam.
• ✅ Economy Integration: Optional money costs for teleportation services.
• ✅ PlaceholderAPI Integration: Home count and request placeholders for display.

🛠️ Available Commands

Command	Syntax	Description
sethome	/sethome [name]	Set a home at your current location
home	/home [name]	Teleport to one of your homes
delhome	/delhome [name]	Delete one of your homes
setwarp	/setwarp <name>	Set a global warp location
warp	/warp <name>	Teleport to a global warp
delwarp	/delwarp <name>	Delete a global warp
setspawn	/setspawn	Set spawn for current dimension
spawn	/spawn	Teleport to spawn
back	/back	Teleport to your previous location
tpa	/tpa <player>	Request to teleport to a player
tpahere	/tpahere <player>	Request a player to teleport to you
tpaccept	/tpaccept [player]	Accept a teleport request
tpdeny	/tpdeny [player]	Deny a teleport request
tpcancel	/tpcancel [player]	Cancel your pending request

Example Usage

# Set your home
/sethome mybase

# Teleport home
/home mybase

# Set server spawn
/setspawn

# Request to teleport to a friend
/tpa Notch

# Accept a teleport request
/tpaccept

# Teleport back after death
/back

Configuration Options

Configure EssentialsTP behavior in the plugin config:

const ESSENTIALSTP_DEFAULTS = {
  limits: {
    maxHomesPerPlayer: 5,
    maxHomeNameLength: 24,
    maxWarpNameLength: 24
  },
  requests: {
    timeoutSeconds: 30
  },
  cooldowns: {
    homeSeconds: 5,
    spawnSeconds: 5,
    warpSeconds: 5,
    backSeconds: 5,
    tpaSeconds: 5,
    tpahereSeconds: 5
  },
  costs: {
    enabled: false,
    home: 0, spawn: 0, warp: 0, back: 0, tpa: 0, tpahere: 0
  }
};

PlaceholderAPI Integration

Placeholder	Description
%essentialstp_home_count%	Number of homes the player has
%essentialstp_pending_requests%	Number of pending teleport requests
%essentialstp_back_available%	Whether back location is available (true/false)
%essentialstp_cooldown_home%	Remaining home cooldown in seconds

Permission System

Permission Node	Command	Default Group
essentialstp.command.home	/home	Guest
essentialstp.command.sethome	/sethome	Guest
essentialstp.command.delhome	/delhome	Guest
essentialstp.command.back	/back	Guest
essentialstp.command.spawn	/spawn	Guest
essentialstp.command.setspawn	/setspawn	Admin
essentialstp.command.warp	/warp	Guest
essentialstp.admin.setwarp	/setwarp	Admin
essentialstp.admin.delwarp	/delwarp	Admin
essentialstp.command.tpa	/tpa	Guest
essentialstp.command.tpahere	/tpahere	Guest
essentialstp.command.tpaccept	/tpaccept	Guest
essentialstp.command.tpdeny	/tpdeny	Guest
essentialstp.command.tpcancel	/tpcancel	Guest

Compatibility & Requirements

• ⚠️ Requires PMMPCore Framework: This plugin is part of the PMMPCore ecosystem and cannot function independently.
• ✅ Version: Optimized for Minecraft Bedrock 1.21.70+ (Release).
• ✅ Multiplayer: Fully tested on Realms and Dedicated Servers.
• ✅ MultiWorld Compatible: Works with MultiWorld plugin for cross-dimensional teleportation.
• ✅ License: GPL-3.0 - Free to use, modify, and distribute under the same terms.

Installation

1. Download EssentialsTP from CurseForge (comes as .mcpack file)
2. Change file extension: Rename EssentialsTP.mcpack to EssentialsTP.zip
3. Extract the archive: Unzip the file to access the contents
4. Locate PMMPCore: Find your PMMPCore Framework installation folder
5. Copy plugin files: From the extracted folder, copy the EssentialsTP folder from scripts/plugins/
6. Paste to plugins: Paste the folder into scripts/plugins/ within PMMPCore
7. Register plugins: Open scripts/plugins.js and add the import:

// Add this line to your plugins.js file
import "./plugins/EssentialsTP/main.js";

1. Restart server: Restart Minecraft Bedrock to load the plugin
2. Verify installation: Use /plugins to confirm plugin is loaded

Getting Started

1. Install PMMPCore Framework first (required dependency)
2. Follow the installation steps above to add EssentialsTP
3. Restart your server to initialize the plugin
4. Use /sethome to set your first home
5. Configure cooldowns and economy costs as needed
6. Set server spawn with /setspawn

Need help with teleportation setup? Join our Discord Server for support!

---

⚠️ Important Notice: This plugin requires PMMPCore Framework and is designed for server administrators with technical knowledge of server management.