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

From EVE University Wiki
Jump to: navigation, search
Line 74: Line 74:
 
* {{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.
 
* {{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.
 
* {{co|lightgreen|Warp scramble duration}} is either attribute {{co|slateblue|505}} (old) or {{co|violet|2506}} (new) but can also be null.
 
* {{co|lightgreen|Warp scramble duration}} is either attribute {{co|slateblue|505}} (old) or {{co|violet|2506}} (new) but can also be null.
* {{co|lightgreen|Warp scramble chance}} is attribute {{co|slateblue|504}} (old) or {{co|violet|null}} (new) and if '''null''' should be treated as 1 (100% chance).
+
* {{co|lightgreen|Warp scramble chance}} is attribute {{co|slateblue|504}} (old) or {{co|violet|null}} (new) and if '''null''' should be treated as 1 (100% chance) if they otherwise have at least strength and range.
 
* {{co|lightgreen|Warp scramble discharge}} is attribute {{co|violet|2508}} (new) but will be {{co|slateblue|null}} for old AI (doesn't simulate cap usage).
 
* {{co|lightgreen|Warp scramble discharge}} is attribute {{co|violet|2508}} (new) but will be {{co|slateblue|null}} for old AI (doesn't simulate cap usage).
 
* {{co|lightgreen|Warp scrambling effect}} is true if either {{co|slateblue|1350}} (old) or {{co|violet|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.
  
 
If you're writing a function or script to check for warp disruption capabilities, it's best to double-check that you have entries for both {{co|lightgreen|warp scramble strength}} and {{co|lightgreen|range}} (they should all have at least those two entries if they actually have warp disrupt capabilities), then if they do also adjust the {{co|lightgreen|warp scramble chance}} to 1 if it's null and check to see if it's the effect is that of a '''warp disruptor''' or a '''warp scrambler'''. The existence of {{co|lightgreen|warp scramble duration}} and {{co|lightgreen|discharge}} will then vary.
 
If you're writing a function or script to check for warp disruption capabilities, it's best to double-check that you have entries for both {{co|lightgreen|warp scramble strength}} and {{co|lightgreen|range}} (they should all have at least those two entries if they actually have warp disrupt capabilities), then if they do also adjust the {{co|lightgreen|warp scramble chance}} to 1 if it's null and check to see if it's the effect is that of a '''warp disruptor''' or a '''warp scrambler'''. The existence of {{co|lightgreen|warp scramble duration}} and {{co|lightgreen|discharge}} will then vary.
 +
 
= Attribute categories =
 
= 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.
 
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.

Revision as of 17:27, 19 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 warpScrambleRange Maximum range objects can be warp scrambled from. EW - Warp Scrambling Old AI - Range in meters.
105 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 warpScrambleDuration Duration 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).

Distinguishing between a warp disruptor 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 and 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 scramble 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 scramble duration is either attribute 505 (old) or 2506 (new) but can also be null.
  • Warp scramble chance is attribute 504 (old) or null (new) and if null should be treated as 1 (100% chance) if they otherwise have at least strength and range.
  • Warp scramble discharge is attribute 2508 (new) but will be null for old AI (doesn't simulate cap usage).
  • Warp scrambling effect is true if either 1350 (old) or 2509 (new) is not null.

If you're writing a function or script to check for warp disruption capabilities, it's best to double-check that you have entries for both warp scramble strength and range (they should all have at least those two entries if they actually have warp disrupt capabilities), then if they do also adjust the warp scramble chance to 1 if it's null and check to see if it's the effect is that of a warp disruptor or a warp scrambler. The existence of warp scramble duration and discharge will then vary.

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.