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](https://github.com/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..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 ```bash 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 | Command | Description | |:--|:--| | `/rc start` | Starts the challenge and timer | | `/rc stop` | Pauses the challenge and timer | | `/rc reset` | Resets the timer to `00:00:00` | | `/rc timer` | Toggles the action-bar timer | | `/rc timer prefix ` | Sets text before the timer | | `/rc timer suffix ` | Sets text after the timer | | `/rc effects` | Toggles chunk-based potion effects | | `/rc fluids ` | Toggles whether water, lava, and fire may be replaced | | `/rc exclude add ` | Adds a block to the replacement blacklist | | `/rc exclude clear` | Clears the custom blacklist | | `/rc spawnmonster chunks ` | Sets how many unique visited chunks trigger mob spawns | | `/rc spawnmonster max ` | Sets the max number of surprise mobs, including `0` to disable them | | `/rc debug <0-3>` | Sets debug output level | Detailed command documentation lives in [docs/COMMANDS-WIKI.md](/Users/razvancostache/Documents/chuckys/docs/COMMANDS-WIKI.md). ## Permissions | Permission | Description | Default | |:--|:--|:--| | `paperchunkrandomizer.admin` | Allows `/rc exclude add` and `/rc exclude clear` | `op` | ## Default Config ```yaml 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 | Key | Description | |:--|:--| | `debug-level` | `0-3` debug output level | | `timer-visible` | Whether the action-bar timer is shown | | `effects-enabled` | Whether chunk potion effects are active | | `spawn-interval` | Unique chunk visits required to trigger surprise spawns | | `max-mobs` | Maximum amount of surprise mobs spawned at once, with `0` disabling surprise mobs | | `replace-fluids` | Whether protected fluids and fire may be replaced | | `timer-prefix` | Text shown before the timer | | `timer-suffix` | Text shown after the timer | | `custom-blacklist` | Materials excluded from becoming chunk replacements | ## 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.