Introduction

This short tutorial shows how to use Visual Studio Code to edit motion scripts associated with profiles in ForceSeatPM. Using Visual Studio Code enables code completion (IntelliSense), syntax highlighting and contextual help. It allows also to browse API classes and functions directly from the editor.

Prerequisites

  1. Make sure that ForceSeatPM 2.109 or newer version is installed. Older versions will not work with Visual Studio Code.
  2. Make sure that Visual Studio Code is installed.
  3. Start the program, go to File, Preferences, Extensions and install C/C++ extension.

  4. Wait until the extension and all dependencies are installed and then close the program.

Steps

  1. Go to ForceSeatPM
  2. Clone the selected profile, e.g. SDK – Vehicle Telemetry:
    • disable Shallow copy
    • enable Activate new profile
    • enable Open editor for new profile
    • enable Clone scripts
  3. In Profile Editor go to Motion Scripts tab and find a script that matches your motion platform.
  4. Press Run button next to the script to verify that the script works correctly and there are no errors in the the output console.
  5. At this point there are two scenarios:
    1. If you are editing the script when the game is running in the background and you plan switch (Alt+Tab) to the game to check your changes (e.g. changed filter parameters),  you can close the Profile Editor. ForceSeatPM will detect any changes made to the script and reload it. If there is any syntax error in the script, details will be displayed in Action Center.
    2. If you are editing the script without the game running in the background or you want to check the script manually and see results in the output console, then don’t close the Profile Editor. You will be clicking Run button later.
  6. Start Visual Studio Code
  7. Click File and Open Folder
  8. Open following directory: C:\Program Files (x86)\MotionSystems\ForceSeatPM\ScriptsDev
    This directory contains template project for scripts editing.
  9. Click File and Open File
  10. Go to Documents\MotionSystems\ForceSeatPM\Scripts and open the script (e.g. SDK_-_Vehicle_Telemetry_Work-Any.cpp)
  11. Code completion and content help will work now.
  12. All headers (with embedded comments/documentation) that define scripts API are located in: C:\Program Files (x86)\MotionSystems\ForceSeatPM\ScriptsAPI
    You can browse them from Visual Studio Code.
  13. When you finish making changes to the script, save it and then go to Profile Editor to press Run (or switch to the game).
  14. If there is any error, it will be displayed in Action Center or in output console (if you press Run button).