Doors - user-grinch/ModelExtras GitHub Wiki

πŸšͺ Overview

AnimatedDoors brings dynamic realism to your vehicle mods by enabling smooth, believable door animations β€” from sleek sliding mechanisms to satisfying hinges. Whether you're crafting a futuristic minivan or a retro coupe, doors can now slide or rotate open and closed automatically using preset bone animations.

There are two main animation types, each triggered by specific node names:

πŸ”„ Type 1 – Slider Doors

These doors slide along a linear path, typically parallel to the vehicle body. Ideal for minivans, futuristic vehicles, or specialty mods.

🧩 Supported Node Names:

  • x_sd_lf – left front sliding door
  • x_sd_rf – right front sliding door
  • x_sd_lr – left rear sliding door
  • x_sd_rr – right rear sliding door

πŸ“ Attach your door geometry under one of these node names to activate sliding behavior. The system handles the animation axis and range.

πŸ” Type 2 – Rotate Doors

These doors pivot on a hinge, emulating traditional car doors.

🧩 Supported Node Names:

  • x_rd_lf – left front rotating door
  • x_rd_rf – right front rotating door
  • x_rd_lr – left rear rotating door
  • x_rd_rr – right rear rotating door

🧠 The game calculates the hinge rotation and speed β€” you just define the correct node and orientation.

βš™οΈ JSONC Integration

Both types of animated doors support a reverse flag in your model’s .jsonc configuration. This allows you to invert the default open direction of any door for custom behavior.

πŸ§ͺ Example:

{
  "doors": {
    "x_sd_lf": { "reverse": true },
    "x_rd_rf": { "reverse": false }
  }
}