BuilderMode

# BuilderMode **A Minecraft plugin that temporarily boosts player render distance with configurable restrictions to prevent exploits.** (https://img.shields.io/badge/Minecraft-1.21.x-brightgreen.svg)](https://github.com/PaperMC/Paper) (https://img.shields.io/badge/Server-Paper%20%7C%20Folia-blue.svg)](https://papermc.io/) ## 📖 Overview BuilderMode allows players to temporarily increase their render distance for building and exploring, with built-in safeguards to prevent abuse. Perfect for building servers, creative worlds, or any server where players need better visibility for short periods. ## ✨ Features ### Core Functionality - **Temporary Render Distance Boost** - Configurable duration and distance per dimension - **Per-Dimension Settings** - Different render distances for Overworld, Nether, and The End - **Cooldown System** - Prevents spam with configurable cooldowns that persist offline - **Automatic Disable** - Deactivates when changing dimensions or logging out ### Security & Anti-Exploit - **Periodic Safety Checks** - Automatically resets render distances to prevent bypasses - **Dimension Change Detection** - Manual checking system for Folia compatibility - **Offline Cooldown Tracking** - Cooldowns continue even when players are offline - **No Bypass Exploits** - Multiple layers of protection against render distance manipulation ### Optional Restrictions - **Elytra Blocking** - Prevent elytra usage during BuilderMode (toggleable) - Automatic removal from chestplate slot - Double-confirmation required when wearing elytra - Blocks all equip attempts - **Entity Riding Prevention** - Block mounting any entity/vehicle (toggleable) - Automatic dismount on activation - Periodic checks to catch bypasses - Blocks horses, boats, minecarts, and all other rideable entities ### Admin Features - **Individual Feature Toggles** - Enable/disable elytra and entity restrictions separately - **Fully Customizable Messages** - All plugin messages support color codes and placeholders - **Verbose Logging** - Optional detailed console logging for debugging - **Hot Reload** - Reload configuration without restarting the server - **Tab Completion** - User-friendly command interface ## 📦 Commands | Command | Description | Permission | |---------|-------------|------------| | `/buildermode` or `/bm` | Show available commands | None | | `/buildermode on` | Activate BuilderMode | None | | `/buildermode off` | Manually deactivate BuilderMode | None | | `/buildermode info` | Check active time or cooldown status | None | | `/bmr` | Reload plugin configuration | `buildermode.reload` | ## 🔑 Permissions | Permission | Description | Default | |------------|-------------|---------| | `buildermode.reload` | Allows reloading the configuration | OP | | `buildermode.*` | Grants all permissions | OP | **Note:** No permission is required to use BuilderMode by default - all players have access! ## ⚙️ Configuration <details> <summary>Click to view full config.yml</summary> ```yaml # BuilderMode Configuration # Enable or disable the entire plugin enabled: true # Enable verbose logging for debugging and monitoring verbose: true # Default render distance to restore after BuilderMode expires default-render-distance: 8 # How often (in seconds) to check and reset render distance # This is a safety feature to prevent bypasses safety-check-interval: 30 # Feature Restrictions restrictions: # Prevent players from using elytra while BuilderMode is active disable-elytra: true # Prevent players from riding entities while BuilderMode is active disable-entity-riding: true # How often (in seconds) to check if players are mounted # Set to 0 to disable repeating check mount-check-interval: 5 # Dimension-specific settings dimensions: overworld: render-distance: 18 # Chunks duration: 1200 # Seconds (20 minutes) cooldown: 1200 # Seconds (20 minutes) nether: render-distance: 12 duration: 900 # 15 minutes cooldown: 1200 the_end: render-distance: 18 duration: 900 cooldown: 1200 # Customizable Messages (supports & color codes) # Placeholders: {time}, {distance}, {duration} messages: activated: "&aBuilderMode activated! Render distance set to {distance} chunks for {duration} seconds." expired: "&eBuilderMode has expired. Render distance restored." on-cooldown: "&cYou must wait {time} seconds before using BuilderMode again!" # ... and many more! ``` </details> ### Key Configuration Options **Render Distance Settings:** - Configure different distances for each dimension - Set custom durations and cooldowns per dimension - Recommended: 12-18 chunks for best performance **Restrictions:** - `disable-elytra: true/false` - Toggle elytra blocking - `disable-entity-riding: true/false` - Toggle entity riding prevention - `mount-check-interval: 5` - How often to check for mounted players (seconds)