🚶 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.

---

💬 Support

Discord

---

Made with by Anonventions