feabertp

> **日本語は下に。プラグインは日本語のみ。** > **The Japanese description is available below. This plugin is available in Japanese only.** # FeaberTeleport FeaberTeleport is a Paper 1.21.11 plugin that provides homes, spawn teleportation, player teleport requests, and an item delivery service with distance-based Vault fees. Player-facing messages are in Japanese. They can be customized in `messages.yml`. ## Features - Save multiple named homes - Teleport to the default world's spawn point - Send `/tpa` and `/tphere` requests - Five-second stationary teleport countdown - Prevent teleportation near hostile mobs or during PvP cooldown - Prevent home, spawn, and TPA teleportation across dimensions - Charge distance-based teleport fees through Vault - Require fee confirmation before teleportation or item delivery - Deliver complete item stacks while preserving names, lore, enchantments, durability, and custom data - Review incoming deliveries in a list and GUI - Shared permanent ignore list for TPA and item delivery - Customizable settings and Japanese messages ## Requirements | Requirement | Version or details | | --- | --- | | Server | Paper 1.21.11 | | Java | Java 21 | | Dependency | Vault | | Economy | A Vault-compatible economy plugin, such as EssentialsX Economy | FeaberTeleport disables itself if no Vault economy provider is available. ## Installation 1. Install Vault and a Vault-compatible economy plugin on your Paper server. 2. Place the FeaberTeleport JAR in the server's `plugins` directory. 3. Start or restart the server. 4. Edit `plugins/FeaberTeleport/config.yml` and `messages.yml` if required. When an update adds new configuration or message entries, the defaults are automatically appended to existing files without replacing customized values. ## Commands | Command | Description | | --- | --- | | `/sethome <name>` | Save your current location as a home | | `/home <name>` | Teleport to a saved home | | `/homelist` | List saved homes | | `/delhome <name>` | Delete a saved home | | `/spawn` | Teleport to the default world's spawn point | | `/tpa <player>` | Request to teleport to another player | | `/tphere <player>` | Request that another player teleport to you | | `/ok`, `/accept` | Accept a pending fee confirmation or TPA request | | `/deny`, `/yada` | Deny the latest TPA request | | `/delivery <player>` | Deliver the item stack in your main hand | | `/checkitem` | List incoming item deliveries | | `/delivery denylist` | Show the shared permanent ignore list | | `/delivery denylist <player>` | Remove a player from the ignore list | ## Safe teleportation Before `/home`, `/spawn`, `/tpa`, or `/tphere` can complete, the teleporting player must: 1. Have no hostile mobs within the configured radius. 2. Be outside the PvP cooldown period. 3. Remain still for the configured countdown, which is five seconds by default. 4. Be in the same dimension as the destination. Looking around does not cancel the countdown. Moving, entering PvP, or having a hostile mob enter the configured area cancels it. A TPA countdown starts only after the request and fee have been accepted. ## Teleport fees The default teleport fee is ¥1 per 100 blocks, with a minimum of ¥100. Distance is measured as a three-dimensional straight line and rounded up. ```text fee = max(100, ceil(distance / 100)) ``` | Distance | Fee | | ---: | ---: | | 320 blocks | ¥100 | | 10,000 blocks | ¥100 | | 420,000 blocks | ¥4,200 | The teleporting player pays the fee for `/home`, `/spawn`, and `/tpa`. `/tphere` is collect-on-delivery, so the player being called pays the fee. Before the countdown starts, the player must confirm the displayed fee by clicking the chat button, repeating the original command, or running `/ok` or `/accept`. The default confirmation timeout is 15 seconds. A failed teleport is not charged, or is refunded if the teleport operation itself fails. ## Item delivery Hold the item stack in your main hand and run `/delivery <player>`. The recipient must be online. Before sending, the sender must confirm the delivery fee by clicking the chat button, repeating the command, or running `/ok` or `/accept`. The default delivery fee is ¥1 per 1,000 blocks, with a minimum of ¥10. ```text fee = max(10, ceil(distance / 1,000)) ``` The recipient can use `/checkitem` to view incoming requests and open a GUI. From the GUI, they can accept the item, reject it, or permanently ignore the sender and reject all matching deliveries. Rejected or expired deliveries return both the item and fee to the sender. If the sender is offline, the item is stored and returned on their next login. The default recipient response timeout is 60 seconds. ## Configuration The following values can be changed in `plugins/FeaberTeleport/config.yml`: - Teleport countdown and movement tolerance - Hostile mob detection radius - PvP cooldown - TPA request timeout - Teleport minimum fee and distance rate - Teleport fee confirmation timeout - Delivery minimum fee and dist