User:Cassiel Seraphim/ESI

From EVE University Wiki
Jump to: navigation, search

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

Most attributes fall into a certain category for easy grouping. In theory, very useful, but sadly 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.

Click the [show]-button to expand the list and show all the categories.