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 |