# CustomBorder<\/p>\n
**Custom square world borders \u2014 fully independent of the vanilla Minecraft border.**<\/p>\n
Define named, persistent borders anywhere in your world. Players are kept inside with particles, pushback, and instant enforcement. Admins get fine-grained control over bypass, visibility, and settings \u2014 all at runtime, no restart needed.<\/p>\n
—<\/p>\n
## \u2728 Features<\/p>\n
– **Square borders** \u2014 defined by a center point and a radius (half side-length in blocks)
\n– **Full build-height wall** \u2014 the border spans 10,000 blocks vertically, covering the entire playable range
\n– **Red particle wall** \u2014 appears as players approach; each player can set their own visibility distance
\n– **Pushback mechanic** \u2014 players are pushed back toward the center when too close to the wall; can be toggled and tuned at runtime
\n– **Instant movement enforcement** \u2014 movement events are intercepted in real-time, preventing any crossing without rubberbanding
\n– **Teleport-back safety net** \u2014 if a player ends up outside anyway, they are immediately moved back in
\n– **Admin bypass** \u2014 admins can toggle border enforcement for themselves with `\/borderop`
\n– **Admin `\/tp` support** \u2014 command-sourced teleports always cross borders freely, so admins can move players to either side
\n– **Per-player particle toggle** \u2014 admins (even with bypass active) can hide the particle wall for themselves
\n– **Multiple borders** \u2014 define as many named borders as needed across any world
\n– **Persistent storage** \u2014 all borders are saved to `borders.yml` and survive server restarts
\n– **Fully independent** \u2014 does not touch or interact with the vanilla world border in any way
\n– **Tab completion** \u2014 all commands support full tab completion including border names and argument suggestions<\/p>\n
—<\/p>\n
## \ud83d\uddc2\ufe0f Commands<\/p>\n
### Player Commands
\n*(Default: OP only \u2014 configurable via permissions)*<\/p>\n
| Command | Description | ### Admin Commands | Command | Description | > **Note:** `\/tp` (and any command-sourced teleport) always crosses borders freely, allowing admins to move players to either side without needing bypass.<\/p>\n —<\/p>\n ## \ud83d\udd10 Permissions<\/p>\n | Permission | Description | Default | —<\/p>\n ## \u2699\ufe0f Configuration<\/p>\n All settings in `plugins\/CustomBorder\/config.yml`:<\/p>\n “`yaml # Whether the pushback mechanic is active. Toggleable at runtime with \/border pushback on|off. # Distance (in blocks) from the wall at which players start getting pushed back. # Velocity strength of the pushback toward the border center. # How often (in ticks) the proximity check runs. 20 ticks = 1 second. # Number of particle points rendered per visible wall per check. # Height of the border wall in blocks. 10000 covers the full build range. All pushback settings can be changed **at runtime** via commands \u2014 no need to edit the file or restart the server. Changes are saved immediately.<\/p>\n —<\/p>\n ## \ud83d\udcd6 How It Works<\/p>\n 1. Stand at the center of where you want the border, then run `\/border create 2. Players who approach within their visibility distance see a **red particle wall** along the border edge.<\/p>\n 3. Within `pushback-distance` blocks of the wall, players are continuously **pushed back** toward the center.<\/p>\n 4. If a player somehow ends up outside (e.g. via a plugin teleport), they are **immediately teleported back** to the nearest safe location inside.<\/p>\n 5. **Admins** can use `\/borderop on` to bypass all enforcement for themselves. When done, `\/borderop off` re-enables it.<\/p>\n 6. **Admins** can freely teleport players across borders using the standard `\/tp` command.<\/p>\n 7. **Every player** can customize how far away they see the particle wall with `\/border view —<\/p>\n ## \ud83d\udcbe Data & Persistence<\/p>\n Borders are stored in `plugins\/CustomBorder\/borders.yml` and loaded automatically on startup. The number of loaded borders is logged on enable:<\/p>\n “` Per-player settings (visibility distance, particles hidden, bypass) are **session-only** and reset on restart \u2014 this is intentional, as they are considered temporary preferences.<\/p>\n —<\/p>\n ## \ud83d\udd27 Requirements<\/p>\n – **Server:** Paper 1.21.1 or compatible fork —<\/p>\n ## \ud83d\udc1b Issues & Source<\/p>\n Found a bug or want to contribute? Open an issue or pull request on the [GitHub repository](#).<\/p>\n","protected":false},"excerpt":{"rendered":" Makes setting custom borders in minecraft possible with a simple command! Perfect for PvP events and other events on SMPs .<\/p>\n","protected":false},"featured_media":52649,"template":"","meta":{"_minecraft_slug":"custom-borders","_minecraft_project_id":"TATsrZov","_minecraft_author":"MiCodeStudios","_minecraft_license":"MIT","_minecraft_downloads":9,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"custom-borders.zip","_minecraft_size_bytes":52428,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-15T23:12:22.085365Z","_minecraft_date_created":"2026-05-12T23:32:14.826104Z","_minecraft_date_modified":"2026-05-09T22:01:54.039208Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/custom-borders","_minecraft_icon_attachment_id":52649,"_minecraft_imported_at":"2026-06-02T21:44:25+00:00","_minecraft_import_hash":"178f6e5e52e2a98c0c58d2d1f566aa87","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[89,126,866,127],"mod_loader":[132],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-52648","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-game-mechanics","mod_category-management","mod_category-minigame","mod_category-paper","mod_loader-paper","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n|—|—|
\n| `\/border help` | Shows all commands with explanations and your current settings |
\n| `\/border list` | Lists all active borders with name, world, center, and radius |
\n| `\/border info
\n| `\/border view` | Shows your current and the server-default visibility distance |
\n| `\/border view
\n| `\/border view reset` | Resets your visibility distance to the server default |<\/p>\n
\n*(Requires `customborder.admin`)*<\/p>\n
\n|—|—|
\n| `\/border create
\n| `\/border remove
\n| `\/border pushback` | Shows current pushback status (enabled, distance, strength) |
\n| `\/border pushback on` | Enables the pushback mechanic globally |
\n| `\/border pushback off` | Disables the pushback mechanic globally |
\n| `\/border pushback distance
\n| `\/border pushback strength
\n| `\/border particles on` | Shows the particle wall for yourself again |
\n| `\/border particles off` | Hides the particle wall for yourself (bypass-independent) |
\n| `\/borderop on` | Enables border bypass \u2014 you can freely cross all borders |
\n| `\/borderop off` | Disables border bypass \u2014 borders are enforced for you again |<\/p>\n
\n|—|—|—|
\n| `customborder.use` | Use basic commands: `help`, `list`, `info`, `view` | `op` |
\n| `customborder.admin` | Full control: create\/remove borders, pushback settings, particles, bypass | `op` |<\/p>\n
\n# Distance (in blocks) at which red particles become visible (server-wide default).
\n# Each player can override this individually with \/border view.
\nparticle-visibility-distance: 10.0<\/p>\n
\npushback-enabled: true<\/p>\n
\npushback-distance: 3.0<\/p>\n
\npushback-strength: 1.2<\/p>\n
\ncheck-interval: 5<\/p>\n
\nparticle-count: 8<\/p>\n
\nborder-height: 10000
\n“`<\/p>\n
\n – `radius` is the **half side-length**: a radius of `100` creates a **200 \u00d7 200** block area.
\n – The border is **square**, axis-aligned, and centered on your exact position at the time of creation.<\/p>\n
\n[CustomBorder] Loaded 3 border(s) from storage.
\n“`<\/p>\n
\n– **Java:** 21 or newer<\/p>\n