RealisticWalk

# 🚶 RealisticWalk > **Make movement feel real.** RealisticWalk slows players down to a natural walking pace and gives them a mild speed boost only when they actively sprint — no more super-speed by default! <iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/1sDC5mWhVtw" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe> --- ## ✨ Features - 🐢 **Reduced walk speed** — players move at a calm, realistic pace by default. - 🏃 **Sprint speed** — pressing **Ctrl / Sprint** grants a slightly faster (but still realistic) speed. - ⚙️ **Fully configurable** — every speed value is tunable via `config.yml`. - 🔄 **Live reload** — change settings without restarting your server. - 🛡️ **Bypass permission** — grant `realisticwalk.bypass` to players/staff who should keep the default Minecraft speed. - 🔌 **Zero dependencies** — lightweight, event-driven, no per-tick scheduler. - ♻️ **Clean disable** — speeds are restored to vanilla defaults when the plugin unloads. --- ## 📦 Installation 1. Download the latest `RealisticWalk-x.x.x.jar` from the releases page. 2. Drop it into your server's `plugins/` folder. 3. Restart (or reload) your server. 4. Edit `plugins/RealisticWalk/config.yml` to your liking. 5. Run `/rw reload` to apply changes without a restart. **Requires:** Paper (or any Paper fork) 1.21+, Java 21+ --- ## ⚙️ Configuration `plugins/RealisticWalk/config.yml` ```yaml # ───────────────────────────────────────────────────────────────────────────── # SPEED SETTINGS # Minecraft's default walk speed is 0.2 (internal value). # Values must be between -1.0 and 1.0. # Recommended sensible range: 0.05 → 0.5 # ───────────────────────────────────────────────────────────────────────────── speeds: # Speed applied while the player is walking normally. walk: 0.15 # Speed applied while the player is sprinting (holding Ctrl / Sprint key). sprint: 0.35 # ───────────────────────────────────────────────────────────────────────────── # MESSAGES # Supports standard Minecraft color codes with & prefix. # Set any message to '' to disable it entirely. # ───────────────────────────────────────────────────────────────────────────── messages: prefix: "&8 " reload-success: "&aConfiguration reloaded successfully." reload-failure: "&cFailed to reload configuration. Check console for details." no-permission: "&cYou don't have permission to use this command." ``` | Key | Default | Description | |-----|---------|-------------| | `speeds.walk` | `0.15` | Player speed while walking | | `speeds.sprint` | `0.35` | Player speed while sprinting | > **Tip:** Minecraft's internal default is `0.2`. Values below that feel slower; values above feel faster. --- ## 🔧 Commands | Command | Alias | Permission | Description | |---------|-------|------------|-------------| | `/realisticwalk reload` | `/rw reload` | `realisticwalk.admin` | Reloads `config.yml` and re-applies speeds live | --- ## 🔑 Permissions | Permission | Default | Description | |------------|---------|-------------| | `realisticwalk.admin` | OP | Access to `/realisticwalk reload` | | `realisticwalk.bypass` | `false` | Exempts the player from speed changes | --- ## 🕹️ How it works 1. When a player **joins**, their walk speed is immediately set to `speeds.walk`. 2. When they **start sprinting** (Ctrl), speed is raised to `speeds.sprint`. 3. When they **stop sprinting**, speed drops back to `speeds.walk`. 4. When they **leave**, their speed is reset to the Minecraft default (`0.2`) so they aren't affected on other servers. The plugin is entirely **event-driven** — there is no per-tick scheduler, keeping server performance impact at near zero. --- ## 📄 License This project is licensed under the (LICENSE). --- ## 💬 Support (https://discord.com/invite/SG8jvb9WU5) --- *Made with by (https://github.com/Anonventions)*