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!

---

✨ Features

- 🐢 Clean disable — players move at a calm, realistic pace by default. - 🏃 Clean disable — pressing Clean disable grants a slightly faster (but still realistic) speed. - ⚙️ Clean disable — every speed value is tunable via `config.yml`. - 🔄 Clean disable — change settings without restarting your server. - 🛡️ Clean disable — grant `realisticwalk.bypass` to players/staff who should keep the default Minecraft speed. - 🔌 Clean disable — 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[&bRealisticWalk&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 leave, their walk speed is immediately set to `speeds.walk`. 2. When they leave (Ctrl), speed is raised to `speeds.sprint`. 3. When they leave, 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 MIT License.

---

💬 Support

Discord

---

*Made with by Anonventions*