Difference between revisions of "OXPConfig"

From Elite Wiki
m (Handling: spelling corrections)
(Relevant OXPs: Added another)
(42 intermediate revisions by 7 users not shown)
Line 1: Line 1:
 +
Tweak your oxp's while in-game!
 
[[Image:OXPConfig_logo.png|150px|right]]
 
[[Image:OXPConfig_logo.png|150px|right]]
 +
[[File:OXPConfig (Entry).png|thumb|right|500px|Game Options screen (Entry to OXPConfig): note orange text in bottom left]]
 +
[[File:OXPConfig (top level).png|thumb|right|500px|Top level of OXPConfig (once 7 or F7 has been pressed)]]
 +
[[File:OXPConfig (config Illegal Goods Tweak).png|thumb|right|500px|Example: Config Screen for Illegal Goods Tweak OXP]]
 +
[[File:OXPConfig (config LaveAcademy).png|thumb|right|500px|Example: Config Screen for Lave Academy OXP]]
 +
 +
 
==Overview==
 
==Overview==
This tool gives you the ability to configure several OXPs. It changes settings to enable (or disable) logging or audio functions
+
{{OXPNote|This AddOn is deprecated. Please use [[Library OXP|Library]] for new AddOns. It is, however, more [[immersion|immersive]] than that Library OXP}}
and special settings to reckognize errors or to avoid clashes or to adjust numbers of planets/moons, etc. OXPs can use it
+
This tool gives you the ability to configure several OXPs. It changes settings to enable (or disable) logging or audio functions, and special settings to recognize errors or to avoid clashes, or to adjust numbers of planets/moons, ''etc''. OXPs can use it in a lot of ways and in most cases it only needs a few additional lines of code.
in a lot of ways and in most cases it only needs a few additional lines of code.
 
  
OXPConfig runs without the debug-console and is primarily meant for non-scripters (and lazy scripters), but if you really need debug-options it is highly recommended to install the Debug.oxp (written by Ahruman) and if necessary the console (written by Ahruman and ported to Windows by Kaks).
+
OXPConfig runs without the debug-console and is primarily meant for non-scripters (and lazy scripters), but if you really need debug-options it is highly recommended to install the Basic-debug.oxp (written by Ahruman) and if necessary the console (written by Ahruman and ported to Windows by Kaks).
 +
 
 +
* List of supported [[:Category:OXPConfig-compatible OXPs|OXPConfig-compatible OXPs]] - currently {{PAGESINCATEGORY:OXPConfig-compatible OXPs}}.
  
 
==Handling==
 
==Handling==
 
* Dock at a station,
 
* Dock at a station,
* open the Options Menu (F2),
+
* open the Options Menu Screen (2/F2),
* then step to the Game Options (where you can change Oolites options),
+
* then step to the '''Game Options''' (where you can change Oolite's options),
* wait till you get a message that OXPConfig is activated,
+
* wait until you get a message that OXPConfig is activated (bottom left corner of screen),
 
* and step directly to the SYSTEM DATA SCREEN (F7).
 
* and step directly to the SYSTEM DATA SCREEN (F7).
 +
* Modify settings and step to the main menu.
 +
 +
The changes have been applied to the OXPs, but nothing is stored yet. To do it:
 +
* Choose '''Store configuration'''.
 +
* Then exit OXPConfig and save the game as usual. If these two steps are skipped the changes remain temporary.
  
 
==Features==
 
==Features==
Line 23: Line 36:
 
* Early settings if OXPConfig has collected the data and flag is set.
 
* Early settings if OXPConfig has collected the data and flag is set.
 
* Notification for OXPs about changed settings if flag is set. Calls oxpcNotifyOnChange().
 
* Notification for OXPs about changed settings if flag is set. Calls oxpcNotifyOnChange().
 +
* User Definable Colors - for supporting OXPs.
 +
* Dump declared sounds - logs them to [[Latest.log]].
 +
* Dump missionVariables - logs them to [[Latest.log]].
 +
* Dump worldScript properties - logs them to [[Latest.log]].
 +
 +
==Requirements==
 +
* Latest version needs Oolite v1.77.
 +
* [[Cabal_Common_Library OXP|Cabal_Common_Library1.7]].
 +
 +
==Download==
 +
* [https://app.box.com/s/gbhv3wgxrpjen31h5n13aovgur5b3ffi OXPConfig2.3.4.zip]
 +
* Download in OXZ format [[Media:OxpConfig_2.3.4.oxz‎ |here]] for Oolite 1.79 or later (downloaded {{#downloads:OXPConfig_2.3.4.oxz}} times).
 +
 +
==Warning==
 +
[[XenonUI]] may interfere with the '''Search via Keyboard''' option
 +
 +
== Immersion ==
 +
Faffing about with OXP configuration is anti-immersive (but see [[Station Options]]). This configuration OXP pops up only outside the game (right at the start before you select your game persona or if you have paused gameplay and have selected Game Options). The Library configuration is available while docked, and is utterly unrealistic, even if it is more adaptable.
 +
 +
<!--* Mirror -> [https://app.dropbox.com/s/wlocyoab95bhlj6/OXPConfig2.2.4.zip OXPConfig2.2.4.zip] - (97.2 KB)-->
 +
 +
 +
For Oolite v1.76.1:
 +
* [http://deephorizonindustries.com/Downloads/OXPConfig2.0.14.zip OXPConfig2.0.14.zip] - (97.2 KB)
  
==Configuration==
 
{{OXPConfig-small}}
 
OXPConfig can be configured like the other oxps:
 
* '''logging''': en/disables the extended logging in OXPConfig.
 
* '''logEarly''': en/disables the logging of OXPs which have set the EarlyCall flag.
 
* '''displayAll''': en/disables collecting data from all OXPs which are declaring oxpcSettings.
 
* '''collectAll''': en/disables collecting of data from all worldScripts.
 
  
 
More infos are available in the [[OXPConfig_Doc|OXPConfig Documentation]].
 
More infos are available in the [[OXPConfig_Doc|OXPConfig Documentation]].
  
==Requirements==
+
== Relevant OXPs ==
* Oolite v1.76.
+
''If you go back, OXP Config eventually configured the following:''
* [[Cabal_Common_Library|Cabal_Common_Library1.5]]
+
*OXPConfig itself
 
+
*[[BGS]]
==Download==
+
*[[BlOomberg Markets]]
* [http://www.box.com/shared/h8dz74u39m OXPConfig2.0.7.zip] - (37.3 KB)
+
*[[BuoyRepair]]
 +
*[[Deep Horizon Advanced Navigation Computer]]
 +
*[[Deep Horizon]] Systems
 +
*[[Explorers' Club OXP]]
 +
*[[Famous Planets OXP]]
 +
*[[Friend or Foe]]
 +
*[[Fuel Station OXP]]
 +
*[[Furball OXP]]
 +
*[[Hyperradio js OXP]]
 +
*[[Illegal Goods Tweak OXP]]
 +
*[[Jaguar Company]]
 +
*[[Lave Academy OXP]]
 +
*[[Localhero OXP]]
 +
*[http://aegidian.org/bb/viewtopic.php?f=4&t=5618 OXPShipRegulator]
 +
*[[Safe Docking]]
 +
*[http://aegidian.org/bb/viewtopic.php?p=58579#p58579 ScriptTimer]
 +
*[[ShieldCycler]]
 +
*[[Skilled NPCs OXP]]
 +
*[[Snoopers]]
 +
*[[System Redux (Oolite)]]
 +
*[[Thargoid Witchspace Drive]]
 +
*[[Vector OXP]]
 +
*[[Welcome Mat OXP]]
  
 
==Quick Facts==
 
==Quick Facts==
{{OXPLevel|0}}{{Infobox OXPb| title = OXPConfig
+
{{OXPLevel|0}}{{IconOXP
|image = [[Image:OXPConfig_logo.png|150px]]
+
|ooVersion = "1.77"
|version = 2.0.7
+
|oxpCPU = "Medium"
|release = 2012-01-13
+
|oxpMEM = "Average"
 +
|oxpGPU = "Low"
 +
|oxpIsParent = true
 +
|oxpIsChild = true
 +
|oxpIsAPI = true
 +
|oxpIsDocumented = true
 +
|oxpIsConfigurable = true
 +
}}
 +
{{Infobox OXPb| title = OXPConfig
 +
|version = 2.3.3
 +
|release = 2015-06-03
 
|license = CC-by-nc-sa-3.0
 
|license = CC-by-nc-sa-3.0
 
|features = Config
 
|features = Config
 
|category = Misc OXPs
 
|category = Misc OXPs
|author = Svengali
+
|author = Svengali, Lone_Wolf
|download = [[#Download|See Download]]
 
 
|feedback = [http://aegidian.org/bb/viewtopic.php?f=4&t=4908 BB-Link]
 
|feedback = [http://aegidian.org/bb/viewtopic.php?f=4&t=4908 BB-Link]
 
}}
 
}}
 +
 +
{{Required OXP|Cabal Common Library}}
  
 
[[Category:Oolite utilities]]
 
[[Category:Oolite utilities]]
 +
[[Category:OXPConfig-compatible OXPs]]
 +
[[Category:Deprecated OXPs]]

Revision as of 10:46, 25 September 2022

Tweak your oxp's while in-game!

OXPConfig logo.png
Game Options screen (Entry to OXPConfig): note orange text in bottom left
Top level of OXPConfig (once 7 or F7 has been pressed)
Example: Config Screen for Illegal Goods Tweak OXP
Example: Config Screen for Lave Academy OXP


Overview

This tool gives you the ability to configure several OXPs. It changes settings to enable (or disable) logging or audio functions, and special settings to recognize errors or to avoid clashes, or to adjust numbers of planets/moons, etc. OXPs can use it in a lot of ways and in most cases it only needs a few additional lines of code.

OXPConfig runs without the debug-console and is primarily meant for non-scripters (and lazy scripters), but if you really need debug-options it is highly recommended to install the Basic-debug.oxp (written by Ahruman) and if necessary the console (written by Ahruman and ported to Windows by Kaks).

Handling

  • Dock at a station,
  • open the Options Menu Screen (2/F2),
  • then step to the Game Options (where you can change Oolite's options),
  • wait until you get a message that OXPConfig is activated (bottom left corner of screen),
  • and step directly to the SYSTEM DATA SCREEN (F7).
  • Modify settings and step to the main menu.

The changes have been applied to the OXPs, but nothing is stored yet. To do it:

  • Choose Store configuration.
  • Then exit OXPConfig and save the game as usual. If these two steps are skipped the changes remain temporary.

Features

  • Loading, storing and resetting to defaults of configurations.
  • 4 booleans.
  • 4 short unsigned integers (0xff).
  • 1 unsigned 24Bit integer (0xffffff) that is used as bitmask e.g. to en/disable appearance of entities.
  • Minimum version checks.
  • Early calls of OXPs startUp function if flag is set.
  • Early settings if OXPConfig has collected the data and flag is set.
  • Notification for OXPs about changed settings if flag is set. Calls oxpcNotifyOnChange().
  • User Definable Colors - for supporting OXPs.
  • Dump declared sounds - logs them to Latest.log.
  • Dump missionVariables - logs them to Latest.log.
  • Dump worldScript properties - logs them to Latest.log.

Requirements

Download

Warning

XenonUI may interfere with the Search via Keyboard option

Immersion

Faffing about with OXP configuration is anti-immersive (but see Station Options). This configuration OXP pops up only outside the game (right at the start before you select your game persona or if you have paused gameplay and have selected Game Options). The Library configuration is available while docked, and is utterly unrealistic, even if it is more adaptable.


For Oolite v1.76.1:


More infos are available in the OXPConfig Documentation.

Relevant OXPs

If you go back, OXP Config eventually configured the following:

Quick Facts

Levelindicator0.png
0-{{{2}}}

Minimum Oolite versionCPU usage mediumMemory usage averageGPU usage lowisParentisChildisAPIisDocumentedisConfigurable

Version Released License Features Category Author(s) Feedback
2.3.3 2015-06-03 CC-by-nc-sa-3.0 Config Misc OXPs Svengali, Lone_Wolf BB-Link