Library OXP

From Elite Wiki
Revision as of 08:51, 3 August 2022 by Cholmondely (talk | contribs) (Added details of Config for AddOns)

This page is about the OXP helper expansion pack, Library, for other uses, see Library (disambiguation).

IconLib.png
Animator
PAD: GalCop
PAD: Persons
PAD: Player data
Starmap
Config for AddOns (List of OXPs with settings)
Config for AddOns (example: BGS flags settings)
Flags are On/Off options, Values give a numerical range. (Old Hyperspace is added by Tsoj's newest version of BGS)
Config for AddOns (example: BGS values settings)
Values (D is the default setting, R shows the range)

Overview

Reinventing the wheel is not everybody's taste, so here comes a collection of useful snippets and helpers. Its main purpose is to simplify or unify some common tasks used by OXPers. Library is the successor to CCL, Hyperradio and OXPConfig. The library does not alter any native JS objects (like Array or String) to avoid clashes and does not clutter the global namespace.

This oxp also adds the following items to the F4 ship-station interface page

  • Config for AddOns (AddOns category) - for tweaking OXPs (see BGS for an example).
  • PAD (Captain's Log category) - a personal assistance device with details of naval career, people met, etc.
The P.A.D. (or Personal Assistance Device) ships functionality to display different sorts of data, sorted by categories. Every category may contain several pages (or subcategories) - which can also be implemented by AddOns. Currently there are categories for
GALCOP: A standard entry, but after doing specific jobs it will contain an entry for the Navy as well. Other AddOns may add more.
GUILDS: An empty entry at the moment. Could be used e.g. by RandomHits, Feudal States and other AddOns which do have a membership.
INFOS: A category for special events, news, etc. Could be useful e.g. for BloombergMarkets, etc.
LOGBOOK: A category for standard events like rescued escape pods, bailed out, fined, etc. Could be used for contracts as well.
PERSONS: A category for characters you have met.
SYSTEMS: A category for special systems like Tianve, Tionisla, etc.
SEARCH
PLAYER DATA
The PAD also ships with search functionality and some categories do allow the player to add custom notes. The display of these pages is based on templates, so all pages in a category will have the same layout. AddOns can add data easily to existing pages or add a new page in existing categories. Another feature is to set player specific data, like origin, species, gender, age and a custom picture.
Note: there are currently several oxp's that allow for configuring other oxp's:
*Library (the most recent, done via the F4 page when docked) by Svengali
*OXPConfig (done via the F2 page - press F7 when told to) by Svengali
*Station Options by cag: this one is comprehensible! But the fabulous flood of detail for Telescope...

Features

For Documentation just follow the links.

  • Lib_2DCollision.js - Methods for checking if point is in bounding-box, on line or in poly.
  • Lib_Animator.js - Tool to create animations on missionscreens (see Demos).
  • Lib_BinSearch.js - Instantiated search tree.
  • Lib_Config.js - Configuration interface for AddOns.
  • Lib_Crypt.js - De-/Encryption for strings.
  • Lib_GUI.js - Unified GUI image, sound and music handling.
  • Lib_Main.js - Generic functions for various tasks.
  • Lib_Music.js - Unified event driven and generic music handling (see Demos).
  • Lib_PAD.js - Unified logbook, mission-log, diary and interface. Added in v1.7
  • Lib_Starmap.js - In-System-Maps in 3D (docked and inflight) (see Demos). Added in v1.7

ID

identifier = "oolite.oxp.Svengali.Library";

Requirements

  • Latest version needs Oolite v1.88.

Download

Install like any other OXP.

Music

Library can introduce music (as well as sound effects). For a full list of all such OXP's see Category:Sound Sets OXPs

Music for playing the game to (these three need Library to function):

Demos

Install like any other OXP.

Tools

There are two tools tucked away in diverse locations:

  • 1) Lib_MatFinder 1.1 (oxz, 39.7 KB) - A developer-tool to work out materials entries.
See MatFinder for more detail (culled from BB and put in order)
See here for original BB description. (2 pages, 2018).
Once you load the .oxp, see your F4 screen (if you have Library.oxp running too) under "Developer" to access this tool.

Lib MatFinder Pos01.png Lib MatFinder Pos02.png Lib MatFinder.png


On starting a game (if you have Library running too):

Library devtools switches.png Library devtools.png Library devtools.values.png

On your F4 screen (if you have Library running too) under "Lib_MatEditor":

Lib MatEditor (1).png Lib MatEditor (2).png



Tweaks

Quick Facts

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

Minimum Oolite versionCPU usage mediumMemory usage averageGPU usage averageisParentisAPIisDocumentedisConfigurable

Version Released License Features Category Author(s) Feedback
1.7.1 2018-11-19 CC-by-nc-sa-4.0 Helper for OXPs Misc OXPs BlackWolf & Svengali BB-Link