TurboBarCam - Tactical Ultra-Responsive Brilliant Optics for BAR Camera

An advanced camera control suite for Beyond All Reason, featuring smooth transitions, various unit tracking modes and more.

Features

• Camera Anchors: Save and recall camera positions with smooth transitions and chaining
• Follow Camera: Follow unit maintaining its orientation or target
• Tracking Camera: Track selected units while maintaining your position
• Orbiting Camera: Circle around units with adjustable speed and height
• Group Tracking Camera: Track a group of units with automatic clustering
• Projectile Camera: Follow projectiles fired from units

Installation

1. Download turbobarcam_vX.zip

2. Extract it in your BAR installation directory (Click Open install directory in the Launcher)

3. After extracting, your folder structure should look like:

   BAR install folder/
   └── LuaUI/
       ├── RmlWidgets/
       ├── Widgets/
       └── TurboBarCam/
       └── TurboBarCommons/
   

4. Enable "Tactical Ultra-Responsive Brilliant Optics for BAR Camera" and "TurboBarCam UI" in-game

Getting Started

By default, TurboBarCam is loaded but disabled. To enable it use the ui or this command:

/turbobarcam_toggle

Default Keybindings

To use the default keybindings, add this line to your uikeys.txt file:

keyload     luaui/TurboBarCam/turbobarcam.uikeys.txt

Parameter Adjustment System

TurboBarCam includes a system to fine-tune camera behaviors using the following format:

turbobarcam_[mode]_adjust_params [action];[param],[value];...

Where:

• [mode] is the camera mode (unit_follow, orbit, tracking_camera, etc.)
• [action] is add, set, temp or reset
• [param] is the parameter name
• [value] is the amount to change or the value to set
• add adds the value to the current parameter value
• set sets the parameter value to the given value
• temp sets the parameter value to the given value but resets back after changing camera mode
• reset resets the parameter to its default value

Buy me a coffee ;) https://ko-fi.com/superkitowiec

Changelog

2.1.0

• Show widget errors in UI
• Global nuke monitoring - you can always track nuke projectile now (turbobarcam_projectile_camera_cycle, turbobarcam_projectile_camera_toggle_mode)
• Added help button in UI

2.2.0

• Fixed group tracking camera
• Anchor sets saved without a name will be saved as default. Default sets are loaded automatically.
• Hide TurboBarCam UI when the game UI is disabled
• Added options to have single-duration anchors
• Added option in UI to disable unit indicators (selection highlight, command lines, etc)
• Added option to move to the next/previous anchor.
  • turbobarcam_anchor_focus prev
  • turbobarcam_anchor_focus next

2.3.0

• Add an option to reset the camera to the current anchor. If another camera mode is active, move smoothly. Otherwise, snap to the anchor.
• UI – Add an option to hide minimap and chat
• Removed Overview mode (now for real)
• UI - added a section with a list of the options and widgets which can interfere with recording. Click to toggle them off
• Attack state cooldown per unit type (how long the camera keeps looking at the last target)
  • turbobarcam_unit_follow_adjust_params set;ATTACK_STATE_COOLDOWN,5
• Added turbobarcam_unit_follow_reset_attack_state n - stop looking at the targets in combat mode for n seconds (for example, if unit keeps targeting air)
• Unit follow uses actual unit orientation instead of the fixed one
• Use turbobarcam_toggle_unit_follow_camera <unitId> [<mode>] to follow specific unit without selecting it
• Attach camera to hull instead of a weapon in combat mode
• Added turbobarcam_unit_follow_set_fixed_look_target <target type> <id>|<x> <y> <z> which forces camera to look at the chosen target. Allowed target types: UNIT, PROJECTILE, POINT. For example: turbobarcam_unit_follow_set_fixed_look_target UNIT 1234 or turbobarcam_unit_follow_set_fixed_look_target POINT 100 200 150
• Improved transition between units in unit_follow. If the distance is high, the camera goes up while looking at the current unit and then turns towards the new one. You can disable it in config.lua - UNIT_TRANSITION_ENABLED
• Added turbobarcam_track_projectiles <unitId> - register unitId for projectile tracking in the future
• Added an option to temporarily change the setting. For example turbobarcam_unit_follow_adjust_params temp;DEFAULT.FORWARD,5 will set DEFAULT.FORWARD to 5, but it will reset to previous value after changing the mode
• Added an option to override current camera smoothing. turbobarcam_smoothing <position|rotation|reset> <value>
• You can now use turbobarcam_anchor_focus <index> snap to instantly snap to the anchor
• Added script runner which allows you to run a list of Spring commands at specific timestamps/frames
  • Added turbobarcam_script_ff <delay> fast-forward to the next step in the current scrip. Delay = how many frames before the step it should skip to
  • Added turbobarcam_script_select_unit_team <unitID> which switches spectated team to the selected unit's team.
  • Added turbobarcam_script_play_track <track path> which plays selected music track. For example, turbobarcam_script_play_track music/original/warhigh/ryan krause - alpha one.ogg
  • Added turbobarcam_script_toggle_music which toggles music on/off
  • Use frame=+n in the script to skip forward n frames relative to the previous step

2.3.1

• Unit follow - save camera smoothing per unit type (for example, slower camera for the Juggernaut)
• Unit follow - save default unit weapon per unit type
• Unit follow - when transitioning to another unit, keep looking at the projectile if tracking was enabled
• Unit follow - improve target stabilization
• Added turbobarcam_unit_follow_choose_weapon <weaponNum> to choose the weapon by number