Difference between revisions of "Explorers' Club OXP"

From Elite Wiki
m (fight the deadend pages)
(Updating BB links)
 
(28 intermediate revisions by 6 users not shown)
Line 1: Line 1:
−
[[File:Explorers_Club.png|200px|thumb|right]]
+
[[Image:Explorers_Club.png|500px|thumb|right]][[Image:Explorers Club snapshot of Anlala-001.png|500px|thumb|right|Original OXP snapshot]][[File:Oolite-012.png|500px|thumb|right|Options]][[File:Oolite-011.png|500px|thumb|right|List of visited systems]]
 +
Explorer's Club records the systems which you have visited.
 +
 
 
== Overview ==
 
== Overview ==
−
 
+
Useful for explorers (and used by other OXPs which make more of the exploration side of Oolite).
−
Explorers’ Club OXP v1.3.2 (05/03/12)
 
−
 
 
−
Inspired by Wildeblood, code by capt murphy - 2011,2012
 
−
 
 
−
Licence: CC BY-NC-SA 3.0 : Please visit http://creativecommons.org/licenses/by-nc-sa/3.0/ for more info.
 
−
 
 
−
Requires Oolite 1.76
 
−
 
 
−
[[File:Explorers Club snapshot of Anlala-001.png|200px|thumb]][[File:Oolite-012.png|200px|thumb]][[File:Oolite-011.png|200px|thumb]]
 
−
 
 
  
 
== Description ==
 
== Description ==
  
−
Once installed this OXP keeps track of unique systems visited and reports on the manifest screen (F5) the total systems visited in the current galaxy out of 256 and the total systems visited out of 2048 in the whole Ooniverse. It also displays an Explorer ‘rank’. You need to visit all 2048 systems to be ranked an Elite Explorer.
+
Once installed this OXP keeps track of unique systems visited and reports on the manifest screen (F5, F5) the total systems visited out of 256 in the current chart and the total systems visited out of 2048 in the whole Ooniverse. It also displays an Explorer ‘rank’. You need to visit all 2048 systems to be ranked an Elite Explorer.
  
−
In addition this OXP adds some functionality to the Long Range Chart (F6/F6) in that it can be set to different modes. To access the options screen press F2, then F6 when docked. The available options are:
+
In addition this OXP adds some functionality to the Long Range Chart (F6, F6) in that it can be set to different modes. To access the options go to the Interfaces screen (F4) when docked. The available options are:
  
−
:1) Default - standard long range chart behaviour.<br>
+
:1) Default - standard long range chart behaviour.
−
:2) Long range chart shows animation of systems visited to date, in order of first visit.<br>
+
:2) Long range chart shows animation of systems visited to date, in order of first visit (marked with green X's)
−
:3) Long range chart marks unvisited systems.<br>
+
:3) Long range chart marks unvisited systems (marked with orange lozenges)
−
:4) Player can manually mark systems on long range chart as a destination (highlight a system with the cursor and press F7).<br>
 
−
:5) Player can manually unmark systems on long range chart as a destination (highlight a system with the cursor and press F7).<br>
 
−
 
 
−
Players should exercise caution when using the 2nd and 3rd options as it will clear any currently marked systems (e.g mission or contract destinations), although the 4th option can be used to manually reinstate them.
 
  
 
The options screen also allows you to choose when a system is recorded as visited. The options are.
 
The options screen also allows you to choose when a system is recorded as visited. The options are.
  
−
:1) Default – when docked at the main station.<br>
+
:1) Default – when docked at the main station.
−
:2) On arrival from witch-space.<br>
+
:2) Immediately on arrival from witch-space.
 +
:3) When reaching the planet's surface.
  
−
Options are persistent between sessions with the same save game.
+
Options are persistent between sessions with the same saved game.
  
 
The options screen also gives access to two further sets of mission screens.
 
The options screen also gives access to two further sets of mission screens.
  
−
:1) Displays a list of the system names that have been visited so far in the current Galaxy, followed by a list of the system names that are yet to be visited in the current galaxy.<br>
+
:1) Displays a list of the system names that have been visited so far in the current Galaxy, followed by a list of the system names that are yet to be visited in the current galaxy.
−
:2) Displays a list of mile-stones that the player has completed / not completed so far. Defined mile-stones are:
+
:2) Displays a list of mile-stones that the player has completed, or not completed, so far. Defined mile-stones are:
−
 
 
−
:* Visited all of the ‘Old Worlds’ in galaxy 1.
 
−
:* Visited all of the ‘Famous Planets’ in galaxy 1 (as per OXP of same name).
 
−
:* Visited all of the ‘Famous Planets’ in galaxy 2 (as per OXP of same name).
 
−
:* Visited the ‘Prodigal Suns’ in galaxy 3.
 
−
:* Visited the ‘Lost Worlds’ in galaxy 6.
 
−
:* Visited the systems beyond the ‘Great Rift’ in galaxy 7.
 
−
:* Visited Oresrati in galaxy 8.
 
−
:* Visited all 8 galaxies at least once.
 
−
 
 
−
The options screen also allows you to enable/disable an experimental feature to keep a photographic record of systems visited. This is disabled by default.
 
−
 
 
−
If enabled the behaviour will depend on which option is set for recording a visit. If a visit is recorded on arrival from witch-space a screenshot will be automatically saved on exiting witch-space. If a visit is recorded on docking with the main station, at the next launch the player will be briefly ‘teleported’ to a good vantage point and a screenshot will be automatically saved before the player is teleported back to the launch point.
 
−
 
 
−
This feature uses the Oolite JS function <code>takeSnapShot()</code>. This is technically a debug tool and as such is not optimised in the core game code. Players on older computers, or with a high OXP count, or with limited hard-disk space, or with larger screen resolutions may encounter <code>[script.javaScript.timeLimit]</code> errors in their log file when the screenshot is taken. If these errors only relate to <code>[explorer_club_snapshot.js]</code> this should not cause any problems. If these errors relate to other scripts please report and consider disabling the feature or editing the script to increase the values of <code>this.explorerClub_snapshotDelay = 0.25;</code> and <code>this.explorerClub_releasePlayer = 1.25;</code> both of which can be found in explorer_club.js.
 
−
 
 
−
(Note - <code>takeSnapShot()</code> has been excluded from the JS time limiter with Trunk revision 4794 - trunk users using this revision or later should not experience any timeouts.)
 
−
 
 
−
During testing on a 7 year old Win XP laptop timeouts were quite frequent until I repaired some hard disk errors via windows chkdsk. After that the default values worked well and did not cause any timeouts so most users should not have any problems.
 
−
 
 
−
 
 
−
== Change Log ==
 
−
 
 
−
Version 1.0: 23/11/11<br>
 
−
Initial release.
 
−
 
 
−
 
 
−
Version 1.1: 24/11/11<br>
 
−
Fixed dodgy condition checks for the ‘rank’ string. Incorporated a number of code tweaks for efficiency suggested by Svengali.
 
−
 
 
−
 
 
−
Version 1.2.1: 1/12/11<br>
 
−
Added functionality to view long range chart with unvisited systems marked, to view list of system names visited and unvisited in current galaxy, and to view list of mile-stones.
 
−
 
 
−
All missionScreens now managed via missionScreenOpportunity.
 
−
 
 
−
Long range chart mark visited systems animation will now complete in a maximum of 32 seconds (if all 256 systems have been visited).
 
−
Script now uses strict mode.
 
  
−
Added code to disable OXP entirely if player is in a galaxy outside of the range 1 to 8.  
+
:* Visited all of the ‘Old Worlds’ in galaxy 1.
 +
:* Visited all of the ‘Famous Planets’ in galaxy 1 (as per OXP of same name).
 +
:* Visited all of the ‘Famous Planets’ in galaxy 2 (as per OXP of same name).
 +
:* Visited the ‘Prodigal Suns’ in galaxy 3.
 +
:* Visited the ‘Lost Worlds’ in galaxy 6.
 +
:* Visited the systems beyond the ‘Great Rift’ in galaxy 7.
 +
:* Visited Oresrati in galaxy 8.
 +
:* Visited all 8 galaxies at least once.
  
−
Added code to disable mile-stones feature if player is using a non-standard galaxy_seed.
+
The experimental feature to keep a photographic record of systems visited, only usable with development versions of Oolite, has been removed from this version of the OXP.
  
 +
== ChangeLog & Downloads ==
  
−
Version 1.3.1: 21/01/12<br>
 
−
Made compatible with Save Anywhere OXP.
 
  
−
Amended start-up behaviour for 1.76.
 
  
−
Removed use of forEach method for array iteration.
+
Download 1.4.6 in OXZ format [[Media:Explorers_Club_1.4.4.oxz|here]] for Oolite 1.80 or later.
  
−
Message appended to system description on F7 screen to indicate whether system has been visited or not.
+
Version 1.4.6 (3/2/2024) Removed Ranking from F5-F5 Manifest Screen
  
−
Added background image for missionScreens.
+
Version 1.4.5 (3/2/2024) Did something else (or didn't do it, because of typo.)
  
−
Added experimental photographic record of visited systems feature (thanks to Wildeblood for the snapshot HUD and some script suggestions, and thanks to the Honourable Guild of Test-Pilots for their valuable testing services).
+
Version 1.4.4 (19/8/2014) Can now leave mission screens at any time, and fixed harmless bug introduced in 1.4.3.  
  
 +
Version 1.4.3 (5/8/2014) Counter now displayed on interface summary, jumping into a nova system is now always logged immediately, and fine-tuned the change made in 1.4.2.
  
−
Version 1.3.1oxpC: 21/1/12<br>
+
Version 1.4.2 (27/7/2014) Code updated for Oolite 1.80: bug-fix for loading games saved at stations other than GalCop main.
−
Same features as 1.3.1 but options are set via oxpConfig.
 
  
 +
Version 1.4.1 (21/10/2013) System data screen tweaked, micro-tweak to API functions, last text string moved to missiontext.plist file.
  
−
Version 1.3.2 and 1.3.2oxpC: 5/03/12<br>
+
Version 1.4 (9/6/2013) Based on version 1.3.3, updated by Wildeblood. Code updated for Oolite 1.77, station interface added, photographic record feature removed, nearly all text strings moved to missiontext.plist file, new option for recording visit added, API functions added.
−
Fixed minor bug in oxpC version that caused setting not to be saved in some circumstances.
 
  
−
Changed timing of record visit on witch space exit from this.shipWillExitWitchSpace to this.shipExitedWitchSpace - for compatibility with as yet unreleased long range jump OXPs.
+
Download original standalone version 1.3.3 from [http://www.box.com/s/c9ogsbist6gj580gh7j1 the box.]
  
−
Fixed mechanism of failsafe which prevents freeze should a JS timeout occur.  
+
Also mirrored on [https://app.box.com/s/5axsr83uf4g39ugsgo6h JazHaz's Box].
  
 +
Download alternate version 1.3.3.oxpC that uses [[OXPConfig]] to change options in game from [http://www.box.com/s/f9oub92gffuaiag5039s the box.]
  
−
== Download and Discussion ==
+
== Related OXPs ==
 +
*In order to visit all 2048 systems and attain the rank of Elite Explorer players may find Wildeblood's [[Galactic Hyperdrive OXP]] and / or Smiv's [[GalDrivePod]] useful tools.
  
−
Download from [http://www.box.com/s/c9ogsbist6gj580gh7j1 the box.]
+
*For the Machiavellian Masters of Murderous Mayhem <br>
 +
:Wildeblood has returned from the Outer Darknesses with a special AddOn for this OXP. Download [[File:Serial Killer.oxz|Serial Killer.oxz]] and add it in to your OXP cocktail mix (either your AddOns or your ManagedAddOns folder work just fine) and your count of visited systems will now only add in those systems in which you scored a kill!
  
−
Discuss on the [http://www.aegidian.org/bb/viewtopic.php?f=4&t=11212 Oolite BB.]
+
== Details ==
  
 +
Requires Oolite 1.80
  
−
== OXPConfig version ==
+
== Tweaks ==
 +
*[https://bb.oolite.space/viewtopic.php?p=260876#p260876 To mark unvisited systems with a white "x" rather than a diamond] Runghold (2017)
  
−
A version of the current release that uses [[OXPConfig]] to set options can be downloaded from [http://www.box.com/s/f9oub92gffuaiag5039s the box.]
+
You might wish to consult [[How to tweak OXZ's]]
  
 +
== Links ==
 +
*[https://bb.oolite.space/viewtopic.php?p=157336#p157336 Fons et Origo of this oxp] (2011)
 +
*[https://bb.oolite.space/viewtopic.php?f=4&t=11212 Explorers' Club OXP] (2011-12) Original BB ''planning'' thread
 +
*[https://bb.oolite.space/viewtopic.php?f=4&t=11228 Explorers' Club OXP] (2011-12) Original OXP thread
 +
*[https://bb.oolite.space/viewtopic.php?f=4&t=16718 Explorers' Club updated for Oolite 1.80] (2014 - date) Current BB thread
 +
*[[Exploration]]
  
−
{{activity-OXP}} [[Category:OXPConfig-compatible OXPs]]
+
{{Infobox OXPb| title = Explorers' Club
 +
|version = 1.4.6
 +
|release = 5/2/2024
 +
|license = [http://creativecommons.org/licenses/by-nc-sa/3.0/ CC BY-NC-SA 3.0]
 +
|features = New activities, improved chart screen
 +
|category = Activities OXPs
 +
|author = [[Capt. Murphy]] & [[User:Wildeblood|Wildeblood]]
 +
|feedback = [https://bb.oolite.space/viewtopic.php?f=4&t=16718 Oolite BB.]
 +
}}

Latest revision as of 01:41, 29 February 2024

Explorers Club.png
Original OXP snapshot
Options
List of visited systems

Explorer's Club records the systems which you have visited.

Overview

Useful for explorers (and used by other OXPs which make more of the exploration side of Oolite).

Description

Once installed this OXP keeps track of unique systems visited and reports on the manifest screen (F5, F5) the total systems visited out of 256 in the current chart and the total systems visited out of 2048 in the whole Ooniverse. It also displays an Explorer ‘rank’. You need to visit all 2048 systems to be ranked an Elite Explorer.

In addition this OXP adds some functionality to the Long Range Chart (F6, F6) in that it can be set to different modes. To access the options go to the Interfaces screen (F4) when docked. The available options are:

1) Default - standard long range chart behaviour.
2) Long range chart shows animation of systems visited to date, in order of first visit (marked with green X's)
3) Long range chart marks unvisited systems (marked with orange lozenges)

The options screen also allows you to choose when a system is recorded as visited. The options are.

1) Default – when docked at the main station.
2) Immediately on arrival from witch-space.
3) When reaching the planet's surface.

Options are persistent between sessions with the same saved game.

The options screen also gives access to two further sets of mission screens.

1) Displays a list of the system names that have been visited so far in the current Galaxy, followed by a list of the system names that are yet to be visited in the current galaxy.
2) Displays a list of mile-stones that the player has completed, or not completed, so far. Defined mile-stones are:
  • Visited all of the ‘Old Worlds’ in galaxy 1.
  • Visited all of the ‘Famous Planets’ in galaxy 1 (as per OXP of same name).
  • Visited all of the ‘Famous Planets’ in galaxy 2 (as per OXP of same name).
  • Visited the ‘Prodigal Suns’ in galaxy 3.
  • Visited the ‘Lost Worlds’ in galaxy 6.
  • Visited the systems beyond the ‘Great Rift’ in galaxy 7.
  • Visited Oresrati in galaxy 8.
  • Visited all 8 galaxies at least once.

The experimental feature to keep a photographic record of systems visited, only usable with development versions of Oolite, has been removed from this version of the OXP.

ChangeLog & Downloads

Download 1.4.6 in OXZ format here for Oolite 1.80 or later.

Version 1.4.6 (3/2/2024) Removed Ranking from F5-F5 Manifest Screen

Version 1.4.5 (3/2/2024) Did something else (or didn't do it, because of typo.)

Version 1.4.4 (19/8/2014) Can now leave mission screens at any time, and fixed harmless bug introduced in 1.4.3.

Version 1.4.3 (5/8/2014) Counter now displayed on interface summary, jumping into a nova system is now always logged immediately, and fine-tuned the change made in 1.4.2.

Version 1.4.2 (27/7/2014) Code updated for Oolite 1.80: bug-fix for loading games saved at stations other than GalCop main.

Version 1.4.1 (21/10/2013) System data screen tweaked, micro-tweak to API functions, last text string moved to missiontext.plist file.

Version 1.4 (9/6/2013) Based on version 1.3.3, updated by Wildeblood. Code updated for Oolite 1.77, station interface added, photographic record feature removed, nearly all text strings moved to missiontext.plist file, new option for recording visit added, API functions added.

Download original standalone version 1.3.3 from the box.

Also mirrored on JazHaz's Box.

Download alternate version 1.3.3.oxpC that uses OXPConfig to change options in game from the box.

Related OXPs

  • For the Machiavellian Masters of Murderous Mayhem
Wildeblood has returned from the Outer Darknesses with a special AddOn for this OXP. Download File:Serial Killer.oxz and add it in to your OXP cocktail mix (either your AddOns or your ManagedAddOns folder work just fine) and your count of visited systems will now only add in those systems in which you scored a kill!

Details

Requires Oolite 1.80

Tweaks

You might wish to consult How to tweak OXZ's

Links


Version Released License Features Category Author(s) Feedback
1.4.6 5/2/2024 CC BY-NC-SA 3.0 New activities, improved chart screen Activities OXPs Capt. Murphy & Wildeblood Oolite BB.
Retrieved from "https://wiki.alioth.net/index.php?title=Explorers%27_Club_OXP&oldid=81634"