Minecraft-plugin ChunkyBorder

🔌 About ChunkyBorder

ChunkyBorder is a Minecraft plugin add-on for the Chunky pre-generator. It provides first-class world border creation and enforcement tied to Chunky selections so servers can limit playable areas, redirect or block teleport attempts outside borders, and optionally render borders to players or maps.

🎯 Purpose

ChunkyBorder solves the problem of keeping a server's playable area aligned with pre-generated chunks. It is useful when you pregenerate areas with Chunky and need a configurable, chunk-aware world border that prevents players and teleports from leaving the pre-generated region or wraps teleportation across edges.

⚙️ Features

• Create a world border from a Chunky selection (square, circle, and other Chunky shapes).
• Prevent player movement past configured borders.
• Redirect or block teleports that would land outside the border.
• Optional client-side world border renderer (requires client-side mod/resource where applicable).
• Optional server-side particle visualizer for border edges.
• Optional border wrapping to teleport players across the border seam.
• Customizable border message, effects, and sounds shown when a player interacts with the border.
• Map marker support for Dynmap, BlueMap, Pl3xMap, and squaremap.
• Commands to add, remove, list, load, and toggle border wrapping.

🧩 Who It Is For

• Server owners and admins who pregenerate world chunks with Chunky and need borders that match pregenerated areas.
• Survival, SMP, or custom map servers that want enforced playable limits without relying on vanilla worldborder alone.
• Servers using web map plugins (Dynmap/BlueMap/Pl3xMap/squaremap) that want border visualization on maps.

🏗️ Example Use Cases

• Create a square play area around spawn, pregenerate it with Chunky, and add a ChunkyBorder so players cannot leave the pregenerated region.
• Load an existing Chunky border from another world and reapply it with a different radius.
• Enable border wrapping to allow teleportation across opposite edges of a bounded world.

⌨️ Commands

Note: ChunkyBorder uses Chunky's selection and command set; use Chunky's commands to prepare selections (for example chunky radius, chunky shape, chunky world, etc.).

🔐 Permissions

⚙️ Installation

📥 Setup

• Obtain the ChunkyBorder JAR for your Minecraft version and place it in the server plugins/ directory.
• Install the Chunky plugin (ChunkyBorder is an add-on and requires Chunky to define selections and generate chunks).
• Restart the server and check the console to confirm ChunkyBorder loaded correctly.

📦 Dependencies

• Required: Chunky (plugin) — ChunkyBorder creates borders from Chunky selections.
• Optional integrations (map markers / visualization): Dynmap, BlueMap, Pl3xMap, squaremap.

⚙️ Java / Version notes

ChunkyBorder releases provide downloads targeting different Minecraft/Java combinations; follow the release that matches your server runtime. Official release packaging indicates different builds for older and newer Minecraft ranges.

🧠 Technical Notes

• License: GPL-3.0.
• ChunkyBorder is distributed with platform-specific builds in the upstream repository; its primary distribution is via the Spigot resource and the project's GitHub repository.
• Confirmed tested Minecraft versions include 1.14 through 1.21 (see project releases for exact compatibility and recommended Java runtime per build).
• The plugin integrates with map plugins to display border markers but does not require them for basic border enforcement.

🤝 When This Plugin Is Useful

If you pregenerate chunks with Chunky and need a border that matches those generated areas (including teleport handling and optional map visualization), ChunkyBorder provides a compact, Chunky-aware border solution that ties selections, enforcement, and visual markers together without replacing Chunky itself.