CineCam | Cinematic Third-Person Camera Replacement
by Zooloo75   Steam Workshop Page: https://steamcommunity.com/sharedfiles/filedetails/?id=1551751531 Version: 0.15 / Nov 1, 2018 Development Began: Oct 27, 2018 License: Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License
Disclaimer:
This mod is not for everyone. Some players may feel motion sickness.
Some features are unavailable or are not fully implemented while in CineCam's third-person.
CineCam could break or cause issues in missions that manipulate the camera.
Description:
This mod replaces the third-person camera. This replacement is more dynamic, moving based on context.
The camera positions itself according to the player's actions. If the player is moving with their weapon lowered,
then the camera will follow centered behind the player, exuding a feeling of tranquility.
When the player has their weapon raised, the camera will go over the player's shoulder, allowing for a clear
shot of what's ahead. Free-look moves the camera in closer towards the player's head, improving feedback.
The camera's motion is derived from various properties of the player. The weight of the player's movement can be felt through the camera.
Known Issues / ToDo:
[Issue] Reloading a secondary weapon while in third-person will reload the primary weapon first if it needs to be reloaded (limitation of `reload` command). [Issue] Reloading in third-person sometimes doesn't work.
[Issue] Action menu cannot be accessed while in third-person due to technical limitations of being switched to a separate camera. [Issue] Aiming down sights can stop working in both third or first person. [Issue] Zooming in by holding right click while in third-person, and then releasing zoom, doesn't return back to the third-person camera. [Issue] Sprinting while the player's weapon is lowered causes the camera to go into shoulder-cam mode (`weaponLowered` command is unreliable). [Issue] Switching fire modes in third-person sometimes fails. [Issue] Firing full-auto in third-person for certain weapons does not work (need to build up list of full-auto fire mode names -- if you come across a weapon that doesn't fire in full-auto while in third-person, let me know). [Issue] Clicking in menus causes the player's weapon to fire. [ToDo] Add crosshair to third-person, which can be toggled via CineCam's Addons Settings. [ToDo] Make camera translations work with relative-space vectors, instead of global-space for easier camera manipulation.
[ToDo] Camera yaw does not utilize torque yet (need to figure out how to handle rotation from 359deg to 0deg, as it rotates 359deg backwards instead of 1deg forward).
[ToDo] Respect different vision modes, such as night vision, and thermal vision.
[ToDo] Separate camera position offset handling for both left and right leaning (common problem of limited visibility when leaning left with right-oriented shoulder cam).
[ToDo] Improve recoil feedback (perhaps tie it to arm/shoulder movement since that should accurately represent the recoil motion?).
[ToDo] Make camera settings user-configurable.
[ToDo] Handle third-person vehicle camera. [ToDo] Potentially use `cameraEffect` to allow for various post-process effects and the ability to change field of view (player loses control of character when using `cameraEffect` at the moment). [ToDo] Initialize camera position on player. [ToDo] Allow for shoulder-cam to be toggled between left and right shoulder. [ToDo] Allow for shoulder-cam position switching to be disabled.
[ToDo] Obligatory code refactor.   Changelog: 0.16 / TBA: Code cleanup. 0.15 / Nov 1, 2018: Made camera settings configurable (via Options > Addon Options > CineCam). Reduced default film grain value. Disabled CineCam's post-process effects by default (can be enabled via Addon Options). 0.14 / Oct 31, 2018: Improved camera offsets for practicality. Prevent firing while viewing map. Fixed issue where attempting to fire in full-auto with an empty magazine would playing the click sound every frame. Fixed issue where firing in full-auto for certain machine guns would only fire single shots. Remove inadequate night-vision handling. 0.13 / Oct 31, 2018:  Allow for shoulder-cam to flip position offset depending on player's lean direction. Added keybinding to manually toggle shoulder-cam position (accessible via Options > Controls > Configure Addons > CineCam > Toggle Camera Shoulder). Allow for inventory to be accessed while in third-person. Fixed issue where sprinting while the weapon was lowered caused the camera to go into shoulder-cam mode (should only happen if the weapon is raised). Added mild post-process effects for eyecandy. Removed inadequate camera shake that represented weapon recoil (will be revisited at a later date). Improved combat lean stance detection for shoulder-cam flipping. Prevent firing while in dialogs. 0.12 / Oct 30, 2018: Fix issue where player can't aim down sights while in first-person. 0.11 / Oct 29, 2018:  Fix issue where players couldn't fire in full-auto while in third-person. 0.1 / Oct 29, 2018: Initial release.   Media: