✦ Overview

NexusWarps is a fully-featured player warp plugin that lets your players create, share, and discover warps — complete with a beautiful paginated GUI, a 5-star rating system, per-rank warp limits, multi-language support, and both SQLite and MySQL database backends. Everything is configurable through config.yml and messages.yml, and all messages support hex colors.



✦ Features

️ Player Warps
Players can create their own warps and share them with the entire server. Each warp has a name, description, icon, location and rating.

️ Beautiful GUI
A clean, paginated 54-slot warp browser lets players browse all server warps with icons, ratings, visit counts and descriptions. Supports sorting by most visited, highest rated, newest and A-Z.

⭐ Rating System
Players can rate any warp from 1 to 5 stars. Ratings are averaged and displayed in the GUI with a star indicator. Highly rated warps even get a glowing effect in the GUI.

️ SQLite & MySQL
Uses SQLite out of the box — no setup required. Switch to MySQL with HikariCP connection pooling for large networks by changing one line in config.yml.

Multi-Language
English and Spanish are included out of the box. Every single message is customizable in the lang folder. Adding a new language is as simple as creating a new file.

Hex Color Support
Every message in the lang files supports both standard &X color codes and &#RRGGBB hex colors.

Per-Rank Warp Limits
Configure how many warps each rank can create via permission nodes. Default, VIP, MVP, Elite and Legend tiers are included — fully customizable in config.yml.

️ Protection Plugin Support
Integrates with WorldGuard, GriefPrevention and Lands to prevent players from creating warps on land they don't own.

PlaceholderAPI Support
10+ placeholders available for scoreboards, holograms and more.

⏱️ Teleport Delay & Cooldown
Configurable teleport countdown with cancel-on-move, and a cooldown between teleports.



✦ Commands

Command	Description	Permission
/pw	Open the warp browser GUI	nexuswarps.use
/pw <name>	Teleport to a warp	nexuswarps.teleport
/pw create <name> [desc]	Create a new warp	nexuswarps.create
/pw remove <name>	Remove your warp	nexuswarps.remove
/pw rename <name> <new>	Rename your warp	nexuswarps.rename
/pw reset <name>	Move warp to your location	nexuswarps.reset
/pw rate <name> <1-5>	Rate a warp	nexuswarps.rate
/pw seticon <name> <material>	Set warp icon in GUI	nexuswarps.seticon
/pw desc <name> <text>	Set warp description	nexuswarps.setdesc
/pwadmin reload	Reload config and messages	nexuswarps.admin
/pwadmin forceremove <name>	Force remove any warp	nexuswarps.admin
/pwadmin list [player]	List all warps	nexuswarps.admin
/pwadmin teleport <name>	Teleport to any warp	nexuswarps.admin
/pwadmin seticon <name> <mat>	Set icon for any warp	nexuswarps.admin

✦ Permissions

Permission	Description	Default
nexuswarps.use	Use /pw	true
nexuswarps.create	Create warps	true
nexuswarps.remove	Remove own warps	true
nexuswarps.rename	Rename own warps	true
nexuswarps.reset	Reset warp location	true
nexuswarps.rate	Rate warps	true
nexuswarps.teleport	Teleport to warps	true
nexuswarps.admin	All admin commands	op
nexuswarps.limit.bypass	Unlimited warps	op
nexuswarps.limit.default	Default limit (1 warp)	true
nexuswarps.limit.vip	VIP limit (2 warps)	false
nexuswarps.limit.mvp	MVP limit (3 warps)	false
nexuswarps.limit.elite	Elite limit (5 warps)	false
nexuswarps.limit.legend	Legend limit (10 warps)	false

✦ PlaceholderAPI Placeholders

Placeholder	Description
%nexuswarps_count%	Total warps on the server
%nexuswarps_player_count%	Warps owned by the player
%nexuswarps_player_limit%	Max warps the player can have
%nexuswarps_top_name_1%	Name of #1 most visited warp (1-10)
%nexuswarps_top_visits_1%	Visit count of #1 warp (1-10)
%nexuswarps_top_rating_1%	Rating of #1 warp (1-10)
%nexuswarps_top_owner_1%	Owner of #1 warp (1-10)
%nexuswarps_warp_<name>_visits%	Visit count of a specific warp
%nexuswarps_warp_<name>_rating%	Rating of a specific warp
%nexuswarps_warp_<name>_owner%	Owner of a specific warp
%nexuswarps_warp_<name>_exists%	true/false if warp exists

✦ Requirements

Required:

• Paper or Spigot 1.21+
• Java 17+

Optional (soft dependencies):

• PlaceholderAPI — for placeholders
• WorldGuard — region protection
• GriefPrevention — claim protection
• Lands — land protection

✦ Coming Soon

• Warp categories and tags
• Favorites system
• Warp search command
• Vault economy integration
• More languages
• bStats metrics

✦ Support

Found a bug? Have a suggestion? Need help setting up?

Join our Discord for fast support:
discord.gg/RDvw427bqC

Please do not leave a bad review if you have an issue — join the Discord first and we'll get it sorted!



✦ More Plugins from CatFarhan

Plugin

Description
eBanks — Banking, Loans & GUI	A fully-featured banking plugin with loans, GUI and a web interface