Skip to content

A Blender add-on designed to simplify track configuration and setting management with various UI Panels and tools.

License

Notifications You must be signed in to change notification settings

nendotools/ac-track-tools

Repository files navigation

Assetto Corsa Track Tools

BLENDER 3D add-on
Track Configuration Manager
GitHub release (latest by date) GitHub Workflow Status (with branch) GitHub issues GitHub PyPI - Python Version

Warning

I've taken a hiatus from maintaining this project to focus on some other things. FluffysAltTabGarage has picked it up to continue development.

Table of Contents

Overview

Assetto Corsa Track Tools is a Blender 3D add-on built to streamline the process of creating and configuring tracks by exposing various configuration options in a more digestible and intuitive manner. It provides several quality of life tools to help manage track settings, surfaces, track/race nodes, cameras, lighting, sounds, and more.

This project is still in its early stages, and many features are still in development. If you have any suggestions or requests, please feel free to open an issue or pull request.

Objectives

  • Simplify the process of creating and configuring tracks for Assetto Corsa
  • Provide a more intuitive and user-friendly interface for managing track settings
  • Automate common tasks and checks to reduce human error
  • Provide clear and explicit defaults and ranges for all settings to reduce ambiguity

Features

Configuration Management

Save/Load track settings, surfaces, nodes, cameras, lighting, and sound settings. This allows for not only effortless validation of inputs, but also binds all track configurations to the Blender project file.

Project initialization automatically creates the necessary folder structure and files to configure the track once the working directory is set.

Pre-flight checks are also performed to ensure that all required settings are present before exporting the track. It's also able to correct some common issues automatically.

Surfaces

Default surfaces are automatically available. Surfaces can easily be added, modified, and overridden from the UI. Surfaces can be easily assigned to selected meshes from the context menu (right click). The UI also allows for easily selecting all meshes with an assigned surface.

Track Nodes

Race start locations, time gates, and pitboxes can be added from the context menu and moved around the track where needed. The preflight check ensures that start locations and pitboxes are even and the ui_track.json file is updated.

Lighting

Currently, the sun settings and some basic lighting extension options are available from the UI. In the future, more advanced settings and mesh bindings will be added to simplify the process of adding the various lighting options available through modding.

Sounds

Reverb zones and sound emitters can be added from the context menu. Some default example reverb options are available and can be easily customized to fit the track's needs. Sounds require some additional work outside of Blender to be usable in Assetto Corsa, but the add-on provides the necessary settings to hook them up once banks are created.

TODO

  • Track Settings
    • Name + Description
    • Tags
    • Metadata
    • save/load
  • Surfaces + Nodes
    • Assign Surface, Wall, Physics
    • Create Race Nodes
      • Start
      • Finish
      • A-B Start + Finish
      • Hotlap Start
      • Time Gate
      • Pit
  • Cameras
    • Attach Camera
    • Focus Movement
    • Monitor Groups
  • Lighting
    • Sun
    • Extension (WIP)
      • Spotlights
      • Mesh Lights
      • Line Lights
      • Light Series
  • Map
    • Generate Map
      • overhead view of track
      • disable all non-track objects
      • black and white
      • resolution config
      • save mini version as ui/outline.png (for track selection)
      • save full version as map.png (for mini-map and loading screen)
    • Generate Preview (ui/preview.png)
  • Track Layouts/Variants
    • Multiple layout support (club, national, etc.)
    • Collection-to-KN5 mapping
    • Per-layout models.ini generation
    • Preview mode for layout visualization
    • Default layout protection
  • Object Setup
    • Auto-setup for trees
    • Auto-setup for grass
    • Auto-setup for standard objects
    • Batch object configuration
  • Overlays: Time-Attack
  • Sections: Track Regions
  • Groove
    • Investigate Implementation
  • AI
    • Investigate Implementation
  • Sounds
    • Reverb Zones
    • Sound Sources
  • Animation
    • Investigate Implementation
  • Multi-Modal Configuration
    • Investigate Implementation
    • useful to reuse track without reconfiguring everything
  • Export
    • Track (FBX)
    • Surface
    • Models (models.ini per layout)
    • KN5 (experimental)
      • Testing and verification
    • Cameras
    • Lighting
    • Sounds

About

A Blender add-on designed to simplify track configuration and setting management with various UI Panels and tools.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages