Role - Revision history

Cholmondely: Added note about age of page

2021-11-04T04:12:40Z

Added note about age of page

Eric Walch: typo

2012-09-18T19:12:30Z

typo

Eric Walch: Added alloy and wreckage roles

2012-09-18T19:11:21Z

Added alloy and wreckage roles

Eric Walch: Added cargopod role

2012-09-18T18:53:11Z

Added cargopod role

Svengali: fight the deadend pages

2012-06-02T13:05:49Z

fight the deadend pages

SandJ: Typos

2012-04-22T22:06:05Z

Typos

Show changes

Eric Walch at 10:15, 21 April 2012

2012-04-21T10:15:00Z

Eric Walch: Addd further difference between police and interceptor role

2012-04-21T10:13:29Z

Addd further difference between police and interceptor role

Eric Walch: Added scripting category

2011-11-15T10:29:48Z

Added scripting category

Eric Walch: Added info for shuttles & hunters

2010-12-07T22:01:58Z

Added info for shuttles & hunters

← Older revision		Revision as of 04:12, 4 November 2021
Line 1:		Line 1:
		+	This page was last edited in 2012. Oolite v.1.80 introduced new AI's which probably replaced what is here. See the '''notice''' on [[OXP howto AI]].
		+
	==Overview==		==Overview==
	<i>Currently most common roles encountered in Oolite:</i>		<i>Currently most common roles encountered in Oolite:</i>

@@ Line 65: / Line 65: @@
-<b>ALLOY</b> alloy is the role used by metal pieces that are released and remain in the system when a ship explodes. The total amount of alloy that is released in explosions depends on the ships mass.
+<b>ALLOY:</b> alloy is the role used by metal pieces that are released and remain in the system when a ship explodes. The total amount of alloy that is released in explosions depends on the ships mass.
-<b>WRECKAGE</b> wreckage is the role used by metal pieces that are released at a high temperature when a ship explodes. Wreckage only lives for a short moment (0.25s till 1.25s) and is scaled on explosion to a certain percentage of the the size of the exploding ship.  The total amount of wreckage that is released in explosions depends on the ships mass and the shipkey 'fragment_chance'.
+<b>WRECKAGE:</b> wreckage is the role used by metal pieces that are released at a high temperature when a ship explodes. Wreckage only lives for a short moment (0.25s till 1.25s) and is scaled on explosion to a certain percentage of the size of the exploding ship.  The total amount of wreckage that is released in explosions depends on the ships mass and the shipkey 'fragment_chance'.
 ==Special cases==

@@ Line 58: / Line 58: @@
-b>CARRIER:</b> The role 'carrier' was used in the past to define a ship as being a carrier. This role however is deprecated in favour of the shipkey 'is_carrier'. and should no longer be used.
+<b>CARRIER:</b> The role 'carrier' was used in the past to define a ship as being a carrier. This role however is deprecated in favour of the shipkey 'is_carrier'. and should no longer be used.
 <b>Carriers</b> should be given a customAI. But really it's not a good idea to call carriers by a standard game role as they’ll get launched and get stuck. You’d need to give them a custom AI and it would be better really to place them by script.
 <b>CARGOPOD & 1t-CARGOPOD:</b> cargopod is the default role for cargo. 1t-cargopod is a special role that is exclusively used to fill up the player ship when he launches from a station. Besides cargopod, cargo can also have a commodity role. Whenever Oolite want to fill pods with a specific commodity it first has a 50% chance of selecting a cargopod that uses that commodity in its roles. The other 50% a pod with role 'cargopod' is used.
 ==Special cases==

← Older revision		Revision as of 18:53, 18 September 2012
Line 58:		Line 58:


		+	b>CARRIER:</b> The role 'carrier' was used in the past to define a ship as being a carrier. This role however is deprecated in favour of the shipkey 'is_carrier'. and should no longer be used.
	<b>Carriers</b> should be given a customAI. But really it's not a good idea to call carriers by a standard game role as they’ll get launched and get stuck. You’d need to give them a custom AI and it would be better really to place them by script.		<b>Carriers</b> should be given a customAI. But really it's not a good idea to call carriers by a standard game role as they’ll get launched and get stuck. You’d need to give them a custom AI and it would be better really to place them by script.

		+
		+	<b>CARGOPOD & 1t-CARGOPOD:</b> cargopod is the default role for cargo. 1t-cargopod is a special role that is exclusively used to fill up the player ship when he launches from a station. Besides cargopod, cargo can also have a commodity role. Whenever Oolite want to fill pods with a specific commodity it first has a 50% chance of selecting a cargopod that uses that commodity in its roles. The other 50% a pod with role 'cargopod' is used.

	==Special cases==		==Special cases==

@@ Line 1: / Line 1: @@
 <i>Currently most common roles encountered in Oolite:</i>
-trader, scavenger, hunter, miner, pirate, thargoid, police, wingman, interceptor, escort, shuttle, station, asteroid, missile, cargopod, etc
+trader, scavenger, hunter, miner, pirate, thargoid, police, wingman, interceptor, escort, shuttle, station, asteroid, missile, cargopod, etc.
 <i>Disclaimer:</i> The text below is an impromptu explanation from LittleBear, and he makes a point of noting that he will want to "tidy up" this article in the not-so-far future. As this is as yet the only exhaustive article about this topic on the wiki, however, it might be added that perhaps he is being overly critical about himself here :)
-The explanations about scan class and its relation to the roles of <b>police, wingman</b> and <b>interceptor</b> are from Ahruman, "What the roles do" from Commander McLane.
+The explanations about scan class and its relation to the roles of <b>police, wingman</b> and <b>interceptor</b> are from Ahruman, "What they do" from Commander McLane.
-<i>What the roles do:</i>
+==What they do==
 The purpose of roles is - simply said - to call an entity into being, with a specific role, like the role some actor plays in a movie or theater. The actor with the role Hero is - in most cases at least - different from the actor with the role Villain, and again different from the actor with the role Gentle Maid. That means that the set of properties attached to each of them is different. Hero: good, Villain: bad, Gentle Maid: helpless and in love with the hero. This set of properties is in Oolite defined in shipdata. So the only logical and convenient way is to have a different shipdata-entry for each role. And a play or movie in which the hero, the villain and the gentle maid are just the same character usually makes not much sense.
-<i>How the roles work:</i>
+==How they work==
 The <b>Role</b> given will determine the ships behaviour and when the game adds it. Oolite will give a ship called as an escort the correct bounty if the bounty key is left out, but will over-ride if one is added. In an entry for a ship with a role “escort” don’t put in any bounty key at all. If the ship is called as a pirate escort then it will be an offender. If called as a clean trader’s escort it will be clean, provided it has no bounty key set in ship data. If you give it a bounty it always has this one. So if you gave a Longshot bounty zero then it will still be clean when escorting a pirate. Escorts really therefore need a separate entry with no bounty key set and only the role escort set for that entry. This is why you really need a separate entry for each type of ship. Just adding roles to the same ship data entry means you get Clean pirates and Offender police ships if the bounty key is included. This is a summary of what the various in-built roles do:
@@ Line 58: / Line 56: @@
 <b>Carriers</b> should be given a customAI. But really it's not a good idea to call carriers by a standard game role as they’ll get launched and get stuck. You’d need to give them a custom AI and it would be better really to place them by script.
 <i>How the police roles (police, wingman, interceptor) & police scan class (police) work:</i>
 The only supported configuration for <b>police</b> is <b>scan class police, bounty 0</b> and one of the roles <b>police, interceptor or wingman</b>. <b>Interceptors</b> are generated in addition to <b>police</b> in high-tech systems, while <b>wingman</b> is used instead of <b>escort</b> for police ships with an escort's property. The primary distinction between wingmen and escorts is that wingmen turn into <b>police</b> with route1patrolAI if their owner dies.
 [[Category:Oolite]]
 [[Category:Oolite scripting]]

@@ Line 46: / Line 46: @@
-<b>POLICE & INTERCEPTOR:</b> Police and interceptors are ships that search the system for offenders and ships that attack clean ships. Interceptor should be an advanced version of plain police ships. It is better not to assign both roles to one ship, but to choose between both roles.  Whenever Oolite wants to add police, it first looks at the technical level of a system. In low-tech systems it adds ships with role police, while in high-tech systems it becomes more likely that interceptors are added. The interceptor role is only used for selecting superior police ships among the installed ships. After adding interceptors to the game, they get a "police" role like the normal police. police & interceptor roles are also used to select the default defense ships of stations. On launch all defense ships will get a "defense_ship" role.<BR>
+<b>POLICE & INTERCEPTOR:</b> Police and interceptors are ships that search the system for offenders and ships that attack clean ships. Interceptor should be an advanced version of plain police ships. Whenever Oolite wants to add police, it first looks at the technical level of a system. In low-tech systems it adds ships with role police, while in high-tech systems it becomes more likely that interceptors are added. The interceptor role is only used for selecting superior police ships among the installed ships. After adding interceptors to the game, they get a "police" role like the normal police. police & interceptor roles are also used to select the default defense ships of stations. On launch all defense ships will get a "defense_ship" role.<BR>
 Creators of ships should avoid to assign both a <code>police</code> and <code>interceptor</code> role to the same ship. They should make a choice between them. This will help the system to better differentiate the choice of ships between high and low-tech systems. The role choice that the populator uses, reads in JS code:
  var role = (Math.random()*7+6 <= system.techLevel) ? "interceptor" : "police";

← Older revision		Revision as of 10:13, 21 April 2012
Line 46:		Line 46:


−	<b>POLICE & INTERCEPTOR:</b> Police and interceptors are ships that search the system for offenders and ships that attack clean ships. Interceptor should be an advanced version of plain police ships. It is better not to assign both roles to one ship, but to choose between both roles. Whenever Oolite wants to add police, it first looks at the technical level of a system. In low-tech systems it adds ships with role police, while in high-tech systems it becomes more likely that interceptors are added. The interceptor role is only used for selecting superior police ships among the installed ships. After adding interceptors to the game, they get a "police" role like the normal police. police & interceptor roles are also used to select the default defense ships of stations. On launch all defense ships will get a "defense_ship" role.	+	<b>POLICE & INTERCEPTOR:</b> Police and interceptors are ships that search the system for offenders and ships that attack clean ships. Interceptor should be an advanced version of plain police ships. It is better not to assign both roles to one ship, but to choose between both roles. Whenever Oolite wants to add police, it first looks at the technical level of a system. In low-tech systems it adds ships with role police, while in high-tech systems it becomes more likely that interceptors are added. The interceptor role is only used for selecting superior police ships among the installed ships. After adding interceptors to the game, they get a "police" role like the normal police. police & interceptor roles are also used to select the default defense ships of stations. On launch all defense ships will get a "defense_ship" role.<BR>
		+	Creators of ships should avoid to assign both a <code>police</code> and <code>interceptor</code> role to the same ship. They should make a choice between them. This will help the system to better differentiate the choice of ships between high and low-tech systems. The role choice that the populator uses, reads in JS code:
		+	var role = (Math.random()*7+6 <= system.techLevel) ? "interceptor" : "police";

← Older revision		Revision as of 10:29, 15 November 2011
Line 66:		Line 66:
	---------------------------------------------------------------------------------------		---------------------------------------------------------------------------------------

−	{{stub}}
	[[Category:Oolite]]		[[Category:Oolite]]
		+	[[Category:Oolite scripting]]

@@ Line 40: / Line 40: @@
-<b>SHUTTLE:</b> Shuttles are launched by stations and fly to the planet. They also take off from the planet and dock with stations. Big ships will crash into the station or get stuck in the docking bay. They are also total cowards and NEVER fight back if attacked. This makes sense in the native game as only Worms, Shuttles and Transporters have this role. As these ships are all unarmed, they cannot fight back so it makes sense for the AI to tell them to always run. If you give another ship this role (however powerful it is) it will always run. Condors fleeing Adders doesn’t really look good.
+<b>SHUTTLE:</b> Shuttles are launched by stations and fly to the planet. They also take off from the planet and dock with stations. Big ships will crash into the station or get stuck in the docking bay. They are also total cowards and NEVER fight back if attacked. This makes sense in the native game as only Worms, Shuttles and Transporters have this role. As these ships are all unarmed, they cannot fight back so it makes sense for the AI to tell them to always run. If you give another ship this role (however powerful it is) it will always run. Condors fleeing Adders doesn’t really look good.<br>When a ship with a shuttle role collides with a planet, this is interpreted as a landing, any other role would just crash.
-<b>HUNTER:</b> These ships cruse the space lanes and attack offenders and ships with bounties (including the player of cause). They are pretty brave in combat only fleeing if really badly hurt and sometimes fight to the death. I’d use powerful ships here.
+<b>HUNTER:</b> These ships cruse the space lanes and attack offenders and ships with bounties (including the player of cause). They are pretty brave in combat only fleeing if really badly hurt and sometimes fight to the death. I’d use powerful ships here. <br>Hunters, like police, can accept escorts of the same scan_class as itself, even when the ship was defined with zero escorts.
@@ Line 49: / Line 49: @@
-<b>WINGMAN:</b> ONLY police ships should be given this role. A wingman forms up on the wing of a ship with the role POLICE. Its random whether a police ship has Wingmen (and how many), but this is how the game creates the little squadrons of cops that you sometimes see flying in formation. Really only small police ships should have this role. A Viper flying lead to a Condor doesn’t look that good (the Condor is also likely to get an AI failer as a wingman – as it cannot keep up with the Viper). Its better really not to use powerful ships as wingmen. Use them as police instead. That way a cop Super Cobra or Condor will be the lead ship with a few small ships on his wings.
+<b>WINGMAN:</b> ONLY police ships should be given this role. A wingman forms up on the wing of a ship with the role POLICE. Its random whether a police ship has Wingmen (and how many), but this is how the game creates the little squadrons of cops that you sometimes see flying in formation. Really only small police ships should have this role. A Viper flying lead to a Condor doesn’t look that good (the Condor is also likely to get an AI failer as a wingman – as it cannot keep up with the Viper). Its better really not to use powerful ships as wingmen. Use them as police instead. That way a cop Super Cobra or Condor will be the lead ship with a few small ships on his wings.<br>When after a fight, the lead-ship was destroyed, one of the wingman will change to police role and the remaining wingman will follow him.