Enhanced Rails

# Enhanced Rails !(https://cdn.modrinth.com/data/cached_images/aa0b702a03bb06fb3fe30e26fb5294fe871b2bc8_0.webp) ## ⚡ Overview Welcome to **Enhanced Rails v1.1**, a plugin that transforms your Minecraft rail systems with exciting features, from blazing-fast speeds to smart automation. Whether you're building complex transportation networks or simple automated item delivery systems, this plugin brings a new level of functionality to minecart travel. Enhanced Rails modifies powered rail behavior under specific conditions, significantly increasing minecart speed for players and enabling automated minecart loading/unloading systems. ## ✨ Features - **Super-Speed Travel**: Dramatically increase minecart speeds for players up to 10x faster than vanilla Minecraft - **Automated Loading/Unloading ✨ NEW IN V1.1! ✨**: Create automated item transportation systems without complex redstone! Minecarts are dispatched automatically when full or empty - **Special Item Activation**: Configure rare items that players must hold to activate super-speed, creating perfect quest rewards or VIP perks - **Block-Based Activation**: Alternatively, enable special features when rails are placed on specific blocks, providing visible infrastructure upgrades - **Smart Slowdown System**: Configure special blocks that automatically reduce speed for curves and slopes, preventing derailments - **Customizable Settings**: Fine-tune all parameters to match your server's needs through a comprehensive configuration system This plugin is perfect for creating quest rewards, enhancing transportation networks, building exciting rail systems, and automating item transport across your Minecraft world. ## 📋 Requirements - Minecraft 1.21.4+ - Paper server (functionality on pure Spigot servers is not guaranteed due to Paper's recent hard-fork) - Java 17 or higher > **Note:** As of version 1.21.4, Paper has created a hard-fork and no longer follows Spigot as a base API. This plugin is built using the latest Paper API and may not function correctly on pure Spigot servers. ## 🔧 Installation 1. **Download the Plugin** - Get the latest EnhancedRails.jar from (https://elfahja.com) 2. **Install on Your Server** - Stop your server (to avoid config conflicts) - Place EnhancedRails.jar into your server's `plugins/` folder - Restart the server—EnhancedRails will generate a default `config.yml` in `plugins/EnhancedRails/` 3. **Verify Installation** - Check the server console for: "EnhancedRails is now enabled! Config loaded from " - You're ready to roll! ## ⚙️ Configuration Guide The `config.yml` file in `plugins/EnhancedRails/` controls all plugin features. Below is the default configuration with explanations: ### Super Speed Configuration ```yaml super-speed: enabled: true ``` ### Special Item Configuration When enabled, provides super-speed only when players hold the specified item in their main hand. ```yaml special-item: enabled: true material: "TRIAL_KEY" # Recommended: use a rare item custom-name: "Super Speed Key" # Optional custom name requirement ``` ### Special Block Configuration If you prefer not using the special item approach, you can enable super-speed based on the block beneath powered rails. Note: This section is ignored if special-item is enabled. ```yaml special-block: enabled: true material: "SMOOTH_STONE" ``` ### Speed Parameters Fine-tune speed settings for different track conditions. Exceed recommended limits at your own risk! ```yaml super-speed-parameters: flat-speed-multiplier: 2.0 # Max recommended: 2.0 flat-max-speed: 4.0 # Max recommended: 4.0 slope-speed-multiplier: 1.1 # Must be greater than 1.0, max recommended: 1.1 slope-max-speed: 1.0 # Max recommended: 1.0 max-uphill-velocity: 2.0 # Max recommended: 2.0 max-downhill-velocity: 2.0 # Max recommended: 2.0 ``` ### Slowdown Blocks Configure special blocks that reduce minecart speed automatically. ```yaml slow-down-parameters: enabled: true block1-material: "GRAVEL" block1-max-speed: 0.4 # 0.4 is a relatively slow speed block2-material: "SAND" block2-max-speed: 0.1 # 0.1 for extreme slowdown ``` ### Minecart Loader/Unloader Configuration Configure the new automatic minecart loading/unloading system (new in v1.1). ```yaml minecart-loader: enabled: true # How strong the push should be (default Minecraft minecart speed is around 0.4) push-strength: 1.0 # Enable debug logging debug: false # Special block settings special-block: enabled: true material: "SMOOTH_STONE" ``` > **Note:** Always back up your configuration before making changes, and avoid exceeding the recommended speed values to prevent unexpected behavior. ## 🎮 In-Game Commands Need to update settings without restarting? Use the reload command: - **Command**: `/enhancedrails reload` - **Permission**: `enhancedrails.use` (default: ops on