Test Ship Model
A utility for testing models of ships/stations et cetera
Contents
Overview
This is a utility mod that allows you to quickly and easily view a ship model from the game. This utility uses features in Oolite 1.92
Use
When docked at a station, an F4 interface will be available, called "Test Ship Model". When you select this, you will be asked to enter the ship's data key to display. Enter that key, and press enter.
At this point, you will be shown the ship.
For Oolite 1.92
You can now use the arrow keys, the page up/dn keys, and the yaw keys ("," and ".") to rotate and zoom the ship. Pressing Ctrl plus the arrow keys will move the model in that direction. You can increase or decrease how far one keypress will move the ship by using the "+" and "-" keys. Pressing Ctrl and the "+" and "-" keys will change the step by a small amount.
"R" will reset the view back to the initial position, including resetting sub-entity positions.
"N" will return to the screen where a new ship data key can be entered. Previous ships you have viewed will be listed as well. Use a number to select one of those ship keys instead of entering another data key. The last 15 ships will be displayed, and the list will be saved with the save game settings.
"H" will hide the instructions, which will be displayed with the ship model. Pressing "H" again will bring the instructions back.
If the ship model uses the personality property to change the skin or colour of the ship, you can enter a personality number by pressing the number keys. As you do, the "New personality" item will show in the instructions. Once you have entered the desired number, press "P" to set the personality to this value.
Pressing ESC will return you to the F4 Interfaces screen.
For Oolite 1.90
Use the menu on the left side to rotate the ship, zoom in and out, change the step amount, and reset the view.
To switch between "Rotation" and "Movement" modes, select either "Rotation >" or "Movement >" at the top of the menu.
Sub-entities
If the model being viewed has sub-entities, it is possible to select and then move/rotate each individual sub-entity. Press "s" (or select the "Select subent" menu) to cycle through the available subentities. As each sub-entity is selected, the index and either the name or data key of the subentity will be shown.
In 1.92, use the Ctrl plus arrows keys and Ctrl + "," and "." to move the sub-entity, and use the arrow keys, "," and "." keys to rotate the sub-entity.
In 1.90, use the menu to rotate and move the sub-entity.
To see the updated definitions for all the sub-entities, press the "d" key (or select the "Dump subents" menu). This will write the updated sub-entity definitions to the log file.
Shortcut
In Oolite 1.92, you can also press Ctrl-T on the F5 Ship Status screen to jump directly to the Test Ship Model screen.
Extra Notes
- You can't display the model of anything with "is_template" set to yes/true/1. You would need the in-game version of the ship, ie. where "like_ship" has been set to the template key name.
- Also, if there is a condition_script on the shipdata entry, those conditions will need to pass to display the model. For instance, attempting to view ships from the Commies mod will require you to be in a Communist system.
And that's it, really. Nothing too fancy, but show-casing a bit of what we can now do with mission screens.
Requirements
Oolite 1.82 or later is required.
Download
- TestShipModel.oxz (v1.4)
License
This work is licensed under the Creative Commons Attribution-Noncommercial-Share Alike 4.0 Unported License. To view a copy of this license, visit http://creativecommons.org/licenses/by-nc-sa/4.0/
Version History
1.4
- Added ability to select a sub-entity and move/rotate it. Adjusted subentity information can then be output to the log file.
- Added ship name to displayed information.
- Added console messages to notify of some changes when instructions are hidden (Oolite 1.92 only).
- Added ability to change the step in small increments (Oolite 1.92 only).
- Improved integration with Library.
1.3
- Added ability to move the model up/down/left/right.
1.2
- Made compatible with Oolite version 1.90 (and back to 1.82 actually!).
- Added shortcut key to F5 Manifest screen (Ctrl-T) to open the test screen (available in Oolite 1.92 or later).
- The ship datakey is now shown at the top of the view model screen.
- Moved all text to descriptions.plist for easier localisation.
1.1
- Switched "allowInterrupt" to false.
- Added option to clear the data key history.
1.0
- initial release
