Viewing a Texture or Model

How to view a specific model and / or texture in Oolite.

If the ship you want to view is your player ship simply launch the ship and press v to cycle through the external views. Otherwise ...

Install Debug.oxp

 Installing Debug.oxp 

 1. Add Debug.oxp to your Oolite Addons [1] 
 2. Install PyDebugConsole [2] 

Run Oolite with the DebugConsole

 1. Run the DebugConsole 
 2. Start Oolite (holding down the shift key while it boots if an oxp has been changed
    (holding down shift clears the cache))
 3. Launch into space (moving into a clear area helps). 

Spawning the ship you want to view

Type in the console
 :spawn role
where role is the parameter to be passed to the :spawn macro. 

To find the correct argument for role refer to [i.e. open in a text editor]
  config\shipdata.plist 

   Find the entry for the ship in question in the shipdata.plist. [we'll call it shipX]

      <key>shipX</key> 
   Find the defined roles
      <key>roles</key> 
   Use one of the defined roles as the argument for :spawn [found between <string></string>]
      <key>shipX</key> 
      <dict> 
      ... 
      <key>roles</key> 
      <string>shipX-trader shipX-escort shipX-hunter</string> 
      ... 
      </dict> 
   yields
      :spawn shipX-trader 
   in the console. 

   If all the defined roles are generic* modify the shipdata.plist from:
      <key>shipX</key> 
      <dict> 
      ... 
      <key>roles</key> 
      <string>trader escort hunter</string>
      ... 
      </dict> 

   to

      <key>shipX</key> 
      <dict> 
      ... 
      <key>roles</key> 
      <string>shipX-trader trader escort hunter</string> 
      ... 
      </dict> 

[* If the defined roles are only generic e.g trader|pirate|hunter|etc then a random ship fulfilling the role will be spawned. Not necessarily the one you wanted.]

[Make sure to use a text editor suitable for programming. One that doesn't change the encoding or add junk to the file. EOL=LF+CR]

To park the spawned ship target it then enter in the console:

 player.ship.target.setAI("dumbAI.plist")

To manipulate sub entities (if the ship has any) use the command: Code:

 player.ship.target.subEntities[0].position = [x, y, z]