# Overview Barrier is a premium world border plugin that breaks the limits of the vanilla world border. It allows server owners to create custom world borders on any axis, at any height, and even as a perfect circle. --- > [!important] Resource Pack Setup (Required) > Barrier renders its borders through a **custom resource pack** that must be set up correctly, or the borders will not render. Follow these steps when deploying: > > - **Layer it above all other packs.** Barrier's pack must be applied **last / highest priority**. If it is not on top, it will not work. > - **Serve it as a separate pack.** Deliver Barrier's pack on its own — stacked on top via a multi-pack setup (stacked server packs, a pack host that serves multiple packs, etc.). Do not bundle it into your main pack. > - **Do not merge it into another pack.** No Nexo, ItemsAdder, or other pack-combining/merging tools — Barrier's custom shaders and models break when merged. > [!danger] License & Usage Notice > The Barrier resource pack and all of its assets are part of a **premium product**. By purchasing Barrier, you are licensed **only** to use these assets to serve players within your own community. You **may not**: > > - **Redistribute** the resource pack or any of its assets, in any form. > - **Merge** the existing pack into your own master pack. > - **Decompile** or reverse-engineer the pack. > - **Claim the assets as your own**, or use them in your own products. --- ## What is Barrier? Barrier replaces the vanilla `/worldborder` command with a fully featured alternative powered by PacketEvents. Unlike the default world border, Barrier supports three distinct border shapes — circles, squares, and boxed squares — and provides granular control over every dimension of the border including width, length, height, and Y-axis position. Borders can be resized, moved, and recolored with smooth transitions over configurable durations. --- ## Features - **Three border shapes** — Circle, Square, and Square Boxed (full 3D box with height) - **Per-axis control** — set width, length, and height independently - **Height support** — borders extend vertically, not just on the XZ plane - **Circle borders** — perfect circular world borders with radius control - **Smooth transitions** — resize and move borders over time with duration support (e.g., `1h30m`, `60`) - **Custom colors** — dye any border shape with hex codes, including dyeable **circle** borders (with the latest resource pack) - **Storm damage** — configurable damage amount, tick rate, knockback, totem support, and absorption heart handling - **Colorful phases** — optional distinct border colors for moving, shrinking, or both - **Per-world borders** — each world gets its own independent storm instance - **Per-player borders** — switch a world to per-player mode so every player has their own independent border, seeded from the world's border - **QoL commands** — move the border to your location, teleport to center, stop/pause movement, and view status - **Resource pack** — separately-served resource pack powering the border visuals (see the notice above) --- ## Premium Plugin Barrier is a premium plugin distributed by Lodestone. A valid license key is required to run the plugin. 1. Purchase Barrier at [https://lode.gg/plugin/barrier](https://lode.gg/plugin/barrier) 2. Configure your license key at [https://lode.gg/plugin/barrier/configure](https://lode.gg/plugin/barrier/configure) 3. The plugin validates your server on startup. If the license is invalid, Barrier disables itself and logs an error. --- ## Dependencies | Dependency | Version | Type | |---|---|---| | Paper API | 1.21.4+ | Server platform | | Java | 21 | Runtime | | PacketEvents | 2.11.1 | Embedded | PacketEvents is shaded into the plugin JAR and listed as a `softdepend` in `plugin.yml`. Bookshelf-API and Bookshelf-CommandAPI are shaded into the final JAR during the build process, so server owners do not need to install them separately. All-in-all, you **do not** need to install any additional plugins. --- ## Related Pages - [[Barrier/Server Owners/Configuration]] — full config.yml breakdown - [[Barrier/Server Owners/Commands]] — complete command reference - [[Barrier/Developers/API Reference]] — developer API for hooking into Barrier