Skip to content

Mihara/RasterPropMonitor

Repository files navigation

RasterPropMonitor

To view this document with formatting, refer to https://github.com/Mihara/RasterPropMonitor/blob/master/README.md

RasterPropMonitor (RPM) is a toolkit and plugin that provides drastically-increased functionality to the IVA mode in Kerbal Space Program. Using RPM-enabled props, a player can control almost any aspect of spacecraft or spaceplane operations.

RPM can interface with some mods, incorporating those mods' behaviors seamlessly into the RPM IVA. A list of actively supported and known working mods is available in the release notes.

Included in the RPM distribution are example props for use in enhancing the IVA experience. Most of these props were created by using stock KSP prop models. There is also an MFD model by alexustas for use in glass cockpit designs.

The RPM distribution also contains configuration files for Module Manager that will override some of the stock IVAs with the example props to give you an idea of what is possible with RPM.

However, ModuleManager is not part of this distribution. You must install it separately.

NOTE: This mod by itself is not intended to be a comprehensive IVA experience. While basic IVAs are included, they are intended to be examples of what is possible. Because creating a good IVA takes a significant amount of time (I've put more than 80 hours into each of the IVAs I've made), these example IVAs are not frequently updated, and they only scratch the surface of what can be accomplished using RasterPropMonitor.

INSTALLATION INSTRUCTIONS:

Extract the contents of the GameData folder in the RPM zip file into the GameData folder of your KSP install. You should see the following folder structure:

GameData |
         + JSI |
               + Agencies
               + RasterPropMonitor
               + RPMPodPatches

If you do not see GameData/JSI, you have installed this mod incorrectly, and it shall misbehave (missing props, other things not working right).

If you have JSIAdvTransparentPods installed, you will see it next to RasterPropMonitor in your file list.

If you used CKAN to install this mod, check the file structure. CKAN has installed this mod incorrectly in the past. If CKAN installed it incorrectly, remove this mod and install it manually. I do not provide support for CKAN installations.

If the plugin was listed as a dependency by some other mod author, and you do not want to use the modified stock interiors included in this package, the JSI/RPMPodPatches directory may be safely deleted. Every capsule being modified has its own pair of patch config files -- you can safely delete only those you don't want.

UPGRADING FROM OLDER VERSIONS:

As a general rule, you should delete any existing installation (just don't accidentally delete JSIAdvTransparentPods if you are using that mod, too). v0.26.1 removed JSITransparentPod and its corresponding JSINonTransparentPod. Contact the makers of the transparent pods to ask them to upgrade to use JSIAdvTransparentPods.

JSIAdvTransparentPods is a separate mod created by JPLRepo. It can be found on GitHub at https://github.com/JPLRepo/JSIAdvTransparentPods and on the KSP forum.

CONFIGURATION

Out of the box, RasterPropMonitor ships with default configuration settings. The configuration file is installed to GameData/JSI/RasterPropMonitor/Plugins/PluginData/rpm-config.cfg

The config file settings are:

  • DebugLogging - False by default. Setting this to True will vastly increase the amount of information that RasterPropMonitor writes to KSP's log file. You should only need to change this for support purposes.
  • ShowCallCount - False by default. Primarily intended for IVA makers to collect information on what impact their IVA has on performance. Should not need to be set True except for collecting this info. DebugLogging must also be set True for the call count to be logged.
  • DefaultRefreshRate - 5 by default. Defines how many Update calls must elapse before RPM will update its variables. One Update occurs every screen refresh, so if KSP is running at 60fps, the default refresh rate of 5 means that variables will update roughly 12 times per second. Note that props may override this value by making it smaller, but never by making it larger.
  • MinimumRefreshRate - 1 by default. Defines what the minimum value for the refresh rate may be. Lower-spec computers may benefit by setting this value higher than 1. It must not be larger than DefaultRefreshRate. Large minimum values will cause some animations and updates to stutter, instead of moving smoothly.

MOAR IVAs?

If the basic IVA experience included in this package is not enough, take a look at some of these:

Take a look around the forum, and you'll find other mods with RasterPropMonitor IVAs.

Even MOAR IVAs!

Maybe you want to try making your own IVA? You'll need to download Unity and KSP's PartTools (look on the forum for more information).

While you can use the props included with this distribution to make some basic IVAs, you really should use the following prop packs to make something exceptional:

  • ASET Avionics - primarily aircraft-oriented props.
  • ASET Props - a mix of spacecraft and spaceplane props, including several MFD designs as well as some classic NASA-style analog gauges.

LINKS

See the forum support thread for support.

See the dull^H^H^H^H full documentation in the wiki on GitHub.

For the latest release notes, please refer to the wiki at Changes in this version

Source code and full license information available at GitHub

LICENSES

RasterPropMonitor plugin (C) 2013-2018 Mihara, MOARdV, and other contributors.

Code and shaders are licensed under GPLv3. You should have received a copy of this license in this distribution package.

Props courtesy of alexustas and other contributors, available under the terms of CC 3.0 BY-NC-SA. Portions of this package are derived from stock textures by Squad and are distributed according to Squad policy of permitting to distribute stock assets with mods if required.

RasterPropMonitor includes the following fonts in its Asset Bundle. License / readme files for the first two are installed adjacent to the RasterPropMonitor DLL

Repetition Scrolling Font by Tepid Monkey Fonts.

Digital-7 by Sizenko Alexander Style-7.

InconsolataGo, released under the Open Font License.

Liberation Sans, released under the Open Font License.