paper-chunk-randomizer

Paper-Chunk-Randomizer (Beta)

Paper-Chunk-Randomizer is a beta Paper plugin build of the Random Chunks challenge originally created by Eckelsoft for fabric.

Every new chunk a player enters is transformed into one deterministic replacement block for that chunk. The result is a chaotic survival run where terrain, caves, oceans, and structures can all turn into something completely different while you try to reach the End and finish the game.

Status

• Current release line: beta
• Target platform: Paper 1.21.x
• Required Java version: 21

Credits

• Original creator of Chunk Randomizer / Random Chunks: Eckelsoft
• Original project source: eckelsoft/Chunk-Randomizer
• This repository contains a beta Paper adaptation of that original project

What It Does

• Replaces blocks in newly entered chunks with a chunk-specific random material
• Applies chunk-based potion effects when players enter a new chunk
• Spawns surprise mobs after a configurable number of unique chunk visits
• Shows a challenge timer in the action bar
• Supports a custom replacement blacklist
• Gives players Chunk Walker boots when the run starts

Download

Drop the jar into your server's plugins/ folder and restart the server.

Installation

1. Stop your Paper server.
2. Copy the newest Paper-Chunk-Randomizer-0.1.0-beta.1-build.<timestamp>.jar into plugins/.
3. Start the server.
4. Configure the plugin in plugins/Paper-Chunk-Randomizer/config.yml if needed.
5. Use /rc start in-game to begin the challenge.

Build From Source

gradle build

The build output is written to build/libs/.

If you are targeting a different Paper 1.21.x version, update these values in gradle.properties:

• paper_api_version
• paper_api_compat_version

Quick Command Reference

Detailed command documentation lives in docs/COMMANDS-WIKI.md.

Permissions

Default Config

debug-level: 1
timer-visible: true
effects-enabled: true
spawn-interval: 16
max-mobs: 8
replace-fluids: false
timer-prefix: ""
timer-suffix: ""
custom-blacklist: []

Config Options

How The Paper Beta Works

• Chunk replacement is deterministic per world and chunk, so revisiting the same chunk gives the same result.
• The plugin uses Paper Material, PotionEffectType, and EntityType pools instead of Fabric registries.
• Replacement candidates are filtered to avoid fragile or problematic block types such as portals, stairs, rails, banners, beds, signs, and similar special blocks.
• This is a beta Paper adaptation, so behavior is intentionally close to the original but not a byte-for-byte Fabric clone.

Gameplay Notes

• Players receive Chunk Walker boots the first time the challenge is started.
• Chunk Walker boots prevent chunk randomization and chunk effects for the wearer.
• Chunk Walker boots lose 10 durability per protected chunk entry.
• Use /rc exclude add minecraft:... to avoid especially laggy or annoying replacement blocks.
• Use /rc spawnmonster chunks 99999 if you want to effectively disable surprise mob spawns.

Credit

Full credit for the original Chunk Randomizer idea and original project goes to Eckelsoft. This Paper-Chunk-Randomizer beta build is an adaptation built on top of that original work.