Portal rendering fixes

Wormholes v3.1.2 · Minecraft 26.1.2 - 26.3 · Java 25
Paper · Purpur · Leaf · Folia · Canvas · Spigot

Changes & Fixes

• Arrival rendering
  • Nearby arrivals keep their server chunks and light data.
  • Client light patches follow replacement chunk caches.
  • Missing mesh sections no longer leave stale cache claims.
  • Iris settings are read only after block IDs are initialized.
• Sodium terrain handoff Terrain stays registered and visible after each portal crossing.
• Portal layers
  • Layers release their render buffers.
  • Stretched aperture masks keep partial edge cells.
• Block-entity capture
  • Turning capture off keeps Folia terrain snapshots.
  • Turning it back on refreshes block-entity contents.
• Optics 0.1.1 Biome visuals and mesh recovery fixed

Two-way End portals and native menus for client-mod players

Wormholes v3.1.1 · Minecraft 26.1.2 - 26.3 · Java 25
Paper · Purpur · Leaf · Folia · Canvas · Spigot

Changes & Fixes

• Two-way End portals, on by default and applies to existing portals on reload. Configuration option is two-way-end-portals under main
• Players running the Wormholes client mod get native menu screens instead of chest menus.
  • Vanilla clients default back to the chest GUI.
  • All actions done via the menu still respect the same permissions, ownership and cost rules.
  • Controlled by the native-screens settings under menus, on by default.
• Converted End portals send you through on contact, like vanilla.
• Floor End portals and the End exit fountain keep solid collisions underneath them.
• Arrivals at floor or ceiling destinations are moved clear of the blocks behind the opening.
• On Folia, vanilla End and Nether travel is blocked while Wormholes converts a portal frame.
• Ender dragons can no longer enter any Wormholes portal.
• After a portal is destroyed, the portals that linked to it stop projecting and stop sending travellers to it.
• Deleting one side of a same-world Link and return pair clears the surviving portal's state return link.
• The startup splash screen is updated for the current VolmLib API.

Optional Client Mod Updates (CurseForge / Modrinth)

• Added native menus with lists, toggles, sliders, text input, tooltips and paging, plus new pixel-art icons.
• A Wormholes section in F3 showing server version and platform, negotiated protocols, portal counts, travel state and mismatch warnings.
• Added 26.1.2 support for NeoForge, Forge and Fabric
• Fixed portal view stutter and freezes with Iris shaders.
• Fixed missing terrain after long teleports with the Iris shadow pass.
• Sodium 0.9.1 support and portal item rendering fixes on 26.1.2.

Portal and Projection Fixes

Wormholes v3.1.0 · Minecraft 26.1.2 - 26.3 · Java 25
Paper · Purpur · Leaf · Folia · Canvas · Spigot

Changes & Fixes

• Added update notifications that check for new GitHub releases upon login or manually with /volmit plugins updates
• Added the wormholes.update permission node and a configuration option to toggle this check
• Updated translations for the update notifications.
• Fixed portal projections losing block, lighting, biome, and block-entity updates when normal world packets overwrite them.
• Added live projection refreshes for edits made with supported patched FAWE 2.16.1 build.
• BileTools reloads now wait for active FAWE edits before unloading Wormholes.
• Fixed traveller scale settings failing to synchronize between linked portals.
• Improved player orientation through rotated portals and preserved entity scale in portal views.
• Fixed Nether portal frame checks after changes to portal direction or geometry.
• Expanded the API with projection controls and traversal refund notifications.

Optional Client Mod Updates (CurseForge / Modrinth)

• Added Minecraft 26.2 builds alongside existing 26.3 builds.
• Added portal gravity rotation with matching movement, jumping, flight, and camera orientation.
• Fixed gravity settings failing to synchronize between linked portals.
• Improved scaled crossings, camera height, and arrival collision checks.
• Improved nested portal views, mirrors, and shader history handling.
• Improved compatibility with the Iris shader mod, Sodium, and Distant Horizons on supported loader combinations.
• Destination terrain now prepares before crossings complete to reduce missing terrain on arrival.
• Improved traversal cost completion and refund reporting.

Portal Shapes, Scaling and Projection Improvements

Wormholes v3.0.0 · Minecraft 26.1.2 - 26.3 · Java 25
Paper · Purpur · Leaf · Folia · Canvas · Spigot

Changes & Fixes

• Added custom portal shapes with presets, rotation controls and saved settings.
• Portal outlines and crossing checks now follow the selected shape.
• Added traveller scaling, with configurable size and movement ratios, limits and automatic size restoration on return.
• Added administrator controls to reset traveller scaling.
• Improved arrival direction and movement through floor, ceiling and rotated portals.
• Fixed unintended crossings at portal edges and gaps in portal surface coverage.
• Portal views now refresh promptly when destination blocks or display settings change.
• Fixed large and small entities disappearing too early or lingering at portal-view edges.
• Improved rotated and mirrored block orientations, including rails, crafters, jigsaws and shelves.
• Corrected wall-mirror controls to offer only distinct orientations.
• Fixed reciprocal links breaking when reapplying the same destination.
• Fixed door collision checks to use the destination's arrival state.
• Fixed backup failures while portal or door data was being saved.
• Added clearer debug messages for failed or cancelled random teleports, including refund reasons.
• Improved compatibility with BileTools reloads.

Optional Client Mod

• Added smooth rendering for custom portal shapes and optional softened edges ins treamed views.
• Added correctly scaled destination views for portals using traveller scaling.
• Fixed projected and reflected entity copies pushing players, blocking movement or being targeted.
• Fixed stale entity copies remaining after switching worlds or reconnecting.
• Fixed Forge client disconnects when receiving ClientView messages.

Rendering & Stability Fixes

Wormholes v2.2.1 · Minecraft 26.1.2 - 26.3 · Java 25
Paper · Purpur · Leaf · Folia · Canvas · Spigot

Changes & Fixes

• Improved destination shader rendering, including shadows, skies and effects.
• Fixed projected and reflected entity animations updating more than once.
• Improved synchronization of entity swings, damage animations and appearance changes.
• Reduced memory allocations during portal rendering.
• Improved portal deletion, door cleanup and network shutdown reliability.

Client Rendering & Portal Performance

Wormholes v2.2.0 · Minecraft 26.1.2 - 26.3 · Java 25
Paper · Purpur · Leaf · Folia · Canvas · Spigot

Changes & Fixes

• Added optional client-mod rendering for portal terrain, entities, lighting, weather, and recursive views. Players without the mod will default back to the standard projections.
• Added shader rendering support for destination views.
• Reduced projection work and packet traffic through shared caching and prioritizing portals the player is looking at.
• Improved mirror stability, live block updates, and overlapping portal views.
• Fixed door and trapdoor arrival direction, momentum, and pocket previews.
• Improved Nether portal placement, End return views, and cross-server destination rendering.
• Corrected React performance metrics and startup cache settings.

Portal Projection Fixes and PacketEvents Hotfix

Wormholes v2.1.0 · Minecraft 26.1.2 - 26.3 · Java 25
Paper · Purpur · Leaf · Folia · Canvas · Spigot

Changes & Fixes

• Fixed portal projection blackouts.
• Changed portal surface skins to thin faces instead of full-block layers.
• Shaded PacketEvents into the plugin, removing its startup download requirement.

Minecraft 26.3 Support and Projection Fixes

Wormholes 2.0.7-26.1.2-26.3 · Minecraft 26.x+ · Java 25
Paper · Purpur · Leaf · Folia · Canvas · Spigot

Changes & Fixes

• Added Minecraft 26.3 support.
• Added ShapedPortals integration for custom Nether portal shapes, including linking, claim checks and frame validation.
• Extended recursive portal views to include entities through nested portals.
• Improved traversal positioning and re-entry detection for players and entities.
• Fixed projected player skins failing to refresh after profile changes.
• Updated projected swing animations and pocket-dimension data.
• Corrected portal flash colors and removed redundant projected hurt-animation packets.

Portal Networks, Expanded Travel Controls and Projection Fixes

Wormholes 2.0.6-26.1.2-26.2 · Minecraft 26.x+ · Java 25
Paper · Purpur · Leaf · Folia · Canvas · Spigot

Added

• Added named portal networks with short addresses and selectable destinations.
• Added /atlas for portal browsing, discovery, favorites, recent visits, directional guidance, and access to dialing menus.
• Added scheduled, weighted, per-player, and return-route destination selection.
• Added redstone controls for opening, closing, locking, and dialing portals, with comparator output.
• Added configurable traversal costs, cooldowns, warmups, and keys.
• Added role-based portal access and claim integrations for WorldGuard, GriefPrevention, Lands, Towny, and PlotSquared.
• Expanded pocket dimensions with templates, additional rooms, rosters, instance resets, and configurable rules.
• Added momentum and orientation controls, including speed scaling, speed limits, and vertical-exit handling.
• Added local portal traversal for projectiles and dropped items while preserving movement.
• Added convoy traversal for vehicles, passengers, and leashed mobs.
• Added trusted-server introductions and gateway destination selection based on availability, load, rotation, player affinity, or server latency.
• Added destination-coordinate and timed RTP rotation countdown placeholders.
• Added adaptive arrival masking based on destination chunks still loading.
• Added automatic portal backups and management tools for inspecting, locating, retargeting, and pruning portals.
• Added portal markers and local destination links for Dynmap, BlueMap, Pl3xMap, and squaremap.
• Added an optional authenticated HTTP endpoint for OpenMetrics and JSON status reports.
• Added a public API for portal/network queries, portal changes, custom destination selection, and lifecycle/traversal events.

Changes & Fixes

• Improved projection performance while moving and when multiple players view the same portal.
• Fixed block rotation, mirrored projections, painting placement, and recursive portal cycle detection.
• Fixed projected entities ignoring visibility restrictions, including interactions with Gloss displays and item effects.
• Fixed passenger and leash relationships during same-server traversal.
• Fixed repeated traversal charges and improved cross-server admission handling.
• Fixed client crashes caused by sending incompatible destination chunk data before changing dimensions.
• Reworked blackout rendering to maintain portal boundaries while destination chunks load.
• Removed managed vanilla Nether/End portals from Atlas discovery and destination lists.
• Fixed replacement vanilla portals briefly opening and closing before their destination pairing completes.
• Removed ambient, synchronization, and approach sounds. Threshold and arrival effects remain.
• Fixed protection checks accidentally triggering portal tools, skins, dialing, or Dimensional Doors, and restored wand selection handling.
• Fixed Iris biome and terrain integration.
• Fixed RTP cleanup when a player disconnects or an entity disappears, avoiding repeated scheduling attempts and false failure warnings.
• Expanded automatic reloads to language files, bStats settings, and Paper chunk-loading/sending tuning. Removed the manual reload command.
• Improved editable TOML translations, English fallback, diagnostic report presentation, and debug-toggle confirmations.
• Added /wormholes debug version and standardized diagnostic commands under /wormholes debug.

Cross-Server Travel & Network Routing Overhaul

Wormholes 2.0.5-26.1.2-26.2 · Minecraft 26.x+ · Java 25
Paper · Purpur · Leaf · Folia · Canvas · Spigot

Warning

Before you update
You will need to recreate your portal codes after upgrading the Jars on all servers if you have any cross-server portals currently created.

1. Run /wh server export on each server
2. Import each fresh code on the opposite server using /wh server import <code>
3. Validate the connection using /wh server list

Changes & Fixes

• Added IPv4/IPv6 CIDR routing with separate public and private Minecraft endpoints for LAN, VPN, and NAT configurations.
• Added proxy-server selection for automatic transfer mode.
• Added direct-transfer checks for client protocol support, authentication, and player identity.
• Added signed destination-endpoint verification before departure.
• Improved handoff admission and destination terrain readiness before acknowledging departure.
• Required destination arrival confirmation before reporting transfer success.
• Improved transfer deadlines, retries, locking, and cleanup to prevent false success, duplicate arrivals, and stale callbacks.
• Fixed stale projections after linking or unlinking portals and stale block, entity, equipment, and map snapshots.
• Fixed blackout panel seams, culling, and reused-display cleanup while reducing rendering work.
• Fixed persistence after deleting all portals and preserved world state when world unloads are cancelled.
• Improved TOML parsing, typed arrays, validation, escaping, and distribution packaging.