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:

/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:

/chunkloader giveblock <player> <amount>

Example:

/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:

/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.