Library

Discussion and information relevant to creating special missions, new ships, skins etc.

Moderators: winston, another_commander

User avatar
phkb
Impressively Grand Sub-Admiral
Impressively Grand Sub-Admiral
Posts: 5319
Joined: Tue Jan 21, 2014 10:37 pm
Location: Writing more OXPs, because the world needs more OXPs.

Re: Library

Post by phkb »

Krager wrote: Tue Jun 10, 2025 11:12 pm
Чуть освобожусь постараюсь посмотреть в сторону консоли отладки. Не знаю как ей пользоваться, буду искать.
Get the debug console here: https://github.com/OoliteProject/oolite-debug-console/releases/tag/v2.14.205

You'll also need the "Deployment to Test release" found here for 1.90: https://github.com/OoliteProject/oolite/releases/download/1.90/Oolite-1.90_x64-Deployment-to-Test-Release.exe

If you're using 1.91, install this version of Oolite: https://github.com/OoliteProject/oolite/releases/download/1.91.0.7677-250528-09ed63a/OoliteInstall-1.91.0.7677-250528-09ed63a-win-test.exe

Either way, once you've got that installed and it's connecting successfully, I'll have a few commands for you to try.
User avatar
Krager
Dangerous
Dangerous
Posts: 123
Joined: Wed Dec 11, 2024 9:44 pm
Location: Russian

Re: Library

Post by Krager »

А вот ещё вопрос интересный. Почему `Svengali Library` конфликтует с `BGS-A v1.10.9` и `BetterScreens v1.2.1`
И чтобы использовать один из этих пакетов приходиться убирать Svengali Library.

А сама Svengali Library требуется для `BGS v2.5.4` и `XenonHUD v3.8.10`

Тут для удобства смены оформления лучше бы тогда вообще избавиться от `Svengali Library` которая у меня криво работает. Однако она нужна для более новой BGS v2.5.4. А ещё в ней находится модуль настройки дополнений... Так бы можно было для настройки дополнений использовать отдельное дополнение `OxpConfig 2.3.4` однако она у меня не работает.

В идеале подумать бы о внедрении возможности настройки дополнений в саму игру, ну или модуль нормальный рабочий сделать. А эти все BGS варианты отвязать от `Svengali Library` чтобы можно было менять оформление простой заменой файла. Ну и возможность ввода на руском языке ещё хочется)
User avatar
phkb
Impressively Grand Sub-Admiral
Impressively Grand Sub-Admiral
Posts: 5319
Joined: Tue Jan 21, 2014 10:37 pm
Location: Writing more OXPs, because the world needs more OXPs.

Re: Library

Post by phkb »

Krager wrote: Sat Jun 21, 2025 9:38 pm
А вот ещё вопрос интересный. Почему `Svengali Library` конфликтует с `BGS-A v1.10.9` и `BetterScreens v1.2.1`
И чтобы использовать один из этих пакетов приходиться убирать Svengali Library.

А сама Svengali Library требуется для `BGS v2.5.4` и `XenonHUD v3.8.10`
Library was the replacement oxp to OXP Config. Better Screens was never designed to work with Library, and so it remains incompatible with it. BGS-A v1.10 was updated to BGS v2, and so the only outstanding item here is that Better Screens was never made to be compatible with Library.

Library contains a much better way for GUI-style apps to work together without stepping on each other. So you can have BGS, and XenonUI installed at the same time, and decide which one you want to have visibility. This is a much better system to what we had before, which was basically a whole pile of incompatibilities.
Krager wrote: Sat Jun 21, 2025 9:38 pm
Тут для удобства смены оформления лучше бы тогда вообще избавиться от `Svengali Library` которая у меня криво работает. Однако она нужна для более новой BGS v2.5.4. А ещё в ней находится модуль настройки дополнений... Так бы можно было для настройки дополнений использовать отдельное дополнение `OxpConfig 2.3.4` однако она у меня не работает.
Well, you are free to do what you want with OXP's. But I would dispute the statement that Library "works crookedly". Yes, there is something going on in your environment that I can't replicate yet, but Library has been working successfully on a variety of OS's and installations for a number of years. It has massive improvements in what can be achieved for configuration, way beyond what OXP Config could ever do.

I get this is frustrating and time consuming, and doubly confusing as we're trying to debug code across language barriers. But we will get it all working, and without needing to throw out one of the best utility mods created for Oolite.
User avatar
Cholmondely
Archivist
Archivist
Posts: 6300
Joined: Tue Jul 07, 2020 11:00 am
Location: The Delightful Domains of His Most Britannic Majesty (industrial? agricultural? mainly anything?)
Contact:

Re: Library

Post by Cholmondely »

"Better Screens" GUI backgrounds are now included as an option in "Littlebear's Galactic Almanac".

"The Galactic Almanac" allows you to select a GUI background choice of BGS (new), XenonUI, and Better Screens. You cannot revert to the vanilla game.

"The Galactic Almanac" seems fine for both BGS (new) and Better Screens. For XenonUI, Phkb's "XenonUI.oxz" is more sophisticated and does more.
Comments wanted:
Missing OXPs? What do you think is missing?
Lore: The economics of ship building How many built for Aronar?
Lore: The Space Traders Flight Training Manual: Cowell & MgRath Do you agree with Redspear?
User avatar
Cholmondely
Archivist
Archivist
Posts: 6300
Joined: Tue Jul 07, 2020 11:00 am
Location: The Delightful Domains of His Most Britannic Majesty (industrial? agricultural? mainly anything?)
Contact:

Re: Library

Post by Cholmondely »

There is now a wiki page up for [EliteWiki] DevTools

I can't pretend to have any idea as to what this one is supposed to do.

1) Config for AddOns
There are 16 entries on the F4 Config for AddOns under Lib_ConfigTest:

Bool-B0-Empty setting
Bool-B0-No Def
Bool-B0-No Desc
Bool-B0-No Name
Bool-B0-null
Bool-Hide all
Bool notify
Bool-Ok
Nested <------ this is where your game opens up if you have DevTools & Library.oxp loaded
Path
Reference emptied
Reference type change
Removed reference object
SInt-Hid all
SInt-Notify
SInt-Ok
GUI-Config

Around half of these seem to be not working. Some are obscure, to put it mildly.

Image




2) F4 "Lib_MatEditor"

This allows you to select ship models and see something like this:

Image

"Flags" does nothing on my AppleMac
"Materials" drops you right into the Pool of Pellucid Perplexity:

Image


3) Latest.log

According to the Lib_PropertiesTestPlayer.js hidden inside the OXP, checks against the standard player Cobra Mk.III exists somewhere inside! There might also be checks for commodities.

One finds readouts such as this:
16:26:04.931 [Lib_PropertiesTestPlayer] GlobalLog (OOJSGlobal.m:266):
Mismatch: Value mismatch: false - expected: true property:docked in player.ship.docked,Value mismatch: FeudalStates_hud.plist - expected: hud.plist property:hud in player.ship.hud,Value mismatch: true - expected: false property:hudAllowsBigGui in player.ship.hudAllowsBigGui,Value mismatch: 0 - expected: 2 property:multiFunctionDisplays in player.ship.multiFunctionDisplays,Value mismatch: -0.20820949971675873 - expected: 0 property:roll in player.ship.roll,Value mismatch: VIEW_FORWARD - expected: VIEW_GUI_DISPLAY property:viewDirection in player.ship.viewDirection,Value mismatch: 2 - expected: 0 property:alertCondition in player.ship.alertCondition,Value mismatch: 175.00001525878906 - expected: 0 property:desiredSpeed in player.ship.desiredSpeed,Value mismatch: 27313 - expected: 28753 property:entityPersonality in player.ship.entityPersonality,Value mismatch: 1.90 - expected: 1.86 property:version in player.ship.script.version,Value mismatch: 175.00001525878906 - expected: 0 property:speed in player.ship.speed,Value mismatch: true - expected: false property:withinStationAegis in player.ship.withinStationAegis,Value mismatch: 72.69734954833984 - expected: 72.69734191894531 property:collisionRadius in player.ship.collisionRadius,Value mismatch: 446.2585144042969 - expected: 0 property:distanceTravelled in player.ship.distanceTravelled,Value mismatch: 214737.6875 - expected: 214737.703125 property:mass in player.ship.mass,Value mismatch: STATUS_IN_FLIGHT - expected: STATUS_DOCKED property:status in player.ship.status,Value mismatch: true - expected: false property:isInSpace in player.ship.isInSpace,Value mismatch: 2 - expected: 0 property:alertCondition in player.alertCondition,Value mismatch: true - expected: false property:alertMassLocked in player.alertMassLocked,
Value mismatch: DOCKING_CLEARANCE_STATUS_NONE - expected: DOCKING_CLEARANCE_STATUS_GRANTED
property:dockingClearanceStatus in player.dockingClearanceStatus

16:26:04.931 [Lib_PropertiesTestPlayer] GlobalLog (OOJSGlobal.m:266): Specials missing: missiles.0.calculatedPrice,missiles.1.calculatedPrice,missiles.2.calculatedPrice

16:26:04.931 [Lib_PropertiesTestPlayer] GlobalLog (OOJSGlobal.m:266): Specials info: Specials matched in missiles



Can anybody throw any light onto any of this?
Comments wanted:
Missing OXPs? What do you think is missing?
Lore: The economics of ship building How many built for Aronar?
Lore: The Space Traders Flight Training Manual: Cowell & MgRath Do you agree with Redspear?
User avatar
phkb
Impressively Grand Sub-Admiral
Impressively Grand Sub-Admiral
Posts: 5319
Joined: Tue Jan 21, 2014 10:37 pm
Location: Writing more OXPs, because the world needs more OXPs.

Re: Library

Post by phkb »

OK, I think I've got to all the text that could potentially need localisation. Here's Library_1.8.4.oxz. Once again, if a few people can give it a spin and let me know if you get any errors, that would be sweet. If there aren't any reports, I'll look to make this the official release next week.
User avatar
phkb
Impressively Grand Sub-Admiral
Impressively Grand Sub-Admiral
Posts: 5319
Joined: Tue Jan 21, 2014 10:37 pm
Location: Writing more OXPs, because the world needs more OXPs.

Re: Library

Post by phkb »

Cholmondely wrote: Sun Jun 22, 2025 5:27 am
"Better Screens" GUI backgrounds are now included as an option in "Littlebear's Galactic Almanac".

"The Galactic Almanac" allows you to select a GUI background choice of BGS (new), XenonUI, and Better Screens. You cannot revert to the vanilla game.

"The Galactic Almanac" seems fine for both BGS (new) and Better Screens. For XenonUI, Phkb's "XenonUI.oxz" is more sophisticated and does more.
For clarity, Galactic Almanac is only controlling the background for its own displays. It isn't somehow making "Better Screens" work with the Xenon UI or BGS in any other screen. It's just giving the user the option of which background to use inside the Almanac.
User avatar
Lone_Wolf
---- E L I T E ----
---- E L I T E ----
Posts: 570
Joined: Wed Aug 08, 2007 10:59 pm
Location: Netherlands

Re: Library

Post by Lone_Wolf »

Does someone know where the Personal Assistance Device looks for avatar pictures ?
OS : Arch Linux 64-bit - rolling release

OXPs : My user page

Retired, occasionally active
User avatar
Wildeblood
---- E L I T E ----
---- E L I T E ----
Posts: 2817
Joined: Sat Jun 11, 2011 6:07 am
Location: Nova Hollandia
Contact:

Re: Library

Post by Wildeblood »

Lone_Wolf wrote: Thu Jul 24, 2025 3:26 pm
Does someone know where the Personal Assistance Device looks for avatar pictures ?
There are only two possibilities: in the Images or Textures folders within Library.
"Must keep this response efficient to preserve remaining context."
User avatar
Cholmondely
Archivist
Archivist
Posts: 6300
Joined: Tue Jul 07, 2020 11:00 am
Location: The Delightful Domains of His Most Britannic Majesty (industrial? agricultural? mainly anything?)
Contact:

Re: Library

Post by Cholmondely »

Library.oxp > Textures > lib_avatar01.png - lib_avatar22.png
Comments wanted:
Missing OXPs? What do you think is missing?
Lore: The economics of ship building How many built for Aronar?
Lore: The Space Traders Flight Training Manual: Cowell & MgRath Do you agree with Redspear?
User avatar
Lone_Wolf
---- E L I T E ----
---- E L I T E ----
Posts: 570
Joined: Wed Aug 08, 2007 10:59 pm
Location: Netherlands

Re: Library

Post by Lone_Wolf »

That suggests I'll need to extract the oxz and move it to AddOns folder to be able to add custom avatar pics ?

Pity that when I do that the expansion manager can no longer be used to update the oxz.
OS : Arch Linux 64-bit - rolling release

OXPs : My user page

Retired, occasionally active
User avatar
Cholmondely
Archivist
Archivist
Posts: 6300
Joined: Tue Jul 07, 2020 11:00 am
Location: The Delightful Domains of His Most Britannic Majesty (industrial? agricultural? mainly anything?)
Contact:

Re: Library

Post by Cholmondely »

Lone_Wolf wrote: Fri Jul 25, 2025 9:10 am
That suggests I'll need to extract the oxz and move it to AddOns folder to be able to add custom avatar pics ?

Pity that when I do that the expansion manager can no longer be used to update the oxz.
Just update the version number in the manifest.plist and upload it as the new version (and why not bung in a few more images while you are at it? - most of the humans look like utter thugs to me!).


Library was totally untouched from 2018 until this year.

7 years.

Library is still not properly understood - we don't know how much of the functionality from Cabal Common Library is actually inside it:
There are also a number of abilities lurking in the precursor CCL which were probably inherited by Library.oxp:
Cabal_Common_Briefing, enhance mission screens (is this what the Library starmap and animator demos run on?)
Cabal_Common_Comms, inflight communication
Cabal_Common_Functions, generic function library
Cabal_Common_Keyboard, user input
Cabal_Common_MissionHandling, start OXPs based on system descriptions
Cabal_Common_Music, inflight event driven music (this is presumably what Arquebus's Contextual Jukebox runs on)
Cabal_Common_Overlay, inflight overlays
Cabal_Common_SpecialMarkets, trading special goods
Cabal_Common_Strength, environment control

somewhere in all this is a random integer function which is used by Factions OXP and is presumably still in Library somewhere... (like https://wiki.alioth.net/index.php/Cabal ... rand.28.29)


Most of the functionality is totally unused. It would be super to see missions using the starmap/animator demo functionality. It would be super to see how the inflight communication compares with what we already have. Ditto with Special Markets. The use of Keyboard to enable more complex input (unless we now have that).


A "still" from the Animator Demo (this is not a "cutscene", but the code for running one is presumably still inside the OXP somewhere):
Image

Starmap Demo:
Image

Keyboard input (Cubecode?) presumably from Vector/CCL:
Image
Last edited by Cholmondely on Fri Jul 25, 2025 6:07 pm, edited 1 time in total.
Comments wanted:
Missing OXPs? What do you think is missing?
Lore: The economics of ship building How many built for Aronar?
Lore: The Space Traders Flight Training Manual: Cowell & MgRath Do you agree with Redspear?
User avatar
phkb
Impressively Grand Sub-Admiral
Impressively Grand Sub-Admiral
Posts: 5319
Joined: Tue Jan 21, 2014 10:37 pm
Location: Writing more OXPs, because the world needs more OXPs.

Re: Library

Post by phkb »

Lone_Wolf wrote: Fri Jul 25, 2025 9:10 am
Pity that when I do that the expansion manager can no longer be used to update the oxz.
The only reason you'd need to add images to the Library folder would be if you were planning to update Library. If you're adding some custom images for your own mission or whatever, they can be in the Textures folder of your own OXP. They don't need to be inside Library in order for Library to make use of them.
User avatar
Cholmondely
Archivist
Archivist
Posts: 6300
Joined: Tue Jul 07, 2020 11:00 am
Location: The Delightful Domains of His Most Britannic Majesty (industrial? agricultural? mainly anything?)
Contact:

Re: Library

Post by Cholmondely »

phkb wrote: Fri Jul 25, 2025 9:50 am
Lone_Wolf wrote: Fri Jul 25, 2025 9:10 am
Pity that when I do that the expansion manager can no longer be used to update the oxz.
The only reason you'd need to add images to the Library folder would be if you were planning to update Library. If you're adding some custom images for your own mission or whatever, they can be in the Textures folder of your own OXP. They don't need to be inside Library in order for Library to make use of them.
But then if there is another update of Library...
Comments wanted:
Missing OXPs? What do you think is missing?
Lore: The economics of ship building How many built for Aronar?
Lore: The Space Traders Flight Training Manual: Cowell & MgRath Do you agree with Redspear?
User avatar
Cholmondely
Archivist
Archivist
Posts: 6300
Joined: Tue Jul 07, 2020 11:00 am
Location: The Delightful Domains of His Most Britannic Majesty (industrial? agricultural? mainly anything?)
Contact:

Re: Library

Post by Cholmondely »

phkb wrote: Fri Jul 25, 2025 9:50 am
make use of them.
Phkb - which of the Library.js scripts have you used for your various missions? And is there anything below you know to be wrong?

Library has these:
? Lib_2DCollision.js - Methods for checking if point is in bounding-box, on line or in poly.
x Lib_Animator.js - Tool to create animations on mission screens (see Demos). - Animator Demo - it animates Oolite models (is not a cutscene)
? Lib_BinSearch.js - Instantiated search tree. (Used by PAD's search function? - identical to CCL version?)
√ Lib_Config.js - Configuration interface for AddOns. (Widely used by many OXPs)
? 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). Plays the Orchestral Demo & [EliteWiki] Contextual Jukebox.
√ Lib_PAD.js - Unified logbook, mission-log, diary and interface. Added in v1.7 - was part of [EliteWiki] Vector OXP.
x Lib_Starmap.js - In-System-Maps in 3D (docked and inflight) (see Demos). Added in v1.7 - Starmap Demo.

and there are more:
x Lib_Cubecode.js (the Vector display above?)
x Lib_EntityStrength.js (seems to check for weapons, shield strength & recharge rates, NPCs in system)
x lib_fx.js
x Lib_MissionCoord.js
- Lib_PAD_Events.js (unsure about this one - is it what adds the [EliteWiki] GNN newsflashes into the PAD? Or new data cards such as NPCs or systems?)
? lib_shield.js
? lib_starmap12.js
? lib_test.js (Detect changes in custom role entity?)

Decoder:
√ - used by our community in other OXPs
x - not used
? - not even understood!


Edited to add that the Animator Demo animates Oolite ship models and is not a Cutscene
Last edited by Cholmondely on Fri Jul 25, 2025 6:04 pm, edited 1 time in total.
Comments wanted:
Missing OXPs? What do you think is missing?
Lore: The economics of ship building How many built for Aronar?
Lore: The Space Traders Flight Training Manual: Cowell & MgRath Do you agree with Redspear?
Post Reply