OMSI 2
评价数不足
OMSI Presentation Tools - installation, usage & more
由 shanie 制作
Assorted tools to aid the creation of high-quality screenshots & videos for OMSI 2, created by me (sjain)

Using OMSI Presentation Tools for a YouTube video you're creating? Why not leave a link to this tool in the description so others can enjoy it too?
   
奖励
收藏
已收藏
取消收藏
What is OMSI Presentation Tools and why use it?
OMSI 2 does not ship with any photo modes or movie tools. Users can switch between several cameras, however these do not offer much in-game flexibility.

In addition, the bus exterior and free map cameras have their FoV (Field-of-view) locked to 45° which is often sub-optimal.

To alleviate this, one can add special cinematic cameras to a bus, which offer much finer control.

This, however, has its disadvantages:
• Not the most user-friendly (requires game file editing)
• Requires a separate bus to be spawned for more angles (can't be used with timetables)
• Cannot be edited in-game (required to adjust focus point)
• Must be manually added to each bus before startup
• Actual camera is often quite far from the bus - Z fighting issues and odd "distant" feel Z fighting[en.wikipedia.org]

A much better approach would be manipulating a camera (such as the Free Map (F4) camera) directly in-game, which would eliminate all of these shortcomings.

To do this, reverse engineering of the game is required. OMSI Presentation Tools is a set of tools to aid the creation of high-quality screenshots & videos for OMSI 2 that does exactly this, written from the ground up in C++ by me (sjain).

It is fully compatible with OMSI 2 v2.2.032 ("Tram compatible" patch) and v2.3.004 (latest version).

Currently it is in very early stages and v0.1.x is my first venture into anything meaningful in this area. It will be updated in the future with new features & fixes.

Disclaimer
Anti-cheat warning

Due to the nature of this tool, it is possible some game anti-cheats will flag this software.

Thus, please ensure you keep all games which have anti-cheats closed while running OMSI 2 with OMSI Presentation Tools.

More information

In theory there should be no issues since this tool restricts itself to memory regions OMSI has read-access to, but its possible it could be flagged up. The same applies to antivirus detections.

As well as this, the OmniNavigation and Bus Company Simulator Addon DLCs read directly from to OMSI 2's process memory, similar to this tool. These DLCs have been public for several years and nobody has reported issues yet.

Although all of these cases are extremely unlikely, if not impossible, please note that I cannot be held personally responsible (directly or indirectly) if usage of this tool results in an anti-cheat ban in other games, the breaking of your OMSI install or other software, or loss of data.

Users will be reminded of this via a pop-up message box upon first launch of the tool (only).

Installation
This tool requires installation of the Visual C++ Redistributable Runtimes. If you do not already have them, please follow the instructions here to download and install them.

If you are updating this tool be sure to check the list of changes of the "Changelog of updates" section below incase there is a "WARNING" or "NOTE" you should be aware of.


  1. Click here to download the archive with the required files.

  2. Open the downloaded archive with File Explorer / Windows Explorer.

  3. Ensure OMSI 2 is not running.

  4. Open the OMSI 2 folder.

  5. Copy the contents inside.

  6. Open Steam.

  7. Hover your cursor over the Library tab in the top left, then click on Home.

  8. Right click on the OMSI 2 entry in the games list on the left.

  9. Click on Properties....

  10. Click on the Local Files option on the left.

  11. Click on Browse.... A File Explorer / Windows Explorer window will appear.

  12. Paste the contents into this location and click Replace the files in the destination (or similar) if prompted.

You have now successfully installed OMSI Presentation Tools for OMSI 2 and can launch the game.

The tool will appear with OMSI 2's main menu. It may get hidden by this - in which case you should press Start on your keyboard to bring up the taskbar, then locate the tool there.

You are not required to run OMSI 2 as administrator for this tool to work.


User Interface
Features

  • Compatibility with OMSI 2 v2.2.032 ("Tram compatible" patch) and v2.3.004 (latest version)

  • Toggle overriding of the FoV (Field-of-View) of the Free Map (F4) Camera to a custom value (1.0-150.0°)

  • Works when multiple instances of OMSI 2 are running (don't ask why, it just works™)

  • Can be injected into Omsi.exe (in the main menu - saves relaunching OMSI if you forgot to install - can take up to 10 mins on larger installs)


Main Program



  1. Toggle pinning of the tool's UI above all other windows, including OMSI ("always on top")

  2. Toggle overriding of the Free Map (F4) Camera's FOV Value (°) in OMSI. *

  3. Decimal representation of the FOV. You can set custom values (up to 1 d.p.) here. *

  4. Buttons to increment or decrement the FOV by 1 degree (°) *

  5. Smooth slider to fine-tune the FOV. You may press the left/right arrow or Page Up/Down keys on your keyboard (with this control focused) to increment or decrement the FOV by 0.1 and 0.5 degrees respectively. *

  6. Link to this tool's YouTube Tutorial.

  7. Link to this tool's Steam Guide (here).

  8. Link to this tool's source code repository on Github.

  9. Link to a full list of individuals & products who were helpful in the creation of this tool.

* This control will be disabled until a map is loaded.

Minimising the tool will send it to the taskbar (not the notification tray) and closing it will reset the FOV of the Free Map (F4) Camera to default (45.0°)


General keyboard binds

Key
Effect
Availability
TAB ⭾
Infinitely cycles keyboard focus from GUI control 1 to 10.
Only whilst the tool's GUI is the current focused window.

Suggested usage & examples
How to use this tool to take better screenshots

This is best shown with a video. Click below to open this section of the YouTube Tutorial
(skip to 1:54 - Steam doesn't support timestamped YouTube embeds):



Example screenshots

Here are several screenshots I took using this method. Please note these were taken while I was using my own ReShade preset, so your results may look different, but the camera angles, FOV, etc can be the exact same.

Alt-Text

Alt-Text

Alt-Text

Alt-Text

Alt-Text

Alt-Text

Alt-Text

Alt-Text

Alt-Text

Alt-Text

Alt-Text

Alt-Text

Uninstallation
If you would no longer like to use OMSI Presentation Tools, follow the instructions below to remove it:

  1. Open Steam.

  2. Hover your cursor over the Library tab in the top left, then click on Home.

  3. Right click on the OMSI 2 entry in the games list on the left.

  4. Click on Properties....

  5. Click on the Local Files option on the left.

  6. Click on Browse.... A File Explorer / Windows Explorer window will appear.

  7. Open the plugins folder.

  8. Delete all files with the name OMSIPresentationTools.

You have now successfully uninstalled OMSI Presentation Tools for OMSI 2 and can launch the game.

Frequently Asked Questions
Q: The Visual C++ Redistributable website isn't an official Microsoft website - is it safe?
A: This is a highly trusted and well known website. If you've used most desktop apps you will have already installed these, however it's possible you may have a specific one missing. This all in one package saves all the hassle of searching for the right one on the Microsoft website and solves the problem once and for all for all C++ applications.

Q: Which versions of OMSI 2 is this tool compatible with?
A: The tool is compatible with OMSI 2 v2.2.032 ("Tram compatible" patch) and v2.3.004 (latest version)

Q: Does this tool negatively impact OMSI 2's performance?
A: No, not at all. There are zero performance implications; it is just like adding a new timer variable to an OMSI 2 bus script (v0.1.0 Alpha). Most buses will already have several of these. The tool is also run under a separate thread and not tied directly to OMSI's plugin system, which does not appear to be thread-safe.

Q: How can I change the height of the Free Map (F4) Camera more easily?
A: Refer to the "Suggested Usage" section of the YouTube Tutorial. In future, a free look camera will be implemented to eliminate this difficulty completely.

Q: Why did you release this tool so early with only one feature (v0.1.0 Alpha)
A: This feature alone took me 3-4 months to implement. When I started I had zero reverse engineering experience.
A: Memory modification is not simple and can be risky. Each feature has to be heavily tested and must consider all edge cases and possibilities.
A: As well as this, I am a full time University student and have scarce amounts of free time. It would be several months until I could release properly polished additional features.
A: Overall, this is still much better than nothing in my opinion and offers more flexibility than before :)

For code-level FAQs, please see here.

Additional Information & Credits
Updating

If you already have a previous version of this tool installed, simply follow the instructions of the "Installation" section above as normal to install / update to the latest version.

If you are updating this tool be sure to check the list of changes of the "Changelog of updates" section below incase there is a "WARNING" or "NOTE" you should be aware of.


Support & input

If you have a technical issue or feature suggestion, please open an issue on Github and fill out the appropriate template.

Please do not use any other means of contact for support (e.g., adding me as a friend on Steam then messaging me privately).


Planned features (hopefully)

  • Ability to toggle overriding of the FOV, angles, positioning & (probably not) roll of all cameras

  • Ability to save modified camera attributes to *.bus & *.ovh files

  • Ability to use the F4 camera as a free-roam/look camera

  • Ability to define pre-defined camera movement sequences (HLAE-like) in text format

  • Ability to toggle overriding of bus presentation variables such as dirt, wetness, physics/roll etc

  • Ability to adjust the Z height of the bus's pseudo shadow (`[isshadow]` mesh in the model configuration file)

  • Ability to toggle overriding of `[viewpoint]` model configuration file tags, to allow meshes to draw in any camera mode (F1/F2/F3/F4)

  • Ability to speedhack (slow/fast) the game - Cheat Engine's speedhack does not work properly with OMSI 2

  • Ability to spawn several morphable & movable chromakeys & toggle between red, blue & green colours

  • (Likely never) TrackIR integration for any free roam camera, if achieved


Credits

sjain - Creation of this tool, it's Steam Guide (here) & YouTube Video

Additional credits can be viewed here

For YouTube Video speciifc acknowledgements, please refer to the description of the YouTube video.


Copyright & Licensing

Copyright © 2021 sjain882. All rights reserved.
For use with MR-Software GbR's OMSI 2 - Der Omnibus Simulator only.
All images and logos remain property of their respective owners.

This software, OMSI Presentation Tools, is licensed under the GNU General Public License v3.0.

You may copy, distribute and modify the software as long as you track changes/dates in source files. Any modifications to or software including (via compiler) GPL-licensed code must also be made available under the GPL along with install instructions.

You may not re-distribute this software unless given permission by the author.

Contact details of the author, sjain882, are listed in the Credits section here.

Please see the LICENSE.txt text file for full details.

If you cannot agree to the above terms and conditions, please delete this software immediately. Ignorance of these terms and conditions is not an excuse for breach!


Changelog of updates

Please refer to the Github Releases page.



1 条留言
CosmiC 2022 年 1 月 31 日 下午 2:14 
saves a lot more time over the invisible bus method I was using before, thank you for making this ! :steamthumbsup: