Difference between revisions of "Escort Contracts OXP"

From Elite Wiki
Line 1: Line 1:
 
== Overview ==
 
== Overview ==
  
Escort Contracts test version 0.9.2 (29/4/11)
+
Escort Contracts version 1.0 (8/5/11)
 
By Capt Murphy 2011
 
By Capt Murphy 2011
Licence: CC BY-NC-SA 3.0
+
Licence: CC BY-NC-SA 3.0 : Please visit http://creativecommons.org/licenses/by-nc-sa/3.0/ for more info.
Tested on Oolite versions 1.75.1 and (trunk) 1.75.2.4517
+
Tested and working on Oolite versions 1.75.1, and trunk revisions 1.75.2.4517 and1.75.2.4544
  
Allow players to enter into short-term escort contracts with NPC lone wolf traders. Fully functional test release.
+
Allows players to enter into short-term escort contracts with NPC lone wolf traders.
  
 
== Description ==
 
== Description ==
Line 12: Line 12:
 
The Independent Traders and Hauliers Association have reacted to demand from lone wolf NPC Traders and introduced a system to allow them to enter into short-term escort contracts with vetted and rated freelance escort pilots.
 
The Independent Traders and Hauliers Association have reacted to demand from lone wolf NPC Traders and introduced a system to allow them to enter into short-term escort contracts with vetted and rated freelance escort pilots.
  
Players who wish want to access these contracts must purchase a I.T.H.A Independent Escort License available to players with a Clean legal status at non Anarchy systems with a Tech Level of 3 or above.
+
Players who wish want to access these contracts must purchase an I.T.H.A Independent Escort License available to players with a Clean legal status at non Anarchy systems with a Tech Level of 3 or above.
  
Once purchased players whose legal rating is still Clean may be offered short term escort contracts on docking at a systems main station. The chance of being offered contracts is based on the players reputation as an escort. The fees offered are also affected by the players reputation as an escort and government type of the target system. Target systems are always within 1 jump of the starting system. Reputation is increased when a contract is successfully fulfilled and reduced when a contract is failed.
+
Once purchased players whose legal rating is still Clean may be offered short term escort contracts on docking at a system’s main station. The chance of being offered contracts is based on the player’s reputation as an escort. The fees offered are also affected by the player’s reputation as an escort and government type of the target system. Target systems are always within 1 jump of the starting system. Reputation is increased when a contract is successfully fulfilled and reduced when a contract is failed.
  
Once agreed the player has 3 game hours to launch from the station or the contract is failed. The NPC trader (or 'mother') will be waiting in the station aegis and will prompt the player to approach as they prepare to jump to the target system. The player can follow them through their wormhole or alternatively jump themselves to the target system (within a time limit). Failure to arrive at the target system ends the contract.
+
Once a contract is agreed the player has 3 game hours to launch from the station or the contract is failed (be careful about buying equipment – it takes up time). The NPC trader (or 'mother') will be waiting in the station aegis and will prompt the player to approach as they prepare to jump to the target system. The player can follow them through their wormhole or alternatively jump themselves to the target system. Failure to arrive at the target system by the point the wormhole expires ends the contract.
  
Once in the target system the players task is to escort the mother to the system's main station. Mothers will issue various prompts to players in flight, will request assistance if attacked, and will assist the player if the player is attacked. The contract is fulfilled once the mother has entered the aegis of the target system's main station.
+
Once in the target system the player’s task is to escort the mother to the system's main station. Mothers will issue various prompts to players in flight, will request assistance if attacked, and will assist the player if the player is attacked. The contract is fulfilled once the mother has entered the aegis of the target system's main station, unless there are hostile craft in the vicinity in which case the player must stand by to protect the mother until it has safely docked.
  
 +
== Game Balance and Playability ==
  
== Game Balance and Playability ==
+
In order to avoid these contracts being long and rather dull in between hostile encounters, this OXP gives the mother the ability to 'synchronise jump drives' with the player. The mother has been given scan_class CLASS_ROCK (but with custom scanner colours) so will not mass-lock the player. In flight if there is nothing else to mass-lock the player the mother will prompt the player to approach within 2500m. Within this distance the mother will synchronise jump drives with the player and 'hop' towards the mother's destination, taking the player with it (checking to see if the player is mass-locked just before every 'hop'). 'Hops' are 1/2 scanner range and occur very 2 seconds so this method should not avoid contact with other ships.
  
In order to avoid these missions being long and rather dull (in between hostile encounters), this OXP gives the mother the ability to 'synchronise jump drives' with the player. The mother has been given scan_class CLASS_ROCK (but with custom scanner colours) so will not mass-lock the player. In flight if there is nothing else to mass-lock the player the mother will prompt the player to approach within 2500m. Within this distance the mother will synchronise jump drives with the player and 'hop' towards the mother's destination, taking the player with it (checking to see if the player is mass-locked just before every 'hop'). 'Hops' are 1 scanner range and occur very 2 seconds so this method should not avoid contact with other ships.
+
If the player is mass-locked but with no hostile contacts in the vicinity the mother may after a short delay decide to try and use injectors to get out of the mass-locked situation so that the player and mother can take advantage of the mother’s synchronised jump drive capability. This feature will only operate if the player also has working injectors and at least 1 LY of fuel.
  
If the player is masslocked but with no hostile contacts in the vicinity the mother will also after a few minutes decide to try and use injectors to get out of the mass-locked situation so that the player and mother can take advantage of the mothers synchronised jump drive capability.
+
Mother’s may be an Anaconda, Boa, Boa Cruiser or Python and all come equipped with ECM, injectors, and fore and aft beam lasers as standard.
  
Mothers are also a bit beefier than standard traders, sporting front military lasers, rear beam lasers, shield boosters, ECM's, and fuel injectors as standard.
 
  
 
== Known Issues ==
 
== Known Issues ==
  
Mothers should be visible on the Advanced Space Compass as a 'M'. Unfortunately due to a bug in 1.75.1 this does not work after the mother has jumped to the target system. This has been fixed in trunk with version 1.75.2.4517
+
Mothers should be visible on the Advanced Space Compass as a 'M'. Unfortunately due to a bug in Oolite 1.75.1 this does not work after the mother has jumped to the target system. This has been fixed in trunk with version 1.75.2.4517.
 +
 
 +
In trunk version 1.75.2.4540 (and probably 4538 & 4539) mother is not added to the target system when the player follows through the wormhole. Fixed in trunk with version 1.75.2.4544 (nightly build 8/5/11).
 +
 
  
 
== Change Log ==
 
== Change Log ==
Line 37: Line 40:
 
Version 0.9 (24/4/11) - Initial Release.
 
Version 0.9 (24/4/11) - Initial Release.
  
Version 0.9.1 (29/4/11) - Fixed a bug in detecting player kills (the mother should pay a bonus for hostile kills made during the contract - was broken in version 0.9). Added code for mother to use injectors to try and escape from mass lock situations after a few minutes. Made criteria for contract success arrival in target system's station aegis rather than mother safely docked to save player time. Replaced the shield enhancers with shield boosters as standard equipment for mothers as mothers were a bit too tough and contracts too easy in 0.9. Added code to stop the I.T.H.A. Independent Escort License being damaged in combat. Added an additional world script to display the players escort reputation on the manifest screen.
+
Version 0.9.1 (29/4/11)
 +
 
 +
Fixed a bug in detecting player kills (the mother should pay a bonus for hostile kills made during the contract - was broken in version 0.9).  
 +
Added code for mother to use injectors to try and escape from mass lock situations after a few minutes.
 +
Made criteria for contract success arrival in target system's station aegis rather than mother safely docked to save player time.  
 +
Replaced shield enhancers with shield boosters as standard equipment for mothers as they were a little too uber.  
 +
Added code to stop the I.T.H.A. Independent Escort License being damaged in combat.  
 +
Added an additional world script which displays the players escort reputation on the manifest screen.
 +
 
 +
Version 0.9.2 (29/4/11)
 +
 
 +
Fixed a small bug in calculation and display of contract prices.
 +
 
 +
Version 1.0 (8/5/11)
  
Version 0.9.2 (29/4/11) – Fixed a small bug in calculation of contract prices. I forgot to round them.
+
Added a cap to escort reputation.
 +
Removed shield boosters as standard equipment for mothers and gave them fore beam lasers instead of military lasers. Mothers now really do need your help to survive an encounter with multiple hostiles.
 +
Many improvements to the AI for the mother using injectors feature.
 +
Fixed a cosmetic bug in the mission screen timing.
 +
Fixed a bug where the mother could still be found waiting to dock after the player had docked, met the mother’s pilot in the bar, got their reward and re-launched.
 +
Improvements and bug fixes to the combat AI, mainly relating to mother - player communication.
 +
Removed player auto targeting mother’s primary aggressor (potential for confusion if other auto target-locking OXP’s are installed).
 +
Adjusted criteria for contract success. If no hostiles in vicinity the contract is fulfilled once the mother is in the station aegis. If there are hostiles in the vicinity when the mother arrives in the aegis the player must not dock until the mother is safely docked to fulfill the contract. The mother will explicitly tell the player this on arrival at the station aegis.
 +
Added code so that if repeatedly attacked by the player, the mother will eventually ‘turn’ and attack the player. The contract is immediately failed at this point.
 +
Added code so the timer the checks to see if the player has followed the mother through it’s wormhole kicks as the wormhole closes. Uses same calculation as oolite engine to work out wormhole expiry time depending on the mother ship mass.
  
 
Feedback can be left on the OXPs discussion topic at [http://www.aegidian.org/bb/viewtopic.php?f=4&t=9713 Oolite BB]
 
Feedback can be left on the OXPs discussion topic at [http://www.aegidian.org/bb/viewtopic.php?f=4&t=9713 Oolite BB]
Line 45: Line 70:
 
== Download Links ==
 
== Download Links ==
  
Download version 0.9.2: [http://www.box.net/shared/fsmb5x04yv box.net]
+
Download version 1.0: [http://www.box.net/shared/60fs2sp7uc box.net]
  
 
{{mission-OXP}}
 
{{mission-OXP}}

Revision as of 09:51, 8 May 2011

Overview

Escort Contracts version 1.0 (8/5/11) By Capt Murphy 2011 Licence: CC BY-NC-SA 3.0 : Please visit http://creativecommons.org/licenses/by-nc-sa/3.0/ for more info. Tested and working on Oolite versions 1.75.1, and trunk revisions 1.75.2.4517 and1.75.2.4544

Allows players to enter into short-term escort contracts with NPC lone wolf traders.

Description

The Independent Traders and Hauliers Association have reacted to demand from lone wolf NPC Traders and introduced a system to allow them to enter into short-term escort contracts with vetted and rated freelance escort pilots.

Players who wish want to access these contracts must purchase an I.T.H.A Independent Escort License available to players with a Clean legal status at non Anarchy systems with a Tech Level of 3 or above.

Once purchased players whose legal rating is still Clean may be offered short term escort contracts on docking at a system’s main station. The chance of being offered contracts is based on the player’s reputation as an escort. The fees offered are also affected by the player’s reputation as an escort and government type of the target system. Target systems are always within 1 jump of the starting system. Reputation is increased when a contract is successfully fulfilled and reduced when a contract is failed.

Once a contract is agreed the player has 3 game hours to launch from the station or the contract is failed (be careful about buying equipment – it takes up time). The NPC trader (or 'mother') will be waiting in the station aegis and will prompt the player to approach as they prepare to jump to the target system. The player can follow them through their wormhole or alternatively jump themselves to the target system. Failure to arrive at the target system by the point the wormhole expires ends the contract.

Once in the target system the player’s task is to escort the mother to the system's main station. Mothers will issue various prompts to players in flight, will request assistance if attacked, and will assist the player if the player is attacked. The contract is fulfilled once the mother has entered the aegis of the target system's main station, unless there are hostile craft in the vicinity in which case the player must stand by to protect the mother until it has safely docked.

Game Balance and Playability

In order to avoid these contracts being long and rather dull in between hostile encounters, this OXP gives the mother the ability to 'synchronise jump drives' with the player. The mother has been given scan_class CLASS_ROCK (but with custom scanner colours) so will not mass-lock the player. In flight if there is nothing else to mass-lock the player the mother will prompt the player to approach within 2500m. Within this distance the mother will synchronise jump drives with the player and 'hop' towards the mother's destination, taking the player with it (checking to see if the player is mass-locked just before every 'hop'). 'Hops' are 1/2 scanner range and occur very 2 seconds so this method should not avoid contact with other ships.

If the player is mass-locked but with no hostile contacts in the vicinity the mother may after a short delay decide to try and use injectors to get out of the mass-locked situation so that the player and mother can take advantage of the mother’s synchronised jump drive capability. This feature will only operate if the player also has working injectors and at least 1 LY of fuel.

Mother’s may be an Anaconda, Boa, Boa Cruiser or Python and all come equipped with ECM, injectors, and fore and aft beam lasers as standard.


Known Issues

Mothers should be visible on the Advanced Space Compass as a 'M'. Unfortunately due to a bug in Oolite 1.75.1 this does not work after the mother has jumped to the target system. This has been fixed in trunk with version 1.75.2.4517.

In trunk version 1.75.2.4540 (and probably 4538 & 4539) mother is not added to the target system when the player follows through the wormhole. Fixed in trunk with version 1.75.2.4544 (nightly build 8/5/11).


Change Log

Version 0.9 (24/4/11) - Initial Release.

Version 0.9.1 (29/4/11)

Fixed a bug in detecting player kills (the mother should pay a bonus for hostile kills made during the contract - was broken in version 0.9). Added code for mother to use injectors to try and escape from mass lock situations after a few minutes. Made criteria for contract success arrival in target system's station aegis rather than mother safely docked to save player time. Replaced shield enhancers with shield boosters as standard equipment for mothers as they were a little too uber. Added code to stop the I.T.H.A. Independent Escort License being damaged in combat. Added an additional world script which displays the players escort reputation on the manifest screen.

Version 0.9.2 (29/4/11)

Fixed a small bug in calculation and display of contract prices.

Version 1.0 (8/5/11)

Added a cap to escort reputation. Removed shield boosters as standard equipment for mothers and gave them fore beam lasers instead of military lasers. Mothers now really do need your help to survive an encounter with multiple hostiles. Many improvements to the AI for the mother using injectors feature. Fixed a cosmetic bug in the mission screen timing. Fixed a bug where the mother could still be found waiting to dock after the player had docked, met the mother’s pilot in the bar, got their reward and re-launched. Improvements and bug fixes to the combat AI, mainly relating to mother - player communication. Removed player auto targeting mother’s primary aggressor (potential for confusion if other auto target-locking OXP’s are installed). Adjusted criteria for contract success. If no hostiles in vicinity the contract is fulfilled once the mother is in the station aegis. If there are hostiles in the vicinity when the mother arrives in the aegis the player must not dock until the mother is safely docked to fulfill the contract. The mother will explicitly tell the player this on arrival at the station aegis. Added code so that if repeatedly attacked by the player, the mother will eventually ‘turn’ and attack the player. The contract is immediately failed at this point. Added code so the timer the checks to see if the player has followed the mother through it’s wormhole kicks as the wormhole closes. Uses same calculation as oolite engine to work out wormhole expiry time depending on the mother ship mass.

Feedback can be left on the OXPs discussion topic at Oolite BB

Download Links

Download version 1.0: box.net