BetterPortals | Enterprise-Grade Portal Rendering & Teleportation Engine
The Future of Immersive Server Infrastructure
Traditional portals are a relic of early Java game development. They force players into ugly, immersion-breaking loading screens, blind transitions, and block the main server thread during cross-world teleports, causing massive tick spikes.BetterPortals changes everything. Engineered as a high-performance, server-side rendering engine, it allows your playerbase to see straight through Nether and custom portals to view blocks and entities on the target destination in real-time. By utilizing advanced packet manipulation and matrix rotation transformations entirely server-side, it delivers a flawless mod-like experience with zero client-side modifications required.
Platform Compatibility & Environment Stack
| Platform / Software | Supported Versions | Operational Status |
| PaperMC / PurpurMC | 1.21 up to 26.1.2+ | Fully Compatible |
| Folia | 26.1.2+ | Production Ready |
| Velocity Proxy | 3.3.0+ | Fully Compatible |
| BungeeCord / Waterfall | Latest | Fully Compatible |
| Java Runtime | Java 21+ | Required |
Core High-Performance Features
Real-Time Seamless Projection
Don't just teleport—experience the destination beforehand. The engine dynamically visualizes block changes, chunks, and terrain states across portal boundaries using highly optimized ProtocolLib wrappers. Everything is calculated and rendered on-the-fly, giving players an absolute sense of world scale.
Live Entity Mirroring
The environment is truly alive. BetterPortals automatically spawns, updates, and translates destination entities across the portal window, including accurate relative camera yaw and pitch rotations. Projectiles, mobs, and items pass through seamlessly, preserving natural physical momentum.
TPS-Aware Performance Shield (Adaptive Guard)
Main thread preservation is treated as a priority. BetterPortals constantly monitors server performance. If the server TPS drops below a configurable threshold (e.g., 19.0), the engine automatically triggers dynamic load shedding, temporarily pausing visual rendering to guarantee your Main Tick Loop stays completely lag-free.
Secure Multi-Proxy Network Grid
Link your worlds across an entire server network effortlessly. Using an asynchronous TCP socket protocol wrapped in secure AES-GCM-128 encryption, the plugin coordinates lightning-fast cross-server teleports across Velocity or BungeeCord proxies with zero noticeable transition delay.
Elite Technical Architecture & UX
Interactive Portal Admin GUI
Forget about memorizing complex command arguments. The built-in, fully interactive in-game panel (/bp gui) provides a premium inventory-based control center. Admins can manage registered portals, toggle entity transport paths, adjust entry fees, and apply audio-visual presets with simple click actions.
Vault Monetization Integration
Turn your portal network into an active server economy drain. You can dynamically enforce custom entry fees for any portal. Stepping through charges the player automatically via Vault, providing a great utility tool for RPG, Survival, or Hub networks.
Per-Player Dynamic Localization
BetterPortals adapts to your global playerbase out-of-the-box. The framework automatically intercepts each player's native Minecraft client language settings, rendering all menus, action bars, and system feedback in their preferred language instantly.
Hardened Performance Tuning Matrix
| Key Configuration Parameter | Default Value | Optimization Impact |
| minTpsForRendering | 19.0 | Autonomously disables rendering under heavy load to safeguard TPS. |
| maxPortalsPerPlayer | 3 | Caps concurrent rendering windows per user to save client-side FPS. |
| allowedSpawnTimePerTick | 35ms | Restricts destination lookup processing to prevent main thread freezes. |
| entityCheckInterval | 7 ticks | Throttles entity tracking loops to minimize CPU overhead. |
Technical Commands & Permissions
Player & Management Actions
- /bp wand — Gives the player a selection wand for mapping portal corners. (betterportals.wand)
- /bp menu (Aliases: gui, list) — Opens the interactive portal administration dashboard. (betterportals.select)
- /bp link — Digitally pairs the selected origin and destination coordinates together. (betterportals.link)
- /bp remove — Deletes the nearest custom portal configuration within a 20-block radius. (betterportals.remove)
Configuration & Infrastructure Controls
- /bp reload — Hot-reloads configuration layouts, language assets, and soft-restarts the plugin context. (betterportals.reload)
- /bp setprice <price> — Dynamically assigns a Vault entrance fee to the closest portal. (betterportals.setname)
- /bp setpreset <preset> — Applies a specific visual particle and sound theme from config.yml. (betterportals.setname)
3-Step Quick Start: How to Link Custom Portals
Setting up a seamless portal takes less than 60 seconds. You don't need to mess with config files; everything is done live in-game:- Step 1: Select the Portals
Run /bp wand to get your selection tool. Left-click and right-click to select the corners of your Origin portal frame, then run /bp origin to lock it in. Move to your destination, select the corners of your Destination portal frame, and run /bp destination. - Step 2: Link Them Instantly
Run /bp link [twoWay] [invert] to bridge the two selections together.- Tip: Set twoWay to true to make it a bidirectional path, and invert to true if you are linking horizontal (floor/ceiling) portals to rotate the player's momentum perfectly.
- Step 3: Cross-Server Multi-Proxy Link (Optional)
If your destination portal is located on a completely different backend server across your network, simply use /bp linkexternal [invert] instead. The encrypted TCP socket engine will immediately register the cross-server handshake.
Enhanced Package Customization & Support
Upgrade your infrastructure with our comprehensive 1-year developer backing. The Enhanced package includes standard support plus full tactical integration for large-scale networks and custom server infrastructures:- 10 Hours of Dedicated Engineering: Use these hours for custom feature requests, API expansions, or deep integrations with your existing server core.
- Feature & Cosmetic Customization: We will tweak, optimize, and modify the plugin codebase or visuals to fit your unique setup and implement absolutely all your custom feature wishes.
- Full Installation & Setup: Our team will manually deploy, configure, and stress-test the software directly on your backend servers or proxy network to guarantee a flawless launch.
- 1-Year Premium Priority Support: Bypass the standard ticket queue with direct access to lead developers for immediate troubleshooting and emergency hotfixes.
Clean Engineering — No Strings Attached
- No DRM / No License Verification — BetterPortals operates completely isolated. It will never ping third-party verification servers, check external tokens, or call home. Your proxy grid remains 100% autonomous and secure, even in completely air-gapped networks.
- No Code Obfuscation — The production artifact contains clean, readable bytecode. Your systems administration team can freely audit the JAR file to guarantee network compliance and security standards.
- No Artificial Limits — Zero player allocation ceilings, zero instance software blocks. Deploy it freely across your internal developer instances, staging setups, and production networks under a single purchase.
CRITICAL DEPENDENCY REQUIREMENT
BetterPortals relies heavily on advanced packet manipulation and cannot run without its core dependency. You must download and install ProtocolLib v5.4.0 on your backend Paper/Folia servers for this plugin to function.- Download Link: ProtocolLib v5.4.0 (Direct GitHub Release)
PRODUCTION-READY TEST RELEASE DISCLAIMER & SLA
Please note that the builds distributed here are designated as Production-Ready Test Releases of our core server software suite. Because of this dynamic testing phase, the product is currently being offered at an extremely steep discount compared to its standard final corporate pricing.- Rock-Solid Stability — Despite the test release label, the codebase is fully optimized, hardened against real-world production stress, and completely safe for immediate high-traffic deployment.
- Ultra-Fast Support (SLA) — If you encounter any edge-case bug, proxy sync anomaly, or configuration conflict, it will be prioritized and fixed incredibly fast upon your first report in our support channels.
BetterPortals is a premium, heavily optimized fork maintained independently by Envel Labs Development. This product is compiled and sold in strict compliance with the original software's open-source license, which explicitly grants full legal rights for modification, private use, and commercial redistribution. Purchasing this resource supports our independent development efforts in modernizing, stabilizing, and optimizing the codebase for high-traffic networks.
Source code is provided upon request, at no additional cost.
