**Requires [Vystorm Core](https://hangar.papermc.io/Vystorm/Vystorm-Core) (free)** – the shared base of all Vystorm plugins (English/German language files, in-game config editor, update check). Just drop one extra jar into `plugins/`, no setup. ![VystormPortals banner](https://cdn.modrinth.com/data/Fdo8wdxs/images/e3486ba80b7df427ac935c96eecf2c3158084754.jpeg) **Look through a portal and see where it leads.** VystormPortals shows each player the blocks behind a portal as a private, client-only view of the destination. It works with your own linked portals and automatically with normal Nether and End portals, with no create or link commands needed for those. ![See before you step](https://cdn.modrinth.com/data/Fdo8wdxs/images/9a5e4e2d70a64a80c6de8c2b0d47ae01cfb26323.jpeg) ## Portal views - **See the other side.** A perspective block view of the destination, up to 16 blocks deep, framed by a client-only black rim. Only the viewer sees it; no world blocks are changed. - **Destination biome colours.** Grass, foliage and water in the view use the destination's biome colours, and the view composes with Winter Is Coming's snowy view. - **Smooth, bounded updates.** Views refresh every server tick with at most 512 block changes per viewer; the aperture and newly visible sides get priority. Closing a view restores it immediately. ![Step through, travel instantly](https://cdn.modrinth.com/data/Fdo8wdxs/images/79a1b276ba54684571515e1b55b2a1c8cb1f94bc.jpeg) ## Your own linked portals - **Create and link.** `/vportal create` places a portal (2 to 8 blocks wide and high) at your position; `/vportal link` connects two of your portals in both directions. `/vportal unlink` separates them again without deleting either. - **Instant travel.** Walk through and you arrive at the linked portal right away, keeping your momentum and rotated like the portal. Set `instant-travel: false` to use per-portal warmups instead. - **Things travel too.** Dropped items, XP orbs, primed TNT, falling blocks, arrows, snowballs, tridents, ender pearls, mobs and empty minecarts and boats that pass through a public portal (both ends public) come out of the linked one with their momentum. Throw loot through, shoot through, let mobs follow you. Each group can be switched off; at most 16 entities travel per tick. The ender dragon, the wither and entities with riders never travel. - **Access and info.** Public or private per portal, owners edit their own portals, `/vportal info` shows world, position, size, access, warmup, target and owner. ![Automatic Nether and End portals](https://cdn.modrinth.com/data/Fdo8wdxs/images/ecdaf8d3ee2e07a834d4445bd551382d4e995dff.jpeg) ## Automatic Nether and End portals - **Nether portals.** Light a normal obsidian portal and, once its counterpart is prepared, it shows the other side. The purple portal block is hidden only for the viewer; real blocks and vanilla teleportation stay in place. Existing portals are recognized when you approach them. - **Counterpart preparation.** The counterpart portal is prepared early through Paper's native portal search and placement, respecting Paper's search radius, dimension scaling, world border and the cancellable `PortalCreateEvent`. With instant travel on, Nether portals also skip the vanilla wait time. - **End portals.** Existing End portal surfaces show the vanilla End arrival area, or your personal return area on the way back. End credits, return teleport and the dragon fountain stay vanilla. ### Honest limits - This is a server-side block projection, not a full client renderer like a portal mod. Entities, destination lighting, dimension sky and tile-entity contents (chest contents, for example) are not shown in the view. - Vanilla biomes use four-block cells and client biome blending, so tint at the aperture is not pixel-perfect. - Preparing a counterpart can generate chunks and a counterpart portal as soon as a portal is lit. - End gateways and Folia are not supported. ## Commands & permissions All commands are run in game. | Command | What it does | |---|---| | `/vportal list` | Portals you may access (default action) | | `/vportal create [width height]` | Create a portal at your position and facing (2–8, default 3 × 3) | | `/vportal info ` | World, position, size, access, warmup, target and owner | | `/vportal link ` | Link two of your portals in both directions | | `/vportal unlink ` | Disconnect a portal from its partner | | `/vportal delete ` | Delete your portal and references to it | | `/vportal access ` | Change who may use the portal | | `/vportal warmup ` | 0–200 tick warmup when instant travel is off | | Permission | Default | For | |---|---|---| | `vystormportals.use` | everyone | Using portals (also public ones), views and `/vportal info` | | `vystormportals.nether-view` | everyone | Nether portal views | | `vystormportals.end-view` | everyone | End portal views | | `vystormportals.create` | OP | Creating portals | | `vystormportals.admin` | OP | Editing all portals | ## Configuration Changes are read on server restart. ```yaml instant-travel: true nether-portals: enabled: true prepare-counterpart: true end-portals: enabled: true return-view: true generate-destination-chunks: true # false = only load already generated chunks prepare-arrival-platform: true entity-travel: enabled: true objects: true projectiles: true mobs: true vehicles: true max-per-tick: 16 ``` Portals are saved in `portals.yml` (up to 256). Messages are in `lang/en.yml` and `lang/de.yml`, per player language. ## Requirements - Paper or Purpur 1.21.8 to 26.2, Java 25 - [Vystorm Core](https://hangar.papermc.io/Vystorm/Vystorm-Core) (free), 0.36.0 or newer ## More from Vystorm Vystorm Core, Vystorm Rails, CustomTrees, XPVaultEconomy, BlockIntegrations, Vystorm Veins, Winter Is Coming, Vystorm Insomnia, Vystorm Gallery, Vystorm Paddock, Vystorm Snapshot, Vystorm Boards and Vystorm Estates, all free. Free and open source (MIT). The idea is inspired by BetterPortals; the code is a new implementation.

VystormPortals

1.5.0