BetterChunkLoader

**BetterChunkLoader** is a Minecraft server plugin that lets administrators place special chunk loader blocks to keep an area loaded even when players are not nearby. The plugin is useful for servers that need important areas to keep running, such as farms, machines, storage systems, or technical builds that should continue working without requiring a player to stand in the chunk. ## Features - **Chunk loader blocks** Place a special block to keep the surrounding server-defined chunk area loaded. - **Persistent chunk loaders** Chunk loaders are saved to plugin storage and restored after a server restart. - **Owner tracking** Every chunk loader stores the UUID of the player who placed it. - **Admin control** Administrators can give chunk loader blocks, open the admin menu, view active loaders, and manage access through permissions. - **Admin GUI** The admin menu shows a list of active chunk loaders with their world and coordinates. - **Teleport from GUI** Admins can click a listed chunk loader to teleport directly to its location. - **Custom language file** Plugin messages, item names, lore, and GUI text are stored in `lang.yml` and support Minecraft color formatting. ## How It Works 1. An administrator gives a player a chunk loader block. 2. The player places the block at the center of the area they want to keep active. 3. BetterChunkLoader saves the chunk loader location and owner. 4. The plugin creates a fake server player at that location, so the server loads chunks around it using the same distance rules configured in `server.properties`. 5. When the block is removed by the owner or an administrator, the chunk loader is removed from storage. ## Installation 1. Download or build the plugin jar. 2. Place the jar file into your server's `plugins` folder. 3. Restart the server. 4. Configure generated files if needed: - `plugins/BetterChunkLoader/lang.yml` - `plugins/BetterChunkLoader/chunks/` ## Commands ### `/chunkloader admin` Opens the BetterChunkLoader admin menu. Use this menu to view active chunk loaders and teleport to their locations. **Permission:** `chunkloader.admin` ### `/chunkloader giveblock <player> <amount>` Gives chunk loader blocks to an online player. Example: ```text /chunkloader giveblock Steve 3 ``` This gives `Steve` 3 chunk loader blocks. **Permission:** `chunkloader.admin` ## Permissions ### `chunkloader.admin` Grants access to BetterChunkLoader admin features. Players with this permission can: - Use the admin menu - Give chunk loader blocks - Place chunk loader blocks - Break chunk loaders owned by other players By default, this permission is available to server operators. ## Usage Guide ### Giving a Chunk Loader Block Use: ```text /chunkloader giveblock <player> <amount> ``` Example: ```text /chunkloader giveblock Alex 1 ``` The target player will receive a special chunk loader block. ### Placing a Chunk Loader Place the chunk loader block at the center of the area you want to keep loaded. Once placed, the plugin registers the block, saves it to storage, and loads nearby chunks according to your server's configured distance settings. ### Removing a Chunk Loader Break the chunk loader block. The loader can be removed by: - The player who placed it - A player with `chunkloader.admin` After removal, the plugin deletes the loader from storage. ### Viewing Active Chunk Loaders Use: ```text /chunkloader admin ``` Open the chunk loader list from the admin menu. Each listed loader displays: - World name - X coordinate - Y coordinate - Z coordinate Click a listed loader to teleport to it. ## Language Customization BetterChunkLoader creates a `lang.yml` file in the plugin folder. You can edit this file to customize: - Plugin prefix - Command messages - Placement and removal messages - Chunk loader item name - Chunk loader item lore - GUI titles - GUI item descriptions The language file supports Minecraft color codes and gradient formatting through the Liba `MinecraftColor.format()` system. ## Notes - Chunk loaders are stored as individual files inside the plugin's `chunks` folder. - The loaded area is controlled by the server's chunk loading rules, such as the distances configured in `server.properties`. - Removing a chunk loader block also removes its saved data. - Only players with the correct permission can place chunk loader blocks. - Server operators have admin permission by default.