User:Cassiel Seraphim/ESI

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).
• 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.

CategoryID	CategoryName	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