Elite Wiki - User contributions [en]

Special:Badtitle/NS101:Dynamic Oolite OXP

2006-04-27T13:21:44Z

Iskander:

=== Namespacing and variable name length ===
There seems to be a length limit on variable names somewhere - possibly in the OOS code - currently I'm reliably crashing Oolite-PC r1.62 with a ''mission_<46 characters>'' variable name in an OOS script. I suspect that need fixing when Java-style naming comes into play (unless mission_ variables are automatically assumed to be scoped to the OXP's name, or something sneaky). I wouldn't have come close to the limit, if it weren't prefixed with ''net.ajnewman.'' Alas, I'm not yet up to speed on the Oolite source base to be able to track any of it down, sorry!

User:Iskander

2006-04-27T12:38:16Z

Iskander: Edited 'otaku' stuff to be smarter.

== Iskander ==
----

== Elite History ==
First played Elite on the BBC-B a couple of decades ago, and have periodically experienced yearnings for it. While EVE:Online came close to scratching that itch, nothing really succeeded until Oolite.

== Works in progress ==
Coming to a galaxy near you, soon: the Yakuza. Two rival clans, the Bunkakei and Taikukei will be pirating their way through Oolite. Kill a few of one clan's ''shatei'' and you'll draw the attention of their ''wakashu''... but also make the ''other'' clan happy. Bump enough ''wakashu'' off, and you will most likely be paid a visit by the system ''shateigashira'', looking for your head. Sooner or later, you will be desperately hunting the location of the clan ''Oyabun'': Chop off the head, and the clan will surely die, won't it?

'''net.ajnewman.yakuza.oxp''' will introduce several new ships and a pair of factions providing a plot arc that will climax at a showdown with a clan Oyabun and his solar yacht. Of course, when you kill the ''oyabun'', one of his ''kobun'' may step into his place, and you could find yourself the target of a blood feud. ''(a.k.a. a sequel)''

For now, here are some previews of the Bunkakei "Tengu" (a pirate / escort ship), and the Bunkakei Oyabun's "Peacock" solar yacht:

[[Image:Tengu.jpg|Tengu-class attack vessels]]

[[Image:Peacock.jpg|The Oyabun's solar yacht]]

Shipyard.plist

2006-04-25T21:12:08Z

Iskander: Corrected a misapprehension.

'''shipyard.plist''' provides Oolite with the information necessary to equip a player-purchaseable ship.

== chance ==
The likelihood that the ship is available for purchase at a station. (See also [[Shipyard.plist#techlevel|techlevel]].)

'''Example:'''
<key>chance</key>
<real>0.25</real>

== optional_equipment ==
This section lists equipment that the ship can be fitted with. Note that Oolite will offer variants of basic ship models with a selection of the optional equipment added, and the cost increased accordingly. Do not list equipment in both this section and the [[Shipyard.plist#standard_equipment|standard_equipment]] section, or you will be ripping your customers off.

'''Example: '''
<key>optional_equipment</key>
<array>
<string>EQ_ECM</string>
<string>EQ_FUEL_SCOOPS</string>
<string>EQ_ESCAPE_POD</string>
</array>

'''Note:''' Some equipment is universally available. For example all ships can buy fuel and equip a [[Galactic Hyperdrive|galactic hyperdrive]]. Refer to ''equipment.plist'' for specifics.

== price ==
How much the ship costs to purchase. Be sure to consider [[Shipyard.plist#standard_equipment|standard_equipment]] when you determine ship price.

'''Example:'''
<key>price</key>
<integer>65000</integer>

== standard_equipment ==
Equipment that comes fitted as standard with your ship. Any extras included in this section are ''free'', and should not appear in the [[Shipyard.plist#optional_equipment|optional_equipment]] section, or the station sales screen may offer a model of the ship with equipment it already has. Be sure to factor in the cost of equipment that comes as standard when pricing your ships.

'''Example:''' ''all models of this ship come with a heat shield, pulse laser and a single missile.''
<key>standard_equipment</key>
<dict>
<key>extras</key>
<array>
<string>EQ_HEAT_SHIELD</string>
</array>
<key>forward_weapon_type</key>
<string>EQ_WEAPON_PULSE_LASER</string>
<key>missiles</key>
<integer>1</integer>
</dict>

'''Example:''' ''all models of this ship come with a military laser, but nothing else as standard. If you have equipment listed as optional, the system may offer a tricked-out variant at a greater cost.''
<key>standard_equipment</key>
<dict>
<key>extras</key>
<array/>
<key>forward_weapon_type</key>
<string>EQ_WEAPON_MILITARY_LASER</string>
<key>missiles</key>
<integer>0</integer>
</dict>

== techlevel ==
Minimum tech. level of a system for the ship to be on sale. (See also [[Shipyard.plist#chance|chance]].)

'''Example:'''
<key>techlevel</key>
<integer>4</integer>

== weapon_facings ==
What weapon mounts are available on the ship. This is a bit-mask, so pick the mounts and add the numbers:
1 - Forward
2 - Aft
4 - Port
8 - Starboard

'''Example:''' ''fore and aft weapon mounts only.''
<key>weapon_facings</key>
<integer>3</integer>

'''Example:''' all weapon mounts.''
<key>weapon_facings</key>
<integer>15</integer>

'''Note:''' ''does something bad happen if the [[Shipdata.plist#weapon_position_..|shipdata weapon positions]] and the weapon_facings don't match?''

--------------------------------------------------------------------------------
[[Category:Oolite]]

OXP howto

2006-04-25T21:04:20Z

Iskander: Linked to shipyard.plist

[[Image:oolite-oxp-icon.png|100px|right|OXP icon]]
An '''Oolite Expansion Pack''' can cause many big changes or additions to Oolite's gameplay, or it may represent just a small, subtle alteration. By appearances, there is no way to tell what is inside, as it's merely a folder with the added extention '''.oxp'''. Inside, it will at least contain a folder named ''Config'', and possibly other folders such as ''AIs'', ''Models'', ''Textures'', ''Sounds'', etc. It is down to the goal of the OXP, which ways to combine elements to the OXP's contents.

=== AIs ===

The folder named AIs would contain any AI.plist additions the OXP might use.

* [[OXP howto AI|Making Oolite AI]]

=== Config===

This folder contains Property Lists such as:

* ''[[shipdata.plist]]'' that introduces any new entity (ships, stations, objects etc.) to Oolite.
* ''[[shipyard.plist]]'' that introduces new ships available for player purchase.
* ''[[script.plist]]'' or ''[[script.oos]]'' that plots conditional ''script actions''. script.oos will be loaded in preference to script.plist if both exist.
* ''[[planetinfo.plist]]'' that plots system specific changes from the default. may also contain ''script actions''.
* ''[[commodities.plist]]'' that contains information for each commodity in a market.
* ''[[misc plists|descriptions.plist]]'' that adds vocabulary to Oolite texts.
* ''[[hud.plist]]'' that allows for changes or a radically new ''Head-Up Display''.
* ''[[missiontext.plist]]'', ''[[misc plists|demoships.plist]]'', ''[[speech_pronunciation_guide.plist]]'' are some of the other custom methods.

All plist files except for those introducing new AI, belong in Config.

In its simplest form, an OXP could contain only a Config with an altering ''script.plist'' or ''planetinfo.plist''. An OXP that adds a new ship needs a ''shipdata.plist'' entry, and unless it is based entirely on existing Oolite data, would include a model and texture.

* [[OXP howto plist|Making Oolite plists]]

=== Models===

Oolite models need to be in the '''.dat''' format. There are utilities available that convert models made in Wings 3D (.obj) and Meshwork (.mesh) into this. A .dat file can be opened in a plain text editor to view the object's assigned texture names and see that they correspond with the actual file names in the Textures folder. The .dat file must be named exactly as it is referenced in the shipdata ''model'' entry.

* [[OXP howto model|Making Oolite models]]

=== Textures===

Oolite's textures are in the '''.png''' format, usually at a standard 512x512 size, and must be named exactly as they are named in the .dat file.

* [[OXP howto texture|Making Oolite textures]]

== External links ==

*[http://oolite.aegidian.org/cyoship/ Oolite Tutorial-Meshwork Shipbuilding]
*[http://oolite.aegidian.org/cyoship2/ Oolite Tutorial-Wings 3D Shipbuilding]

[[Category:Oolite]]

User:Iskander

2006-04-25T20:57:18Z

Iskander: Introducing myself and what I'm working on.

== Iskander ==
----

== Elite History ==
First played Elite on the BBC-B a couple of decades ago, and have periodically experienced yearnings for it. While EVE:Online came close to scratching that itch, nothing really succeeded until Oolite.

== Works in progress ==
Coming to a galaxy near you, soon: the Yakuza. Clan [http://en.wikipedia.org/wiki/Otaku Otaku] will be pirating their way through Oolite. Kill a few ''shatei'' and you'll draw the attention of their ''wakashu''. Bump enough ''wakashu'' off, and you will most likely be paid a visit by the system ''shateigashira''. Sooner or later, you will be desperately hunting the location of the Otaku ''Oyabun'': Chop off the head, and the clan will surely die, won't it?

I envision yakuza.oxp introducing several new ships and an extensive parallel plot arc climaxing at a showdown with the Oyabun and his solar yacht. Of course, when you kill the ''oyabun'', one of his ''kobun'' may step into his place, and you could find yourself the target of a blood feud. ''(a.k.a. a sequel)''

For now, here are some previews of the "Tengu" (a pirate / escort ship), and the Oyabun's "Peacock" solar yacht:

[[Image:Tengu.jpg|Tengu-class attack vessels]]

[[Image:Peacock.jpg|The Oyabun's solar yacht]]

File:Peacock.jpg

2006-04-25T20:55:34Z

Iskander: Early version of the Oyabun's solar yacht, ''The Peacock''.

Early version of the Oyabun's solar yacht, ''The Peacock''.

File:Tengu.jpg

2006-04-25T20:54:40Z

Iskander: Promo render of the Tengu

Promo render of the Tengu

Shipyard.plist

2006-04-25T20:31:10Z

Iskander: Initial documentation of shipyard.plist

'''shipyard.plist''' provides Oolite with the information necessary to equip a player-purchaseable ship.

== chance ==
The likelihood that the ship is available for purchase at a station. (See also [[Shipyard.plist#techlevel|techlevel]].)

'''Example:'''
<key>chance</key>
<real>0.25</real>

== optional_equipment ==
This section lists equipment that the ship may be sold with. Oolite will offer variants of basic ship models with a selection of the optional equipment added, and the cost increased accordingly. Do not list equipment in both this section and the [[Shipyard.plist#standard_equipment|standard_equipment]] section, or you will be ripping your customers off.

'''Example: '''
<key>optional_equipment</key>
<array>
<string>EQ_ECM</string>
<string>EQ_FUEL_SCOOPS</string>
<string>EQ_ESCAPE_POD</string>
</array>

== price ==
How much the ship costs to purchase. Be sure to consider [[Shipyard.plist#standard_equipment|standard_equipment]] when you determine ship price.

'''Example:'''
<key>price</key>
<integer>65000</integer>

== standard_equipment ==
Equipment that comes fitted as standard with your ship. Any extras included in this section are ''free'', and should not appear in the [[Shipyard.plist#optional_equipment|optional_equipment]] section, or the station sales screen may offer a model of the ship with equipment it already has. Be sure to factor in the cost of equipment that comes as standard when pricing your ships.

'''Example:''' ''all models of this ship come with a heat shield, pulse laser and a single missile.''
<key>standard_equipment</key>
<dict>
<key>extras</key>
<array>
<string>EQ_HEAT_SHIELD</string>
</array>
<key>forward_weapon_type</key>
<string>EQ_WEAPON_PULSE_LASER</string>
<key>missiles</key>
<integer>1</integer>
</dict>

'''Example:''' ''all models of this ship come with a military laser, but nothing else as standard. If you have equipment listed as optional, the system may offer a tricked-out variant at a greater cost.''
<key>standard_equipment</key>
<dict>
<key>extras</key>
<array/>
<key>forward_weapon_type</key>
<string>EQ_WEAPON_MILITARY_LASER</string>
<key>missiles</key>
<integer>0</integer>
</dict>

== techlevel ==
Minimum tech. level of a system for the ship to be on sale. (See also [[Shipyard.plist#chance|chance]].)

'''Example:'''
<key>techlevel</key>
<integer>4</integer>

== weapon_facings ==
What weapon mounts are available on the ship. This is a bit-mask, so pick the mounts and add the numbers:
1 - Forward
2 - Aft
4 - Port
8 - Starboard

'''Example:''' ''fore and aft weapon mounts only.''
<key>weapon_facings</key>
<integer>3</integer>

'''Example:''' all weapon mounts.''
<key>weapon_facings</key>
<integer>15</integer>

'''Note:''' ''does something bad happen if the [[Shipdata.plist#weapon_position_..|shipdata weapon positions]] and the weapon_facings don't match?''

--------------------------------------------------------------------------------
[[Category:Oolite]]