Home - user-grinch/ModelExtras GitHub Wiki

ModelExtras is a modification that adds extra functionality to pedestrian, vehicle, and weapon models in GTA: San Andreas. This mod enhances customization and introduces new features to improve your gaming experience.

⚠ Important: ModelExtras requires model adaptation. Pedestrian, vehicle, and weapon models must be adjusted accordingly. Detailed instructions are available in the sidebar.

Getting Started ✔️

Follow these key guidelines to use ModelExtras effectively:

1. Model Adaptation is Required

ModelExtras will not work by default. You must adapt your pedestrian, vehicle, or weapon models for compatibility. See the sidebar for step-by-step adaptation instructions.

2. Compatible with Other Mods

ModelExtras works with models designed for:

  • EarShot (Functionality included)
  • PedFuncs (Functionality included)
  • VehFuncs
  • ImVehFt (Functionality included)
  • AVS (Functionality included)

You can combine these mods for even more customization options.

3. Node Name Limitations

The game limits node names to 23 characters. Exceeding this may cause crashes or problems, so keep names short and descriptive.

4. JSONC Configuration Files

ModelExtras uses .jsonc files (JSON with Comments) for configuration. JSONC works like standard JSON but supports inline comments using // or /* */. These files are loaded from the ModelExtras/data folder.

Used for:

  • ImVehFt carcols .ivfc
  • Enhanced sirens .eml
  • AVS sirens and model configs .json

Recommended Editors:

  • Visual Studio Code (built-in support)
  • Notepad++ (with JSON plugin)
  • Sublime Text

Reloading Configuration

You can reload .jsonc config files without restarting the game by using the MERELOAD cheat code.

  • Player must be inside a vehicle to reload that vehicle’s config
  • DeveloperMode must be enabled in the .ini file

5. Guidelines for JSONC Files and Metadata

  • Avoid Undocumented Features
    Do not rely on undocumented behavior, especially from other mods. These features are unsupported and may change or break at any time. Many ImVehFt models suffer from this and may behave unpredictably.

  • Explicitly Define All Parameters
    Always define every field in your configuration, even if you think it’s optional:

"rotation": 0.0
  • Do not misuse features outside their intended purpose
    For example, repurposing brake light materials as dashboard LEDs is not supported. If you need functionality beyond what's available, please submit a feature request.

This ensures your config remains valid in future versions where defaults might be removed or changed.

  • Follow the JSONC Schema Closely

Make sure your structure is clean and matches the expected format:

  • Properly nest fields
  • Use correct data types
  • Avoid typos or missing commas/brackets

Validate your files against a known working example whenever possible.

  • Provide Accurate Metadata

Each config must include a metadata section. This helps with debugging, version control, and future compatibility.

{
  "metadata": {
    "author": "Grinch_",
    "desc": "Lamborghini Aventador SVJ",
    "creationtime": "2023-10-01",
    "minver": 10700
  }
}

Read more about it here

Sidebar Resources 👉

The sidebar includes detailed guides on:
✔ Adapting your models
✔ Ensuring compatibility
✔ Using ModelExtras to its full potential

Whether you're modifying pedestrians, vehicles, or weapons, these resources will help you get the best results.

Happy Modding! 🎮

⚠️ **GitHub.com Fallback** ⚠️