MobSteer | Ride Mobs & WASD Control

New Features:

• Player Riding – Players now can be ridden! Not just mobs.
• Swimming - Mobs no longer automatically dismount when entering water.
• Permissions - Expanded permissions as an alternative to the LuckPerms group hook.

New Commands:

• /msr speed [mob|override] <value>
• /msr players [ride|rideop|eject] <true|false>
• /msr force [mount|dismount|dismountlock] <player> <entity|true|false>
• /msr messages <true|false>
• /msrfix - fixes broken mobs (AI) or broken player attributes if occur.

New Permissions:

mobsteer.fix mobsteer.unridable mobsteer.ride.* mobsteer.ride.players mobsteer.ride.players.op mobsteer.ride.players.eject mobsteer.ride mobsteer.ride.<mob>

Other:

• Removed Unnecesary interact event cancelation you can interact with other plugin mobs now...
• Added Mannequin Riding - Mannequins now can be ridden on 1.21.11+.
• Added isDismountLocked & setDismountLocked to the API.
• Added PlayerMountMobEvent & PlayerDismountMobEvent events to the API.

New Config Options:

mechanics:

  # Ignore right-click entity mount interactions for OP and mobsteer.admin permission players.
  # Useful when configuring NPCs, shops, and other plugins or just using custom menus.
  ignore-op-interactions: false

  # How high can mobs step up?
  auto-step-height: 1.1

  player-riding:
    # Allow players to ride other players. (global)
    enabled: false

    # Allow players to ride OP players. (global)
    ride-op: false

    # Allow the ridden player to eject riders pressing 3x Shift.
    rider-eject: true

    # Mobs on this list will always use flying movement. (Useful for custom mounts)
  forced-flying-mobs:
    - ARMOR_STAND


network-sync:
  # Available modes:
  # AGGRESSIVE  - Maximum movement smoothness. Highest network usage.
  # MEDIUM      - Balanced synchronization with reduced network usage.
  # AUTO        - Automatically switches synchronization based on TPS and viewers.
  # OFF         - Uses vanilla Minecraft synchronization. (May cause unexpected desync).
  mode: AUTO

  # Allows AUTO mode to switch to OFF when TPS or viewer hard limits are reached.
  fallback-mode-enabled: true

  # Minimum server TPS before AUTO switches to fallback mode.
  # Values above 20.0 act as a safety buffer.
  # This allows AUTO to reduce network synchronization before the server reaches 50ms MSPT.
  # Recommended values:
  # 22.0 - Triggers at ~45ms MSPT (prevents load before lag occurs)
  # 19.8 - Triggers at ~50.5ms MSPT (only activates when the server starts lagging)
  tps-limit: 22.0

  # AUTO mode switches from AGGRESSIVE to MEDIUM when an entity has this many viewers.
  viewers-limit: 5

  # Force OFF mode when an entity reaches this number of viewers.
  viewers-hard-limit: 16


visuals:
  # Should plugin send its own messages while riding?
  actionbar:
    enabled: true
    message: '&6Press SHIFT to dismount'
    dismount-triple-warning: '&6Press 3x SHIFT to dismount'
    dismount-player-warning: '&6Press 3x SHIFT to dismount rider'


  messages:
    enabled: true

    ride-players: "&c&l[!] &cYou can't ride players!"
    ride-op-players: "&c&l[!] &cYou can't ride this player!"

hooks:
  luckperms:
    # Enable LuckPerms for group-based restrictions (You can use permission instead now.)
    enabled: false
    # Can-ride requires mobsteer.use permission set on true to work (/steer requires both .use and .steer)
    groups:
      default:
        can-ride: false
        ride-players: false
        allowed-entities: []
        blocked-entities:
          - ARMOR_STAND

speed-multipliers:
  HAPPY_GHAST: 0.2
  GIANT: 0.8