SyTP

# SyTP - Better Teleport Plugin A feature-rich and easy-to-use Minecraft Paper/Purpur server teleport plugin with support for economy systems, teleport delay, particle effects, and more. ## Features - **Multiple Teleport Methods** - `/tpa` - Request to teleport to another player - `/tpc` - Request another player to teleport to you - `/tpw` - Invite all players on the server to teleport to you - `/tpt <x y z>` - Teleport to specific coordinates (with confirmation prompt) - **Instant Teleport on Accept** - When a player accepts a teleport request, the teleport happens immediately - No more waiting for the delay timer after accepting - **Economy System Support** - Supports Vault economy system - Configurable teleport costs (tpa/tpc/tpw/tpt) - Admin bypass for costs - **Teleport Delay** - Configurable teleport wait time (only applied to direct teleport commands, not accept actions) - Movement cancels teleport - Cooldown system - **GUI Interface** - Visual teleport request management - Click to accept/reject - **Particle Effects** - Particle effects on teleport completion - Multiple particle types available - **Highly Configurable** - All messages are customizable - Toggle features on/off - Flexible cost and delay settings ## Requirements - **Server**: Paper / Purpur 1.21.x - **Java**: 21 or higher - **Optional Dependency**: Vault + Economy plugin (e.g., EssentialsX) ## Installation 1. Download the latest version `SyTP-1.2.0.jar` 2. Place the JAR file in your server's `plugins` folder 3. Restart the server or load the plugin 4. Edit `plugins/SyTP/config.yml` to customize settings 5. Execute `/sytp reload` to reload configuration ## Commands | Command | Description | Permission | |---------|-------------|------------| | `/sytp reload` | Reload plugin configuration | `sytp.admin` | | `/tpa <player>` | Request to teleport to a player | `sytp.tpa` | | `/tpc <player>` | Request a player to teleport to you | `sytp.tpc` | | `/tpw` | Invite all players to teleport to you | `sytp.tpw` | | `/tpt <x y z>` | Teleport to specific coordinates (with confirmation) | `sytp.tpt` | | `/tpt confirm` | Confirm a pending coordinate teleport | `sytp.tpt` | | `/tpt cancel` | Cancel a pending coordinate teleport | `sytp.tpt` | | `/tpaccept` | Accept teleport request | `sytp.accept` | | `/tpdeny` | Deny teleport request | `sytp.deny` | ## Permissions | Permission | Description | Default | |------------|-------------|---------| | `sytp.admin` | Plugin admin permission | OP | | `sytp.tpa` | Use /tpa command | Everyone | | `sytp.tpc` | Use /tpc command | Everyone | | `sytp.tpw` | Use /tpw command | OP | | `sytp.tpt` | Use /tpt command (teleport to coordinates) | Everyone | | `sytp.accept` | Accept teleport requests | Everyone | | `sytp.deny` | Deny teleport requests | Everyone | | `sytp.bypass.cost` | Bypass teleport costs | OP | | `sytp.bypass.delay` | Bypass teleport delay | OP | ## Configuration ```yaml # Feature Toggles enable-teleport-cost: true # Enable teleport cost enable-teleport-delay: true # Enable teleport delay enable-particle-effect: true # Enable particle effects enable-tpt: true # Enable /tpt command enable-tpt-cost: true # Enable /tpt teleport cost # Cost Settings teleport-cost: 100.0 # TPA cost teleport-here-cost: 100.0 # TPC cost tpw-cost: 500.0 # TPW cost tpt-cost: 100.0 # TPT (coordinate teleport) cost # Teleport Settings teleport-delay-seconds: 3 # Teleport delay (seconds) request-timeout-seconds: 30 # Request timeout (seconds) teleport-cooldown-seconds: 10 # Cooldown time (seconds) # Particle Effects particle-type: PORTAL # Particle type particle-count: 50 # Particle count ``` ## How /tpt Works 1. Player runs `/tpt <x> <y> <z>` (e.g., `/tpt 100 64 -200`) 2. Plugin validates coordinates and checks balance 3. A confirmation message is sent with the cost and click buttons: - `请确认是否传送到 100.0 64.0 -200.0？将花费 100.0 金币` - `` (click to confirm) | `` (click to cancel) 4. Clicking confirm teleports the player immediately and deducts the cost 5. Clicking cancel aborts the teleport Notes: - The currency unit is automatically fetched from the Vault economy plugin - Admins with `sytp.bypass.cost` permission teleport for free - The teleport is instant (no delay) since the player has explicitly confirmed - Pending requests expire after `request-timeout-seconds` ## Changelog ### v1.2.0 - **New Feature**: Added `/tpt <x y z>` command to teleport to specific coordinates - Admins can enable/disable the command in `config.yml` (`enable-tpt`) - Admins can configure the teleport cost (`tpt-cost`) and toggle cost (`enable-tpt-cost`) - Players receive a confirmation prompt showing the cost before teleporting - Click-to-confirm / click-to-cancel interface - **Change**: Teleport requests are now executed immed