Difference between revisions of "User:Cassiel Seraphim/ESI"

From EVE University Wiki
Jump to: navigation, search
m
Line 1: Line 1:
This is just a page to help me document how to decipher the NPC stats available from CCP through the [https://esi.evetech.net/ui/ EVE Swagger Interface (ESI)], for example output for an [https://esi.evetech.net/latest/universe/types/52213/?datasource=tranquility&language=en-us Anchoring Kikimora]
+
This is just a page to help me document how to decipher the data available from CCP through the [https://esi.evetech.net/ui/ EVE Swagger Interface (ESI)], for example output for an [https://esi.evetech.net/latest/universe/types/52213/?datasource=tranquility&language=en-us Anchoring Kikimora] with specific focus to the ''dogma''-attributes.
 
== Warp disruption and warp scrambling ==
 
== Warp disruption and warp scrambling ==
{| class="wikitable" style="text-font:left; td:nth-child(4) { background:red; color:wheat; };"
+
{| class="wikitable" style="text-font:left;"
! style="background-color:#111111; text-align:left;" | AttributeID
+
! style="background-color:#222222; text-align:left;" | AttributeID
! style="background-color:#111111; text-align:left;" | AttributeName
+
! style="background-color:#222222; text-align:left;" | AttributeName
! style="background-color:#111111; text-align:left;" | Description
+
! style="background-color:#222222; text-align:left;" | Description
 +
! style="background-color:#222222; text-align:left;" | CategoryName
 
! style="background-color:#222222; color:wheat; text-align:left;" | My notes
 
! style="background-color:#222222; color:wheat; text-align:left;" | My notes
 
|-
 
|-
Line 10: Line 11:
 
| behaviorWarpScrambleDuration
 
| behaviorWarpScrambleDuration
 
|
 
|
 +
| Behavior Attributes
 
| New AI - Duration in miliseconds.
 
| New AI - Duration in miliseconds.
 
|-
 
|-
Line 15: Line 17:
 
| behaviorWarpScrambleRange
 
| behaviorWarpScrambleRange
 
|
 
|
 +
| Behavior Attributes
 
| New AI - Range in meters.
 
| New AI - Range in meters.
 
|-
 
|-
Line 20: Line 23:
 
| behaviorWarpScrambleDischarge
 
| behaviorWarpScrambleDischarge
 
|
 
|
 +
| Behavior Attributes
 
| New AI - Cap usage in GJ.
 
| New AI - Cap usage in GJ.
 
|-
 
|-
Line 25: Line 29:
 
| behaviorWarpScrambleStrength
 
| behaviorWarpScrambleStrength
 
|
 
|
 +
| Behavior Attributes
 
| New AI - Warp scramble strength (so far always a real scram).
 
| New AI - Warp scramble strength (so far always a real scram).
 
|-
 
|-
Line 30: Line 35:
 
| Warp Disruption Range (warpScrambleRange)
 
| Warp Disruption Range (warpScrambleRange)
 
| Maximum range objects can be warp scrambled from.
 
| Maximum range objects can be warp scrambled from.
 +
| EW - Warp Scrambling
 
| Old AI - Range in meters.
 
| Old AI - Range in meters.
 
|-
 
|-
Line 35: Line 41:
 
| Warp Scramble Strength (warpScrambleStrength)
 
| Warp Scramble Strength (warpScrambleStrength)
 
| Amount to modify ships warp scramble status by.
 
| Amount to modify ships warp scramble status by.
 +
| EW - Warp Scrambling
 
| Old AI - Warp disrupt/scramble strength.
 
| Old AI - Warp disrupt/scramble strength.
 
|-
 
|-
Line 40: Line 47:
 
| entityWarpScrambleChance
 
| entityWarpScrambleChance
 
| Chance of entity warp scrambling it's target.
 
| Chance of entity warp scrambling it's target.
 +
| EW - Warp Scrambling
 
| Old AI - Some NPCs don't warp disrupt/scram every cycle.
 
| Old AI - Some NPCs don't warp disrupt/scram every cycle.
 
|-
 
|-
Line 45: Line 53:
 
| Duration (warpScrambleDuration)
 
| Duration (warpScrambleDuration)
 
|  
 
|  
 +
| EW - Warp Scrambling
 
| Old AI - Duration in miliseconds (can be null).
 
| Old AI - Duration in miliseconds (can be null).
 
|-
 
|-
Line 50: Line 59:
 
| activationBlockedStrenght
 
| activationBlockedStrenght
 
|
 
|
 +
| EW - Warp Scrambling
 
| Old AI - Denotes warp scrambling effect (instead of just disruption).
 
| Old AI - Denotes warp scrambling effect (instead of just disruption).
 +
|-
 +
| 104
 +
| Warp Scramble Status (warpScrambleStatus)
 +
| Warp ability of a ship.  If greater than zero than the ship cannot warp.
 +
| Miscellaneous
 +
| Unique AI - Only on CONCORD Police Captains (effect unconfirmed).
 
|}
 
|}
 
==== Distinguishing between a warp disrupter and a warp scrambler ====
 
==== Distinguishing between a warp disrupter and a warp scrambler ====
In the good old day no NPC actually warp scrambled, they all just warp disrupted at various strengths. With the introduction of the Burners, this changed and yet again with the new AI seen in Triglavian invasion rats etc. There are two things to check to see if it's a warp disrupter or a warp scrambler:
+
In the good old day no NPC actually warp scrambled (shuts down microjump- and microwarpdrives), they all just warp disrupted at various strengths. With the introduction of the [[Burner Mission|Burner missions]] (2014), followed by diamond ♦-named NPCs and [[Forward Operating Base]]s (2017) as well as [[Triglavian Invasion]]s (2019) this changed. There are now two things to check to see if an NPC uses normal warp disruption or actual warp scrambling:
  
* Old AI - An actual warp scrambler will have the attribute 1350 (activationBlockedStrenght) set to 1.
+
* {{co|slateblue|Old AI}} - An actual warp scrambler will have the attribute 1350 (activationBlockedStrenght) set to 1.
* New AI - All NPCs with the behavior-attribute of 2509 (behaviorWarpScrambleStrength) use actual warp scramblers.
+
* {{co|violet|New AI}}  - All NPCs with the behavior-attribute of 2509 (behaviorWarpScrambleStrength) use actual warp scramblers.
  
==== Consolidating old and new data ====
+
==== Consolidating & sanity checks ====
So far there doesn't seem to be an overlap of identical types of data between the old and new AI, if it's a newer NPC using the new behavior-attributes it doesn't have the old attributes. This means that you can use things like coalesce in sql, or similar functions, because they will never both be set to non-null values for a single entity.
+
So far there doesn't seem to be an overlap of identical types of data between the old and new AI, if it's a newer NPC using the new behavior-attributes it doesn't have the equivalent old attributes. This means that you can use things like coalesce in sql, or similar functions, because they will never both be set to non-null values for a single entity. There will also be entries with only some of the warp disrupt attributes, like the '''Renyn Meten''' that has a warp disrupt chance value in attribute 504 but no other attributes so it cannot actually warp disrupt.
  
* Warp disruption/scramble '''range''' is either attribute 103 (old) or 2507 (new).
+
* {{co|lightgreen|Warp disruption range}} is either attribute {{co|slateblue|103}} (old) or {{co|violet|2507}} (new).
* Warp disruption '''strength''' is either attribute 105 8old) or 2509 (new).
+
* {{co|lightgreen|Warp scramble strength}} is either attribute {{co|slateblue|105}} (old) or {{co|violet|2509}} (new) and values above 1 doesn't necessarily mean it's a scram.
* Warp disruption '''duration''' is either attribute 505, 2506)
+
* {{co|lightgreen|Warp disruption duration}} is either attribute {{co|slateblue|505}} (old) or {{co|violet|2506}} (new) but can also be null.
* Warp disruption '''chance''' is attribute 504 (old) or null (new).
+
* {{co|lightgreen|Warp disruption chance}} is attribute {{co|slateblue|504}} (old) or {{co|violet|null}} (new).
* Warp disruption '''discharge''' is attribute 2508 (new) but will be null for old AI who don't use cap.
+
* {{co|lightgreen|Warp disruption discharge}} is attribute {{co|violet|2508}} (new) but will be {{co|slateblue|null}} for old AI who don't use cap.
* Warp '''scrambling''' effect is true if either 1350 (old) or 2509 (new) is not null.
+
* {{co|lightgreen|Warp scrambling effect}} is true if either {{co|slateblue|1350}} (old) or {{co|violet|2509}} (new) is not null.
 +
* {{co|lightgreen|Warp scramble status}} is attribute {{co|slateblue|104}} but is seemingly only used for CONCORD vessels (presumably to ensure players can't fit warp core stabs to overcome the warp scramble strength).
 +
 
 +
= Attribute categories =
 +
Here's a list of the attribute categories used. Keep in mind that the new behavior-attributes are all lumped up into one and won't show up in the various EWAR-categories like the old attributes did and on top of that there's the odd stat that ends up under ''"Miscellaneous"'' or something. So while they help a little, it's always best to go through all attributes to make sure you're not missing an important attribute that isn't labelled correctly.
 +
 
 +
{| class="wikitable collapsible collapsed" style="text-font:left;"
 +
! style="background-color:#222222; text-align:left;" | CategoryID 
 +
! style="background-color:#222222; text-align:left;" | CategoryName
 +
! style="background-color:#222222; text-align:left;" | CategoryDescription
 +
|-
 +
| 1 || Fitting || Fitting capabilities of a ship
 +
|-
 +
| 2 || Shield || Shield attributes of ships
 +
|-
 +
| 3 || Armor || Armor attributes of ships
 +
|-
 +
| 4 || Structure || Structure attributes of ships
 +
|-
 +
| 5 || Capacitor || Capacitor attributes for ships
 +
|-
 +
| 6 || Targeting || Targeting Attributes for ships
 +
|-
 +
| 7 || Miscellaneous || Misc. attributes
 +
|-
 +
| 8 || Required Skills || Skill requirements
 +
|-
 +
| 9 || NULL || Attributes already checked and not going into a category
 +
|-
 +
| 10 || Drones || All you need to know about drones
 +
|-
 +
| 12 || AI || Attribs for the AI configuration
 +
|-
 +
| 17 || Speed || Attributes used for velocity, speed and such
 +
|-
 +
| 19 || Loot || Attributes that affect loot drops
 +
|-
 +
| 20 || Remote Assistance || Remote shield transfers, armor, structure and such 
 +
|-
 +
| 21 || EW - Target Painting || NPC Target Painting Attributes
 +
|-
 +
| 22 || EW - Energy Neutralizing || NPC Energy Neutralizing Attributes
 +
|-
 +
| 23 || EW - Remote Electronic Counter Measures || NPC Remote Electronic Counter Measures Attributes
 +
|-
 +
| 24 || EW - Sensor Dampening || NPC Sensor Dampening Attributes
 +
|-
 +
| 25 || EW - Target Jamming || NPC Target Jamming Attributes
 +
|-
 +
| 26 || EW - Tracking Disruption || NPC Tracking Disruption Attributes
 +
|-
 +
| 27 || EW - Warp Scrambling || NPC Warp Scrambling Attributes
 +
|-
 +
| 28 || EW - Webbing || NPC Stasis Webbing  Attributes
 +
|-
 +
| 29 || Turrets || NPC Turrets Attributes
 +
|-
 +
| 30 || Missile || NPC Missile Attributes
 +
|-
 +
| 31 || Graphics || NPC Graphic Attributes
 +
|-
 +
| 32 || Entity Rewards || NPC Entity Rewards Attributes
 +
|-
 +
| 33 || Entity Extra Attributes || NPC Extra Attributes
 +
|-
 +
| 34 || Fighter Abilities || Fighter abilities are like built-in modules on fighters
 +
|-
 +
| 36 || EW - Resistance || Resistances to different types of EWar Effects
 +
|-
 +
| 37 || Bonuses || Bonuses
 +
|-
 +
| 38 || Fighter Attributes || Attributes related to fighters (but not abilities)
 +
|-
 +
| 39 || Superweapons || Attributes relating to Doomsdays and Superweapons
 +
|-
 +
| 40 || Hangars & Bays || Hangars & Bays
 +
|-
 +
| 41 || On Death || Attributes relating to the death of a ship
 +
|-
 +
| 42 || Behavior Attributes || NPC Behavior Attributes
 +
|-
 +
|}

Revision as of 16:26, 16 August 2019

This is just a page to help me document how to decipher the data available from CCP through the EVE Swagger Interface (ESI), for example output for an Anchoring Kikimora with specific focus to the dogma-attributes.

Warp disruption and warp scrambling

AttributeID AttributeName Description CategoryName My notes
2506 behaviorWarpScrambleDuration Behavior Attributes New AI - Duration in miliseconds.
2507 behaviorWarpScrambleRange Behavior Attributes New AI - Range in meters.
2508 behaviorWarpScrambleDischarge Behavior Attributes New AI - Cap usage in GJ.
2509 behaviorWarpScrambleStrength Behavior Attributes New AI - Warp scramble strength (so far always a real scram).
103 Warp Disruption Range (warpScrambleRange) Maximum range objects can be warp scrambled from. EW - Warp Scrambling Old AI - Range in meters.
105 Warp Scramble Strength (warpScrambleStrength) Amount to modify ships warp scramble status by. EW - Warp Scrambling Old AI - Warp disrupt/scramble strength.
504 entityWarpScrambleChance Chance of entity warp scrambling it's target. EW - Warp Scrambling Old AI - Some NPCs don't warp disrupt/scram every cycle.
505 Duration (warpScrambleDuration) EW - Warp Scrambling Old AI - Duration in miliseconds (can be null).
1350 activationBlockedStrenght EW - Warp Scrambling Old AI - Denotes warp scrambling effect (instead of just disruption).
104 Warp Scramble Status (warpScrambleStatus) Warp ability of a ship. If greater than zero than the ship cannot warp. Miscellaneous Unique AI - Only on CONCORD Police Captains (effect unconfirmed).

Distinguishing between a warp disrupter and a warp scrambler

In the good old day no NPC actually warp scrambled (shuts down microjump- and microwarpdrives), they all just warp disrupted at various strengths. With the introduction of the Burner missions (2014), followed by diamond ♦-named NPCs and Forward Operating Bases (2017) as well as Triglavian Invasions (2019) this changed. There are now two things to check to see if an NPC uses normal warp disruption or actual warp scrambling:

  • Old AI - An actual warp scrambler will have the attribute 1350 (activationBlockedStrenght) set to 1.
  • New AI - All NPCs with the behavior-attribute of 2509 (behaviorWarpScrambleStrength) use actual warp scramblers.

Consolidating & sanity checks

So far there doesn't seem to be an overlap of identical types of data between the old and new AI, if it's a newer NPC using the new behavior-attributes it doesn't have the equivalent old attributes. This means that you can use things like coalesce in sql, or similar functions, because they will never both be set to non-null values for a single entity. There will also be entries with only some of the warp disrupt attributes, like the Renyn Meten that has a warp disrupt chance value in attribute 504 but no other attributes so it cannot actually warp disrupt.

  • Warp disruption range is either attribute 103 (old) or 2507 (new).
  • Warp scramble strength is either attribute 105 (old) or 2509 (new) and values above 1 doesn't necessarily mean it's a scram.
  • Warp disruption duration is either attribute 505 (old) or 2506 (new) but can also be null.
  • Warp disruption chance is attribute 504 (old) or null (new).
  • Warp disruption discharge is attribute 2508 (new) but will be null for old AI who don't use cap.
  • Warp scrambling effect is true if either 1350 (old) or 2509 (new) is not null.
  • Warp scramble status is attribute 104 but is seemingly only used for CONCORD vessels (presumably to ensure players can't fit warp core stabs to overcome the warp scramble strength).

Attribute categories

Here's a list of the attribute categories used. Keep in mind that the new behavior-attributes are all lumped up into one and won't show up in the various EWAR-categories like the old attributes did and on top of that there's the odd stat that ends up under "Miscellaneous" or something. So while they help a little, it's always best to go through all attributes to make sure you're not missing an important attribute that isn't labelled correctly.