Difference between revisions of "OXPConfig"

From Elite Wiki
m (new version)
m (Added deprecated flag)
 
(56 intermediate revisions by 8 users not shown)
Line 1: Line 1:
−
<!-- [[Image: OXPConfig_compatible.png|140px|thumb|This sign shows that a oxp is configurable by OXPConfig]] -->
  
  +
[[Image:OXPConfig_logo.png|150px|right]]
−
[[Image:OXPConfig_compatible80px.png|140px|frame|This sign shows that a oxp is configurable by OXPConfig]]
  
  +
==Overview==
  +
{{OXPNote|This AddOn is deprecated. Please use [[Library]] for new AddOns}}
  +
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.
   
−
===STORY===
  
  +
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).
−
'''''Ouch, that is weird! Why doesn't it work? What the heck...!?!'''''
  
   
−
Have you ever seen such comments about oxps? But not always it is an error in this particular oxp. Very often it happens that several oxps are trying to do their business at the same time (e.g. displaying a missionscreen or playing a music- or soundfile). Usually the last oxp overrides the other commands and everything is fine. But not always and then very strange things can happen.
  
  +
* List of supported [[:Category:OXPConfig-compatible OXPs|OXPConfig-compatible OXPs]] - currently {{PAGESINCATEGORY:OXPConfig-compatible OXPs}}.
   
−
For a user the only chance to avoid it is to remove oxps from the AddOns folder, but this is not a very elegant way to handle this. And with nearly 200 oxps out there it is a timeintensive task, sorting them, moving them in and out - every day. Again and again. And before [[User:Eric_Walch|Eric Walchs]] [[OXP_mission_offering|solution for the missionscreen-handling]] the potential for clashes was immense, but there are still a few oxps that need some tweaks to avoid this problem. And there are more possible clashes. Music- and soundfiles can collide, even complete missions can get broken and the user will never be able to finish them. That's why I wrote OXPConfig. A small tool to help scripters and users, because it gives everybody the ability to enable/disable special features of oxps (like the enhanced logging) that are supporting this.
  
  +
==Handling==
  +
* Dock at a station,
  +
* open the Options Menu (F2),
  +
* then step to the Game Options (where you can change Oolites options),
  +
* wait till you get a message that OXPConfig is activated,
  +
* and step directly to the SYSTEM DATA SCREEN (F7).
  +
* Modify settings and step to the main menue.
   
−
And with a detailed logfile it will be a lot easier to see what happened... ...and to fix it. The BulletinBoard is always the best place to report problems with oxps and there are a lot of helpful and experienced oxp'er (not to mention the development team) ready to stick their nose into your problem. So every bit of information can help to recognize the weak points and before you'll post it there, collect all necessary data (OS, OS-version, Oolite version, Latest.log, stderr.txt). A few oxps are already supporting enhanced logging features [[BuoyRepair]], [[Famous_Planets_OXP|Famous_Planets]], [[Fuel_Station_OXP]], [[Hyperradio_js_OXP|Hyperradio]], [[Lave_Academy_OXP|Lave Academy]], [[Localhero_OXP|Localhero]], [[OXPConfig]], [[ScriptTimer]], [[Vector_OXP|Vector]] and [[Welcome_Mat_OXP|Welcome Mat]] and I hope that more oxps will use this way in future releases to be included into the database.
  
  +
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 are temporary.
   
−
===FEATURES===
 +
==Features==
−
* Storing and loading of configurations
 +
* Loading, storing and resetting to defaults of configurations.
−
* Automatic loading when Oolite is started (configurable)
 +
* 4 booleans.
−
* Selective loading of changed oxps (configurable)
 +
* 4 short unsigned integers (0xff).
−
* Default configuration is stored and can be reloaded
 +
* 1 unsigned 24Bit integer (0xffffff) that is used as bitmask e.g. to en/disable appearance of entities.
−
* Internal logging (configurable)
 +
* 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.
   
−
===OVERVIEW===
  
  +
==Requirements==
−
This tool gives you the ability to configure several oxps. It changes internal (local) settings of the oxps to enable (or disable) logging or audio functions and special settings to recognize errors or to avoid clashes, but it is for sure no cheat-tool. The oxps have to support these functions too - to be implemented in the database - so not every oxp can be included.
  
  +
* Latest version needs Oolite v1.77.
−
This oxp 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|Debug.oxp]] (written by [[User:Ahruman|Ahruman]]) and if necessary the console (written by [[User:Ahruman|Ahruman]] and ported to Windows by [[User:Kaks|Kaks]]). Compatible oxps can use this sign to show that they can be configured by OXPConfig.
  
  +
* [[Cabal_Common_Library|Cabal_Common_Library1.7]].
   
−
The handling is simple:
  
  +
==Download==
−
* Dock at a main station
  
  +
* [https://app.box.com/s/gbhv3wgxrpjen31h5n13aovgur5b3ffi OXPConfig2.3.4.zip]
−
* Open the Options-Menue (F2)
  
  +
* 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).
−
* Step to the Gameoptions (where Oolites options resides). Wait till activation message comes
  
−
* Step directly to the SYSTEM_DATA_SCREEN (F7)
  
−
* Do your settings and store them if you've changed something (in OXPConfig and save your game in the usual way)
  
−
* To deactivate it - step to any other screen (you'll get a message)
  
   
−
===REQUIREMENTS===
  
  +
<!--* Mirror -> [https://www.dropbox.com/s/wlocyoab95bhlj6/OXPConfig2.2.4.zip OXPConfig2.2.4.zip] - (97.2 KB)-->
−
Oolite v1.73 - No other [[OXP]] necessary - put in what you like.
  
−
A new version is already in development.
  
   
−
===DOWNLOAD===
  
−
[http://www.box.net/shared/t6z6mbsuzc OXPConfig1.08.zip] - (11KB) Updated 04/09/2009.
  
   
−
{{unclassified-OXP}} [[Category:Oolite utilities]][[Category:OXPConfig-compatible OXPs]]
  
  +
For Oolite v1.76.1:
  +
* [http://deephorizonindustries.com/Downloads/OXPConfig2.0.14.zip OXPConfig2.0.14.zip] - (97.2 KB)
  +
  +
  +
More infos are available in the [[OXPConfig_Doc|OXPConfig Documentation]].
  +
  +
==Quick Facts==
  +
{{OXPLevel|0}}{{IconOXP
  +
|ooVersion = "1.77"
  +
|oxpCPU = "Medium"
  +
|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
  +
|features = Config
  +
|category = Misc OXPs
  +
|author = Svengali, Lone_Wolf
  +
|feedback = [http://aegidian.org/bb/viewtopic.php?f=4&t=4908 BB-Link]
  +
}}
  +
  +
{{Required OXP|Cabal Common Library}}
  +
  +
[[Category:Oolite utilities]]
  +
[[Category:OXPConfig-compatible OXPs]]
  +
[[Category:Deprecated OXPs]]

Latest revision as of 22:24, 24 February 2018

OXPConfig logo.png

Overview

Mr Gimlet.png

Please note:   This AddOn is deprecated. Please use Library for new AddOns.

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 (F2),
  • then step to the Game Options (where you can change Oolites options),
  • wait till you get a message that OXPConfig is activated,
  • and step directly to the SYSTEM DATA SCREEN (F7).
  • Modify settings and step to the main menue.

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 are 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


For Oolite v1.76.1:


More infos are available in the OXPConfig Documentation.

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
Retrieved from "http://backup.witchspacewiki.org/index.php?title=OXPConfig&oldid=57023"