# Dimensions

## Docs

- [ForceLink Addon: Permanently Pair Two Dimensions Portals](https://dimensions.luminescent.dev/addons/free/forcelink.md): Permanently link any two Dimensions portals so they always teleport to each other, bypassing the automatic nearest-portal search algorithm.
- [Horizontal Portals Addon: Flat and Ceiling Portals](https://dimensions.luminescent.dev/addons/free/horizontal-portals.md): Build Dimensions portals flat on the ground or ceiling. Configure each portal type as vertical-only, horizontal-only, or both orientations at once.
- [Free Addons for Dimensions: Extend Your Custom Portals](https://dimensions.luminescent.dev/addons/free/overview.md): Extend your Dimensions portals with free, modular addons. Grab the DimensionsFreeAddons pack from SpigotMC and drop the jars into your Addons folder.
- [Patreon Cosmetics Addon: Portal Effects for Supporters](https://dimensions.luminescent.dev/addons/free/patreon-cosmetics.md): Give Patreon supporters exclusive particle effects on portal interactions. Plug and play for players, with optional config for server owners.
- [WorldGuard Flags Addon: Restrict Portals in Regions](https://dimensions.luminescent.dev/addons/free/world-guard-flags.md): Add three WorldGuard region flags to control portal ignition, destruction, and use inside any protected region on your Dimensions server.
- [Better Portals Addon: See-Through Portal Windows](https://dimensions.luminescent.dev/addons/premium/better-portals.md): Integrate with the BetterPortals plugin to render a live view of the portal destination through the portal frame, giving players a window into the other world.
- [Biomes Addon: Control Portal Access by Player Biome](https://dimensions.luminescent.dev/addons/premium/biomes.md): Allow or deny Dimensions portal usage based on the biome the player is standing in, with a configurable deny message for blocked biomes.
- [BungeeCord Addon: Cross-Server Dimensions Portals](https://dimensions.luminescent.dev/addons/premium/bungee.md): Extend Dimensions portals across a BungeeCord or Velocity proxy network so players travel between servers by walking through a portal, just like changing worlds.
- [Charge on Use Addon: Economy-Gated Portal Teleportation](https://dimensions.luminescent.dev/addons/premium/charge-on-use.md): Withdraw money from a player's balance each time they use a Dimensions portal, with support for return-trip exemptions and one-time payment options.
- [Commands on Use Addon: Run Commands at Portal Use Time](https://dimensions.luminescent.dev/addons/premium/commands-on-use.md): Execute player or console commands with full conditional logic and placeholder support every time a player uses a Dimensions portal.
- [Custom Lighter Addon: Use Custom Items as Portal Lighters](https://dimensions.luminescent.dev/addons/premium/custom-lighter.md): Use items from Oraxen, ItemsAdder, or CustomItems as the portal lighter, frame block, or inside block — integrating custom item plugins into Dimensions portals.
- [Daylight Sensor Addon: Time-Based Portal Access](https://dimensions.luminescent.dev/addons/premium/daylight-sensor.md): Restrict portal usage to specific in-game time windows so that portals only activate during the day, only at night, or any custom range you define.
- [Hub World Addon: Central Hub Portal Management](https://dimensions.luminescent.dev/addons/premium/hubworld.md): Designate a hub world so portals from any location send players to a central hub, and using a portal in the hub returns them to where they came from.
- [LightAPI Addon: Portals That Emit Block Light](https://dimensions.luminescent.dev/addons/premium/lightapi.md): Make your portals glow by emitting configurable block light into the surrounding area, powered by the LightAPI plugin for dynamic in-world lighting.
- [Limited Uses Addon: Auto-Destruct Portals After N Uses](https://dimensions.luminescent.dev/addons/premium/limited-uses.md): Configure a Dimensions portal to automatically close or destroy itself after it has been used a set number of times across all players.
- [Message on Use Addon: Notify Players Using a Portal](https://dimensions.luminescent.dev/addons/premium/message-on-use.md): Send a fully customizable chat message to any player the moment they step through a Dimensions portal, with support for color codes.
- [Premium Addons Overview for Dimensions Custom Portals](https://dimensions.luminescent.dev/addons/premium/overview.md): Explore the full suite of premium addons bundled with Dimensions Full — each one extends your portals with powerful new behaviors and controls.
- [Particles Addon: Custom Portal Particle Effects](https://dimensions.luminescent.dev/addons/premium/particles.md): Build scripted particle packs that emit custom effects from your portals, using a YAML-based scripting system with math support and a visual web editor.
- [Pasted Portals Addon: Auto-Ignite Placed Portals](https://dimensions.luminescent.dev/addons/premium/pasted-portals.md): Automatically ignite Dimensions portals when they are pasted via WorldEdit or generated by skyblock plugins, using an in-portal sign to identify them.
- [Permissions Addon: Restrict Portal Access by Permission](https://dimensions.luminescent.dev/addons/premium/permissions.md): Require players to hold a specific permission node before they can ignite or travel through a Dimensions portal, with a configurable deny message.
- [Random Location Addon: Teleport to Random Destinations](https://dimensions.luminescent.dev/addons/premium/random-location.md): Scatter players to a random location within a configurable range when they use a Dimensions portal, bypassing any fixed destination.
- [Stylish Portals Addon: Custom Portal Frame Shapes](https://dimensions.luminescent.dev/addons/premium/stylish-portals.md): Define custom block patterns for each side of your portal frame so portals can be built from any combination of blocks, slabs, and stairs.
- [Timed Portals Addon: Schedule Portal Availability Window](https://dimensions.luminescent.dev/addons/premium/timed-portals.md): Automatically destroy a Dimensions portal after a configured number of milliseconds, with optional particle effects leading up to destruction.
- [Unbreakable Addon: Protect Your Dimensions Portals](https://dimensions.luminescent.dev/addons/premium/unbreakable.md): Prevent players, entities, pistons, and other destruction sources from breaking your Dimensions portals using the Unbreakable addon.
- [Creating a Dimensions Addon: Step-by-Step Guide](https://dimensions.luminescent.dev/api/creating-an-addon.md): Set up a Java project, write your DimensionsAddon main class, register it with ServiceLoader, and deploy your addon to a Dimensions server.
- [Dimensions Addon Example: Portal Ignite Particles](https://dimensions.luminescent.dev/api/example-addon.md): A complete walkthrough of a working Dimensions addon that spawns explosion particles when a permissioned player ignites a custom portal.
- [Dimensions Developer API: Build Custom Addons](https://dimensions.luminescent.dev/api/overview.md): Use the Dimensions API to build addons that extend and customize portal behavior beyond what the base plugin provides.
- [CompletePortal API Reference for Dimensions Addons](https://dimensions.luminescent.dev/api/reference/complete-portal.md): Reference for CompletePortal — the class representing a physical portal built in the world, with methods for creation, tags, and active state.
- [CustomPortal API Reference for Dimensions Addons](https://dimensions.luminescent.dev/api/reference/custom-portal.md): Reference for the CustomPortal class — the registered portal type definition loaded from YAML config files in the Dimensions Portals directory.
- [Dimensions Events API Reference for Addon Developers](https://dimensions.luminescent.dev/api/reference/events.md): Reference for the three cancellable Dimensions events: CustomPortalUseEvent, CustomPortalIgniteEvent, and CustomPortalBreakEvent.
- [PortalGeometry API: Custom Portal Shapes](https://dimensions.luminescent.dev/api/reference/portal-geometry.md): Learn how to extend PortalGeometry to implement non-rectangular portals, unusual orientations, and custom build and detection logic for Dimensions.
- [Dimensions Plugin Commands and Permissions](https://dimensions.luminescent.dev/configuration/commands.md): A complete reference for every /dim command, what each one does, and how to view the permission node required to run it on your server.
- [Dimensions Plugin Configuration Reference](https://dimensions.luminescent.dev/configuration/plugin-config.md): Configure the core Dimensions plugin settings in config.yml to control portal search behaviour, teleportation, debugging verbosity, and more.
- [Portal Configuration Options for Dimensions](https://dimensions.luminescent.dev/configuration/portal-config.md): Learn every configuration option available in each portal's .yml file, from frame materials and particle colours to teleport delay and world restrictions.
- [Configure World Settings for Dimensions Portals](https://dimensions.luminescent.dev/configuration/worlds.md): Set per-world Y-level boundaries and size ratios in config.yml, and learn how to add pre-existing or freshly generated worlds to your Dimensions setup.
- [Create Your First Custom Portal in Dimensions](https://dimensions.luminescent.dev/creating-a-portal.md): Use the Portal Creator web tool to configure your portal, download the config file, place it on your server, and build your first portal in-game.
- [Install Dimensions on Your Minecraft Server](https://dimensions.luminescent.dev/installation.md): Download the Dimensions jar, drop it into your server's plugins folder, and restart to have custom portals up and running in minutes.
- [Dimensions: Custom Portals for Minecraft Servers](https://dimensions.luminescent.dev/introduction.md): Dimensions lets you create nether-styled custom portals from any block material to teleport players between worlds or across servers.
- [Download and Deploy Your Portal Config File to the Server](https://dimensions.luminescent.dev/portal-creator/downloading.md): Assign a portal ID, download the generated .yml config file, place it in the Portals folder, and restart your server to activate the portal in-game.
- [Editing Your Portal in the Portal Creator: Full Guide](https://dimensions.luminescent.dev/portal-creator/editing.md): Click the interactive circles on the portal preview to configure the frame block, inside block, lighter material, and particle effects for your portal.
- [Portal Creator Extra Options: Left-Side Panel Settings](https://dimensions.luminescent.dev/portal-creator/extra-options.md): Use the Portal Creator's left-side panel to configure additional portal behavior settings and addon-specific options before downloading your config.
- [Dimensions Portal Creator: Visual Portal Design Tool](https://dimensions.luminescent.dev/portal-creator/overview.md): Portal Creator is a free browser tool at astaspasta.alwaysdata.net for visually designing Dimensions portals without touching any YAML files.