FishWarp

FishWarp is a lightweight, purely server-side Fabric mod that lets players teleport back to the world spawn by sneaking on designated warp blocks for a configurable duration.

100% Server-Side: Players do not need to install this mod on their clients to join and use its features.

---

Features

• Warp Pads: Standing on a registered warp position initiates a smooth teleport sequence with a nausea visual effect.
• Automatic Cancellation: Stepping off the block immediately cancels the teleport and clears the effect.
• Warp Hint: Displays an italic blue “Hold sneak” label 1.5 blocks above every warp position.
• LuckPerms Ready: Uses the Fabric Permissions API (fish.warp) with an automatic fallback to vanilla OP levels.

---

How It Works for Players

1. Step onto a Warp Block: Stand on any registered warp pad in the world.
2. Stay on the Pad: Remain on the block for 6 seconds (configurable) without moving off it.
3. Teleport to Spawn: Once the countdown finishes, you are teleported directly to the server spawn point.

---

Commands & Permissions

Management commands require the permission fish.warp (configurable) or OP status (Level 3/4) if no permission plugin is installed.

For Team Members (fish.warp)

• /warp – Displays command usage overview.
• /warp set <Name> – Saves your current block position as a warp pad.
• /warp delete <Name> – Deletes a saved warp position.
• /warp list – Lists all registered warp positions with clickable /tp coordinates.
• /warp reload – Reloads config.json and coordinates.json at runtime.

---

⚙️ Configuration

All configuration and runtime files are automatically generated and stored in config/fishwarp/:

• config.json – Customize warpPermission, teleportDelaySeconds (default 6), nauseaExtraSeconds (default 3), and overworldOnly (default true).
• coordinates.json – Stores all registered warp pad block coordinates.