PWarp+ | 12 GUIs | 5 Warp Modes | Voting | Doorbell | Audit Log | Multilang

✦━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━✦

⚡ Why PWarp+?

The original PWarp is abandoned (last update March 2024). It uses JSON flat files, has one basic GUI, no voting, no categories, no economy taxes, no audit log, and limited permissions.

PWarp+ is a near-complete rewrite: 30 classes vs 18, 6,863 lines vs 4,251, SQLite database, 12 GUI screens, and dozens of features the original never had.

✦━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━✦

95% GUI-Driven — Built for Bedrock & Java

PWarp+ is designed to minimize typing. Almost everything is done through visual menus, making it perfect for servers with Bedrock and Java players side by side. Phone players won't struggle typing long commands — they just click through the GUIs.


Players only type in chat for 3 specific things:

• Setting a warp name when creating
• Setting a price for paid warps
• Entering a password for password-protected warps

Everything else — creating, deleting, editing, voting, favoriting, browsing by category, ranking, whitelist management, teleporting — all through GUI clicks.

✦━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━✦

️ 12 GUI Screens

Not just a warp list. PWarp+ has a complete visual interface:

• Main Menu — Browse all public warps with pagination, search, categories, top, favorites
• Warp Detail — Full info: owner, category, stats, votes, visits. Teleport, vote, favorite
• Edit Warp — Rename, description, icon, mode, price, password, category, move, hide, delete
• Create Wizard — 3-step process: category → mode → confirm (not a single command)
• My Warps — Your own warps only
• Top Warps — Ranked by votes (gold/silver/bronze)
• Favorites — Your saved warps
• Search Results — Name search with pagination
• Category Filter — Browse by category
• Whitelist Manager — Visual add/remove players
• Config (Admin) — In-game language selector

All GUIs are fully customizable via gui.yml (295 lines) — change materials, slots, sounds, layout.

✦━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━✦

5 Warp Access Modes

• FREE — Anyone can teleport. No restrictions
• PAID — Visitors pay the warp price. Owner receives money (minus tax)
• PRIVATE — Only owner and whitelisted players
• PASSWORD — Enter the correct password to teleport
• DOORBELL — Visitor requests access. Owner gets clickable [Accept]/[Reject] in chat

✦━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━✦

6 Warp Categories

• Farm — Farms, crops, mob grinders
• Shop — Player shops, markets
• ⚔️ PvP — Arenas, PvP zones
• Decoration — Builds, art, showcases
• ️ Community — Public areas, meeting points
• Other — Everything else

Players select category when creating. Category Filter GUI lets users browse by type.

✦━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━✦

⭐ Voting & Favorites

Voting: Players vote warps up or down. One vote per player per warp (can change). Top Warps GUI shows rankings with gold/silver/bronze medals.

Favorites: Save any warp as a favorite for quick access. Dedicated Favorites GUI.

Both are persistent in SQLite — survive server restarts.

✦━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━✦

Economy Integration

Requires Vault + economy plugin (EssentialsX, CMI, etc.)

When a visitor uses a PAID warp ($500), the tax is applied: owner receives $400, $100 is destroyed. Bypass with pwarp.nocost (creation) or pwarp.bypass (paid access).

✦━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━✦

Commands

Players
Everything else (create, edit, delete, vote, favorite) is done through the GUI.

Admin
Aliases: /pw for /pwarp, /pwa for /pwarpadmin

✦━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━✦

Permissions

Quick LuckPerms setup:
✦━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━✦

Per-Group Warp Limits

Priority: pwarp.nolimit > pwarp.limit.X > config groups > global default

Requires LuckPerms for group detection.

✦━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━✦

World Management

Manage in-game with /pwarpadmin worlds. World aliases show in GUIs instead of folder names.

✦━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━✦

Audit Log

All actions logged to SQLite: CREATE, DELETE, VISIT, VOTE_UP, VOTE_DOWN. Query with /pwarpadmin log or export to file.

✦━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━✦

Multilanguage

Ships with English and Spanish (413 keys each). Add any language:

1. Copy lang/en.yml to lang/<code>.yml
2. Translate the values
3. Set idioma: "<code>" in config or use /pwarpadmin config GUI
4. /pwarpadmin reload

✦━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━✦

Installation

1. Drop the JAR in plugins/
2. Start the server. Done.

Auto-generates: config.yml, gui.yml, lang/es.yml, lang/en.yml, warps.db, WIKI.md, ADMIN_GUIDE.md, USER_GUIDE.md

Built-in Documentation
A complete 577-line WIKI, admin guide, and user guide auto-extract to your plugin folder. Feed the WIKI to an AI assistant to configure the plugin in seconds.

Required: Vault + economy plugin. Optional: LuckPerms.
Tested: 1.13 through 1.21.11. Paper and Spigot.


✦━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━✦

What's New vs Original PWarp

• Storage — Original: JSON flat file. Fork: SQLite async (5 tables, 5 indexes)
• GUI screens — Original: 1 basic list. Fork: 12 specialized screens
• GUI customization — Original: none. Fork: gui.yml (295 lines)
• Warp modes — Original: public/private. Fork: 5 modes (free/paid/private/password/doorbell)
• Categories — Original: none. Fork: 6 categories with filter GUI
• Voting — Original: none. Fork: up/down with rankings
• Favorites — Original: none. Fork: persistent with GUI
• Doorbell — Original: none. Fork: request system with clickable accept/reject
• Economy — Original: basic price. Fork: creation cost + tax + price range
• Permissions — Original: basic. Fork: hierarchical with LuckPerms groups
• Audit log — Original: none. Fork: full logging with export
• World management — Original: basic blacklist. Fork: blacklist/whitelist + aliases
• Languages — Original: partial messages.yml. Fork: 413 keys ES/EN + custom
• Documentation — Original: none in JAR. Fork: WIKI + admin guide + user guide auto-extracted
• Code — Original: 18 files, 4,251 lines. Fork: 30 files, 6,863 lines

✦━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━✦



✦━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━✦

Credits

• Original plugin: TheKingSenne — PWarp v3.0.6
• Rewrite: VenecoLuis — Mundo Veneco
• AI-assisted development: Claude Code by Anthropic (Opus 4.6)
• License: MIT

✦━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━✦