🚶 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

• 🐢 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

# ─────────────────────────────────────────────────────────────────────────────
#  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 **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 [MIT License](LICENSE).

---

## 💬 Support

Discord

---

*Made with by Anonventions*