OXP howto dockable stations - Revision history

Cholmondely: /* Some examples of more advanced stuff */ Added note on issues with saving the game

2024-05-26T21:20:38Z

‎Some examples of more advanced stuff: Added note on issues with saving the game

Cholmondely: /* Links */ Added Eric Walch's dock-scraping fines

2024-05-20T06:12:44Z

‎Links: Added Eric Walch's dock-scraping fines

Phkb: Updating BB links

2024-02-29T02:17:01Z

Updating BB links

Cholmondely: /* Snippets from elsewhere */ Added Griff's comment

2024-01-31T14:06:23Z

‎Snippets from elsewhere: Added Griff's comment

Cholmondely: Added note

2024-01-31T10:23:27Z

Added note

Cholmondely: Improved structure

2024-01-31T10:18:30Z

Improved structure

Cholmondely: Tweak!

2024-01-30T14:16:45Z

Tweak!

Cholmondely: /* Multiple Docking/External Docking Issues */ "Corrected" Switeck's comment to what I think he means

2024-01-30T13:24:36Z

‎Multiple Docking/External Docking Issues: "Corrected" Switeck's comment to what I think he means

Cholmondely: Updated with Cim's post

2024-01-30T13:22:39Z

Updated with Cim's post

Cholmondely: /* Docking */ Added more

2024-01-24T17:57:31Z

‎Docking: Added more

@@ Line 192: / Line 192: @@
 *Adding Missions: see [[Taranis OXP]] and the 2023 update of [[Tionisla Chronicle Array]] with the original [[Tionisla Reporter]]
 :Mission Screens: [[HDBG]] and then [[Library OXP]] (more sophisticated - see Demos: Animator & Starmap) for better missions screens
 == Multiple Docking/External Docking Issues ==
 Cim's 2024 response to a couple of issues (taken from [https://bb.oolite.space/viewtopic.php?p=293660#p293660 here]):

@@ Line 239: / Line 239: @@
 * [https://bb.oolite.space/viewtopic.php?p=264830#p264830 Putting it all together] (2018) by [[User:Phkb|Phkb]] - for ships but ''recent''
 * [https://bb.oolite.space/viewtopic.php?f=4&t=16028 BGS tunnel textures] (2013)
-* [https://bb.oolite.space/viewtopic.php?p=178983#p178983 Code for placing a station randomly around a planet rather than at a fixed position] (Ahruman, 2012)
+* [https://bb.oolite.space/viewtopic.php?p=178983#p178983 Code for placing a station randomly around a planet rather than at a fixed position] ([[User:Ahruman|Ahruman]], 2012)
-* [https://bb.oolite.space/viewtopic.php?p=132808#p132808 Javascript for docking and launching at 2 different docks at 180°] by [[User:Thargoid]] (2011)
+* [https://bb.oolite.space/viewtopic.php?p=132808#p132808 Javascript for docking and launching at 2 different docks at 180°] ([[User:Thargoid|Thargoid]], 2011)
 * [https://bb.oolite.space/viewtopic.php?p=98050#p98050 1 1/2 pages on station population percentages] (2010)

@@ Line 141: / Line 141: @@
 *[[Charlie]] on the above (2007): For those who prefer to use an alternate 3D package to Wings you don't have to use it for the ''hole'' material. Just chopping holes in your model & dock seems to work!
-*[[Killer Wolf]] (2022): I actually did a dockable asteroid, the hacker outpost and salvage gang that was incorporated into the [[Anarchies OXP]] according to a search. You could fly inside it and then into the docking bay itself so you could probably reverse engineer that if needed. I wrote a [http://aegidian.org/bb/viewtopic.php?p=95072#p95072 post about docks] (2009) on page 2 of the "things I wish I knew.." thread. Beyond that stations like the [[Hathor Trade Station]] also have docking tunnels that might help.
+*[[Killer Wolf]] (2022): I actually did a dockable asteroid, the hacker outpost and salvage gang that was incorporated into the [[Anarchies OXP]] according to a search. You could fly inside it and then into the docking bay itself so you could probably reverse engineer that if needed. I wrote a [https://bb.oolite.space/viewtopic.php?p=95072#p95072 post about docks] (2009) on page 2 of the "things I wish I knew.." thread. Beyond that stations like the [[Hathor Trade Station]] also have docking tunnels that might help.
 *[[User:Murgh|Murgh]] (2022): For starters you just leave a 192m x 64m slit (material defined as a "hole" in the [station/dockable] model).. always facing the Z axis, with the hole's center at x=0 and y=0 if there will be rotation..
 :There are of course plenty of fine dock models you can directly borrow or modify, or build a 192x64x250 (or bigger) cube yourself, skinning its insides (In Wings3D, in "body mode", ''invert'' the dock's surfaces for UVmapping to look right) to your pleasure.. I'd recommend keeping the two models separate to make it easier (to keep distinct objects with regular and inverted texturing apart), since they will be two different .dat files and the unification of the two happens later in the shipdata.plist.
-*[http://aegidian.org/bb/viewtopic.php?p=28851#p28851 dajt] ([[David Taylor]]) on backwards-facing docks (2007)
+*[https://bb.oolite.space/viewtopic.php?p=28851#p28851 dajt] ([[David Taylor]]) on backwards-facing docks (2007)
-*[[User:Phkb|Phkb]] (2024): [http://aegidian.org/bb/viewtopic.php?f=3&t=21567 Issue with Taranis dock] - trying to prevent the view of the central orb during docking
+*[[User:Phkb|Phkb]] (2024): [https://bb.oolite.space/viewtopic.php?f=3&t=21567 Issue with Taranis dock] - trying to prevent the view of the central orb during docking
 ----
@@ Line 166: / Line 166: @@
 *Double Entry Dock - see [[Superhub]] or Thargoid's [[Kiota Stations]]
 *[[Multiple Docks]] - some for launching, some for docking, some for both (with Proof of Concept). And see Cim's note below.
-*[http://www.aegidian.org/bb/viewtopic.php?f=2&t=21515 External Docking] - thread with Proof of Concept video link.
+*[https://bb.oolite.space/viewtopic.php?f=2&t=21515 External Docking] - thread with Proof of Concept video link.
 *Buoys: There are some impressive Buoys out there. See [[Buoy (Oolite)]] for examples.
@@ Line 177: / Line 177: @@
 *See [[Mining Contracts OXP]] for something simpler.
 *[[Galactic Navy OXP]], the [[Royal Hunting Lodge]] and the [[Lave Academy]] all have special contextual interfaces. GN's is especially immersive. [[HIMSN]] has a very unfriendly one.
-*[http://www.aegidian.org/bb/viewtopic.php?p=228461#p228461 [[User:Wildeblood|Wildeblood]]] : I want an unfriendly station, where dockside services are not available. How do I prevent or undo your OXP setting an interface on my station? (2014)
+*[https://bb.oolite.space/viewtopic.php?p=228461#p228461 [[User:Wildeblood|Wildeblood]]] : I want an unfriendly station, where dockside services are not available. How do I prevent or undo your OXP setting an interface on my station? (2014)
 *[[F4 page (ship and system interfaces)]] contains links to all known OXPs which interface this way - ''eg'' [[Station Dock Control]]
 === Tweaking F3 shipyard screens (equipment sales, ship sales) ===
@@ Line 183: / Line 183: @@
 *Changing Shipyard ships for sale
 :[[File:LaveInitialShipyard.oxz]] adds ships to the Lave shipyard but ''only'' at the start of the game, not later on.
-:[http://aegidian.org/bb/viewtopic.php?p=293174#p293174 Code for replacing all ships for sale] with custom selection
+:[https://bb.oolite.space/viewtopic.php?p=293174#p293174 Code for replacing all ships for sale] with custom selection
 === Markets ===
 *Tweaking commodity markets:
 :See [[Shipdata.plist]]: "market", "market_broadcast", "market_capacity", "market_definition", "market_monitored", "market_script"
-:and the lengthy discussion at [http://aegidian.org/bb/viewtopic.php?f=2&t=21512 Secondary Market Definitions Defined] which discusses pitfalls and gives more examples
+:and the lengthy discussion at [https://bb.oolite.space/viewtopic.php?f=2&t=21512 Secondary Market Definitions Defined] which discusses pitfalls and gives more examples
-:[[New Cargoes]]: see [[Tianve]] v2.0 for an example, and the [http://aegidian.org/bb/viewtopic.php?f=4&t=20937 BB thread] on updating the [[SothisTC]] stations (which includes tweaking New Cargoes and also positioning the station).
+:[[New Cargoes]]: see [[Tianve]] v2.0 for an example, and the [https://bb.oolite.space/viewtopic.php?f=4&t=20937 BB thread] on updating the [[SothisTC]] stations (which includes tweaking New Cargoes and also positioning the station).
 === Missions ===
 *Adding Missions: see [[Taranis OXP]] and the 2023 update of [[Tionisla Chronicle Array]] with the original [[Tionisla Reporter]]
@@ Line 195: / Line 195: @@
 ----
 == Multiple Docking/External Docking Issues ==
-Cim's 2024 response to a couple of issues (taken from [http://www.aegidian.org/bb/viewtopic.php?p=293660#p293660 here]):
+Cim's 2024 response to a couple of issues (taken from [https://bb.oolite.space/viewtopic.php?p=293660#p293660 here]):
   •Is the difficulty in allowing External Docking tied in with the dock needing to be along the Z-azis of the station?
@@ Line 234: / Line 234: @@
 BB Threads:
-* [http://www.aegidian.org/bb/viewtopic.php?f=4&t=17991 Tutorial for creating a simple station. (Help needed!)] (2016)
+* [https://bb.oolite.space/viewtopic.php?f=4&t=17991 Tutorial for creating a simple station. (Help needed!)] (2016)
-* [http://www.aegidian.org/bb/viewtopic.php?f=4&t=12477 (REQUEST) Station tutorial] (2012)
+* [https://bb.oolite.space/viewtopic.php?f=4&t=12477 (REQUEST) Station tutorial] (2012)
-* [http://www.aegidian.org/bb/viewtopic.php?f=8&t=6831 Scanner Blebs] (2009) This thread contains posts on positioning of docking ports, enabling bounding boxes, getting station docks properly formatted (one presumes that references are to the [[Nuit Space Station OXP]]).
+* [https://bb.oolite.space/viewtopic.php?f=8&t=6831 Scanner Blebs] (2009) This thread contains posts on positioning of docking ports, enabling bounding boxes, getting station docks properly formatted (one presumes that references are to the [[Nuit Space Station OXP]]).
-* [http://aegidian.org/bb/viewtopic.php?p=264830#p264830 Putting it all together] (2018) by [[User:Phkb|Phkb]] - for ships but ''recent''
+* [https://bb.oolite.space/viewtopic.php?p=264830#p264830 Putting it all together] (2018) by [[User:Phkb|Phkb]] - for ships but ''recent''
-* [http://www.aegidian.org/bb/viewtopic.php?f=4&t=16028 BGS tunnel textures] (2013)
+* [https://bb.oolite.space/viewtopic.php?f=4&t=16028 BGS tunnel textures] (2013)
-* [http://aegidian.org/bb/viewtopic.php?p=178983#p178983 Code for placing a station randomly around a planet rather than at a fixed position] (Ahruman, 2012)
+* [https://bb.oolite.space/viewtopic.php?p=178983#p178983 Code for placing a station randomly around a planet rather than at a fixed position] (Ahruman, 2012)
-* [http://aegidian.org/bb/viewtopic.php?p=132808#p132808 Javascript for docking and launching at 2 different docks at 180°] by [[User:Thargoid]] (2011)
+* [https://bb.oolite.space/viewtopic.php?p=132808#p132808 Javascript for docking and launching at 2 different docks at 180°] by [[User:Thargoid]] (2011)
-* [http://aegidian.org/bb/viewtopic.php?p=98050#p98050 1 1/2 pages on station population percentages] (2010)
+* [https://bb.oolite.space/viewtopic.php?p=98050#p98050 1 1/2 pages on station population percentages] (2010)

@@ Line 114: / Line 114: @@
 *'''Important''': You need to include "station" or "carrier" as one of the "roles" in the [[Shipdata.plist]], or docking will fail dismally, no matter the excellence of the dock itself!
-*[[User:Aegidian|Aegidian]] (2003-6?): Quick and easy instructions for wings3D.
+*[[User:Aegidian|Aegidian]] (2003-6?): Quick and easy instructions for '''Wings3D'''.
 . Make a panel on your main model where the dock entrance will be. A rectangle 192x64 is ideal, but you can go bigger - and use different shapes.
@@ Line 135: / Line 135: @@
 . You should now be done. You can vary the shape of the dock entrance in stage 1. If you copy and paste the panel into a new model you can even use it to extrude the dock shape.
 *[[Charlie]] on the above (2007): For those who prefer to use an alternate 3D package to Wings you don't have to use it for the ''hole'' material. Just chopping holes in your model & dock seems to work!
@@ Line 148: / Line 151: @@
 ----
 == Some examples of more advanced stuff ==
 ''Almost all OXZ Javascript scripts are now easily available through Hiran's [https://ooliteproject.github.io/oolite-expansion-catalog/indexExpansionsByName.html Oolite Expansion Catalog] (if you know which OXZ to look in!).''

@@ Line 174: / Line 174: @@
 *[[Galactic Navy OXP]], the [[Royal Hunting Lodge]] and the [[Lave Academy]] all have special contextual interfaces. GN's is especially immersive. [[HIMSN]] has a very unfriendly one.
 *[http://www.aegidian.org/bb/viewtopic.php?p=228461#p228461 [[User:Wildeblood|Wildeblood]]] : I want an unfriendly station, where dockside services are not available. How do I prevent or undo your OXP setting an interface on my station? (2014)
 === Tweaking F3 shipyard screens (equipment sales, ship sales) ===
 *Tweaking TL levels: this is read-only. But see Montana05's multiple models with different TL's as a work around for this in [[S.I.R.F.]]

@@ Line 1: / Line 1: @@
 [[File:BuoyRepair Facility sm.png|thumb|right|200px|[[Buoy Repair]] GRS station by Svengali ]]
-This tutorial was written back in 2009. But the stuff beneath/links are up-to-date (2024).
+The 4 chapter tutorial was written back in 2009. But the stuff beneath/links are up-to-date (2024).
 === Introduction ===

@@ Line 159: / Line 159: @@
-  •Proximity-checking but to make a ship look like it's docked it needs to be so close it risks math-rounding error collisions.
+  •Proximity-checking is a problem: to make a ship look like it's docked it needs to be so close it risks math-rounding error collisions.
 This is what the "addCollisionException" function is for. [[Oolite_JavaScript_Reference:_Ship#addCollisionException]]
@@ Line 166: / Line 166: @@
 The [[SOTL Altmap]] OXP I used for various experiments has a "resupply shuttle" component where shuttles will launch from a station, dock externally with a nearby freighter (fairly crudely, since I never got around to making custom models for either), transfer cargo, then undock and take the cargo back to the station - with use of that function to cover the loose edges as they get close.
 == Snippets from elsewhere ==

@@ Line 119: / Line 119: @@
 :Welcome: [[HIMSN]] Naval Bases, [[SothisTC]], [[Home System]]. [[HDBG]] can provide a welcome screen.
 :Adding description/depth/possibilities: see [[Black Monk Monastery]], [[Royal Hunting Lodge]]s & [[Galactic Navy OXP]] naval bases
-*Force-field over docking tunnel: see Svengali's [[BuoyRepair]] OXP.
 *Solid Door preventing docking: this ''has'' to be a sub-entity (the "door" in the Deep Space Dredger can be flown through): see [[TCAT OXP]] for an example
 *''At the moment (Dec 2023) there seems to be no way of allowing external docking. All ships '''must''' "fly" into the docking tunnel and dock internally.''
 *Buoys: There are some impressive Buoys out there. See [[Buoy (Oolite)]] for examples.
 === Activities inside the Station ===
 *The Rolls-Royce OXP is [[Life in the Frontier]] - see File:LitF+v0.06.oxz for the newest development version with different layouts for Coriolis, dodos, icos & RH's. Musings gives links to other OXPs offering activities inside the station.