ChunkyOffline Plugin

A Paper plugin for offline chunk generation using the Chunky plugin. This plugin is fully compatible with Folia.

Features

• Automatic Offline Generation: Automatically generates chunks when no players online and pauses generation when a player joins the server
• Configurable: Set custom radius and center coordinates
• Full Control: Start, pause, resume, and cancel chunk generation
• Global Messages: Optional broadcast messages for generation events in your language
• Folia Compatible: Fully async-safe implementation
• Permission Support: Full LuckPerms and other permission plugin support

Currently implemented languages

• English
• German

If you want your language be supported, fork the repo and create a new language file. Then send a pull request and I gladly add your language to the plugin.

Requirements

• Paper/Folia/Spigot/Purpur 1.21.11+
• Chunky plugin (1.3.152+)
• Java 21+

Installation

1. Download the plugin JAR file
2. Place it in your plugins/ directory
3. Restart your server

Configuration

The plugin creates a config.yml file in the plugins/ChunkyOffline/ directory.

Default Configuration

# ChunkyOffline Configuration
# This file contains the settings for offline chunk generation

Language Settings

Supported languages: en (English), de (German)

You can add custom languages by creating JSON files in the lang/ folder

language: en

chunk-generation:

Radius for chunk generation (in blocks)

radius: 10000

Center coordinates for chunk generation

center: x: 0 z: 0

## Commands

All commands require the corresponding permission or OP level.

### Start Generation

/chunkyoffline start /co start

Permission: `chunkyoffline.admin.start`

### Pause Generation

/chunkyoffline pause /co pause

Permission: `chunkyoffline.admin.pause`

### Resume Generation

/chunkyoffline resume /co resume

Permission: `chunkyoffline.admin.resume`

### Cancel Generation

/chunkyoffline cancel /co cancel

Permission: `chunkyoffline.admin.cancel`

### Configure Settings

/chunkyoffline config set radius 10000 /chunkyoffline config set center-x 0 /chunkyoffline config set center-z 0 /chunkyoffline config set global-messages true

/chunkyoffline config get radius /chunkyoffline config get center-x /chunkyoffline config get center-z /chunkyoffline config get global-messages

Permission: `chunkyoffline.admin.config`

## Permissions

| Permission | Default | Description |
|---|---|---|
| `chunkyoffline.admin.start` | OP | Start chunk generation |
| `chunkyoffline.admin.pause` | OP | Pause chunk generation |
| `chunkyoffline.admin.resume` | OP | Resume chunk generation |
| `chunkyoffline.admin.cancel` | OP | Cancel chunk generation |
| `chunkyoffline.admin.config` | OP | Configure plugin settings |