core

package
v0.1.14 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Feb 6, 2023 License: MIT Imports: 25 Imported by: 0

Documentation

Overview

Proto-based function interface for the simulator

Functions for creating common types of auras.

Index

Constants

View Source
const (
	ItemIDAtieshMage            = 22589
	ItemIDAtieshWarlock         = 22630
	ItemIDBraidedEterniumChain  = 24114
	ItemIDChainOfTheTwilightOwl = 24121
	ItemIDEyeOfTheNight         = 24116
	ItemIDJadePendantOfBlasting = 20966
	ItemIDTheLightningCapacitor = 28785
)

IDs for items used in core

View Source
const (
	ProcMaskMeleeMH = ProcMaskMeleeMHAuto | ProcMaskMeleeMHSpecial
	ProcMaskMeleeOH = ProcMaskMeleeOHAuto | ProcMaskMeleeOHSpecial
	// Equivalent to in-game mask of 4.
	ProcMaskMeleeWhiteHit = ProcMaskMeleeMHAuto | ProcMaskMeleeOHAuto
	// Equivalent to in-game mask of 68.
	ProcMaskWhiteHit = ProcMaskMeleeMHAuto | ProcMaskMeleeOHAuto | ProcMaskRangedAuto
	// Equivalent to in-game mask of 16.
	ProcMaskMeleeSpecial = ProcMaskMeleeMHSpecial | ProcMaskMeleeOHSpecial
	// Equivalent to in-game mask of 272.
	ProcMaskMeleeOrRangedSpecial = ProcMaskMeleeSpecial | ProcMaskRangedSpecial
	// Equivalent to in-game mask of 20.
	ProcMaskMelee = ProcMaskMeleeWhiteHit | ProcMaskMeleeSpecial
	// Equivalent to in-game mask of 320.
	ProcMaskRanged = ProcMaskRangedAuto | ProcMaskRangedSpecial
	// Equivalent to in-game mask of 340.
	ProcMaskMeleeOrRanged = ProcMaskMelee | ProcMaskRanged

	ProcMaskDirect = ProcMaskMelee | ProcMaskRanged | ProcMaskSpellDamage

	ProcMaskTwoRoll = ProcMaskRanged | ProcMaskMeleeSpecial

	ProcMaskSpecial = ProcMaskMeleeOrRangedSpecial | ProcMaskSpellDamage
)
View Source
const (
	CooldownPriorityLow       = -1.0
	CooldownPriorityDefault   = 0.0
	CooldownPriorityDrums     = 2.0
	CooldownPriorityBloodlust = 1.0
)
View Source
const ArmorPenPerPercentArmor = 13.99
View Source
const AverageMagicPartialResistMultiplier = 0.94
View Source
const BleedEffectCategory = "BleedDamage"
View Source
const BlockRatingPerBlockChance = 16.39
View Source
const BloodlustAuraTag = "Bloodlust"
View Source
const BloodlustCD = time.Minute * 10
View Source
const BloodlustDuration = time.Second * 40
View Source
const CharacterLevel = 80
View Source
const CritRatingPerCritChance = 45.91
View Source
const DTPSReferenceStat = stats.Armor
View Source
const DefenseRatingPerDefense = 4.92
View Source
const DefenseRatingToChanceReduction = (1.0 / DefenseRatingPerDefense) * MissDodgeParryBlockCritChancePerDefense / 100
View Source
const Diminish_Cd_Druid = 116.890707 / 100
View Source
const Diminish_Cd_Nondruid = 88.129021 / 100
View Source
const Diminish_Cm = 16.000 / 100
View Source
const Diminish_Cp = 47.003525 / 100
View Source
const Diminish_kCd_Druid = (Diminish_k_Druid * Diminish_Cd_Druid)
View Source
const Diminish_kCd_Nondruid = (Diminish_k_Nondruid * Diminish_Cd_Nondruid)
View Source
const Diminish_kCm_Druid = (Diminish_k_Druid * Diminish_Cm)
View Source
const Diminish_kCm_Nondruid = (Diminish_k_Nondruid * Diminish_Cm)
View Source
const Diminish_kCp = (Diminish_k_Nondruid * Diminish_Cp)
View Source
const Diminish_k_Druid = 0.972

Could be in constants.go, but they won't be used anywhere else C values are divided by 100 so that we are working with 1% = 0.01

View Source
const Diminish_k_Nondruid = 0.956
View Source
const DivineGuardianCD = time.Minute * 2
View Source
const DivineGuardianDuration = time.Second * 6
View Source
const DodgeRatingPerDodgeChance = 45.25
View Source
const EnemyAutoAttackAPCoefficient = 0.0002883296

TODO: More log scraping to verify this value for WOTLK. Assuming 574 AP debuffs go to exactly zero and achieve -14.2%

View Source
const EnergyPerTick = 1.0

Extra 0.2 because Blizzard

View Source
const EnergyTickDuration = time.Millisecond * 100

Time between energy ticks.

View Source
const ExpertisePerQuarterPercentReduction = 32.79 / 4 // TODO: Does it still cutoff at 1/4 percents?
View Source
const GCDDefault = time.Millisecond * 1500
View Source
const GCDMin = time.Second * 1
View Source
const HasteRatingPerHastePercent = 32.79
View Source
const HuntersMarkAuraTag = "HuntersMark"
View Source
const Inactive = -1
View Source
const InnervateCD = time.Minute * 3
View Source
const InnervateDuration = time.Second * 10
View Source
const LongDuration = 300
View Source
const ManaTideTotemCD = time.Minute * 5
View Source
const ManaTideTotemDuration = time.Second * 12
View Source
const MaxRage = 100.0
View Source
const MeleeAttackRatingPerDamage = 14.0
View Source
const MeleeHitRatingPerHitChance = 32.79
View Source
const MissDodgeParryBlockCritChancePerDefense = 0.04
View Source
const NeverExpires = time.Duration(math.MaxInt64)
View Source
const PainSuppressionCD = time.Minute * 3
View Source
const PainSuppressionDuration = time.Second * 8
View Source
const ParryRatingPerParryChance = 45.25
View Source
const PowerInfusionCD = time.Minute * 2
View Source
const PowerInfusionDuration = time.Second * 15
View Source
const RageFactor = 453.3
View Source
const ReplenishmentAuraDuration = time.Second * 15
View Source
const ResilienceRatingPerCritDamageReductionPercent = 39.4231 / 2.2
View Source
const ResilienceRatingPerCritReductionChance = 82.0
View Source
const ShatteringThrowCD = time.Minute * 5
View Source
const ShortDuration = 60
View Source
const SpellHitRatingPerHitChance = 26.232
View Source
const ThreatPerManaGained = 0.5
View Source
const ThreatPerRageGained = 5
View Source
const TricksOfTheTradeCD = time.Second * 3600 // CD is 30s from the time buff ends (so 40s with glyph) but that's in order to be able to set the number of TotT you'll have during the fight
View Source
const UnholyFrenzyCD = time.Minute * 3
View Source
const UnholyFrenzyDuration = time.Second * 30

Variables

View Source
var AddEffectsToTest = true

This value can be set before adding item effects, to control whether they are included in tests.

View Source
var AlchStoneItemIDs = []int32{44322, 44323, 44324}
View Source
var AverageDefaultSimTestOptions = &proto.SimOptions{
	Iterations: 2000,
	IsTest:     true,
	Debug:      false,
	RandomSeed: 101,
}
View Source
var BaseStats = map[BaseStatsKey]stats.Stats{}
View Source
var BloodlustActionID = ActionID{SpellID: 2825}
View Source
var ChanceOfDeathAuraLabel = "Chance of Death"
View Source
var CobaltFragBombActionID = ActionID{ItemID: 40771}
View Source
var ConjuredAuraTag = "Conjured"
View Source
var DefaultSimTestOptions = &proto.SimOptions{
	Iterations: 20,
	IsTest:     true,
	Debug:      false,
	RandomSeed: 101,
}
View Source
var DefaultTargetProto = &proto.Target{
	Level: CharacterLevel + 3,
	Stats: stats.Stats{
		stats.Armor:       10643,
		stats.AttackPower: 320,
		stats.BlockValue:  54,
	}.ToFloatArray(),
	MobType: proto.MobType_MobTypeDemon,

	SwingSpeed:    2,
	MinBaseDamage: 4192.05,
	ParryHaste:    true,
}
View Source
var DivineGuardianAuraTag = "DivineGuardian"
View Source
var EnchantsByEffectID = map[int32]Enchant{}
View Source
var ExplosiveDecoyActionID = ActionID{ItemID: 40536}
View Source
var FaerieFireAuraTag = "Faerie Fire"
View Source
var FullDebuffs = &proto.Debuffs{
	BloodFrenzy:        true,
	CurseOfElements:    true,
	CurseOfWeakness:    proto.TristateEffect_TristateEffectImproved,
	EarthAndMoon:       true,
	EbonPlaguebringer:  true,
	ExposeArmor:        true,
	FaerieFire:         proto.TristateEffect_TristateEffectImproved,
	GiftOfArthas:       true,
	HeartOfTheCrusader: true,
	ImprovedScorch:     true,
	InsectSwarm:        true,
	JudgementOfLight:   true,
	JudgementOfWisdom:  true,
	Mangle:             true,
	Misery:             true,
	ScorpidSting:       true,
	ShadowEmbrace:      true,
	ShadowMastery:      true,
	SunderArmor:        true,
	ThunderClap:        proto.TristateEffect_TristateEffectImproved,
	TotemOfWrath:       true,
	Vindication:        true,
}
View Source
var FullIndividualBuffs = &proto.IndividualBuffs{
	BlessingOfKings:     true,
	BlessingOfMight:     proto.TristateEffect_TristateEffectImproved,
	BlessingOfSanctuary: true,
	BlessingOfWisdom:    proto.TristateEffect_TristateEffectImproved,
	JudgementsOfTheWise: true,
	VampiricTouch:       true,
}
View Source
var FullPartyBuffs = &proto.PartyBuffs{

	ManaTideTotems: 1,
}
View Source
var FullRaidBuffs = &proto.RaidBuffs{
	AbominationsMight:     true,
	ArcaneBrilliance:      true,
	ArcaneEmpowerment:     true,
	BattleShout:           proto.TristateEffect_TristateEffectImproved,
	Bloodlust:             true,
	DemonicPact:           500,
	DevotionAura:          proto.TristateEffect_TristateEffectImproved,
	DivineSpirit:          true,
	ElementalOath:         true,
	FerociousInspiration:  true,
	GiftOfTheWild:         proto.TristateEffect_TristateEffectImproved,
	IcyTalons:             true,
	LeaderOfThePack:       proto.TristateEffect_TristateEffectImproved,
	ManaSpringTotem:       proto.TristateEffect_TristateEffectRegular,
	MoonkinAura:           proto.TristateEffect_TristateEffectImproved,
	PowerWordFortitude:    proto.TristateEffect_TristateEffectImproved,
	SanctifiedRetribution: true,
	ShadowProtection:      true,
	StrengthOfEarthTotem:  proto.TristateEffect_TristateEffectImproved,
	SwiftRetribution:      true,
	Thorns:                proto.TristateEffect_TristateEffectImproved,
	TotemOfWrath:          true,
	TrueshotAura:          true,
	UnleashedRage:         true,
	WindfuryTotem:         proto.TristateEffect_TristateEffectImproved,
	WrathOfAirTotem:       true,
}
View Source
var GemsByID = map[int32]Gem{}
View Source
var InnervateAuraTag = "Innervate"
View Source
var ItemsByID = map[int32]Item{}
View Source
var JudgementOfLightAuraLabel = "Judgement of Light"
View Source
var JudgementOfWisdomAuraLabel = "Judgement of Wisdom"
View Source
var ManaTideTotemActionID = ActionID{SpellID: 16190}
View Source
var ManaTideTotemAuraTag = "ManaTideTotem"
View Source
var (
	OutcomePartialOffset = bits.TrailingZeros(uint(OutcomePartial1))
)
View Source
var PainSuppressionAuraTag = "PainSuppression"
View Source
var PotionAuraTag = "Potion"
View Source
var PowerInfusionAuraTag = "PowerInfusion"
View Source
var PresetEncounters []*proto.PresetEncounter
View Source
var SaroniteBombActionID = ActionID{ItemID: 41119}
View Source
var ShatteringThrowAuraTag = "ShatteringThrow"
View Source
var ShatteringThrowDuration = time.Second * 10
View Source
var StatWeightsDefaultSimTestOptions = &proto.SimOptions{
	Iterations: 300,
	IsTest:     true,
	Debug:      false,
	RandomSeed: 101,
}
View Source
var ThermalSapperActionID = ActionID{ItemID: 42641}
View Source
var TricksOfTheTradeAuraTag = "TricksOfTheTrade"
View Source
var UnholyFrenzyAuraTag = "UnholyFrenzy"
View Source
var WITH_DB = false

Functions

func AddItemToSets added in v0.1.5

func AddItemToSets(item Item)

func AddPresetEncounter

func AddPresetEncounter(name string, targetPaths []string)

func AddPresetTarget

func AddPresetTarget(newPreset *PresetTarget)

func AddWeaponEffect

func AddWeaponEffect(id int32, weaponEffect ApplyWeaponEffect)

func ApplyFixedUptimeAura

func ApplyFixedUptimeAura(aura *Aura, uptime float64, tickLength time.Duration)

func ApplyInspiration

func ApplyInspiration(character *Character, uptime float64)

func ApplyPetConsumeEffects

func ApplyPetConsumeEffects(pet *Character, ownerConsumes *proto.Consumes)

func ApplyProcTriggerCallback added in v0.1.7

func ApplyProcTriggerCallback(unit *Unit, aura *Aura, config ProcTrigger)

func BlessingOfSanctuaryAura

func BlessingOfSanctuaryAura(character *Character)

func BothTimersReady

func BothTimersReady(t1 *Timer, t2 *Timer, sim *Simulation) bool

func BothTimersReadyAt

func BothTimersReadyAt(t1 *Timer, t2 *Timer) time.Duration

func CharacterStatsTest

func CharacterStatsTest(label string, t *testing.T, raid *proto.Raid, expectedStats stats.Stats)

func ColorIntersects added in v0.1.5

func ColorIntersects(g proto.GemColor, o proto.GemColor) bool

func ComputeStats

*

  • Returns character stats taking into account gear / buffs / consumes / etc

func DurationFromSeconds

func DurationFromSeconds(numSeconds float64) time.Duration

func EquipmentSpecFromJsonString added in v0.1.5

func EquipmentSpecFromJsonString(jsonString string) *proto.EquipmentSpec

func FillTalentsProto added in v0.1.10

func FillTalentsProto(data protoreflect.Message, talentsStr string, treeSizes [3]int)

Uses proto reflection to set fields in a talents proto (e.g. MageTalents, WarriorTalents) based on a talentsStr. treeSizes should contain the number of talents in each tree, usually around 30. This is needed because talent strings truncate 0's at the end of each tree so we can't infer the start index of the tree from the string.

func FilterMap added in v0.1.5

func FilterMap[K comparable, V any](src map[K]V, f func(K, V) bool) map[K]V

Returns a new map containing only the key/value pairs for which f returns true.

func FilterSlice added in v0.1.5

func FilterSlice[T any](src []T, f func(T) bool) []T

Returns a new slice containing only the elements for which f returns true.

func FocusMagicAura added in v0.1.10

func FocusMagicAura(caster *Character, target *Character) (*Aura, *Aura)

func GetActionAvgCast

func GetActionAvgCast(playerMetrics *proto.UnitMetrics, actionID ActionID) float64

Calculates average cast damage for an action.

func GetActionDPS

func GetActionDPS(playerMetrics *proto.UnitMetrics, iterations int32, duration time.Duration, actionID ActionID, ignoreTag bool) float64

Calculates DPS for an action.

func GetPrimaryTalentTreeIndex added in v0.1.1

func GetPrimaryTalentTreeIndex(talentStr string) uint8

Returns the talent tree (0, 1, or 2) of the tree with the most points.

talentStr is expected to be a wowhead-formatted talent string, e.g. "12123131-123123123-123123213"

func GetTristateValueFloat

func GetTristateValueFloat(effect proto.TristateEffect, regularValue float64, impValue float64) float64

func GetTristateValueInt32

func GetTristateValueInt32(effect proto.TristateEffect, regularValue int32, impValue int32) int32

func HasEnchantEffect added in v0.1.3

func HasEnchantEffect(id int32) bool

func HasItemEffect

func HasItemEffect(id int32) bool

func HasItemEffectForTest

func HasItemEffectForTest(id int32) bool

func HasWeaponEffect

func HasWeaponEffect(id int32) bool

func InnervateManaThreshold

func InnervateManaThreshold(character *Character) float64

func MakeSingleTargetEncounter

func MakeSingleTargetEncounter(variation float64) *proto.Encounter

func MakeTristateValue

func MakeTristateValue(hasRegular bool, hasImproved bool) proto.TristateEffect

func MapMap added in v0.1.5

func MapMap[KI comparable, VI any, KO comparable, VO any](src map[KI]VI, f func(KI, VI) (KO, VO)) map[KO]VO

Returns a new map by applying f to each key/value pair in src.

func MapSlice added in v0.1.5

func MapSlice[I any, O any](src []I, f func(I) O) []O

Returns a new slice by applying f to each element in src.

func MaxDuration

func MaxDuration(a time.Duration, b time.Duration) time.Duration

func MaxFloat

func MaxFloat(a float64, b float64) float64

func MaxInt

func MaxInt(a int, b int) int

func MaxInt32

func MaxInt32(a int32, b int32) int32

func MaxTimeToReady

func MaxTimeToReady(t1 *Timer, t2 *Timer, sim *Simulation) time.Duration

func MinDuration

func MinDuration(a time.Duration, b time.Duration) time.Duration

func MinFloat

func MinFloat(a float64, b float64) float64

func MinInt

func MinInt(a int, b int) int

func MinInt32

func MinInt32(a int32, b int32) int32

func NewDefaultTarget

func NewDefaultTarget() *proto.Target

func NewEnchantEffect added in v0.1.3

func NewEnchantEffect(id int32, enchantEffect ApplyEffect)

func NewItemEffect

func NewItemEffect(id int32, itemEffect ApplyEffect)

Registers an ApplyEffect function which will be called before the Sim starts, for any Agent that is wearing the item.

func NewSimpleStatDefensiveTrinketEffect

func NewSimpleStatDefensiveTrinketEffect(itemID int32, bonus stats.Stats, duration time.Duration, cooldown time.Duration)

func NewSimpleStatItemActiveEffect

func NewSimpleStatItemActiveEffect(itemID int32, bonus stats.Stats, duration time.Duration, cooldown time.Duration, sharedCDFunc func(*Character) Cooldown, otherEffects ApplyEffect)

func NewSimpleStatItemEffect

func NewSimpleStatItemEffect(itemID int32, bonus stats.Stats, duration time.Duration, cooldown time.Duration)

No shared CD

func NewSimpleStatOffensiveTrinketEffect

func NewSimpleStatOffensiveTrinketEffect(itemID int32, bonus stats.Stats, duration time.Duration, cooldown time.Duration)

func NewSimpleStatOffensiveTrinketEffectWithOtherEffects added in v0.1.7

func NewSimpleStatOffensiveTrinketEffectWithOtherEffects(itemID int32, bonus stats.Stats, duration time.Duration, cooldown time.Duration, otherEffects ApplyEffect)

func PlayerProtoToSpec

func PlayerProtoToSpec(player *proto.Player) proto.Spec

func RaidBenchmark

func RaidBenchmark(b *testing.B, rsr *proto.RaidSimRequest)

func RaidPlayersWithClass

func RaidPlayersWithClass(raid *proto.Raid, class proto.Class) []*proto.Player

func RaidPlayersWithSpec

func RaidPlayersWithSpec(raid *proto.Raid, spec proto.Spec) []*proto.Player

func RaidSimTest

func RaidSimTest(label string, t *testing.T, rsr *proto.RaidSimRequest, expectedDps float64)

func RegisterAgentFactory

func RegisterAgentFactory(emptyOptions interface{}, spec proto.Spec, factory AgentFactory, specSetter SpecSetter)

func RegisterTemporaryStatsOnUseCD

func RegisterTemporaryStatsOnUseCD(character *Character, auraLabel string, tempStats stats.Stats, duration time.Duration, config SpellConfig)

Add a major cooldown to the given agent, which provides a temporary boost to a single stat. This is use for effects like Icon of the Silver Crescent and Bloodlust Brooch.

func ResetRunes

func ResetRunes(runeMeta *RuneMeta)

func RunRaidSim

func RunRaidSim(request *proto.RaidSimRequest) *proto.RaidSimResult

*

  • Runs multiple iterations of the sim with a full raid.

func RunRaidSimAsync

func RunRaidSimAsync(request *proto.RaidSimRequest, progress chan *proto.ProgressMetrics)

func RunSim

func RunSim(rsr *proto.RaidSimRequest, progress chan *proto.ProgressMetrics) (result *proto.RaidSimResult)

func RunTestSuite

func RunTestSuite(t *testing.T, suiteName string, generator TestGenerator)

func ScheduledMajorArmorAura added in v0.1.8

func ScheduledMajorArmorAura(aura *Aura, options PeriodicActionOptions, raid *proto.Raid)

func SinglePlayerRaidProto

func SinglePlayerRaidProto(player *proto.Player, partyBuffs *proto.PartyBuffs, raidBuffs *proto.RaidBuffs, debuffs *proto.Debuffs) *proto.Raid

func StatWeights

func StatWeights(request *proto.StatWeightsRequest) *proto.StatWeightsResult

*

  • Returns stat weights and EP values, with standard deviations, for all stats.

func StatWeightsAsync

func StatWeightsAsync(request *proto.StatWeightsRequest, progress chan *proto.ProgressMetrics)

func StatWeightsTest

func StatWeightsTest(label string, t *testing.T, _swr *proto.StatWeightsRequest, expectedStatWeights stats.Stats)

func Ternary

func Ternary[T any](condition bool, val1 T, val2 T) T

func TernaryDuration

func TernaryDuration(condition bool, val1 time.Duration, val2 time.Duration) time.Duration

func TernaryFloat64

func TernaryFloat64(condition bool, val1 float64, val2 float64) float64

func TernaryInt

func TernaryInt(condition bool, val1 int, val2 int) int

func TernaryInt32

func TernaryInt32(condition bool, val1 int32, val2 int32) int32

func UnitLevelFloat64

func UnitLevelFloat64(unitLevel int32, maxLevelPlus0Val float64, maxLevelPlus1Val float64, maxLevelPlus2Val float64, maxLevelPlus3Val float64) float64

func WithSpec

func WithSpec(player *proto.Player, spec interface{}) *proto.Player

Applies the spec options to the given player. This is only necessary because the generated proto code does not export oneof interface types. Player is returned so this function can be used in-line with player creation.

func WithinToleranceFloat64

func WithinToleranceFloat64(expectedValue float64, actualValue float64, tolerance float64) bool

Types

type AIFactory

type AIFactory func() TargetAI

type ActionID

type ActionID struct {
	// Only one of these should be set.
	SpellID int32
	ItemID  int32
	OtherID proto.OtherAction

	Tag int32
}

func ProtoToActionID

func ProtoToActionID(protoID *proto.ActionID) ActionID

func (ActionID) IsEmptyAction

func (actionID ActionID) IsEmptyAction() bool

func (ActionID) IsItemAction

func (actionID ActionID) IsItemAction(itemID int32) bool

func (ActionID) IsOtherAction

func (actionID ActionID) IsOtherAction(otherID proto.OtherAction) bool

func (ActionID) IsSpellAction

func (actionID ActionID) IsSpellAction(spellID int32) bool

func (ActionID) SameAction

func (actionID ActionID) SameAction(other ActionID) bool

func (ActionID) SameActionIgnoreTag

func (actionID ActionID) SameActionIgnoreTag(other ActionID) bool

func (ActionID) String

func (actionID ActionID) String() string

func (ActionID) ToProto

func (actionID ActionID) ToProto() *proto.ActionID

func (ActionID) WithTag

func (actionID ActionID) WithTag(tag int32) ActionID

Returns a new ActionID with the corresponding Tag value.

type ActionMetrics

type ActionMetrics struct {
	IsMelee bool // True if melee action, false if spell action.

	// Metrics for this action, for each possible target.
	Targets []TargetedActionMetrics
}

func (*ActionMetrics) ToProto

func (actionMetrics *ActionMetrics) ToProto(actionID ActionID) *proto.ActionMetrics

type ActionPriority

type ActionPriority int32
const (
	ActionPriorityLow ActionPriority = -1
	ActionPriorityGCD ActionPriority = 0

	// Higher than GCD because regen can cause GCD actions (if we were waiting
	// for mana).
	ActionPriorityRegen ActionPriority = 1

	// Autos can cause regen (JoW, rage, energy procs, etc) so they should be
	// higher prio so that we never go backwards in the priority order.
	ActionPriorityAuto ActionPriority = 2

	// DOTs need to be higher than anything else so that dots can properly expire before we take other actions.
	ActionPriorityDOT ActionPriority = 3
)

type ActiveSetBonus

type ActiveSetBonus struct {
	// Name of the set.
	Name string

	// Number of pieces required for this bonus.
	NumPieces int32

	// Function for applying the effects of this set bonus.
	BonusEffect ApplyEffect
}

type Agent

type Agent interface {
	// The Character controlled by this Agent.
	GetCharacter() *Character

	// Called once after all Players/Pets/Targets have finished the construction phase.
	// Use this to register spells and any initialization steps that require
	// other raid members or auras.
	Initialize()

	// Updates the input Buffs to include raid-wide buffs provided by this Agent.
	AddRaidBuffs(raidBuffs *proto.RaidBuffs)
	// Updates the input Buffs to include party-wide buffs provided by this Agent.
	AddPartyBuffs(partyBuffs *proto.PartyBuffs)

	// All talent stats / auras should be added within this callback. This makes sure
	// talents are applied at the right time so we can calculate groups of stats.
	ApplyTalents()

	// Returns this Agent to its initial state. Called before each Sim iteration
	// and once after the final iteration.
	Reset(sim *Simulation)

	// Called whenever the GCD becomes ready for this Agent.
	OnGCDReady(sim *Simulation)

	// Called after each auto attack performed by this Agent.
	// This is different from Aura.OnSpellHit in that it is invoked fully after
	// everything related to the attack is complete, and it is only invoked for
	// auto attacks (white hits or white-hit-replacers).
	OnAutoAttack(sim *Simulation, spell *Spell)
}

Agent can be thought of as the 'Player', i.e. the thing controlling the Character. This is the interface implemented by each class/spec.

func NewAgent

func NewAgent(party *Party, partyIndex int, player *proto.Player) Agent

Constructs a new Agent.

type AgentFactory

type AgentFactory func(Character, *proto.Player) Agent

type ApplyEffect

type ApplyEffect func(Agent)

Function for applying permanent effects to an Agent.

Passing Character instead of Agent would work for almost all cases, but there are occasionally class-specific item effects.

func MakeTemporaryStatsOnUseCDRegistration

func MakeTemporaryStatsOnUseCDRegistration(auraLabel string, tempStats stats.Stats, duration time.Duration, config SpellConfig, cdFunc func(*Character) Cooldown, sharedCDFunc func(*Character) Cooldown) ApplyEffect

Helper function to make an ApplyEffect for a temporary stats on-use cooldown.

type ApplySpellResults added in v0.1.1

type ApplySpellResults func(sim *Simulation, target *Unit, spell *Spell)

type ApplyWeaponEffect

type ApplyWeaponEffect func(Agent, proto.ItemSlot)

Function for applying permenent effects to an agent's weapon

type AttackTable

type AttackTable struct {
	Attacker *Unit
	Defender *Unit

	BaseMissChance      float64
	BaseSpellMissChance float64
	BaseBlockChance     float64
	BaseDodgeChance     float64
	BaseParryChance     float64
	BaseGlanceChance    float64

	GlanceMultiplier float64
	CritSuppression  float64

	DamageDealtMultiplier               float64 // attacker buff, applied in applyAttackerModifiers()
	DamageTakenMultiplier               float64 // defender debuff, applied in applyTargetModifiers()
	NatureDamageTakenMultiplier         float64
	PeriodicShadowDamageTakenMultiplier float64
	HealingDealtMultiplier              float64
}

Holds cached values for outcome/damage calculations, for a specific attacker+defender pair. These are updated dynamically when attacker or defender stats change.

func NewAttackTable

func NewAttackTable(attacker *Unit, defender *Unit) *AttackTable

func (*AttackTable) GetArmorDamageModifier

func (at *AttackTable) GetArmorDamageModifier(spell *Spell) float64

type Aura

type Aura struct {
	// String label for this Aura. Guaranteed to be unique among the Auras for a single Unit.
	Label string

	// For easily grouping auras.
	Tag string

	ActionID ActionID // If set, metrics will be tracked for this aura.

	Duration time.Duration // Duration of aura, upon being applied.

	// The unit this aura is attached to.
	Unit *Unit

	MaxStacks int32

	ExclusiveEffects []*ExclusiveEffect

	// Lifecycle callbacks.
	OnInit          OnInit
	OnReset         OnReset
	OnDoneIteration OnDoneIteration
	OnGain          OnGain
	OnExpire        OnExpire
	OnStacksChange  OnStacksChange // Invoked when the number of stacks of this aura changes.
	OnStatsChange   OnStatsChange  // Invoked when the stats of this aura owner changes.

	OnCastComplete        OnCastComplete   // Invoked when a spell cast completes casting, before results are calculated.
	OnSpellHitDealt       OnSpellHit       // Invoked when a spell hits and this unit is the caster.
	OnSpellHitTaken       OnSpellHit       // Invoked when a spell hits and this unit is the target.
	OnPeriodicDamageDealt OnPeriodicDamage // Invoked when a dot tick occurs and this unit is the caster.
	OnPeriodicDamageTaken OnPeriodicDamage // Invoked when a dot tick occurs and this unit is the target.
	OnHealDealt           OnSpellHit       // Invoked when a heal hits and this unit is the caster.
	OnHealTaken           OnSpellHit       // Invoked when a heal hits and this unit is the target.
	OnPeriodicHealDealt   OnPeriodicDamage // Invoked when a hot tick occurs and this unit is the caster.
	OnPeriodicHealTaken   OnPeriodicDamage // Invoked when a hot tick occurs and this unit is the target.

	// If non-default, stat bonuses fron the OnGain callback of this aura will be
	// included in Character Stats in the UI.
	BuildPhase CharacterBuildPhase
	// contains filtered or unexported fields
}

Aura lifecycle:

myAura := unit.RegisterAura(myAuraConfig) myAura.Activate(sim) myAura.SetStacks(sim, 3) myAura.Refresh(sim) myAura.Deactivate(sim)

func AcidSpitAura

func AcidSpitAura(target *Unit) *Aura

func BloodFrenzyAura

func BloodFrenzyAura(target *Unit, points int32) *Aura

func BloodlustAura

func BloodlustAura(character *Character, actionTag int32) *Aura

func CurseOfElementsAura

func CurseOfElementsAura(target *Unit) *Aura

func CurseOfWeaknessAura

func CurseOfWeaknessAura(target *Unit, points int32) *Aura

func DemonicPactAura

func DemonicPactAura(character *Character) *Aura

func DemoralizingRoarAura

func DemoralizingRoarAura(target *Unit, points int32) *Aura

func DemoralizingScreechAura added in v0.1.8

func DemoralizingScreechAura(target *Unit) *Aura

func DemoralizingShoutAura

func DemoralizingShoutAura(target *Unit, boomingVoicePts int32, impDemoShoutPts int32) *Aura

func DivineGuardianAura added in v0.1.8

func DivineGuardianAura(character *Character, actionTag int32) *Aura

func EarthAndMoonAura

func EarthAndMoonAura(target *Unit, points int32) *Aura

func EbonPlaguebringerOrCryptFeverAura added in v0.1.8

func EbonPlaguebringerOrCryptFeverAura(caster *Character, target *Unit, epidemicPoints, cryptFeverPoints, ebonPlaguebringerPoints int32) *Aura

func ExposeArmorAura

func ExposeArmorAura(target *Unit, hasGlyph bool) *Aura

func FaerieFireAura

func FaerieFireAura(target *Unit, points int32) *Aura

func FlametongueTotemAura

func FlametongueTotemAura(character *Character) *Aura

func FrostFeverAura

func FrostFeverAura(target *Unit, impIcyTouch int32) *Aura

func GiftOfArthasAura

func GiftOfArthasAura(target *Unit) *Aura

func HeartoftheCrusaderDebuff

func HeartoftheCrusaderDebuff(target *Unit, points float64) *Aura

func HuntersMarkAura

func HuntersMarkAura(target *Unit, points int32, glyphed bool) *Aura

func ImprovedScorchAura

func ImprovedScorchAura(target *Unit) *Aura

func InfectedWoundsAura

func InfectedWoundsAura(target *Unit, points int32) *Aura

func InnervateAura

func InnervateAura(character *Character, expectedBonusManaReduction float64, actionTag int32) *Aura

func InsectSwarmAura

func InsectSwarmAura(target *Unit) *Aura

func InspirationAura

func InspirationAura(unit *Unit, points int32) *Aura

func JudgementOfLightAura

func JudgementOfLightAura(target *Unit) *Aura

func JudgementOfWisdomAura

func JudgementOfWisdomAura(target *Unit) *Aura

func JudgementsOfTheJustAura

func JudgementsOfTheJustAura(target *Unit, points int32) *Aura

Note: Paladin code might apply this as part of their judgement auras instead of using another separate aura.

func MakePermanent

func MakePermanent(aura *Aura) *Aura

Returns the same Aura for chaining.

func MakeProcTriggerAura added in v0.1.7

func MakeProcTriggerAura(unit *Unit, config ProcTrigger) *Aura

func MakeStackingAura added in v0.1.12

func MakeStackingAura(character *Character, config StackingStatAura) *Aura

func ManaTideTotemAura

func ManaTideTotemAura(character *Character, actionTag int32) *Aura

func MangleAura

func MangleAura(target *Unit) *Aura

func MarkOfBloodAura

func MarkOfBloodAura(target *Unit) *Aura

func MasterPoisonerDebuff

func MasterPoisonerDebuff(target *Unit, points float64) *Aura

func MiseryAura

func MiseryAura(target *Unit, points int32) *Aura

func PainSuppressionAura added in v0.1.8

func PainSuppressionAura(character *Character, actionTag int32) *Aura

func PowerInfusionAura

func PowerInfusionAura(character *Character, actionTag int32) *Aura

func RetributionAura

func RetributionAura(character *Character, sanctifiedRetribution bool) *Aura

func RuneOfRazoriceVulnerabilityAura

func RuneOfRazoriceVulnerabilityAura(target *Unit) *Aura

func SavageCombatAura

func SavageCombatAura(target *Unit, points int32) *Aura

func ScorpidStingAura

func ScorpidStingAura(target *Unit) *Aura

func ShadowMasteryAura

func ShadowMasteryAura(target *Unit) *Aura

func ShatteringThrowAura

func ShatteringThrowAura(target *Unit) *Aura

func SporeCloudAura

func SporeCloudAura(target *Unit) *Aura

func StampedeAura

func StampedeAura(target *Unit) *Aura

func StingAura

func StingAura(target *Unit) *Aura

func SunderArmorAura

func SunderArmorAura(target *Unit) *Aura

func ThornsAura

func ThornsAura(character *Character, points int32) *Aura

func ThunderClapAura

func ThunderClapAura(target *Unit, points int32) *Aura

func TotemOfWrathAura

func TotemOfWrathAura(character *Character) *Aura

func TotemOfWrathDebuff

func TotemOfWrathDebuff(target *Unit) *Aura

func TraumaAura

func TraumaAura(target *Unit, points int) *Aura

func TricksOfTheTradeAura

func TricksOfTheTradeAura(character *Character, actionTag int32, glyphed bool) *Aura

func UnholyFrenzyAura

func UnholyFrenzyAura(character *Character, actionTag int32) *Aura

func VindicationAura

func VindicationAura(target *Unit) *Aura

func WintersChillAura

func WintersChillAura(target *Unit, startingStacks int32) *Aura

func (*Aura) Activate

func (aura *Aura) Activate(sim *Simulation)

Adds a new aura to the simulation. If an aura with the same ID already exists it will be replaced with the new one.

func (*Aura) AddStack

func (aura *Aura) AddStack(sim *Simulation)

func (*Aura) ApplyOnExpire added in v0.1.8

func (aura *Aura) ApplyOnExpire(newOnExpire OnExpire)

Adds a handler to be called OnExpire, in addition to any current handlers.

func (*Aura) ApplyOnGain added in v0.1.8

func (aura *Aura) ApplyOnGain(newOnGain OnGain)

Adds a handler to be called OnGain, in addition to any current handlers.

func (*Aura) Deactivate

func (aura *Aura) Deactivate(sim *Simulation)

Remove an aura by its ID

func (*Aura) ExpiresAt

func (aura *Aura) ExpiresAt() time.Duration

func (*Aura) GetStacks

func (aura *Aura) GetStacks() int32

func (*Aura) IsActive

func (aura *Aura) IsActive() bool

func (*Aura) NewExclusiveEffect added in v0.1.8

func (aura *Aura) NewExclusiveEffect(categoryName string, singleAura bool, config ExclusiveEffect) *ExclusiveEffect

func (*Aura) Refresh

func (aura *Aura) Refresh(sim *Simulation)

func (*Aura) RemainingDuration

func (aura *Aura) RemainingDuration(sim *Simulation) time.Duration

func (*Aura) RemoveStack

func (aura *Aura) RemoveStack(sim *Simulation)

func (*Aura) SetStacks

func (aura *Aura) SetStacks(sim *Simulation, newStacks int32)

func (*Aura) ShouldRefreshExclusiveEffects added in v0.1.8

func (aura *Aura) ShouldRefreshExclusiveEffects(sim *Simulation, refreshWindow time.Duration) bool

Returns if an aura should be refreshed, i.e. the aura is inactive/about to expire AND there are no other active effects of equal or greater strength.

func (*Aura) StartedAt

func (aura *Aura) StartedAt() time.Duration

func (*Aura) TimeActive added in v0.1.10

func (aura *Aura) TimeActive(sim *Simulation) time.Duration

The amount of time this aura has been active.

func (*Aura) UpdateExpires

func (aura *Aura) UpdateExpires(newExpires time.Duration)

type AuraCallback added in v0.1.7

type AuraCallback uint16
const (
	CallbackEmpty AuraCallback = 0

	CallbackOnSpellHitDealt AuraCallback = 1 << iota
	CallbackOnSpellHitTaken
	CallbackOnPeriodicDamageDealt
	CallbackOnHealDealt
	CallbackOnPeriodicHealDealt
	CallbackOnCastComplete
)

func (AuraCallback) Matches added in v0.1.7

func (c AuraCallback) Matches(other AuraCallback) bool

type AuraFactory

type AuraFactory func(*Simulation) *Aura

type AuraMetrics

type AuraMetrics struct {
	ID ActionID

	// Metrics for the current iteration.
	Uptime time.Duration
	Procs  int32
	// contains filtered or unexported fields
}

func (*AuraMetrics) ToProto

func (auraMetrics *AuraMetrics) ToProto() *proto.AuraMetrics

type AutoAttackOptions

type AutoAttackOptions struct {
	MainHand        Weapon
	OffHand         Weapon
	Ranged          Weapon
	AutoSwingMelee  bool // If true, core engine will handle calling SwingMelee() for you.
	AutoSwingRanged bool // If true, core engine will handle calling SwingMelee() for you.
	SyncType        int32
	ReplaceMHSwing  ReplaceMHSwing
}

Options for initializing auto attacks.

type AutoAttacks

type AutoAttacks struct {
	MH     Weapon
	OH     Weapon
	Ranged Weapon

	IsDualWielding bool

	// If true, core engine will handle calling SwingMelee(). Set to false to manually manage
	// swings, for example for hunter melee weaving.
	AutoSwingMelee bool

	// If true, core engine will handle calling SwingRanged(). Unless you're a hunter, don't
	// use this.
	AutoSwingRanged bool

	// Set this to 1 to sync your auto attacks together, or 2 to use the OH delay macro, mostly used by enhance shamans.
	// This will intentionally perfectly sync or delay OH swings to that they always fall within the
	// 0.5s window following a MH swing.
	SyncType int32

	MainhandSwingAt time.Duration
	OffhandSwingAt  time.Duration
	RangedSwingAt   time.Duration

	MHConfig     SpellConfig
	OHConfig     SpellConfig
	RangedConfig SpellConfig

	MHAuto     *Spell
	OHAuto     *Spell
	RangedAuto *Spell

	ReplaceMHSwing ReplaceMHSwing

	PreviousSwingAt time.Duration
	// contains filtered or unexported fields
}

func (*AutoAttacks) CancelAutoSwing

func (aa *AutoAttacks) CancelAutoSwing(sim *Simulation)

Stops the auto swing action for the rest of the iteration. Used for pets after being disabled.

func (*AutoAttacks) DelayMeleeBy added in v0.1.3

func (aa *AutoAttacks) DelayMeleeBy(sim *Simulation, delay time.Duration)

Delays all swing timers for the specified amount. Only used by Slam.

func (*AutoAttacks) DelayRangedUntil

func (aa *AutoAttacks) DelayRangedUntil(sim *Simulation, readyAt time.Duration)

func (*AutoAttacks) EnableAutoSwing

func (aa *AutoAttacks) EnableAutoSwing(sim *Simulation)

Renables the auto swing action for the iteration

func (*AutoAttacks) IsEnabled

func (aa *AutoAttacks) IsEnabled() bool

func (*AutoAttacks) MainhandSwingSpeed

func (aa *AutoAttacks) MainhandSwingSpeed() time.Duration

The amount of time between two MH swings.

func (*AutoAttacks) MaybeReplaceMHSwing

func (aa *AutoAttacks) MaybeReplaceMHSwing(sim *Simulation, mhSwingSpell *Spell) *Spell

Optionally replaces the given swing spell with an Agent-specified MH Swing replacer. This is for effects like Heroic Strike or Raptor Strike.

func (*AutoAttacks) NewPPMManager

func (aa *AutoAttacks) NewPPMManager(ppm float64, procMask ProcMask) PPMManager

func (*AutoAttacks) NextAttackAt

func (aa *AutoAttacks) NextAttackAt() time.Duration

Returns the time at which the next attack will occur.

func (*AutoAttacks) OffhandSwingSpeed

func (aa *AutoAttacks) OffhandSwingSpeed() time.Duration

The amount of time between two OH swings.

func (*AutoAttacks) PPMProc added in v0.1.5

func (aa *AutoAttacks) PPMProc(sim *Simulation, ppm float64, procMask ProcMask, label string) bool

Returns whether a PPM-based effect procced.

Using NewPPMManager() is preferred; this function should only be used when the attacker is not known at initialization time.

func (*AutoAttacks) RangedSwingSpeed

func (aa *AutoAttacks) RangedSwingSpeed() time.Duration

The amount of time between two ranged swings.

func (*AutoAttacks) StopMeleeUntil added in v0.1.3

func (aa *AutoAttacks) StopMeleeUntil(sim *Simulation, readyAt time.Duration, desyncOH bool)

StopMeleeUntil should be used whenever a non-melee spell is cast. It stops melee, then restarts it at end of cast, but with a reset swing timer (as if swings had just landed).

func (*AutoAttacks) SwingMelee

func (aa *AutoAttacks) SwingMelee(sim *Simulation, target *Unit)

SwingMelee will check any swing timers if they are up, and if so, swing!

func (*AutoAttacks) SwingRanged

func (aa *AutoAttacks) SwingRanged(sim *Simulation, target *Unit)

func (*AutoAttacks) TrySwingMH

func (aa *AutoAttacks) TrySwingMH(sim *Simulation, target *Unit)

Performs an autoattack using the main hand weapon, if the MH CD is ready.

func (*AutoAttacks) TrySwingOH

func (aa *AutoAttacks) TrySwingOH(sim *Simulation, target *Unit)

Performs an autoattack using the main hand weapon, if the OH CD is ready.

func (*AutoAttacks) TrySwingRanged

func (aa *AutoAttacks) TrySwingRanged(sim *Simulation, target *Unit)

Performs an autoattack using the ranged weapon, if the ranged CD is ready.

func (*AutoAttacks) UpdateSwingTime

func (aa *AutoAttacks) UpdateSwingTime(sim *Simulation)

type BaseStatsKey

type BaseStatsKey struct {
	Race  proto.Race
	Class proto.Class
}

type BuffsCombo

type BuffsCombo struct {
	Label    string
	Raid     *proto.RaidBuffs
	Party    *proto.PartyBuffs
	Debuffs  *proto.Debuffs
	Player   *proto.IndividualBuffs
	Consumes *proto.Consumes
}

func MakeDefaultBuffCombos

func MakeDefaultBuffCombos(config CharacterSuiteConfig) []BuffsCombo

type CanCastCondition added in v0.1.12

type CanCastCondition func(sim *Simulation, target *Unit) bool

type Cast

type Cast struct {
	// Amount of resource that will be consumed by this cast.
	Cost float64

	// The length of time the GCD will be on CD as a result of this cast.
	GCD time.Duration

	// The amount of time between the call to spell.Cast() and when the spell
	// effects are invoked.
	CastTime time.Duration

	// Additional GCD delay after the cast completes.
	ChannelTime time.Duration

	// Additional GCD delay after the cast ends. Never affected by cast speed.
	// This is typically used for latency.
	AfterCastDelay time.Duration
}

func (Cast) EffectiveTime added in v0.1.8

func (cast Cast) EffectiveTime() time.Duration

type CastConfig

type CastConfig struct {
	// Default cast values with all static effects applied.
	DefaultCast Cast

	// Dynamic modifications for each cast.
	ModifyCast func(*Simulation, *Spell, *Cast)

	// Ignores haste when calculating the GCD and cast time for this cast.
	IgnoreHaste bool

	CD       Cooldown
	SharedCD Cooldown

	// Callbacks for providing additional custom behavior.
	OnCastComplete func(*Simulation, *Spell)
}

Input for constructing the CastSpell function for a spell.

type CastFunc

type CastFunc func(*Simulation, *Unit)

type CastSuccessFunc

type CastSuccessFunc func(*Simulation, *Unit) bool

type Character

type Character struct {
	Unit

	Name  string // Different from Label, needed for returned results.
	Race  proto.Race
	Class proto.Class

	// Current gear.
	Equip Equipment
	//Item Swap Handler
	ItemSwap ItemSwap

	// Consumables this Character will be using.
	Consumes *proto.Consumes

	PrimaryTalentTree uint8

	// Up reference to this Character's Party.
	Party *Party

	// This character's index within its party [0-4].
	PartyIndex int

	// Total amount of remaining additional mana expected for the current sim iteration,
	// beyond this Character's mana pool. This should include mana potions / runes /
	// innervates / etc.
	ExpectedBonusMana float64
	// contains filtered or unexported fields
}

Character is a data structure to hold all the shared values that all class logic shares. All players have stats, equipment, auras, etc

func NewCharacter

func NewCharacter(party *Party, partyIndex int, player *proto.Player) Character

func (*Character) AddComboPoints

func (eb *Character) AddComboPoints(sim *Simulation, pointsToAdd int32, metrics *ResourceMetrics)

func (*Character) AddEnergy

func (eb *Character) AddEnergy(sim *Simulation, amount float64, metrics *ResourceMetrics)

func (*Character) AddMajorCooldown

func (mcdm *Character) AddMajorCooldown(mcd MajorCooldown)

Registers a major cooldown to the Character, which will be automatically used when available.

func (*Character) AddPartyBuffs

func (character *Character) AddPartyBuffs(partyBuffs *proto.PartyBuffs)

func (*Character) AddPet

func (character *Character) AddPet(pet PetAgent)

func (*Character) AddRage

func (rb *Character) AddRage(sim *Simulation, amount float64, metrics *ResourceMetrics)

func (*Character) AddRaidBuffs

func (character *Character) AddRaidBuffs(raidBuffs *proto.RaidBuffs)

func (*Character) ComboPoints

func (eb *Character) ComboPoints() int32

func (*Character) CurrentEnergy

func (eb *Character) CurrentEnergy() float64

func (*Character) CurrentHealth

func (hb *Character) CurrentHealth() float64

func (*Character) CurrentHealthPercent

func (hb *Character) CurrentHealthPercent() float64

func (*Character) CurrentRage

func (rb *Character) CurrentRage() float64

func (*Character) DefaultHealingCritMultiplier

func (character *Character) DefaultHealingCritMultiplier() float64

func (*Character) DefaultMeleeCritMultiplier

func (character *Character) DefaultMeleeCritMultiplier() float64

func (*Character) DefaultSpellCritMultiplier

func (character *Character) DefaultSpellCritMultiplier() float64

func (*Character) DelayDPSCooldowns added in v0.1.5

func (mcdm *Character) DelayDPSCooldowns(delay time.Duration)

Adds a delay to the first usage of all CDs overriding shouldActivate for cooldownTypeDPS, MCDs that have a user-specified timing are not delayed. This function should be called from Agent.Init().

func (*Character) DelayDPSCooldownsForArmorDebuffs

func (mcdm *Character) DelayDPSCooldownsForArmorDebuffs(delay time.Duration)

Adds a delay to the first usage of all CDs so that debuffs have time to be applied. MCDs that have a user-specified timing are not delayed.

This function should be called from Agent.Init().

func (*Character) DoNothing

func (character *Character) DoNothing()

DoNothing will explicitly declare that the character is intentionally doing nothing.

If the GCD is not used during OnGCDReady and this flag is set, OnGCDReady will not be called again
until it is used in some other way (like from an auto attack or resource regeneration).

func (*Character) EnableItemSwap added in v0.1.10

func (character *Character) EnableItemSwap(itemSwap *proto.ItemSwap, mhCritMultiplier float64, ohCritMultiplier float64, rangedCritMultiplier float64)

TODO All the extra parameters here and the code in multiple places for handling the Weapon struct is really messy,

we'll need to figure out something cleaner as this will be quite error-prone

func (*Character) EnableManaBar

func (character *Character) EnableManaBar()

EnableManaBar will setup caster stat dependencies (int->mana and int->spellcrit) as well as enable the mana gain action to regenerate mana. It will then enable mana gain metrics for reporting.

func (*Character) EnableManaBarWithModifier

func (character *Character) EnableManaBarWithModifier(modifier float64)

func (*Character) EnableResumeAfterManaWait

func (character *Character) EnableResumeAfterManaWait(callback func(sim *Simulation))

EnableResumeAfterManaWait will setup the OnManaTick callback to resume the given callback

once enough mana has been gained after calling unit.WaitForMana()

func (*Character) Finalize

func (character *Character) Finalize(playerStats *proto.PlayerStats)

func (*Character) GainHealth

func (hb *Character) GainHealth(sim *Simulation, amount float64, metrics *ResourceMetrics)

func (*Character) GetActiveAuraWithTag

func (at *Character) GetActiveAuraWithTag(tag string) *Aura

func (*Character) GetActiveSetBonusNames

func (character *Character) GetActiveSetBonusNames() []string

Returns the names of all active set bonuses.

func (*Character) GetActiveSetBonuses

func (character *Character) GetActiveSetBonuses() []ActiveSetBonus

Returns a list describing all active set bonuses.

func (*Character) GetAura

func (at *Character) GetAura(label string) *Aura

func (*Character) GetAurasWithTag

func (at *Character) GetAurasWithTag(tag string) []*Aura

func (*Character) GetBaseStats

func (character *Character) GetBaseStats() stats.Stats

func (*Character) GetConjuredCD

func (character *Character) GetConjuredCD() *Timer

func (*Character) GetDefensiveTrinketCD

func (character *Character) GetDefensiveTrinketCD() *Timer

func (*Character) GetInitialMajorCooldown

func (mcdm *Character) GetInitialMajorCooldown(actionID ActionID) MajorCooldown

func (*Character) GetMHWeapon

func (character *Character) GetMHWeapon() *Item

Returns the MH weapon if one is equipped, and null otherwise.

func (*Character) GetMajorCooldown

func (mcdm *Character) GetMajorCooldown(actionID ActionID) *MajorCooldown

func (*Character) GetMajorCooldownIDs

func (mcdm *Character) GetMajorCooldownIDs() []*proto.ActionID

func (*Character) GetMajorCooldownIgnoreTag added in v0.1.10

func (mcdm *Character) GetMajorCooldownIgnoreTag(actionID ActionID) *MajorCooldown

func (*Character) GetMajorCooldowns

func (mcdm *Character) GetMajorCooldowns() []*MajorCooldown

Returns all MCDs.

func (*Character) GetMetricsProto

func (character *Character) GetMetricsProto() *proto.UnitMetrics

func (*Character) GetOHWeapon

func (character *Character) GetOHWeapon() *Item

Returns the OH weapon if one is equipped, and null otherwise. Note that shields / Held-in-off-hand items are NOT counted as weapons in this function.

func (*Character) GetOffensiveTrinketCD

func (character *Character) GetOffensiveTrinketCD() *Timer

func (*Character) GetPet

func (character *Character) GetPet(name string) PetAgent

func (*Character) GetPresimOptions

func (character *Character) GetPresimOptions(playerConfig *proto.Player) *PresimOptions

func (*Character) GetPseudoStatsProto added in v0.1.8

func (character *Character) GetPseudoStatsProto() []float64

func (*Character) GetRangedWeapon

func (character *Character) GetRangedWeapon() *Item

Returns the ranged weapon if one is equipped, and null otherwise.

func (*Character) GetWeaponHands

func (character *Character) GetWeaponHands(itemID int32) (bool, bool)

Returns the hands that the item is equipped in, as (MH, OH).

func (*Character) HasActiveAura

func (at *Character) HasActiveAura(label string) bool

func (*Character) HasActiveAuraWithTag

func (at *Character) HasActiveAuraWithTag(tag string) bool

func (*Character) HasActiveAuraWithTagExcludingAura

func (at *Character) HasActiveAuraWithTagExcludingAura(tag string, excludeAura *Aura) bool

func (*Character) HasAlchStone

func (character *Character) HasAlchStone() bool

func (*Character) HasAura

func (at *Character) HasAura(label string) bool

func (*Character) HasAuraWithTag

func (at *Character) HasAuraWithTag(tag string) bool

func (*Character) HasGlyph

func (character *Character) HasGlyph(glyphID int32) bool

func (*Character) HasMHWeapon

func (character *Character) HasMHWeapon() bool

func (*Character) HasMetaGemEquipped

func (character *Character) HasMetaGemEquipped(gemID int32) bool

func (*Character) HasOHWeapon

func (character *Character) HasOHWeapon() bool

func (*Character) HasProfession

func (character *Character) HasProfession(prof proto.Profession) bool

func (*Character) HasRangedWeapon

func (character *Character) HasRangedWeapon() bool

func (*Character) HasRingEquipped

func (character *Character) HasRingEquipped(itemID int32) bool

func (*Character) HasSetBonus

func (character *Character) HasSetBonus(itemSet *ItemSet, numItems int32) bool

func (*Character) HasTrinketEquipped

func (character *Character) HasTrinketEquipped(itemID int32) bool

func (*Character) HealingCritMultiplier

func (character *Character) HealingCritMultiplier(primaryModifiers float64, secondaryModifiers float64) float64

func (*Character) MaxHealth

func (hb *Character) MaxHealth() float64

func (*Character) MeleeCritMultiplier

func (character *Character) MeleeCritMultiplier(primaryModifiers float64, secondaryModifiers float64) float64

func (*Character) MultiplyAttackSpeed

func (character *Character) MultiplyAttackSpeed(sim *Simulation, amount float64)

func (*Character) MultiplyMeleeSpeed

func (character *Character) MultiplyMeleeSpeed(sim *Simulation, amount float64)

func (*Character) MultiplyRangedSpeed

func (character *Character) MultiplyRangedSpeed(sim *Simulation, amount float64)

func (*Character) NewTemporaryStatsAura

func (character *Character) NewTemporaryStatsAura(auraLabel string, actionID ActionID, tempStats stats.Stats, duration time.Duration) *Aura

Helper for the common case of making an aura that adds stats.

func (*Character) NewTemporaryStatsAuraWrapped

func (character *Character) NewTemporaryStatsAuraWrapped(auraLabel string, actionID ActionID, buffs stats.Stats, duration time.Duration, modConfig func(*Aura)) *Aura

Alternative that allows modifying the Aura config.

func (*Character) NextEnergyTickAt

func (eb *Character) NextEnergyTickAt() time.Duration

func (*Character) NumActiveAurasWithTag

func (at *Character) NumActiveAurasWithTag(tag string) int32

func (*Character) OnCastComplete

func (at *Character) OnCastComplete(sim *Simulation, spell *Spell)

Invokes the OnCastComplete event for all tracked Auras.

func (*Character) OnHealDealt

func (at *Character) OnHealDealt(sim *Simulation, spell *Spell, result *SpellResult)

Invokes the OnHeal event for all tracked Auras.

func (*Character) OnHealTaken

func (at *Character) OnHealTaken(sim *Simulation, spell *Spell, result *SpellResult)

func (*Character) OnPeriodicDamageDealt

func (at *Character) OnPeriodicDamageDealt(sim *Simulation, spell *Spell, result *SpellResult)

Invokes the OnPeriodicDamage

As a debuff when target is being hit by dot.
As a buff when caster's dots are ticking.

func (*Character) OnPeriodicDamageTaken

func (at *Character) OnPeriodicDamageTaken(sim *Simulation, spell *Spell, result *SpellResult)

func (*Character) OnPeriodicHealDealt

func (at *Character) OnPeriodicHealDealt(sim *Simulation, spell *Spell, result *SpellResult)

Invokes the OnPeriodicHeal

As a debuff when target is being hit by dot.
As a buff when caster's dots are ticking.

func (*Character) OnPeriodicHealTaken

func (at *Character) OnPeriodicHealTaken(sim *Simulation, spell *Spell, result *SpellResult)

func (*Character) OnSpellHitDealt

func (at *Character) OnSpellHitDealt(sim *Simulation, spell *Spell, result *SpellResult)

Invokes the OnSpellHit event for all tracked Auras.

func (*Character) OnSpellHitTaken

func (at *Character) OnSpellHitTaken(sim *Simulation, spell *Spell, result *SpellResult)

func (*Character) RegisterOnItemSwap added in v0.1.10

func (character *Character) RegisterOnItemSwap(callback OnSwapItem)

func (*Character) RegisterResetEffect

func (at *Character) RegisterResetEffect(resetEffect ResetEffect)

Registers a callback to this Character which will be invoked on every Sim reset.

func (*Character) RemoveHealth

func (hb *Character) RemoveHealth(sim *Simulation, amount float64)

func (*Character) ResetEnergyTick

func (eb *Character) ResetEnergyTick(sim *Simulation)

Gives an immediate partial energy tick and restarts the tick timer.

func (*Character) SpellCritMultiplier

func (character *Character) SpellCritMultiplier(primaryModifiers float64, secondaryModifiers float64) float64

func (*Character) SpendComboPoints

func (eb *Character) SpendComboPoints(sim *Simulation, metrics *ResourceMetrics)

func (*Character) SpendEnergy

func (eb *Character) SpendEnergy(sim *Simulation, amount float64, metrics *ResourceMetrics)

func (*Character) SpendRage

func (rb *Character) SpendRage(sim *Simulation, amount float64, metrics *ResourceMetrics)

func (*Character) TryUseCooldowns

func (mcdm *Character) TryUseCooldowns(sim *Simulation)

func (*Character) UpdateMajorCooldowns

func (mcdm *Character) UpdateMajorCooldowns()

This function should be called if the CD for a major cooldown changes outside of the TryActivate() call.

func (*Character) WeaponFromMainHand

func (character *Character) WeaponFromMainHand(critMultiplier float64) Weapon

Returns weapon stats using the main hand equipped weapon.

func (*Character) WeaponFromOffHand

func (character *Character) WeaponFromOffHand(critMultiplier float64) Weapon

Returns weapon stats using the off hand equipped weapon.

func (*Character) WeaponFromRanged

func (character *Character) WeaponFromRanged(critMultiplier float64) Weapon

Returns weapon stats using the ranged equipped weapon.

type CharacterBuildPhase added in v0.1.8

type CharacterBuildPhase uint8
const (
	CharacterBuildPhaseNone CharacterBuildPhase = 0
	CharacterBuildPhaseBase CharacterBuildPhase = 1 << iota
	CharacterBuildPhaseGear
	CharacterBuildPhaseTalents
	CharacterBuildPhaseBuffs
	CharacterBuildPhaseConsumes
)

func (CharacterBuildPhase) Matches added in v0.1.8

func (cbp CharacterBuildPhase) Matches(other CharacterBuildPhase) bool

type CharacterIterationMetrics

type CharacterIterationMetrics struct {
	Died    bool // Whether this unit died in the current iteration.
	WentOOM bool // Whether the agent has hit OOM at least once in this iteration.

	ManaSpent       float64
	ManaGained      float64
	BonusManaGained float64 // Only includes amount from mana pots / runes / innervates.

	OOMTime time.Duration // time spent not casting and waiting for regen.

	FirstOOMTimestamp time.Duration // Timestamp at which unit first went OOM.
}

Metrics for the current iteration, for 1 agent. Keep this as a separate struct so its easy to clear.

type CharacterSuiteConfig

type CharacterSuiteConfig struct {
	Class proto.Class

	Race        proto.Race
	GearSet     GearSetCombo
	SpecOptions SpecOptionsCombo
	Glyphs      *proto.Glyphs
	Talents     string

	Consumes *proto.Consumes

	IsHealer        bool
	IsTank          bool
	InFrontOfTarget bool

	OtherRaces       []proto.Race
	OtherGearSets    []GearSetCombo
	OtherSpecOptions []SpecOptionsCombo

	ItemFilter ItemFilter

	StatsToWeigh    []proto.Stat
	EPReferenceStat proto.Stat
}

type CombinedTestGenerator

type CombinedTestGenerator struct {
	// contains filtered or unexported fields
}

func (*CombinedTestGenerator) GetTest

func (*CombinedTestGenerator) NumTests

func (generator *CombinedTestGenerator) NumTests() int

type Cooldown

type Cooldown struct {
	*Timer

	// Default amount of time after activation before this CD can be used again.
	// Note that some CDs won't use this, e.g. the GCD.
	Duration time.Duration
}

func (*Cooldown) Use

func (cd *Cooldown) Use(sim *Simulation)

Puts this CD on cooldown, using the default duration.

type CooldownActivation

type CooldownActivation func(*Simulation, *Character)

Function for activating a cooldown. Returns whether the activation was successful.

type CooldownActivationCondition

type CooldownActivationCondition func(*Simulation, *Character) bool

Condition for whether a cooldown can/should be activated. Returning false prevents the cooldown from being activated.

type CooldownType

type CooldownType byte
const (
	CooldownTypeUnknown CooldownType = 0
	CooldownTypeMana    CooldownType = 1 << iota
	CooldownTypeDPS
	CooldownTypeExplosive
	CooldownTypeSurvival
)

func (CooldownType) Matches

func (ct CooldownType) Matches(other CooldownType) bool

type DelayedActionOptions

type DelayedActionOptions struct {
	// When the action should be performed.
	DoAt time.Duration

	Priority ActionPriority

	OnAction func(*Simulation)
	CleanUp  func(*Simulation)
}

type DistributionMetrics

type DistributionMetrics struct {
	// Values for the current iteration. These are cleared after each iteration.
	Total float64
	// contains filtered or unexported fields
}

func NewDistributionMetrics

func NewDistributionMetrics() DistributionMetrics

func (*DistributionMetrics) ToProto

func (distMetrics *DistributionMetrics) ToProto() *proto.DistributionMetrics

type Dot

type Dot struct {
	Spell *Spell

	// Embed Aura so we can use IsActive/Refresh/etc directly.
	*Aura

	NumberOfTicks int32         // number of ticks over the whole duration
	TickLength    time.Duration // time between each tick

	// If true, tick length will be shortened based on casting speed.
	AffectedByCastSpeed bool

	OnSnapshot OnSnapshot
	OnTick     OnTick

	SnapshotBaseDamage         float64
	SnapshotCritChance         float64
	SnapshotAttackerMultiplier float64

	// Number of ticks since last call to Apply().
	TickCount int32
	// contains filtered or unexported fields
}

func NewDot

func NewDot(config Dot) *Dot

func (*Dot) Apply

func (dot *Dot) Apply(sim *Simulation)

func (*Dot) ApplyOrRefresh added in v0.1.3

func (dot *Dot) ApplyOrRefresh(sim *Simulation)

Like Apply(), but does not reset the tick timer.

func (*Dot) ApplyOrReset added in v0.1.5

func (dot *Dot) ApplyOrReset(sim *Simulation)

ApplyOrReset is used for rolling dots that reset the tick timer on reapplication. This is more efficient than Apply(), and works around tickAction.CleanUp() wrongly generating an extra ticks if (re-)application and tick happen at the same time.

func (*Dot) CalcAndDealPeriodicSnapshotDamage added in v0.1.1

func (dot *Dot) CalcAndDealPeriodicSnapshotDamage(sim *Simulation, target *Unit, outcomeApplier OutcomeApplier) *SpellResult

func (*Dot) CalcAndDealPeriodicSnapshotHealing added in v0.1.1

func (dot *Dot) CalcAndDealPeriodicSnapshotHealing(sim *Simulation, target *Unit, outcomeApplier OutcomeApplier) *SpellResult

func (*Dot) CalcSnapshotDamage added in v0.1.1

func (dot *Dot) CalcSnapshotDamage(sim *Simulation, target *Unit, outcomeApplier OutcomeApplier) *SpellResult

func (*Dot) CalcSnapshotHealing added in v0.1.1

func (dot *Dot) CalcSnapshotHealing(sim *Simulation, target *Unit, outcomeApplier OutcomeApplier) *SpellResult

func (*Dot) Cancel

func (dot *Dot) Cancel(sim *Simulation)

func (*Dot) NumTicksRemaining added in v0.1.10

func (dot *Dot) NumTicksRemaining(sim *Simulation) int

func (*Dot) OutcomeExpectedMagicSnapshotCrit added in v0.1.10

func (dot *Dot) OutcomeExpectedMagicSnapshotCrit(sim *Simulation, result *SpellResult, attackTable *AttackTable)

func (*Dot) OutcomeMagicHitAndSnapshotCrit added in v0.1.1

func (dot *Dot) OutcomeMagicHitAndSnapshotCrit(sim *Simulation, result *SpellResult, attackTable *AttackTable)

func (*Dot) OutcomeRangedHitAndCritSnapshot added in v0.1.1

func (dot *Dot) OutcomeRangedHitAndCritSnapshot(sim *Simulation, result *SpellResult, attackTable *AttackTable)

func (*Dot) OutcomeSnapshotCrit added in v0.1.1

func (dot *Dot) OutcomeSnapshotCrit(sim *Simulation, result *SpellResult, attackTable *AttackTable)

func (*Dot) OutcomeTick added in v0.1.1

func (dot *Dot) OutcomeTick(sim *Simulation, result *SpellResult, attackTable *AttackTable)

A tick always hits, but we don't count them as hits in the metrics.

func (*Dot) OutcomeTickPhysicalCrit added in v0.1.1

func (dot *Dot) OutcomeTickPhysicalCrit(sim *Simulation, result *SpellResult, attackTable *AttackTable)

func (*Dot) RecomputeAuraDuration

func (dot *Dot) RecomputeAuraDuration()

Call this after manually changing NumberOfTicks or TickLength.

func (*Dot) Rollover

func (dot *Dot) Rollover(sim *Simulation)

Rollover is used to reset the duration of a dot from an external spell (not casting the dot itself) This keeps the snapshotted crit and %dmg modifiers. However sp and haste are recalculated.

func (*Dot) TakeSnapshot

func (dot *Dot) TakeSnapshot(sim *Simulation, doRollover bool)

Takes a new snapshot of this Dot's effects.

In most cases this will be called automatically, and should only be called to force a new snapshot to be taken.

doRollover will apply previously snapshotted crit/%dmg instead of recalculating.

func (*Dot) TickOnce

func (dot *Dot) TickOnce(sim *Simulation)

Forces an instant tick. Does not reset the tick timer or aura duration, the tick is simply an extra tick.

func (*Dot) TickPeriod added in v0.1.5

func (dot *Dot) TickPeriod() time.Duration

TickPeriod is how fast the snapshotted dot ticks.

func (*Dot) TimeUntilNextTick added in v0.1.10

func (dot *Dot) TimeUntilNextTick(sim *Simulation) time.Duration

type DotArray added in v0.1.12

type DotArray []*Dot

func (DotArray) Get added in v0.1.12

func (dots DotArray) Get(target *Unit) *Dot

type DotConfig added in v0.1.12

type DotConfig struct {
	IsAOE    bool // Set to true for AOE dots (Blizzard, Hurricane, Consecrate, etc)
	SelfOnly bool // Set to true to only create the self-hot.

	// Optional, will default to the corresponding spell.
	Spell *Spell

	Aura Aura

	NumberOfTicks int32         // number of ticks over the whole duration
	TickLength    time.Duration // time between each tick

	// If true, tick length will be shortened based on casting speed.
	AffectedByCastSpeed bool

	OnSnapshot OnSnapshot
	OnTick     OnTick
}

type DynamicDamageTakenModifier

type DynamicDamageTakenModifier func(sim *Simulation, spell *Spell, result *SpellResult)

type Enchant added in v0.1.5

type Enchant struct {
	EffectID int32 // Used by UI to apply effect to tooltip
	Stats    stats.Stats
}

func EnchantFromProto added in v0.1.5

func EnchantFromProto(pData *proto.SimEnchant) Enchant

type Encounter

type Encounter struct {
	Duration          time.Duration
	DurationVariation time.Duration
	Targets           []*Target
	TargetUnits       []*Unit

	ExecuteProportion_20 float64
	ExecuteProportion_25 float64
	ExecuteProportion_35 float64

	EndFightAtHealth float64
	// DamgeTaken is used to track health fights instead of duration fights.
	//  Once primary target has taken its health worth of damage, fight ends.
	DamageTaken float64
	// In health fight: set to true until we get something to base on
	DurationIsEstimate bool
	// contains filtered or unexported fields
}

func NewEncounter

func NewEncounter(options *proto.Encounter) Encounter

func (*Encounter) AOECapMultiplier

func (encounter *Encounter) AOECapMultiplier() float64

func (*Encounter) GetMetricsProto

func (encounter *Encounter) GetMetricsProto() *proto.EncounterMetrics

type EncounterCombo

type EncounterCombo struct {
	Label     string
	Encounter *proto.Encounter
}

func MakeDefaultEncounterCombos

func MakeDefaultEncounterCombos() []EncounterCombo

type EnergyCost added in v0.1.10

type EnergyCost struct {
	Refund          float64
	RefundMetrics   *ResourceMetrics
	ResourceMetrics *ResourceMetrics
}

func (*EnergyCost) IssueRefund added in v0.1.10

func (ec *EnergyCost) IssueRefund(sim *Simulation, spell *Spell)

func (*EnergyCost) LogCostFailure added in v0.1.10

func (ec *EnergyCost) LogCostFailure(sim *Simulation, spell *Spell)

func (*EnergyCost) MeetsRequirement added in v0.1.10

func (ec *EnergyCost) MeetsRequirement(spell *Spell) bool

func (*EnergyCost) SpendCost added in v0.1.10

func (ec *EnergyCost) SpendCost(sim *Simulation, spell *Spell)

type EnergyCostOptions added in v0.1.10

type EnergyCostOptions struct {
	Cost float64

	Refund        float64
	RefundMetrics *ResourceMetrics // Optional, will default to unit.EnergyRefundMetrics if not supplied.
}

type Environment

type Environment struct {
	State EnvironmentState

	// Whether stats are currently being measured. Used to disable some validation
	// checks which are otherwise helpful.
	MeasuringStats bool

	Raid      *Raid
	Encounter Encounter
	AllUnits  []*Unit

	BaseDuration      time.Duration // base duration
	DurationVariation time.Duration // variation per duration
	// contains filtered or unexported fields
}

func NewEnvironment

func NewEnvironment(raidProto *proto.Raid, encounterProto *proto.Encounter) (*Environment, *proto.RaidStats)

func (*Environment) GetMaxDuration

func (env *Environment) GetMaxDuration() time.Duration

The maximum possible duration for any iteration.

func (*Environment) GetNumTargets

func (env *Environment) GetNumTargets() int32

func (*Environment) GetTarget

func (env *Environment) GetTarget(index int32) *Target

func (*Environment) GetTargetUnit

func (env *Environment) GetTargetUnit(index int32) *Unit

func (*Environment) IsFinalized

func (env *Environment) IsFinalized() bool

func (*Environment) NextTarget

func (env *Environment) NextTarget(target *Unit) *Target

func (*Environment) NextTargetUnit

func (env *Environment) NextTargetUnit(target *Unit) *Unit

func (*Environment) RegisterPostFinalizeEffect

func (env *Environment) RegisterPostFinalizeEffect(postFinalizeEffect PostFinalizeEffect)

Registers a callback to this Character which will be invoked after all Units are finalized.

type EnvironmentState

type EnvironmentState int
const (
	Created EnvironmentState = iota
	Constructed
	Initialized
	Finalized
)

type Equipment added in v0.1.5

type Equipment [proto.ItemSlot_ItemSlotRanged + 1]Item

func NewEquipmentSet added in v0.1.5

func NewEquipmentSet(equipSpec EquipmentSpec) Equipment

func ProtoToEquipment added in v0.1.5

func ProtoToEquipment(es *proto.EquipmentSpec) Equipment

func (Equipment) Clone added in v0.1.5

func (equipment Equipment) Clone() Equipment

func (*Equipment) EquipItem added in v0.1.5

func (equipment *Equipment) EquipItem(item Item)

func (Equipment) Stats added in v0.1.5

func (equipment Equipment) Stats() stats.Stats

func (*Equipment) ToEquipmentSpecProto added in v0.1.5

func (equipment *Equipment) ToEquipmentSpecProto() *proto.EquipmentSpec

type EquipmentSpec added in v0.1.5

type EquipmentSpec [proto.ItemSlot_ItemSlotRanged + 1]ItemSpec

Structs used for looking up items/gems/enchants

func ProtoToEquipmentSpec added in v0.1.5

func ProtoToEquipmentSpec(es *proto.EquipmentSpec) EquipmentSpec

type ExclusiveCategory added in v0.1.8

type ExclusiveCategory struct {
	Name       string
	SingleAura bool // If true, only 1 aura in this category may be active at a time.
	// contains filtered or unexported fields
}

func (*ExclusiveCategory) AnyActive added in v0.1.8

func (ec *ExclusiveCategory) AnyActive() bool

func (*ExclusiveCategory) GetActiveAura added in v0.1.8

func (ec *ExclusiveCategory) GetActiveAura() *Aura

func (*ExclusiveCategory) GetActiveEffect added in v0.1.8

func (ec *ExclusiveCategory) GetActiveEffect() *ExclusiveEffect

func (*ExclusiveCategory) GetHighestPrioActiveEffect added in v0.1.8

func (ec *ExclusiveCategory) GetHighestPrioActiveEffect() *ExclusiveEffect

func (*ExclusiveCategory) SetActive added in v0.1.8

func (ec *ExclusiveCategory) SetActive(sim *Simulation, newActiveEffect *ExclusiveEffect)

type ExclusiveEffect added in v0.1.8

type ExclusiveEffect struct {
	Aura     *Aura
	Priority float64

	OnGain   func(*ExclusiveEffect, *Simulation)
	OnExpire func(*ExclusiveEffect, *Simulation)

	Category *ExclusiveCategory
	// contains filtered or unexported fields
}

An Exclusive effect is one which may not be active at the same time as other effects in the same category. For example, the armor reduction effects from Sunder Armor and Expose Armor are exclusive with each other.

Within each ExclusiveCategory, the ExclusiveEffect with the highest Priority AND isEnabled == true is the one whose effect is applied.

func AtkSpeedReductionEffect added in v0.1.8

func AtkSpeedReductionEffect(aura *Aura, speedMultiplier float64) *ExclusiveEffect

func (*ExclusiveEffect) Activate added in v0.1.8

func (ee *ExclusiveEffect) Activate(sim *Simulation) bool

Returns whether the effect is active.

func (*ExclusiveEffect) Deactivate added in v0.1.8

func (ee *ExclusiveEffect) Deactivate(sim *Simulation)

func (*ExclusiveEffect) IsActive added in v0.1.8

func (ee *ExclusiveEffect) IsActive() bool

func (*ExclusiveEffect) SetPriority added in v0.1.8

func (ee *ExclusiveEffect) SetPriority(sim *Simulation, newPrio float64)

type ExclusiveEffectManager added in v0.1.8

type ExclusiveEffectManager struct {
	// contains filtered or unexported fields
}

func (*ExclusiveEffectManager) GetExclusiveEffectCategory added in v0.1.8

func (eem *ExclusiveEffectManager) GetExclusiveEffectCategory(categoryName string) *ExclusiveCategory

Returns a category with the given name. Creates a new category if one doesn't already exist.

type ExpectedDamageCalculator added in v0.1.1

type ExpectedDamageCalculator func(sim *Simulation, target *Unit, spell *Spell, useSnapshot bool) *SpellResult

type GearSetCombo

type GearSetCombo struct {
	Label   string
	GearSet *proto.EquipmentSpec
}

type Gem added in v0.1.5

type Gem struct {
	ID    int32
	Name  string
	Stats stats.Stats
	Color proto.GemColor
}

func GemFromProto added in v0.1.5

func GemFromProto(pData *proto.SimGem) Gem

type GoRand

type GoRand struct {
	rand.Source64
}

func NewGoRand

func NewGoRand(seed uint64) *GoRand

wraps go's default source; will panic if it's not a Source64

func (GoRand) Next

func (g GoRand) Next() uint64

func (GoRand) NextFloat64

func (g GoRand) NextFloat64() float64

type Hand

type Hand bool
const MainHand Hand = true
const OffHand Hand = false

type Hardcast

type Hardcast struct {
	Expires    time.Duration
	ActionID   ActionID
	OnComplete func(*Simulation, *Unit)
	Target     *Unit
}

type HitOutcome

type HitOutcome uint16

Possible outcomes of any hit/damage roll.

const (
	OutcomeEmpty HitOutcome = 0

	// These bits are set by the hit roll
	OutcomeMiss HitOutcome = 1 << iota
	OutcomeHit
	OutcomeDodge
	OutcomeGlance
	OutcomeParry
	OutcomeBlock

	// These bits are set by the crit and damage rolls.
	OutcomeCrit
	OutcomeCrush

	OutcomePartial1
	OutcomePartial2
	OutcomePartial4
	OutcomePartial8
)

Single-bit outcomes.

func (HitOutcome) Matches

func (ho HitOutcome) Matches(other HitOutcome) bool

Returns whether there is any overlap between the given masks.

func (HitOutcome) PartialResistString

func (ho HitOutcome) PartialResistString() string

func (HitOutcome) String

func (ho HitOutcome) String() string

type IndividualTestSuite

type IndividualTestSuite struct {
	Name string
	// contains filtered or unexported fields
}

func NewIndividualTestSuite

func NewIndividualTestSuite(suiteName string) *IndividualTestSuite

func (*IndividualTestSuite) Done

func (testSuite *IndividualTestSuite) Done(t *testing.T)

func (*IndividualTestSuite) TestCasts

func (testSuite *IndividualTestSuite) TestCasts(testName string, rsr *proto.RaidSimRequest)

func (*IndividualTestSuite) TestCharacterStats

func (testSuite *IndividualTestSuite) TestCharacterStats(testName string, csr *proto.ComputeStatsRequest)

func (*IndividualTestSuite) TestDPS

func (testSuite *IndividualTestSuite) TestDPS(testName string, rsr *proto.RaidSimRequest)

func (*IndividualTestSuite) TestStatWeights

func (testSuite *IndividualTestSuite) TestStatWeights(testName string, swr *proto.StatWeightsRequest)

type Item added in v0.1.5

type Item struct {
	ID        int32
	Type      proto.ItemType
	ArmorType proto.ArmorType
	// Weapon Stats
	WeaponType       proto.WeaponType
	HandType         proto.HandType
	RangedWeaponType proto.RangedWeaponType
	WeaponDamageMin  float64
	WeaponDamageMax  float64
	SwingSpeed       float64

	Name    string
	Stats   stats.Stats // Stats applied to wearer
	Quality proto.ItemQuality
	SetName string // Empty string if not part of a set.

	GemSockets  []proto.GemColor
	SocketBonus stats.Stats

	// Modified for each instance of the item.
	Gems    []Gem
	Enchant Enchant

	//Internal use
	TempEnchant int32
}

func ItemFromProto added in v0.1.5

func ItemFromProto(pData *proto.SimItem) Item

func NewItem added in v0.1.5

func NewItem(itemSpec ItemSpec) Item

func (Item) ToItemSpecProto added in v0.1.5

func (item Item) ToItemSpecProto() *proto.ItemSpec

type ItemFilter

type ItemFilter struct {
	// If set to ClassUnknown, any class is fine.
	Class proto.Class

	ArmorType proto.ArmorType

	// Blank list allows any value. Otherwise item must match 1 value from the list.
	WeaponTypes       []proto.WeaponType
	HandTypes         []proto.HandType
	RangedWeaponTypes []proto.RangedWeaponType

	// Item IDs to ignore.
	IDBlacklist []int32
}

Returns all items that meet the given conditions.

func (*ItemFilter) FindAllItems

func (filter *ItemFilter) FindAllItems() []Item

func (*ItemFilter) FindAllMetaGems

func (filter *ItemFilter) FindAllMetaGems() []Gem

func (*ItemFilter) FindAllSets

func (filter *ItemFilter) FindAllSets() []*ItemSet

func (*ItemFilter) Matches

func (filter *ItemFilter) Matches(item Item, equipChecksOnly bool) bool

Returns whether the given item matches the conditions of this filter.

If equipChecksOnly is true, will only check conditions related to whether the item is equippable.

type ItemSet

type ItemSet struct {
	Name            string
	AlternativeName string

	// IDs of items that are part of this set. map[key]struct{} is roughly a set in go.
	Items map[int32]struct{}

	// Maps set piece requirement to an ApplyEffect function that will be called
	// before the Sim starts.
	//
	// The function should apply any benefits provided by the set bonus.
	Bonuses map[int32]ApplyEffect
}

func GetAllItemSets

func GetAllItemSets() []*ItemSet

func NewItemSet

func NewItemSet(setStruct ItemSet) *ItemSet

Registers a new ItemSet with item IDs populated.

func (ItemSet) ItemIDs

func (set ItemSet) ItemIDs() []int32

func (ItemSet) ItemIsInSet

func (set ItemSet) ItemIsInSet(itemID int32) bool

type ItemSlot added in v0.1.5

type ItemSlot byte
const (
	ItemSlotHead ItemSlot = iota
	ItemSlotNeck
	ItemSlotShoulder
	ItemSlotBack
	ItemSlotChest
	ItemSlotWrist
	ItemSlotHands
	ItemSlotWaist
	ItemSlotLegs
	ItemSlotFeet
	ItemSlotFinger1
	ItemSlotFinger2
	ItemSlotTrinket1
	ItemSlotTrinket2
	ItemSlotMainHand // can be 1h or 2h
	ItemSlotOffHand
	ItemSlotRanged
)

func ItemTypeToSlot added in v0.1.5

func ItemTypeToSlot(it proto.ItemType) ItemSlot

func (ItemSlot) String added in v0.1.13

func (is ItemSlot) String() string

type ItemSpec added in v0.1.5

type ItemSpec struct {
	ID      int32
	Enchant int32
	Gems    []int32
}

type ItemStringSpec added in v0.1.5

type ItemStringSpec struct {
	Name    string
	Enchant string
	Gems    []string
}

Like ItemSpec, but uses names for reference instead of ID.

type ItemSwap added in v0.1.10

type ItemSwap struct {
	// contains filtered or unexported fields
}

func (*ItemSwap) GetItem added in v0.1.10

func (swap *ItemSwap) GetItem(slot proto.ItemSlot) *Item

func (*ItemSwap) IsEnabled added in v0.1.10

func (swap *ItemSwap) IsEnabled() bool

func (*ItemSwap) RegisterOnSwapItemForEffectWithPPMManager added in v0.1.10

func (swap *ItemSwap) RegisterOnSwapItemForEffectWithPPMManager(effectID int32, ppm float64, ppmm *PPMManager, aura *Aura)

Helper for handling Effects that use PPMManager to toggle the aura on/off

func (*ItemSwap) ReigsterOnSwapItemForEffect added in v0.1.10

func (swap *ItemSwap) ReigsterOnSwapItemForEffect(effectID int32, aura *Aura)

Helper for handling Effects that use the effectID to toggle the aura on and off

func (*ItemSwap) SwapItems added in v0.1.10

func (swap *ItemSwap) SwapItems(sim *Simulation, slots []proto.ItemSlot, useGCD bool)

type ItemsTestGenerator

type ItemsTestGenerator struct {
	// Fields describing the base API request.
	Player     *proto.Player
	PartyBuffs *proto.PartyBuffs
	RaidBuffs  *proto.RaidBuffs
	Debuffs    *proto.Debuffs
	Encounter  *proto.Encounter
	SimOptions *proto.SimOptions
	IsHealer   bool

	// Some fields are populated automatically.
	ItemFilter ItemFilter
	// contains filtered or unexported fields
}

func (*ItemsTestGenerator) GetTest

func (*ItemsTestGenerator) NumTests

func (generator *ItemsTestGenerator) NumTests() int

type MajorCooldown

type MajorCooldown struct {
	// Spell that is cast when this MCD is activated.
	Spell *Spell

	// Cooldowns with higher priority get used first. This is important when some
	// cooldowns have a non-zero cast time. For example, Drums should be used
	// before Bloodlust.
	Priority float64

	// Internal category, used for filtering. For example, mages want to disable
	// all DPS cooldowns during their regen rotation.
	Type CooldownType

	// Whether the cooldown meets all hard requirements for activation (e.g. resource cost).
	// Note chat whether the cooldown is off CD is automatically checked, so it does not
	// need to be checked again by this function.
	CanActivate CooldownActivationCondition

	// Whether the cooldown meets all optional conditions for activation. These
	// conditions will be ignored when the user specifies their own activation time.
	// This is for things like mana thresholds, which are optimizations for better
	// automatic timing.
	ShouldActivate CooldownActivationCondition
	// contains filtered or unexported fields
}

func (*MajorCooldown) Disable added in v0.1.3

func (mcd *MajorCooldown) Disable()

func (*MajorCooldown) Enable added in v0.1.3

func (mcd *MajorCooldown) Enable()

func (*MajorCooldown) GetTimings

func (mcd *MajorCooldown) GetTimings() []time.Duration

func (*MajorCooldown) IsEnabled

func (mcd *MajorCooldown) IsEnabled() bool

func (*MajorCooldown) IsReady

func (mcd *MajorCooldown) IsReady(sim *Simulation) bool

func (*MajorCooldown) ReadyAt

func (mcd *MajorCooldown) ReadyAt() time.Duration

func (*MajorCooldown) TimeToNextCast added in v0.1.10

func (mcd *MajorCooldown) TimeToNextCast(sim *Simulation) time.Duration

Roughly how long until the next cast will happen, accounting for both spell CD and user-specified timings.

func (*MajorCooldown) TimeToReady

func (mcd *MajorCooldown) TimeToReady(sim *Simulation) time.Duration

func (*MajorCooldown) TryActivate

func (mcd *MajorCooldown) TryActivate(sim *Simulation, character *Character) bool

Public version of TryActivate for manual activation by Agent code. Note that this version will work even if the MCD is disabled.

type ManaCost added in v0.1.10

type ManaCost struct {
	ResourceMetrics *ResourceMetrics
}

func (*ManaCost) IssueRefund added in v0.1.10

func (mc *ManaCost) IssueRefund(sim *Simulation, spell *Spell)

func (*ManaCost) LogCostFailure added in v0.1.10

func (mc *ManaCost) LogCostFailure(sim *Simulation, spell *Spell)

func (*ManaCost) MeetsRequirement added in v0.1.10

func (mc *ManaCost) MeetsRequirement(spell *Spell) bool

func (*ManaCost) SpendCost added in v0.1.10

func (mc *ManaCost) SpendCost(sim *Simulation, spell *Spell)

type ManaCostOptions added in v0.1.10

type ManaCostOptions struct {
	BaseCost   float64
	FlatCost   float64 // Alternative to BaseCost for giving a flat value.
	Multiplier float64 // It's OK to leave this at 0, will default to 1.
}

type MeleeDamageCalculator

type MeleeDamageCalculator func(attackPower float64, bonusWeaponDamage float64) float64

type OnCastComplete

type OnCastComplete func(aura *Aura, sim *Simulation, spell *Spell)

Callback for when a cast is finished, i.e. when the in-game castbar reaches full.

type OnDoneIteration

type OnDoneIteration func(aura *Aura, sim *Simulation)

type OnEnergyGain

type OnEnergyGain func(sim *Simulation)

OnEnergyGain is called any time energy is increased.

type OnExpire

type OnExpire func(aura *Aura, sim *Simulation)

type OnGain

type OnGain func(aura *Aura, sim *Simulation)

type OnInit

type OnInit func(aura *Aura, sim *Simulation)

type OnManaTick

type OnManaTick func(sim *Simulation)

type OnPeriodicDamage

type OnPeriodicDamage func(aura *Aura, sim *Simulation, spell *Spell, result *SpellResult)

OnPeriodicDamage is called when dots tick, after damage is calculated. Use it for proc effects or anything that comes from the final result of a tick.

type OnPetDisable

type OnPetDisable func(sim *Simulation)

type OnPetEnable

type OnPetEnable func(sim *Simulation)

type OnRageGain

type OnRageGain func(sim *Simulation)

OnRageGain is called any time rage is increased.

type OnReset

type OnReset func(aura *Aura, sim *Simulation)

type OnRune

type OnRune func(sim *Simulation)

type OnRunicPowerGain

type OnRunicPowerGain func(sim *Simulation)

type OnSnapshot added in v0.1.1

type OnSnapshot func(sim *Simulation, target *Unit, dot *Dot, isRollover bool)

type OnSpellHit

type OnSpellHit func(aura *Aura, sim *Simulation, spell *Spell, result *SpellResult)

Callback for after a spell hits the target and after damage is calculated. Use it for proc effects or anything that comes from the final result of the spell.

type OnStacksChange

type OnStacksChange func(aura *Aura, sim *Simulation, oldStacks int32, newStacks int32)

type OnStatsChange

type OnStatsChange func(aura *Aura, sim *Simulation, oldStats stats.Stats, newStats stats.Stats)

type OnSwapItem added in v0.1.10

type OnSwapItem func(*Simulation)

type OnTick added in v0.1.1

type OnTick func(sim *Simulation, target *Unit, dot *Dot)

type OutcomeApplier

type OutcomeApplier func(sim *Simulation, result *SpellResult, attackTable *AttackTable)

This function should do 3 things:

  1. Set the Outcome of the hit effect.
  2. Update spell outcome metrics.
  3. Modify the damage if necessary.

type PPMManager

type PPMManager struct {
	// contains filtered or unexported fields
}

func (*PPMManager) Chance added in v0.1.10

func (ppmm *PPMManager) Chance(procMask ProcMask) float64

func (*PPMManager) Proc

func (ppmm *PPMManager) Proc(sim *Simulation, procMask ProcMask, label string) bool

Returns whether the effect procced.

type Party

type Party struct {
	Raid  *Raid
	Index int

	Players []Agent
	Pets    []PetAgent // Cached list of all the pets in the party.

	PlayersAndPets []Agent // Cached list of players + pets, concatenated.
	// contains filtered or unexported fields
}

func NewParty

func NewParty(raid *Raid, index int, partyConfig *proto.Party) *Party

func (*Party) AddStat

func (party *Party) AddStat(stat stats.Stat, amount float64)

func (*Party) AddStats

func (party *Party) AddStats(newStats stats.Stats)

func (*Party) GetMetrics

func (party *Party) GetMetrics() *proto.PartyMetrics

func (*Party) GetPartyBuffs

func (party *Party) GetPartyBuffs(basePartyBuffs *proto.PartyBuffs) *proto.PartyBuffs

func (*Party) IsFull

func (party *Party) IsFull() bool

func (*Party) Size

func (party *Party) Size() int

type PendingAction

type PendingAction struct {
	NextActionAt time.Duration
	Priority     ActionPriority

	OnAction func(*Simulation)
	CleanUp  func(*Simulation)
	// contains filtered or unexported fields
}

func NewDelayedAction

func NewDelayedAction(sim *Simulation, options DelayedActionOptions) *PendingAction

func NewPeriodicAction

func NewPeriodicAction(sim *Simulation, options PeriodicActionOptions) *PendingAction

func StartDelayedAction

func StartDelayedAction(sim *Simulation, options DelayedActionOptions) *PendingAction

Convenience for immediately creating and starting a delayed action.

func StartPeriodicAction

func StartPeriodicAction(sim *Simulation, options PeriodicActionOptions) *PendingAction

Convenience for immediately creating and starting a periodic action.

func (*PendingAction) Cancel

func (pa *PendingAction) Cancel(sim *Simulation)

type PeriodicActionOptions

type PeriodicActionOptions struct {
	// How often the action should be performed.
	Period time.Duration

	// Number of times to perform the action before stopping.
	// 0 indicates a permanent periodic action.
	NumTicks int

	// Whether the first tick should happen immediately. If false, first tick will
	// wait for Period.
	TickImmediately bool

	Priority ActionPriority

	OnAction func(*Simulation)
	CleanUp  func(*Simulation)
}

type Pet

type Pet struct {
	Character

	Owner *Character

	OnPetEnable  OnPetEnable
	OnPetDisable OnPetDisable
	// contains filtered or unexported fields
}

Pet is an extension of Character, for any entity created by a player that can take actions on its own.

func NewPet

func NewPet(name string, owner *Character, baseStats stats.Stats, statInheritance PetStatInheritance, guardianDynamicStatInheritance PetStatInheritance, enabledOnStart bool, isGuardian bool) Pet

func (*Pet) AddComboPoints

func (eb *Pet) AddComboPoints(sim *Simulation, pointsToAdd int32, metrics *ResourceMetrics)

func (*Pet) AddEnergy

func (eb *Pet) AddEnergy(sim *Simulation, amount float64, metrics *ResourceMetrics)

func (*Pet) AddMajorCooldown

func (mcdm *Pet) AddMajorCooldown(mcd MajorCooldown)

Registers a major cooldown to the Character, which will be automatically used when available.

func (*Pet) AddPartyBuffs

func (pet *Pet) AddPartyBuffs(partyBuffs *proto.PartyBuffs)

func (*Pet) AddRage

func (rb *Pet) AddRage(sim *Simulation, amount float64, metrics *ResourceMetrics)

func (*Pet) AddRaidBuffs

func (pet *Pet) AddRaidBuffs(raidBuffs *proto.RaidBuffs)

func (*Pet) ApplyTalents

func (pet *Pet) ApplyTalents()

func (*Pet) ComboPoints

func (eb *Pet) ComboPoints() int32

func (*Pet) CurrentEnergy

func (eb *Pet) CurrentEnergy() float64

func (*Pet) CurrentHealth

func (hb *Pet) CurrentHealth() float64

func (*Pet) CurrentHealthPercent

func (hb *Pet) CurrentHealthPercent() float64

func (*Pet) CurrentRage

func (rb *Pet) CurrentRage() float64

func (*Pet) DelayDPSCooldowns added in v0.1.5

func (mcdm *Pet) DelayDPSCooldowns(delay time.Duration)

Adds a delay to the first usage of all CDs overriding shouldActivate for cooldownTypeDPS, MCDs that have a user-specified timing are not delayed. This function should be called from Agent.Init().

func (*Pet) DelayDPSCooldownsForArmorDebuffs

func (mcdm *Pet) DelayDPSCooldownsForArmorDebuffs(delay time.Duration)

Adds a delay to the first usage of all CDs so that debuffs have time to be applied. MCDs that have a user-specified timing are not delayed.

This function should be called from Agent.Init().

func (*Pet) Disable

func (pet *Pet) Disable(sim *Simulation)

func (*Pet) Enable

func (pet *Pet) Enable(sim *Simulation, petAgent PetAgent)

petAgent should be the PetAgent which embeds this Pet.

func (*Pet) EnableWithTimeout

func (pet *Pet) EnableWithTimeout(sim *Simulation, petAgent PetAgent, petDuration time.Duration)

Helper for enabling a pet that will expire after a certain duration.

func (*Pet) Finalize

func (pet *Pet) Finalize()

func (*Pet) GainHealth

func (hb *Pet) GainHealth(sim *Simulation, amount float64, metrics *ResourceMetrics)

func (*Pet) GetActiveAuraWithTag

func (at *Pet) GetActiveAuraWithTag(tag string) *Aura

func (*Pet) GetAura

func (at *Pet) GetAura(label string) *Aura

func (*Pet) GetAurasWithTag

func (at *Pet) GetAurasWithTag(tag string) []*Aura

func (*Pet) GetCharacter

func (pet *Pet) GetCharacter() *Character

Default implementations for some Agent functions which most Pets don't need.

func (*Pet) GetInitialMajorCooldown

func (mcdm *Pet) GetInitialMajorCooldown(actionID ActionID) MajorCooldown

func (*Pet) GetMajorCooldown

func (mcdm *Pet) GetMajorCooldown(actionID ActionID) *MajorCooldown

func (*Pet) GetMajorCooldownIDs

func (mcdm *Pet) GetMajorCooldownIDs() []*proto.ActionID

func (*Pet) GetMajorCooldownIgnoreTag added in v0.1.10

func (mcdm *Pet) GetMajorCooldownIgnoreTag(actionID ActionID) *MajorCooldown

func (*Pet) GetMajorCooldowns

func (mcdm *Pet) GetMajorCooldowns() []*MajorCooldown

Returns all MCDs.

func (*Pet) HasActiveAura

func (at *Pet) HasActiveAura(label string) bool

func (*Pet) HasActiveAuraWithTag

func (at *Pet) HasActiveAuraWithTag(tag string) bool

func (*Pet) HasActiveAuraWithTagExcludingAura

func (at *Pet) HasActiveAuraWithTagExcludingAura(tag string, excludeAura *Aura) bool

func (*Pet) HasAura

func (at *Pet) HasAura(label string) bool

func (*Pet) HasAuraWithTag

func (at *Pet) HasAuraWithTag(tag string) bool

func (*Pet) IsGuardian

func (pet *Pet) IsGuardian() bool

func (*Pet) MaxHealth

func (hb *Pet) MaxHealth() float64

func (*Pet) NextEnergyTickAt

func (eb *Pet) NextEnergyTickAt() time.Duration

func (*Pet) NumActiveAurasWithTag

func (at *Pet) NumActiveAurasWithTag(tag string) int32

func (*Pet) OnCastComplete

func (at *Pet) OnCastComplete(sim *Simulation, spell *Spell)

Invokes the OnCastComplete event for all tracked Auras.

func (*Pet) OnHealDealt

func (at *Pet) OnHealDealt(sim *Simulation, spell *Spell, result *SpellResult)

Invokes the OnHeal event for all tracked Auras.

func (*Pet) OnHealTaken

func (at *Pet) OnHealTaken(sim *Simulation, spell *Spell, result *SpellResult)

func (*Pet) OnPeriodicDamageDealt

func (at *Pet) OnPeriodicDamageDealt(sim *Simulation, spell *Spell, result *SpellResult)

Invokes the OnPeriodicDamage

As a debuff when target is being hit by dot.
As a buff when caster's dots are ticking.

func (*Pet) OnPeriodicDamageTaken

func (at *Pet) OnPeriodicDamageTaken(sim *Simulation, spell *Spell, result *SpellResult)

func (*Pet) OnPeriodicHealDealt

func (at *Pet) OnPeriodicHealDealt(sim *Simulation, spell *Spell, result *SpellResult)

Invokes the OnPeriodicHeal

As a debuff when target is being hit by dot.
As a buff when caster's dots are ticking.

func (*Pet) OnPeriodicHealTaken

func (at *Pet) OnPeriodicHealTaken(sim *Simulation, spell *Spell, result *SpellResult)

func (*Pet) OnSpellHitDealt

func (at *Pet) OnSpellHitDealt(sim *Simulation, spell *Spell, result *SpellResult)

Invokes the OnSpellHit event for all tracked Auras.

func (*Pet) OnSpellHitTaken

func (at *Pet) OnSpellHitTaken(sim *Simulation, spell *Spell, result *SpellResult)

func (*Pet) OwnerAttackSpeedChanged

func (pet *Pet) OwnerAttackSpeedChanged(sim *Simulation)

Add a default base if pets dont need this

func (*Pet) RegisterResetEffect

func (at *Pet) RegisterResetEffect(resetEffect ResetEffect)

Registers a callback to this Character which will be invoked on every Sim reset.

func (*Pet) RemoveHealth

func (hb *Pet) RemoveHealth(sim *Simulation, amount float64)

func (*Pet) ResetEnergyTick

func (eb *Pet) ResetEnergyTick(sim *Simulation)

Gives an immediate partial energy tick and restarts the tick timer.

func (*Pet) SpendComboPoints

func (eb *Pet) SpendComboPoints(sim *Simulation, metrics *ResourceMetrics)

func (*Pet) SpendEnergy

func (eb *Pet) SpendEnergy(sim *Simulation, amount float64, metrics *ResourceMetrics)

func (*Pet) SpendRage

func (rb *Pet) SpendRage(sim *Simulation, amount float64, metrics *ResourceMetrics)

func (*Pet) TryUseCooldowns

func (mcdm *Pet) TryUseCooldowns(sim *Simulation)

func (*Pet) UpdateMajorCooldowns

func (mcdm *Pet) UpdateMajorCooldowns()

This function should be called if the CD for a major cooldown changes outside of the TryActivate() call.

type PetAgent

type PetAgent interface {
	Agent

	// The Pet controlled by this PetAgent.
	GetPet() *Pet
	OwnerAttackSpeedChanged(sim *Simulation)
}

Extension of Agent interface, for Pets.

type PetStatInheritance

type PetStatInheritance func(ownerStats stats.Stats) stats.Stats

type PostFinalizeEffect

type PostFinalizeEffect func()

Callback for doing something after finalization.

type PowerBarType

type PowerBarType int
const (
	ManaBar PowerBarType = iota
	EnergyBar
	RageBar
	RunicPower
)

type PrepullAction added in v0.1.14

type PrepullAction struct {
	DoAt   time.Duration
	Action func(*Simulation)
}

Callback for doing something on prepull.

type PresetTarget

type PresetTarget struct {
	// String in folder-structure format identifying a category for this unit, e.g. "Black Temple/Bosses".
	PathPrefix string

	Config *proto.Target

	AI AIFactory
}

func GetPresetTargetWithID

func GetPresetTargetWithID(id int32) *PresetTarget

func GetPresetTargetWithPath

func GetPresetTargetWithPath(path string) *PresetTarget

func (PresetTarget) Path

func (pt PresetTarget) Path() string

func (PresetTarget) ToProto

func (pt PresetTarget) ToProto() *proto.PresetTarget

type PresimOptions

type PresimOptions struct {
	// Called once before each presim round.
	//
	// Modify the player parameter to use whatever player options are desired
	// for the presim.
	SetPresimPlayerOptions func(player *proto.Player)

	// Called once after each presim round to provide the results.
	//
	// Should return true if this Agent is done running presims, and false otherwise.
	OnPresimResult func(presimResult *proto.UnitMetrics, iterations int32, duration time.Duration) bool
}

Controls the presim behavior for 1 Agent.

type Presimmer

type Presimmer interface {
	GetPresimOptions(*proto.Player) *PresimOptions
}

A presim is a full simulation run with multiple iterations, as a preparation step for testing out settings before starting the recorded iterations.

To use this, just implement this interface on your Agent.

If you don't know what this is, you probably don't need it.

type ProcHandler added in v0.1.7

type ProcHandler func(sim *Simulation, spell *Spell, result *SpellResult)

type ProcMask

type ProcMask uint32
const (
	// Default value is invalid, to force authors to think about proc masks.
	ProcMaskUnknown ProcMask = 0

	ProcMaskEmpty ProcMask = 1 << iota
	ProcMaskMeleeMHAuto
	ProcMaskMeleeOHAuto
	ProcMaskMeleeMHSpecial
	ProcMaskMeleeOHSpecial
	ProcMaskRangedAuto
	ProcMaskRangedSpecial
	ProcMaskSpellDamage
	ProcMaskSpellHealing
)

Single-bit masks. These don't need to match Blizzard's values.

func GetMeleeProcMaskForHands

func GetMeleeProcMaskForHands(mh bool, oh bool) ProcMask

func (ProcMask) Matches

func (pm ProcMask) Matches(other ProcMask) bool

Returns whether there is any overlap between the given masks.

type ProcTrigger added in v0.1.7

type ProcTrigger struct {
	Name       string
	ActionID   ActionID
	Duration   time.Duration
	Callback   AuraCallback
	ProcMask   ProcMask
	SpellFlags SpellFlag
	Outcome    HitOutcome
	Harmful    bool
	ProcChance float64
	PPM        float64
	ICD        time.Duration
	Handler    ProcHandler
}

type RageBarOptions

type RageBarOptions struct {
	StartingRage   float64
	RageMultiplier float64
	MHSwingSpeed   float64
	OHSwingSpeed   float64
}

type RageCost added in v0.1.10

type RageCost struct {
	Refund          float64
	RefundMetrics   *ResourceMetrics
	ResourceMetrics *ResourceMetrics
}

func (*RageCost) IssueRefund added in v0.1.10

func (rc *RageCost) IssueRefund(sim *Simulation, spell *Spell)

func (*RageCost) LogCostFailure added in v0.1.10

func (rc *RageCost) LogCostFailure(sim *Simulation, spell *Spell)

func (*RageCost) MeetsRequirement added in v0.1.10

func (rc *RageCost) MeetsRequirement(spell *Spell) bool

func (*RageCost) SpendCost added in v0.1.10

func (rc *RageCost) SpendCost(sim *Simulation, spell *Spell)

type RageCostOptions added in v0.1.10

type RageCostOptions struct {
	Cost float64

	Refund        float64
	RefundMetrics *ResourceMetrics // Optional, will default to unit.RageRefundMetrics if not supplied.
}

type Raid

type Raid struct {
	Parties []*Party

	AllUnits []*Unit // Cached list of all Units (players and pets) in the raid.
	// contains filtered or unexported fields
}

func NewRaid

func NewRaid(raidConfig *proto.Raid) *Raid

Makes a new raid.

func (Raid) AddStats

func (raid Raid) AddStats(s stats.Stats)

func (*Raid) GetFirstEmptyRaidIndex

func (raid *Raid) GetFirstEmptyRaidIndex() (*Party, int)

Returns (party, index within party)

func (Raid) GetFirstNPlayersOrPets

func (raid Raid) GetFirstNPlayersOrPets(n int32) []*Unit

func (*Raid) GetFirstTargetDummy

func (raid *Raid) GetFirstTargetDummy() *TargetDummy

func (*Raid) GetMetrics

func (raid *Raid) GetMetrics() *proto.RaidMetrics

func (Raid) GetPlayerFromRaidTarget

func (raid Raid) GetPlayerFromRaidTarget(raidTarget *proto.RaidTarget) Agent

func (Raid) GetPlayerFromUnit

func (raid Raid) GetPlayerFromUnit(unit *Unit) Agent

func (*Raid) GetPlayerFromUnitIndex

func (raid *Raid) GetPlayerFromUnitIndex(unitIndex int32) Agent

func (Raid) GetPlayersOfClass

func (raid Raid) GetPlayersOfClass(class proto.Class) []Agent

func (*Raid) GetRaidBuffs

func (raid *Raid) GetRaidBuffs(baseRaidBuffs *proto.RaidBuffs) *proto.RaidBuffs

func (*Raid) NewReplenishmentSource added in v0.1.6

func (raid *Raid) NewReplenishmentSource(actionID ActionID) ReplenishmentSource

Returns a new aura whose activation will give the Replenishment buff to 10 party/raid members.

func (*Raid) ProcReplenishment added in v0.1.6

func (raid *Raid) ProcReplenishment(sim *Simulation, src ReplenishmentSource)

func (*Raid) Size

func (raid *Raid) Size() int

type Rand

type Rand interface {
	Next() uint64
	NextFloat64() float64
	Seed(int64)
	GetSeed() int64
}

implementing Source or Source64 is possible, but adds too much overhead

type ReplaceMHSwing

type ReplaceMHSwing func(sim *Simulation, mhSwingSpell *Spell) *Spell

ReplaceMHSwing is called right before an auto attack fires

If it returns nil, the attack takes place as normal. If it returns a Spell,
that Spell is used in place of the attack.
This allows for abilities that convert a white attack into yellow attack.

type ReplenishmentSource added in v0.1.6

type ReplenishmentSource int

type ResetEffect

type ResetEffect func(*Simulation)

Callback for doing something on reset.

type ResourceKey

type ResourceKey struct {
	ActionID ActionID
	Type     proto.ResourceType
}

type ResourceMetrics

type ResourceMetrics struct {
	ActionID ActionID
	Type     proto.ResourceType

	Events     int32
	Gain       float64
	ActualGain float64

	EventsFromPreviousIterations     int32
	ActualGainFromPreviousIterations float64
}

func (*ResourceMetrics) ActualGainForCurrentIteration

func (resourceMetrics *ResourceMetrics) ActualGainForCurrentIteration() float64

func (*ResourceMetrics) AddEvent

func (resourceMetrics *ResourceMetrics) AddEvent(gain float64, actualGain float64)

func (*ResourceMetrics) EventsForCurrentIteration

func (resourceMetrics *ResourceMetrics) EventsForCurrentIteration() int32

func (*ResourceMetrics) ToProto

func (resourceMetrics *ResourceMetrics) ToProto() *proto.ResourceMetrics

type RotationCastsTestGenerator

type RotationCastsTestGenerator struct {
	SpecOptions []SpecOptionsCombo
	PartyBuffs  *proto.PartyBuffs
	RaidBuffs   *proto.RaidBuffs
	Debuffs     *proto.Debuffs
	Player      *proto.Player
	Encounter   *proto.Encounter
	SimOptions  *proto.SimOptions
}

func (*RotationCastsTestGenerator) GetTest

func (*RotationCastsTestGenerator) NumTests

func (generator *RotationCastsTestGenerator) NumTests() int

type RuneConvertType added in v0.1.12

type RuneConvertType int8
const (
	RuneConvertTypeNone RuneConvertType = 1 << iota
	RuneConvertTypeBlood
	RuneConvertTypeFrost
	RuneConvertTypeUnholy
)

type RuneCost

type RuneCost uint16

func NewRuneCost

func NewRuneCost(rp, blood, frost, unholy, death uint8) RuneCost

func (RuneCost) Blood

func (rc RuneCost) Blood() uint8

func (RuneCost) Death

func (rc RuneCost) Death() uint8

func (RuneCost) Frost

func (rc RuneCost) Frost() uint8

func (RuneCost) HasRune

func (rc RuneCost) HasRune() bool

HasRune returns if this cost includes a rune portion.

If any bit is set in the rune bits it means that there is a rune cost.

func (RuneCost) RunicPower

func (rc RuneCost) RunicPower() uint8

func (RuneCost) String

func (rc RuneCost) String() string

func (RuneCost) Unholy

func (rc RuneCost) Unholy() uint8

type RuneCostImpl added in v0.1.12

type RuneCostImpl struct {
	BloodRuneCost  int8
	FrostRuneCost  int8
	UnholyRuneCost int8
	RunicPowerCost float64
	RunicPowerGain float64
	Refundable     bool
}

func (*RuneCostImpl) IssueRefund added in v0.1.12

func (rc *RuneCostImpl) IssueRefund(sim *Simulation, spell *Spell)

func (*RuneCostImpl) LogCostFailure added in v0.1.12

func (rc *RuneCostImpl) LogCostFailure(sim *Simulation, spell *Spell)

func (*RuneCostImpl) MeetsRequirement added in v0.1.12

func (rc *RuneCostImpl) MeetsRequirement(spell *Spell) bool

func (*RuneCostImpl) SpendCost added in v0.1.12

func (rc *RuneCostImpl) SpendCost(sim *Simulation, spell *Spell)

func (*RuneCostImpl) SpendRefundableCost added in v0.1.12

func (rc *RuneCostImpl) SpendRefundableCost(sim *Simulation, spell *Spell, result *SpellResult)

func (*RuneCostImpl) SpendRefundableCostAndConvertBloodRune added in v0.1.12

func (rc *RuneCostImpl) SpendRefundableCostAndConvertBloodRune(sim *Simulation, spell *Spell, result *SpellResult, convertChance float64)

func (*RuneCostImpl) SpendRefundableCostAndConvertFrostOrUnholyRune added in v0.1.12

func (rc *RuneCostImpl) SpendRefundableCostAndConvertFrostOrUnholyRune(sim *Simulation, spell *Spell, result *SpellResult, convertChance float64)

type RuneCostOptions added in v0.1.12

type RuneCostOptions struct {
	BloodRuneCost  int8
	FrostRuneCost  int8
	UnholyRuneCost int8
	RunicPowerCost float64
	RunicPowerGain float64
	Refundable     bool
}

type RuneKind

type RuneKind uint8
const (
	RuneKind_Undef RuneKind = iota
	RuneKind_Blood
	RuneKind_Frost
	RuneKind_Unholy
	RuneKind_Death
)

type RuneMeta

type RuneMeta struct {
	// contains filtered or unexported fields
}

type RunicPowerBar

type RunicPowerBar struct {
	// contains filtered or unexported fields
}

func (*RunicPowerBar) AddRunicPower

func (rp *RunicPowerBar) AddRunicPower(sim *Simulation, amount float64, metrics *ResourceMetrics)

func (*RunicPowerBar) Advance

func (rp *RunicPowerBar) Advance(sim *Simulation, newTime time.Duration)

func (*RunicPowerBar) AllBloodRunesSpent

func (rp *RunicPowerBar) AllBloodRunesSpent() bool

func (*RunicPowerBar) AllFrostSpent

func (rp *RunicPowerBar) AllFrostSpent() bool

func (*RunicPowerBar) AllRunesSpent

func (rp *RunicPowerBar) AllRunesSpent() bool

func (*RunicPowerBar) AllUnholySpent

func (rp *RunicPowerBar) AllUnholySpent() bool

func (*RunicPowerBar) AnyRuneReadyAt

func (rp *RunicPowerBar) AnyRuneReadyAt(sim *Simulation) time.Duration

func (*RunicPowerBar) AnySpentRuneReadyAt

func (rp *RunicPowerBar) AnySpentRuneReadyAt() time.Duration

AnySpentRuneReadyAt returns the next time that a rune will regenerate.

It will be NeverExpires if there is no rune pending regeneration.

func (*RunicPowerBar) BloodDeathRuneBothReadyAt added in v0.1.8

func (rp *RunicPowerBar) BloodDeathRuneBothReadyAt() time.Duration

func (*RunicPowerBar) BloodRuneGainMetrics

func (rp *RunicPowerBar) BloodRuneGainMetrics() *ResourceMetrics

func (*RunicPowerBar) BloodRuneReadyAt

func (rp *RunicPowerBar) BloodRuneReadyAt(sim *Simulation) time.Duration

func (*RunicPowerBar) BloodRuneSpentAt

func (rp *RunicPowerBar) BloodRuneSpentAt(dur time.Duration) int32

func (*RunicPowerBar) CancelBloodTap

func (rp *RunicPowerBar) CancelBloodTap(sim *Simulation)

func (*RunicPowerBar) CastCostPossible

func (rp *RunicPowerBar) CastCostPossible(sim *Simulation, runicPowerAmount float64, bloodAmount int8, frostAmount int8, unholyAmount int8) bool

func (*RunicPowerBar) ConvertFromDeath

func (rp *RunicPowerBar) ConvertFromDeath(sim *Simulation, slot int8)

ConvertFromDeath reverts the rune to its original type.

func (*RunicPowerBar) ConvertToDeath

func (rp *RunicPowerBar) ConvertToDeath(sim *Simulation, slot int8, revertAt time.Duration)

ConvertToDeath converts the given slot to death and sets up the revertion conditions

func (*RunicPowerBar) CopyRunicPowerBar

func (rp *RunicPowerBar) CopyRunicPowerBar() *RunicPowerBar

CopyRunicPowerBar will create a clone of the bar with the same

func (*RunicPowerBar) CorrectBloodTapConversion

func (rp *RunicPowerBar) CorrectBloodTapConversion(sim *Simulation, bloodGainMetrics *ResourceMetrics, deathGainMetrics *ResourceMetrics, spell *Spell)

func (*RunicPowerBar) CurrentBloodRuneGrace

func (rp *RunicPowerBar) CurrentBloodRuneGrace(sim *Simulation) time.Duration

func (*RunicPowerBar) CurrentBloodRunes

func (rp *RunicPowerBar) CurrentBloodRunes() int8

func (*RunicPowerBar) CurrentDeathRunes

func (rp *RunicPowerBar) CurrentDeathRunes() int8

func (*RunicPowerBar) CurrentFrostRuneGrace

func (rp *RunicPowerBar) CurrentFrostRuneGrace(sim *Simulation) time.Duration

func (*RunicPowerBar) CurrentFrostRunes

func (rp *RunicPowerBar) CurrentFrostRunes() int8

func (*RunicPowerBar) CurrentRuneGrace

func (rp *RunicPowerBar) CurrentRuneGrace(sim *Simulation, slot int32) time.Duration

func (*RunicPowerBar) CurrentRuneGraces

func (rp *RunicPowerBar) CurrentRuneGraces(sim *Simulation) (time.Duration, time.Duration, time.Duration)

func (*RunicPowerBar) CurrentRunicPower

func (rp *RunicPowerBar) CurrentRunicPower() float64

func (*RunicPowerBar) CurrentUnholyRuneGrace

func (rp *RunicPowerBar) CurrentUnholyRuneGrace(sim *Simulation) time.Duration

func (*RunicPowerBar) CurrentUnholyRunes

func (rp *RunicPowerBar) CurrentUnholyRunes() int8

func (*RunicPowerBar) DeathRuneGainMetrics

func (rp *RunicPowerBar) DeathRuneGainMetrics() *ResourceMetrics

func (*RunicPowerBar) DeathRuneRegenAt

func (rp *RunicPowerBar) DeathRuneRegenAt(slot int32) time.Duration

DeathRuneRegenAt returns the time the given death rune will regen at.

If the rune is not death or not spent it returns NeverExpires

func (*RunicPowerBar) DeathRuneRevertAt

func (rp *RunicPowerBar) DeathRuneRevertAt() time.Duration

DeathRuneRevertAt returns the next time that a death rune will revert.

If there is no deathrune that needs to revert it returns `NeverExpires`.

func (*RunicPowerBar) DeathRunesInFU

func (rp *RunicPowerBar) DeathRunesInFU() int8

func (*RunicPowerBar) DebugString

func (rp *RunicPowerBar) DebugString() string

func (*RunicPowerBar) FrostRuneGainMetrics

func (rp *RunicPowerBar) FrostRuneGainMetrics() *ResourceMetrics

func (*RunicPowerBar) FrostRuneReadyAt

func (rp *RunicPowerBar) FrostRuneReadyAt(sim *Simulation) time.Duration

func (*RunicPowerBar) FrostRuneSpentAt

func (rp *RunicPowerBar) FrostRuneSpentAt(dur time.Duration) int32

func (*RunicPowerBar) GainDeathRuneMetrics

func (rp *RunicPowerBar) GainDeathRuneMetrics(sim *Simulation, spell *Spell, currRunes int32, newRunes int32)

func (*RunicPowerBar) GainRuneMetrics

func (rp *RunicPowerBar) GainRuneMetrics(sim *Simulation, metrics *ResourceMetrics, gainAmount int8)

GainRuneMetrics should be called after gaining the rune

func (*RunicPowerBar) IsBloodTappedRune added in v0.1.10

func (rp *RunicPowerBar) IsBloodTappedRune(slot int8) bool

func (*RunicPowerBar) LaunchRuneRegen

func (rp *RunicPowerBar) LaunchRuneRegen(sim *Simulation, slot int8)

func (*RunicPowerBar) LeftBloodRuneReady

func (rp *RunicPowerBar) LeftBloodRuneReady() bool

func (*RunicPowerBar) MaxRunicPower

func (rp *RunicPowerBar) MaxRunicPower() float64

func (*RunicPowerBar) NormalCurrentBloodRunes

func (rp *RunicPowerBar) NormalCurrentBloodRunes() int32

func (*RunicPowerBar) NormalCurrentFrostRunes

func (rp *RunicPowerBar) NormalCurrentFrostRunes() int32

func (*RunicPowerBar) NormalCurrentRunes

func (rp *RunicPowerBar) NormalCurrentRunes() (int32, int32, int32)

func (*RunicPowerBar) NormalCurrentUnholyRunes

func (rp *RunicPowerBar) NormalCurrentUnholyRunes() int32

func (*RunicPowerBar) NormalFrostRuneReadyAt

func (rp *RunicPowerBar) NormalFrostRuneReadyAt(sim *Simulation) time.Duration

func (*RunicPowerBar) NormalSpentBloodRuneReadyAt

func (rp *RunicPowerBar) NormalSpentBloodRuneReadyAt(sim *Simulation) time.Duration

func (*RunicPowerBar) NormalSpentFrostRuneReadyAt

func (rp *RunicPowerBar) NormalSpentFrostRuneReadyAt(sim *Simulation) time.Duration

func (*RunicPowerBar) NormalSpentUnholyRuneReadyAt

func (rp *RunicPowerBar) NormalSpentUnholyRuneReadyAt(sim *Simulation) time.Duration

func (*RunicPowerBar) NormalUnholyRuneReadyAt

func (rp *RunicPowerBar) NormalUnholyRuneReadyAt(sim *Simulation) time.Duration

func (*RunicPowerBar) OptimalRuneCost

func (rp *RunicPowerBar) OptimalRuneCost(cost RuneCost) RuneCost

func (*RunicPowerBar) PercentRunicPower

func (rp *RunicPowerBar) PercentRunicPower() float64

func (*RunicPowerBar) Print

func (rp *RunicPowerBar) Print()

func (*RunicPowerBar) ReadyDeathRune

func (rp *RunicPowerBar) ReadyDeathRune() int8

ReadyDeathRune returns the slot of first available death rune.

Returns -1 if there are no ready death runes

func (*RunicPowerBar) RegenAllRunes

func (rp *RunicPowerBar) RegenAllRunes(sim *Simulation)

func (*RunicPowerBar) RegenRune

func (rp *RunicPowerBar) RegenRune(sim *Simulation, regenAt time.Duration, slot int8)

func (*RunicPowerBar) RightBloodRuneReady

func (rp *RunicPowerBar) RightBloodRuneReady() bool

func (*RunicPowerBar) RuneGraceAt added in v0.1.7

func (rp *RunicPowerBar) RuneGraceAt(slot int8, at time.Duration) (runeGraceDuration time.Duration)

func (*RunicPowerBar) RuneIsDeath

func (rp *RunicPowerBar) RuneIsDeath(slot int8) bool

func (*RunicPowerBar) RuneReadyAt added in v0.1.7

func (rp *RunicPowerBar) RuneReadyAt(sim *Simulation, slot int8) time.Duration

func (*RunicPowerBar) SetRuneCd added in v0.1.1

func (rp *RunicPowerBar) SetRuneCd(runeCd time.Duration)

func (*RunicPowerBar) SpendBloodRune

func (rp *RunicPowerBar) SpendBloodRune(sim *Simulation, metrics *ResourceMetrics) int8

func (*RunicPowerBar) SpendDeathRune

func (rp *RunicPowerBar) SpendDeathRune(sim *Simulation, metrics *ResourceMetrics) int8

func (*RunicPowerBar) SpendFrostRune

func (rp *RunicPowerBar) SpendFrostRune(sim *Simulation, metrics *ResourceMetrics) int8

func (*RunicPowerBar) SpendRuneCost

func (rp *RunicPowerBar) SpendRuneCost(sim *Simulation, spell *Spell, cost RuneCost) (int8, int8, int8)

func (*RunicPowerBar) SpendRuneFromKind

func (rp *RunicPowerBar) SpendRuneFromKind(sim *Simulation, rkind RuneKind) int8

func (*RunicPowerBar) SpendRuneMetrics

func (rp *RunicPowerBar) SpendRuneMetrics(sim *Simulation, metrics *ResourceMetrics, spendAmount int8)

SpendRuneMetrics should be called after spending the rune

func (*RunicPowerBar) SpendRuneReadyAt added in v0.1.7

func (rp *RunicPowerBar) SpendRuneReadyAt(slot int8, spendAt time.Duration) time.Duration

func (*RunicPowerBar) SpendUnholyRune

func (rp *RunicPowerBar) SpendUnholyRune(sim *Simulation, metrics *ResourceMetrics) int8

func (*RunicPowerBar) SpentBloodRuneReadyAt

func (rp *RunicPowerBar) SpentBloodRuneReadyAt() time.Duration

func (*RunicPowerBar) SpentDeathRuneReadyAt

func (rp *RunicPowerBar) SpentDeathRuneReadyAt() time.Duration

func (*RunicPowerBar) SpentFrostRuneReadyAt

func (rp *RunicPowerBar) SpentFrostRuneReadyAt() time.Duration

func (*RunicPowerBar) SpentUnholyRuneReadyAt

func (rp *RunicPowerBar) SpentUnholyRuneReadyAt() time.Duration

func (*RunicPowerBar) TryRegenRune

func (rp *RunicPowerBar) TryRegenRune(sim *Simulation, newTime time.Duration, slot int8)

func (*RunicPowerBar) UnholyRuneGainMetrics

func (rp *RunicPowerBar) UnholyRuneGainMetrics() *ResourceMetrics

func (*RunicPowerBar) UnholyRuneReadyAt

func (rp *RunicPowerBar) UnholyRuneReadyAt(sim *Simulation) time.Duration

func (*RunicPowerBar) UnholyRuneSpentAt

func (rp *RunicPowerBar) UnholyRuneSpentAt(dur time.Duration) int32

type SettingsCombos

type SettingsCombos struct {
	Class       proto.Class
	Races       []proto.Race
	GearSets    []GearSetCombo
	TalentSets  []TalentsCombo
	SpecOptions []SpecOptionsCombo
	Buffs       []BuffsCombo
	Encounters  []EncounterCombo
	SimOptions  *proto.SimOptions
	IsHealer    bool
}

func (*SettingsCombos) GetTest

func (*SettingsCombos) NumTests

func (combos *SettingsCombos) NumTests() int

type Shield

type Shield struct {
	Spell *Spell

	// Embed Aura so we can use IsActive/Refresh/etc directly.
	*Aura
}

Rerpresents an absorption effect, e.g. Power Word: Shield.

func NewAllyShieldArray added in v0.1.7

func NewAllyShieldArray(caster *Unit, config Shield, auraConfig Aura) []*Shield

Creates Shields for all allied units.

func NewShield

func NewShield(config Shield) *Shield

func (*Shield) Apply

func (shield *Shield) Apply(sim *Simulation, shieldAmount float64)

type Simulation

type Simulation struct {
	*Environment

	Options *proto.SimOptions

	CurrentTime time.Duration // duration that has elapsed in the sim since starting
	Duration    time.Duration // Duration of current iteration

	ProgressReport func(*proto.ProgressMetrics)

	Log func(string, ...interface{})
	// contains filtered or unexported fields
}

func NewSim

func NewSim(rsr *proto.RaidSimRequest) *Simulation

func (*Simulation) AddPendingAction

func (sim *Simulation) AddPendingAction(pa *PendingAction)

func (*Simulation) GetRemainingDuration

func (sim *Simulation) GetRemainingDuration() time.Duration

func (*Simulation) GetRemainingDurationPercent

func (sim *Simulation) GetRemainingDurationPercent() float64

Returns the percentage of time remaining in the current iteration, as a value from 0-1.

func (*Simulation) IsExecutePhase20

func (sim *Simulation) IsExecutePhase20() bool

func (*Simulation) IsExecutePhase25

func (sim *Simulation) IsExecutePhase25() bool

func (*Simulation) IsExecutePhase35

func (sim *Simulation) IsExecutePhase35() bool

func (*Simulation) Proc added in v0.1.1

func (sim *Simulation) Proc(p float64, label string) bool

func (*Simulation) RandomFloat

func (sim *Simulation) RandomFloat(label string) float64

Returns a random float.

In tests, although we can set the initial seed, test results are still very sensitive to the exact order of RandomFloat() calls. To mitigate this, when testing we use a separate rand object for each RandomFloat callsite, distinguished by the label string.

func (*Simulation) RegisterExecutePhaseCallback

func (sim *Simulation) RegisterExecutePhaseCallback(callback func(*Simulation, int))

func (*Simulation) Reset

func (sim *Simulation) Reset()

func (*Simulation) Roll

func (sim *Simulation) Roll(min float64, max float64) float64

Shorthand for commonly-used RNG behavior. Returns a random number between min and max.

func (*Simulation) RollWithLabel added in v0.1.13

func (sim *Simulation) RollWithLabel(min float64, max float64, label string) float64

type SingleCharacterStatsTestGenerator

type SingleCharacterStatsTestGenerator struct {
	Name    string
	Request *proto.ComputeStatsRequest
}

func (*SingleCharacterStatsTestGenerator) GetTest

func (*SingleCharacterStatsTestGenerator) NumTests

func (generator *SingleCharacterStatsTestGenerator) NumTests() int

type SingleDpsTestGenerator

type SingleDpsTestGenerator struct {
	Name    string
	Request *proto.RaidSimRequest
}

func (*SingleDpsTestGenerator) GetTest

func (*SingleDpsTestGenerator) NumTests

func (generator *SingleDpsTestGenerator) NumTests() int

type SingleStatWeightsTestGenerator

type SingleStatWeightsTestGenerator struct {
	Name    string
	Request *proto.StatWeightsRequest
}

func (*SingleStatWeightsTestGenerator) GetTest

func (*SingleStatWeightsTestGenerator) NumTests

func (generator *SingleStatWeightsTestGenerator) NumTests() int

type SnapshotManager added in v0.1.5

type SnapshotManager struct {
	// contains filtered or unexported fields
}

func NewSnapshotManager added in v0.1.5

func NewSnapshotManager(character *Character) *SnapshotManager

func (*SnapshotManager) ActivateMajorCooldowns added in v0.1.5

func (manager *SnapshotManager) ActivateMajorCooldowns(sim *Simulation)

func (*SnapshotManager) AddMajorCooldown added in v0.1.5

func (manager *SnapshotManager) AddMajorCooldown(majorCd *MajorCooldown)

func (*SnapshotManager) AddProc added in v0.1.5

func (manager *SnapshotManager) AddProc(id int32, label string, isActive bool) bool

func (*SnapshotManager) CanSnapShot added in v0.1.5

func (manager *SnapshotManager) CanSnapShot(sim *Simulation, castTime time.Duration) bool

func (*SnapshotManager) ClearMajorCooldowns added in v0.1.5

func (manager *SnapshotManager) ClearMajorCooldowns()

func (*SnapshotManager) ResetProcTrackers added in v0.1.5

func (manager *SnapshotManager) ResetProcTrackers()

type SpecOptionsCombo

type SpecOptionsCombo struct {
	Label       string
	SpecOptions interface{}
}

type SpecSetter

type SpecSetter func(*proto.Player, interface{})

type Spell

type Spell struct {
	// ID for this spell.
	ActionID

	// The unit who will perform this spell.
	Unit *Unit

	// Fire, Frost, Shadow, etc.
	SpellSchool SpellSchool
	SchoolIndex stats.SchoolIndex

	// Controls which effects can proc from this spell.
	ProcMask ProcMask

	// Flags
	Flags SpellFlag

	// Speed in yards/second. Spell missile speeds can be found in the game data.
	// Example: https://wow.tools/dbc/?dbc=spellmisc&build=3.4.0.44996
	MissileSpeed float64

	// Should be stats.Mana, stats.Energy, stats.Rage, or unset.
	ResourceType    stats.Stat
	ResourceMetrics *ResourceMetrics

	// Base cost. Many effects in the game which 'reduce mana cost by X%'
	// are calculated using the base cost.
	BaseCost float64

	Cost               SpellCost // Cost for the spell.
	DefaultCast        Cast      // Default cast parameters with all static effects applied.
	CD                 Cooldown
	SharedCD           Cooldown
	ExtraCastCondition CanCastCondition

	SpellMetrics []SpellMetrics

	// Performs the actions of this spell.
	ApplyEffects ApplySpellResults

	// The current or most recent cast data.
	CurCast Cast

	BonusHitRating           float64
	BonusCritRating          float64
	BonusSpellPower          float64
	BonusExpertiseRating     float64
	BonusArmorPenRating      float64
	CastTimeMultiplier       float64
	CostMultiplier           float64
	DamageMultiplier         float64
	DamageMultiplierAdditive float64
	CritMultiplier           float64

	// Multiplier for all threat generated by this effect.
	ThreatMultiplier float64

	// Adds a fixed amount of threat to this spell, before multipliers.
	FlatThreatBonus float64
	// contains filtered or unexported fields
}

func (*Spell) AOEDot added in v0.1.12

func (spell *Spell) AOEDot() *Dot

func (*Spell) AOEHot added in v0.1.12

func (spell *Spell) AOEHot() *Dot

func (*Spell) ApplyAOEThreat

func (spell *Spell) ApplyAOEThreat(threatAmount float64)

func (*Spell) ApplyAOEThreatIgnoreMultipliers

func (spell *Spell) ApplyAOEThreatIgnoreMultipliers(threatAmount float64)

func (*Spell) ApplyCostModifiers

func (spell *Spell) ApplyCostModifiers(cost float64) float64

func (*Spell) ApplyPostOutcomeDamageModifiers

func (spell *Spell) ApplyPostOutcomeDamageModifiers(sim *Simulation, result *SpellResult)

func (*Spell) AttackerDamageMultiplier added in v0.1.1

func (spell *Spell) AttackerDamageMultiplier(attackTable *AttackTable) float64

Returns the combined attacker modifiers.

func (*Spell) BloodRuneMetrics

func (spell *Spell) BloodRuneMetrics() *ResourceMetrics

func (*Spell) BonusWeaponDamage

func (spell *Spell) BonusWeaponDamage() float64

func (*Spell) CalcAndDealDamage added in v0.1.1

func (spell *Spell) CalcAndDealDamage(sim *Simulation, target *Unit, baseDamage float64, outcomeApplier OutcomeApplier) *SpellResult

func (*Spell) CalcAndDealHealing added in v0.1.1

func (spell *Spell) CalcAndDealHealing(sim *Simulation, target *Unit, baseHealing float64, outcomeApplier OutcomeApplier) *SpellResult

func (*Spell) CalcAndDealOutcome added in v0.1.1

func (spell *Spell) CalcAndDealOutcome(sim *Simulation, target *Unit, outcomeApplier OutcomeApplier) *SpellResult

func (*Spell) CalcAndDealPeriodicDamage added in v0.1.1

func (spell *Spell) CalcAndDealPeriodicDamage(sim *Simulation, target *Unit, baseDamage float64, outcomeApplier OutcomeApplier) *SpellResult

func (*Spell) CalcAndDealPeriodicHealing added in v0.1.1

func (spell *Spell) CalcAndDealPeriodicHealing(sim *Simulation, target *Unit, baseHealing float64, outcomeApplier OutcomeApplier) *SpellResult

func (*Spell) CalcDamage

func (spell *Spell) CalcDamage(sim *Simulation, target *Unit, baseDamage float64, outcomeApplier OutcomeApplier) *SpellResult

func (*Spell) CalcHealing

func (spell *Spell) CalcHealing(sim *Simulation, target *Unit, baseHealing float64, outcomeApplier OutcomeApplier) *SpellResult

func (*Spell) CalcOutcome

func (spell *Spell) CalcOutcome(sim *Simulation, target *Unit, outcomeApplier OutcomeApplier) *SpellResult

For spells that do no damage but still have a hit/miss check.

func (*Spell) CalcPeriodicDamage added in v0.1.1

func (spell *Spell) CalcPeriodicDamage(sim *Simulation, target *Unit, baseDamage float64, outcomeApplier OutcomeApplier) *SpellResult

func (*Spell) CanCast added in v0.1.12

func (spell *Spell) CanCast(sim *Simulation, target *Unit) bool

Returns whether a call to Cast() would be successful, without actually doing a cast.

func (*Spell) Cast

func (spell *Spell) Cast(sim *Simulation, target *Unit) bool

func (*Spell) CasterHealingMultiplier

func (spell *Spell) CasterHealingMultiplier() float64

func (*Spell) ComboPointMetrics

func (spell *Spell) ComboPointMetrics() *ResourceMetrics

func (*Spell) CurDamagePerCast

func (spell *Spell) CurDamagePerCast() float64

Metrics for the current iteration

func (*Spell) CurDot added in v0.1.12

func (spell *Spell) CurDot() *Dot

func (*Spell) CurHot added in v0.1.12

func (spell *Spell) CurHot() *Dot

func (*Spell) DealDamage

func (spell *Spell) DealDamage(sim *Simulation, result *SpellResult)

func (*Spell) DealHealing

func (spell *Spell) DealHealing(sim *Simulation, result *SpellResult)

func (*Spell) DealOutcome

func (spell *Spell) DealOutcome(sim *Simulation, result *SpellResult)

func (*Spell) DealPeriodicDamage added in v0.1.1

func (spell *Spell) DealPeriodicDamage(sim *Simulation, result *SpellResult)

func (*Spell) DealPeriodicHealing added in v0.1.1

func (spell *Spell) DealPeriodicHealing(sim *Simulation, result *SpellResult)

func (*Spell) DeathRuneMetrics

func (spell *Spell) DeathRuneMetrics() *ResourceMetrics

func (*Spell) DisposeResult added in v0.1.1

func (spell *Spell) DisposeResult(result *SpellResult)

func (*Spell) Dot added in v0.1.12

func (spell *Spell) Dot(target *Unit) *Dot

func (*Spell) ExpectedDamage added in v0.1.1

func (spell *Spell) ExpectedDamage(sim *Simulation, target *Unit) float64

func (*Spell) ExpectedDamageFromCurrentSnapshot added in v0.1.10

func (spell *Spell) ExpectedDamageFromCurrentSnapshot(sim *Simulation, target *Unit) float64

func (*Spell) ExpertisePercentage

func (spell *Spell) ExpertisePercentage() float64

func (*Spell) FrostRuneMetrics

func (spell *Spell) FrostRuneMetrics() *ResourceMetrics

func (*Spell) HealingCritChance added in v0.1.1

func (spell *Spell) HealingCritChance() float64

func (*Spell) HealingCritCheck added in v0.1.1

func (spell *Spell) HealingCritCheck(sim *Simulation) bool

func (*Spell) HealingPower

func (spell *Spell) HealingPower(target *Unit) float64

func (*Spell) HealthMetrics

func (spell *Spell) HealthMetrics(target *Unit) *ResourceMetrics

func (*Spell) Hot added in v0.1.12

func (spell *Spell) Hot(target *Unit) *Dot

func (*Spell) IsMH

func (spell *Spell) IsMH() bool

Returns whether this hit effect is associated with the main-hand weapon.

func (*Spell) IsMelee

func (spell *Spell) IsMelee() bool

Returns whether this hit effect is associated with either melee weapon.

func (*Spell) IsOH

func (spell *Spell) IsOH() bool

Returns whether this hit effect is associated with the off-hand weapon.

func (*Spell) IsReady

func (spell *Spell) IsReady(sim *Simulation) bool

func (*Spell) IssueRefund added in v0.1.10

func (spell *Spell) IssueRefund(sim *Simulation)

func (*Spell) MagicCritCheck added in v0.1.1

func (spell *Spell) MagicCritCheck(sim *Simulation, target *Unit) bool

func (*Spell) MagicHitCheck

func (spell *Spell) MagicHitCheck(sim *Simulation, attackTable *AttackTable) bool

func (*Spell) MeleeAttackPower

func (spell *Spell) MeleeAttackPower() float64

func (*Spell) NewResult added in v0.1.1

func (spell *Spell) NewResult(target *Unit) *SpellResult

func (*Spell) OutcomeAlwaysHit

func (spell *Spell) OutcomeAlwaysHit(_ *Simulation, result *SpellResult, _ *AttackTable)

func (*Spell) OutcomeAlwaysMiss added in v0.1.1

func (spell *Spell) OutcomeAlwaysMiss(_ *Simulation, result *SpellResult, _ *AttackTable)

func (*Spell) OutcomeCritFixedChance

func (spell *Spell) OutcomeCritFixedChance(critChance float64) OutcomeApplier

func (*Spell) OutcomeEnemyMeleeWhite added in v0.1.1

func (spell *Spell) OutcomeEnemyMeleeWhite(sim *Simulation, result *SpellResult, attackTable *AttackTable)

func (*Spell) OutcomeExpectedMagicAlwaysHit added in v0.1.1

func (spell *Spell) OutcomeExpectedMagicAlwaysHit(sim *Simulation, result *SpellResult, attackTable *AttackTable)

func (*Spell) OutcomeExpectedMagicCrit added in v0.1.1

func (spell *Spell) OutcomeExpectedMagicCrit(sim *Simulation, result *SpellResult, attackTable *AttackTable)

func (*Spell) OutcomeExpectedMagicHit added in v0.1.1

func (spell *Spell) OutcomeExpectedMagicHit(sim *Simulation, result *SpellResult, attackTable *AttackTable)

func (*Spell) OutcomeExpectedMagicHitAndCrit added in v0.1.1

func (spell *Spell) OutcomeExpectedMagicHitAndCrit(sim *Simulation, result *SpellResult, attackTable *AttackTable)

func (*Spell) OutcomeExpectedTick added in v0.1.1

func (spell *Spell) OutcomeExpectedTick(sim *Simulation, result *SpellResult, attackTable *AttackTable)

func (*Spell) OutcomeHealingCrit

func (spell *Spell) OutcomeHealingCrit(sim *Simulation, result *SpellResult, attackTable *AttackTable)

func (*Spell) OutcomeMagicCrit

func (spell *Spell) OutcomeMagicCrit(sim *Simulation, result *SpellResult, attackTable *AttackTable)

func (*Spell) OutcomeMagicCritFixedChance added in v0.1.5

func (spell *Spell) OutcomeMagicCritFixedChance(critChance float64) OutcomeApplier

func (*Spell) OutcomeMagicHit

func (spell *Spell) OutcomeMagicHit(sim *Simulation, result *SpellResult, attackTable *AttackTable)

func (*Spell) OutcomeMagicHitAndCrit

func (spell *Spell) OutcomeMagicHitAndCrit(sim *Simulation, result *SpellResult, attackTable *AttackTable)

func (*Spell) OutcomeMeleeSpecialCritOnly

func (spell *Spell) OutcomeMeleeSpecialCritOnly(sim *Simulation, result *SpellResult, attackTable *AttackTable)

func (*Spell) OutcomeMeleeSpecialHit added in v0.1.1

func (spell *Spell) OutcomeMeleeSpecialHit(sim *Simulation, result *SpellResult, attackTable *AttackTable)

func (*Spell) OutcomeMeleeSpecialHitAndCrit added in v0.1.1

func (spell *Spell) OutcomeMeleeSpecialHitAndCrit(sim *Simulation, result *SpellResult, attackTable *AttackTable)

func (*Spell) OutcomeMeleeSpecialNoBlockDodgeParry added in v0.1.1

func (spell *Spell) OutcomeMeleeSpecialNoBlockDodgeParry(sim *Simulation, result *SpellResult, attackTable *AttackTable)

func (*Spell) OutcomeMeleeSpecialNoBlockDodgeParryNoCrit added in v0.1.1

func (spell *Spell) OutcomeMeleeSpecialNoBlockDodgeParryNoCrit(sim *Simulation, result *SpellResult, attackTable *AttackTable)

func (*Spell) OutcomeMeleeWeaponSpecialHitAndCrit added in v0.1.1

func (spell *Spell) OutcomeMeleeWeaponSpecialHitAndCrit(sim *Simulation, result *SpellResult, attackTable *AttackTable)

Like OutcomeMeleeSpecialHitAndCrit, but blocks prevent crits (all weapon damage based attacks).

func (*Spell) OutcomeMeleeWeaponSpecialNoCrit added in v0.1.1

func (spell *Spell) OutcomeMeleeWeaponSpecialNoCrit(sim *Simulation, result *SpellResult, attackTable *AttackTable)

func (*Spell) OutcomeMeleeWhite

func (spell *Spell) OutcomeMeleeWhite(sim *Simulation, result *SpellResult, attackTable *AttackTable)

func (*Spell) OutcomeRangedCritOnly

func (spell *Spell) OutcomeRangedCritOnly(sim *Simulation, result *SpellResult, attackTable *AttackTable)

func (*Spell) OutcomeRangedHit

func (spell *Spell) OutcomeRangedHit(sim *Simulation, result *SpellResult, attackTable *AttackTable)

func (*Spell) OutcomeRangedHitAndCrit

func (spell *Spell) OutcomeRangedHitAndCrit(sim *Simulation, result *SpellResult, attackTable *AttackTable)

func (*Spell) OutcomeTickMagicHit added in v0.1.1

func (spell *Spell) OutcomeTickMagicHit(sim *Simulation, result *SpellResult, attackTable *AttackTable)

func (*Spell) PhysicalCritChance added in v0.1.1

func (spell *Spell) PhysicalCritChance(target *Unit, attackTable *AttackTable) float64

func (*Spell) PhysicalCritCheck added in v0.1.1

func (spell *Spell) PhysicalCritCheck(sim *Simulation, target *Unit, attackTable *AttackTable) bool

func (*Spell) PhysicalHitChance

func (spell *Spell) PhysicalHitChance(target *Unit) float64

func (*Spell) RangedAttackPower

func (spell *Spell) RangedAttackPower(target *Unit) float64

func (*Spell) ReadyAt

func (spell *Spell) ReadyAt() time.Duration

func (*Spell) ResistanceMultiplier

func (spell *Spell) ResistanceMultiplier(sim *Simulation, isPeriodic bool, attackTable *AttackTable) float64

Modifies damage based on Armor or Magic resistances, depending on the damage type.

func (*Spell) RunicPowerMetrics

func (spell *Spell) RunicPowerMetrics() *ResourceMetrics

func (*Spell) SelfHot added in v0.1.12

func (spell *Spell) SelfHot() *Dot

func (*Spell) SkipCastAndApplyEffects

func (spell *Spell) SkipCastAndApplyEffects(sim *Simulation, target *Unit)

Skips the actual cast and applies spell effects immediately.

func (*Spell) SpellChanceToMiss added in v0.1.1

func (spell *Spell) SpellChanceToMiss(attackTable *AttackTable) float64

func (*Spell) SpellCritChance added in v0.1.1

func (spell *Spell) SpellCritChance(target *Unit) float64

func (*Spell) SpellHitChance

func (spell *Spell) SpellHitChance(target *Unit) float64

func (*Spell) SpellPower

func (spell *Spell) SpellPower() float64

func (*Spell) SpendRefundableCost added in v0.1.12

func (spell *Spell) SpendRefundableCost(sim *Simulation, result *SpellResult)

func (*Spell) SpendRefundableCostAndConvertBloodRune added in v0.1.12

func (spell *Spell) SpendRefundableCostAndConvertBloodRune(sim *Simulation, result *SpellResult, convertChance float64)

func (*Spell) SpendRefundableCostAndConvertFrostOrUnholyRune added in v0.1.12

func (spell *Spell) SpendRefundableCostAndConvertFrostOrUnholyRune(sim *Simulation, result *SpellResult, convertChance float64)

func (*Spell) TargetDamageMultiplier added in v0.1.1

func (spell *Spell) TargetDamageMultiplier(attackTable *AttackTable, isPeriodic bool) float64

func (*Spell) ThreatFromDamage added in v0.1.1

func (spell *Spell) ThreatFromDamage(outcome HitOutcome, damage float64) float64

func (*Spell) TimeToReady

func (spell *Spell) TimeToReady(sim *Simulation) time.Duration

func (*Spell) UnholyRuneMetrics

func (spell *Spell) UnholyRuneMetrics() *ResourceMetrics

func (*Spell) WaitTravelTime

func (spell *Spell) WaitTravelTime(sim *Simulation, callback func(*Simulation))

type SpellConfig

type SpellConfig struct {
	// See definition of Spell (below) for comments on these.
	ActionID
	SpellSchool  SpellSchool
	ProcMask     ProcMask
	Flags        SpellFlag
	MissileSpeed float64
	ResourceType stats.Stat
	BaseCost     float64

	ManaCost   ManaCostOptions
	EnergyCost EnergyCostOptions
	RageCost   RageCostOptions
	RuneCost   RuneCostOptions

	Cast               CastConfig
	ExtraCastCondition CanCastCondition

	BonusHitRating       float64
	BonusCritRating      float64
	BonusSpellPower      float64
	BonusExpertiseRating float64
	BonusArmorPenRating  float64

	DamageMultiplier         float64
	DamageMultiplierAdditive float64
	CritMultiplier           float64

	ThreatMultiplier float64

	FlatThreatBonus float64

	// Performs the actions of this spell.
	ApplyEffects ApplySpellResults

	// Optional field. Calculates expected average damage.
	ExpectedDamage ExpectedDamageCalculator

	Dot DotConfig
	Hot DotConfig
}

type SpellCost added in v0.1.10

type SpellCost interface {
	// Whether the Unit associated with the spell meets the resource cost
	// requirements to cast the spell.
	MeetsRequirement(*Spell) bool

	// Logs a message for when the cast fails due to lack of resources.
	LogCostFailure(*Simulation, *Spell)

	// Subtracts the resources used from a cast from the Unit.
	SpendCost(*Simulation, *Spell)

	// Space for handling refund mechanics. Not all spells provide refunds.
	IssueRefund(*Simulation, *Spell)
}

Handles computing the cost of spells and checking whether the Unit meets them.

type SpellFlag

type SpellFlag uint32

Other flags

const (
	SpellFlagNone                     SpellFlag = 0
	SpellFlagIgnoreResists            SpellFlag = 1 << iota // skip spell resist/armor
	SpellFlagIgnoreTargetModifiers                          // skip target damage modifiers
	SpellFlagIgnoreAttackerModifiers                        // skip attacker damage modifiers
	SpellFlagApplyArmorReduction                            // Forces damage reduction from armor to apply, even if it otherwise wouldn't.
	SpellFlagCannotBeDodged                                 // Ignores dodge in physical hit rolls
	SpellFlagIncludeTargetBonusDamage                       // Spell benefits from Gift of Arthas and Hemorrhage.
	SpellFlagBinary                                         // Does not do partial resists and could need a different hit roll.
	SpellFlagChanneled                                      // Spell is channeled
	SpellFlagDisease                                        // Spell is categorized as disease
	SpellFlagHelpful                                        // For healing spells / buffs.
	SpellFlagMeleeMetrics                                   // Marks a spell as a melee ability for metrics.
	SpellFlagNoOnCastComplete                               // Disables the OnCastComplete callback.
	SpellFlagNoMetrics                                      // Disables metrics for a spell.
	SpellFlagNoLogs                                         // Disables logs for a spell.

	// Used to let agents categorize their spells.
	SpellFlagAgentReserved1
	SpellFlagAgentReserved2
	SpellFlagAgentReserved3
	SpellFlagAgentReserved4

	SpellFlagIgnoreModifiers = SpellFlagIgnoreAttackerModifiers | SpellFlagIgnoreTargetModifiers
)

func (SpellFlag) Matches

func (se SpellFlag) Matches(other SpellFlag) bool

Returns whether there is any overlap between the given masks.

type SpellMetrics

type SpellMetrics struct {
	Casts   int32
	Misses  int32
	Hits    int32
	Crits   int32
	Crushes int32
	Dodges  int32
	Glances int32
	Parries int32
	Blocks  int32

	TotalDamage    float64 // Damage done by all casts of this spell.
	TotalThreat    float64 // Threat generated by all casts of this spell.
	TotalHealing   float64 // Healing done by all casts of this spell.
	TotalShielding float64 // Shielding done by all casts of this spell.
	TotalCastTime  time.Duration
}

Metric totals for a spell against a specific target, for the current iteration.

type SpellRegisteredHandler

type SpellRegisteredHandler func(spell *Spell)

type SpellResult added in v0.1.1

type SpellResult struct {
	// Target of the spell.
	Target *Unit

	// Results
	Outcome HitOutcome
	Damage  float64 // Damage done by this cast.
	Threat  float64 // The amount of threat generated by this cast.

	ResistanceMultiplier float64 // Partial Resists / Armor multiplier
	PreOutcomeDamage     float64 // Damage done by this cast before Outcome is applied
	// contains filtered or unexported fields
}

func (*SpellResult) DamageString added in v0.1.1

func (result *SpellResult) DamageString() string

func (*SpellResult) DidCrit added in v0.1.1

func (result *SpellResult) DidCrit() bool

func (*SpellResult) HealingString added in v0.1.1

func (result *SpellResult) HealingString() string

func (*SpellResult) Landed added in v0.1.1

func (result *SpellResult) Landed() bool

type SpellSchool

type SpellSchool byte
const (
	SpellSchoolNone     SpellSchool = 0
	SpellSchoolPhysical SpellSchool = 1 << iota
	SpellSchoolArcane
	SpellSchoolFire
	SpellSchoolFrost
	SpellSchoolHoly
	SpellSchoolNature
	SpellSchoolShadow

	SpellSchoolMagic = SpellSchoolArcane | SpellSchoolFire | SpellSchoolFrost | SpellSchoolHoly | SpellSchoolNature | SpellSchoolShadow
)

func SpellSchoolFromProto

func SpellSchoolFromProto(p proto.SpellSchool) SpellSchool

func (SpellSchool) Matches

func (ss SpellSchool) Matches(other SpellSchool) bool

Returns whether there is any overlap between the given masks.

func (SpellSchool) ResistanceStat

func (ss SpellSchool) ResistanceStat() stats.Stat

type SplitMix64

type SplitMix64 struct {
	// contains filtered or unexported fields
}

adapted from https://prng.di.unimi.it/splitmix64.c

func NewSplitMix

func NewSplitMix(seed uint64) *SplitMix64

func (*SplitMix64) GetSeed

func (sm *SplitMix64) GetSeed() int64

func (*SplitMix64) Next

func (sm *SplitMix64) Next() uint64

func (*SplitMix64) NextFloat64

func (sm *SplitMix64) NextFloat64() float64

func (*SplitMix64) Seed

func (sm *SplitMix64) Seed(s int64)

type StackingStatAura added in v0.1.12

type StackingStatAura struct {
	Aura          Aura
	BonusPerStack stats.Stats
}

type StatWeightValues

type StatWeightValues struct {
	Weights       UnitStats
	WeightsStdev  UnitStats
	EpValues      UnitStats
	EpValuesStdev UnitStats
}

func NewStatWeightValues added in v0.1.8

func NewStatWeightValues() StatWeightValues

func (StatWeightValues) ToProto

func (swv StatWeightValues) ToProto() *proto.StatWeightValues

type StatWeightsResult

type StatWeightsResult struct {
	Dps  StatWeightValues
	Hps  StatWeightValues
	Tps  StatWeightValues
	Dtps StatWeightValues
}

func CalcStatWeight

func CalcStatWeight(swr *proto.StatWeightsRequest, referenceStat stats.Stat, progress chan *proto.ProgressMetrics) StatWeightsResult

func NewStatWeightsResult added in v0.1.8

func NewStatWeightsResult() StatWeightsResult

func (StatWeightsResult) ToProto

func (swr StatWeightsResult) ToProto() *proto.StatWeightsResult

type SubGenerator

type SubGenerator struct {
	// contains filtered or unexported fields
}

type TalentsCombo added in v0.1.10

type TalentsCombo struct {
	Label   string
	Talents string
	Glyphs  *proto.Glyphs
}

type Target

type Target struct {
	Unit

	AI TargetAI
}

Target is an enemy/boss that can be the target of player attacks/spells.

func NewTarget

func NewTarget(options *proto.Target, targetIndex int32) *Target

func (*Target) AddComboPoints

func (eb *Target) AddComboPoints(sim *Simulation, pointsToAdd int32, metrics *ResourceMetrics)

func (*Target) AddEnergy

func (eb *Target) AddEnergy(sim *Simulation, amount float64, metrics *ResourceMetrics)

func (*Target) AddPartyBuffs

func (target *Target) AddPartyBuffs(partyBuffs *proto.PartyBuffs)

func (*Target) AddRage

func (rb *Target) AddRage(sim *Simulation, amount float64, metrics *ResourceMetrics)

func (*Target) AddRaidBuffs

func (target *Target) AddRaidBuffs(raidBuffs *proto.RaidBuffs)

Empty Agent interface functions.

func (*Target) Advance

func (target *Target) Advance(sim *Simulation, elapsedTime time.Duration)

func (*Target) ApplyTalents

func (target *Target) ApplyTalents()

func (*Target) ComboPoints

func (eb *Target) ComboPoints() int32

func (*Target) CurrentEnergy

func (eb *Target) CurrentEnergy() float64

func (*Target) CurrentHealth

func (hb *Target) CurrentHealth() float64

func (*Target) CurrentHealthPercent

func (hb *Target) CurrentHealthPercent() float64

func (*Target) CurrentRage

func (rb *Target) CurrentRage() float64

func (*Target) DoNothing

func (target *Target) DoNothing()

func (*Target) GainHealth

func (hb *Target) GainHealth(sim *Simulation, amount float64, metrics *ResourceMetrics)

func (*Target) GetActiveAuraWithTag

func (at *Target) GetActiveAuraWithTag(tag string) *Aura

func (*Target) GetAura

func (at *Target) GetAura(label string) *Aura

func (*Target) GetAurasWithTag

func (at *Target) GetAurasWithTag(tag string) []*Aura

func (*Target) GetCharacter

func (target *Target) GetCharacter() *Character

func (*Target) GetMetricsProto

func (target *Target) GetMetricsProto() *proto.UnitMetrics

func (*Target) HasActiveAura

func (at *Target) HasActiveAura(label string) bool

func (*Target) HasActiveAuraWithTag

func (at *Target) HasActiveAuraWithTag(tag string) bool

func (*Target) HasActiveAuraWithTagExcludingAura

func (at *Target) HasActiveAuraWithTagExcludingAura(tag string, excludeAura *Aura) bool

func (*Target) HasAura

func (at *Target) HasAura(label string) bool

func (*Target) HasAuraWithTag

func (at *Target) HasAuraWithTag(tag string) bool

func (*Target) Initialize

func (target *Target) Initialize()

func (*Target) MaxHealth

func (hb *Target) MaxHealth() float64

func (*Target) NextEnergyTickAt

func (eb *Target) NextEnergyTickAt() time.Duration

func (*Target) NextTarget

func (target *Target) NextTarget() *Target

func (*Target) NumActiveAurasWithTag

func (at *Target) NumActiveAurasWithTag(tag string) int32

func (*Target) OnAutoAttack

func (target *Target) OnAutoAttack(sim *Simulation, spell *Spell)

func (*Target) OnCastComplete

func (at *Target) OnCastComplete(sim *Simulation, spell *Spell)

Invokes the OnCastComplete event for all tracked Auras.

func (*Target) OnGCDReady

func (target *Target) OnGCDReady(sim *Simulation)

func (*Target) OnHealDealt

func (at *Target) OnHealDealt(sim *Simulation, spell *Spell, result *SpellResult)

Invokes the OnHeal event for all tracked Auras.

func (*Target) OnHealTaken

func (at *Target) OnHealTaken(sim *Simulation, spell *Spell, result *SpellResult)

func (*Target) OnPeriodicDamageDealt

func (at *Target) OnPeriodicDamageDealt(sim *Simulation, spell *Spell, result *SpellResult)

Invokes the OnPeriodicDamage

As a debuff when target is being hit by dot.
As a buff when caster's dots are ticking.

func (*Target) OnPeriodicDamageTaken

func (at *Target) OnPeriodicDamageTaken(sim *Simulation, spell *Spell, result *SpellResult)

func (*Target) OnPeriodicHealDealt

func (at *Target) OnPeriodicHealDealt(sim *Simulation, spell *Spell, result *SpellResult)

Invokes the OnPeriodicHeal

As a debuff when target is being hit by dot.
As a buff when caster's dots are ticking.

func (*Target) OnPeriodicHealTaken

func (at *Target) OnPeriodicHealTaken(sim *Simulation, spell *Spell, result *SpellResult)

func (*Target) OnSpellHitDealt

func (at *Target) OnSpellHitDealt(sim *Simulation, spell *Spell, result *SpellResult)

Invokes the OnSpellHit event for all tracked Auras.

func (*Target) OnSpellHitTaken

func (at *Target) OnSpellHitTaken(sim *Simulation, spell *Spell, result *SpellResult)

func (*Target) RegisterResetEffect

func (at *Target) RegisterResetEffect(resetEffect ResetEffect)

Registers a callback to this Character which will be invoked on every Sim reset.

func (*Target) RemoveHealth

func (hb *Target) RemoveHealth(sim *Simulation, amount float64)

func (*Target) Reset

func (target *Target) Reset(sim *Simulation)

func (*Target) ResetEnergyTick

func (eb *Target) ResetEnergyTick(sim *Simulation)

Gives an immediate partial energy tick and restarts the tick timer.

func (*Target) SpendComboPoints

func (eb *Target) SpendComboPoints(sim *Simulation, metrics *ResourceMetrics)

func (*Target) SpendEnergy

func (eb *Target) SpendEnergy(sim *Simulation, amount float64, metrics *ResourceMetrics)

func (*Target) SpendRage

func (rb *Target) SpendRage(sim *Simulation, amount float64, metrics *ResourceMetrics)

type TargetAI

type TargetAI interface {
	Initialize(*Target)

	DoAction(*Simulation)
}

type TargetDummy

type TargetDummy struct {
	Character
}

func NewTargetDummy

func NewTargetDummy(dummyIndex int, party *Party, partyIndex int) *TargetDummy

func (*TargetDummy) AddComboPoints

func (eb *TargetDummy) AddComboPoints(sim *Simulation, pointsToAdd int32, metrics *ResourceMetrics)

func (*TargetDummy) AddEnergy

func (eb *TargetDummy) AddEnergy(sim *Simulation, amount float64, metrics *ResourceMetrics)

func (*TargetDummy) AddMajorCooldown

func (mcdm *TargetDummy) AddMajorCooldown(mcd MajorCooldown)

Registers a major cooldown to the Character, which will be automatically used when available.

func (*TargetDummy) AddPartyBuffs

func (td *TargetDummy) AddPartyBuffs(partyBuffs *proto.PartyBuffs)

func (*TargetDummy) AddRage

func (rb *TargetDummy) AddRage(sim *Simulation, amount float64, metrics *ResourceMetrics)

func (*TargetDummy) AddRaidBuffs

func (td *TargetDummy) AddRaidBuffs(raidBuffs *proto.RaidBuffs)

func (*TargetDummy) ApplyTalents

func (td *TargetDummy) ApplyTalents()

func (*TargetDummy) ComboPoints

func (eb *TargetDummy) ComboPoints() int32

func (*TargetDummy) CurrentEnergy

func (eb *TargetDummy) CurrentEnergy() float64

func (*TargetDummy) CurrentHealth

func (hb *TargetDummy) CurrentHealth() float64

func (*TargetDummy) CurrentHealthPercent

func (hb *TargetDummy) CurrentHealthPercent() float64

func (*TargetDummy) CurrentRage

func (rb *TargetDummy) CurrentRage() float64

func (*TargetDummy) DelayDPSCooldowns added in v0.1.5

func (mcdm *TargetDummy) DelayDPSCooldowns(delay time.Duration)

Adds a delay to the first usage of all CDs overriding shouldActivate for cooldownTypeDPS, MCDs that have a user-specified timing are not delayed. This function should be called from Agent.Init().

func (*TargetDummy) DelayDPSCooldownsForArmorDebuffs

func (mcdm *TargetDummy) DelayDPSCooldownsForArmorDebuffs(delay time.Duration)

Adds a delay to the first usage of all CDs so that debuffs have time to be applied. MCDs that have a user-specified timing are not delayed.

This function should be called from Agent.Init().

func (*TargetDummy) GainHealth

func (hb *TargetDummy) GainHealth(sim *Simulation, amount float64, metrics *ResourceMetrics)

func (*TargetDummy) GetActiveAuraWithTag

func (at *TargetDummy) GetActiveAuraWithTag(tag string) *Aura

func (*TargetDummy) GetAura

func (at *TargetDummy) GetAura(label string) *Aura

func (*TargetDummy) GetAurasWithTag

func (at *TargetDummy) GetAurasWithTag(tag string) []*Aura

func (*TargetDummy) GetCharacter

func (td *TargetDummy) GetCharacter() *Character

func (*TargetDummy) GetInitialMajorCooldown

func (mcdm *TargetDummy) GetInitialMajorCooldown(actionID ActionID) MajorCooldown

func (*TargetDummy) GetMajorCooldown

func (mcdm *TargetDummy) GetMajorCooldown(actionID ActionID) *MajorCooldown

func (*TargetDummy) GetMajorCooldownIDs

func (mcdm *TargetDummy) GetMajorCooldownIDs() []*proto.ActionID

func (*TargetDummy) GetMajorCooldownIgnoreTag added in v0.1.10

func (mcdm *TargetDummy) GetMajorCooldownIgnoreTag(actionID ActionID) *MajorCooldown

func (*TargetDummy) GetMajorCooldowns

func (mcdm *TargetDummy) GetMajorCooldowns() []*MajorCooldown

Returns all MCDs.

func (*TargetDummy) HasActiveAura

func (at *TargetDummy) HasActiveAura(label string) bool

func (*TargetDummy) HasActiveAuraWithTag

func (at *TargetDummy) HasActiveAuraWithTag(tag string) bool

func (*TargetDummy) HasActiveAuraWithTagExcludingAura

func (at *TargetDummy) HasActiveAuraWithTagExcludingAura(tag string, excludeAura *Aura) bool

func (*TargetDummy) HasAura

func (at *TargetDummy) HasAura(label string) bool

func (*TargetDummy) HasAuraWithTag

func (at *TargetDummy) HasAuraWithTag(tag string) bool

func (*TargetDummy) Initialize

func (td *TargetDummy) Initialize()

func (*TargetDummy) MaxHealth

func (hb *TargetDummy) MaxHealth() float64

func (*TargetDummy) NextEnergyTickAt

func (eb *TargetDummy) NextEnergyTickAt() time.Duration

func (*TargetDummy) NumActiveAurasWithTag

func (at *TargetDummy) NumActiveAurasWithTag(tag string) int32

func (*TargetDummy) OnAutoAttack

func (td *TargetDummy) OnAutoAttack(sim *Simulation, spell *Spell)

func (*TargetDummy) OnCastComplete

func (at *TargetDummy) OnCastComplete(sim *Simulation, spell *Spell)

Invokes the OnCastComplete event for all tracked Auras.

func (*TargetDummy) OnGCDReady

func (td *TargetDummy) OnGCDReady(sim *Simulation)

func (*TargetDummy) OnHealDealt

func (at *TargetDummy) OnHealDealt(sim *Simulation, spell *Spell, result *SpellResult)

Invokes the OnHeal event for all tracked Auras.

func (*TargetDummy) OnHealTaken

func (at *TargetDummy) OnHealTaken(sim *Simulation, spell *Spell, result *SpellResult)

func (*TargetDummy) OnPeriodicDamageDealt

func (at *TargetDummy) OnPeriodicDamageDealt(sim *Simulation, spell *Spell, result *SpellResult)

Invokes the OnPeriodicDamage

As a debuff when target is being hit by dot.
As a buff when caster's dots are ticking.

func (*TargetDummy) OnPeriodicDamageTaken

func (at *TargetDummy) OnPeriodicDamageTaken(sim *Simulation, spell *Spell, result *SpellResult)

func (*TargetDummy) OnPeriodicHealDealt

func (at *TargetDummy) OnPeriodicHealDealt(sim *Simulation, spell *Spell, result *SpellResult)

Invokes the OnPeriodicHeal

As a debuff when target is being hit by dot.
As a buff when caster's dots are ticking.

func (*TargetDummy) OnPeriodicHealTaken

func (at *TargetDummy) OnPeriodicHealTaken(sim *Simulation, spell *Spell, result *SpellResult)

func (*TargetDummy) OnSpellHitDealt

func (at *TargetDummy) OnSpellHitDealt(sim *Simulation, spell *Spell, result *SpellResult)

Invokes the OnSpellHit event for all tracked Auras.

func (*TargetDummy) OnSpellHitTaken

func (at *TargetDummy) OnSpellHitTaken(sim *Simulation, spell *Spell, result *SpellResult)

func (*TargetDummy) RegisterResetEffect

func (at *TargetDummy) RegisterResetEffect(resetEffect ResetEffect)

Registers a callback to this Character which will be invoked on every Sim reset.

func (*TargetDummy) RemoveHealth

func (hb *TargetDummy) RemoveHealth(sim *Simulation, amount float64)

func (*TargetDummy) Reset

func (td *TargetDummy) Reset(sim *Simulation)

func (*TargetDummy) ResetEnergyTick

func (eb *TargetDummy) ResetEnergyTick(sim *Simulation)

Gives an immediate partial energy tick and restarts the tick timer.

func (*TargetDummy) SpendComboPoints

func (eb *TargetDummy) SpendComboPoints(sim *Simulation, metrics *ResourceMetrics)

func (*TargetDummy) SpendEnergy

func (eb *TargetDummy) SpendEnergy(sim *Simulation, amount float64, metrics *ResourceMetrics)

func (*TargetDummy) SpendRage

func (rb *TargetDummy) SpendRage(sim *Simulation, amount float64, metrics *ResourceMetrics)

func (*TargetDummy) TryUseCooldowns

func (mcdm *TargetDummy) TryUseCooldowns(sim *Simulation)

func (*TargetDummy) UpdateMajorCooldowns

func (mcdm *TargetDummy) UpdateMajorCooldowns()

This function should be called if the CD for a major cooldown changes outside of the TryActivate() call.

type TargetedActionMetrics

type TargetedActionMetrics struct {
	UnitIndex int32

	Casts   int32
	Hits    int32
	Crits   int32
	Misses  int32
	Dodges  int32
	Parries int32
	Blocks  int32
	Glances int32

	Damage    float64
	Threat    float64
	Healing   float64
	Shielding float64
	CastTime  time.Duration
}

func (*TargetedActionMetrics) ToProto

type TestGenerator

type TestGenerator interface {
	// The total number of tests that this generator can generate.
	NumTests() int

	// The name and API request for the test with the given index.
	GetTest(testIdx int) (string, *proto.ComputeStatsRequest, *proto.StatWeightsRequest, *proto.RaidSimRequest)
}

func FullCharacterTestSuiteGenerator

func FullCharacterTestSuiteGenerator(config CharacterSuiteConfig) TestGenerator

func RotationTestSuiteGenerator

func RotationTestSuiteGenerator(config CharacterSuiteConfig) TestGenerator

type Threshold

type Threshold struct {
	// contains filtered or unexported fields
}

type Thresholds

type Thresholds [4]Threshold

func (Thresholds) String

func (x Thresholds) String() string

type Timer

type Timer time.Duration

Stored value is the time at which the cooldown will be available again.

func (*Timer) IsReady

func (timer *Timer) IsReady(sim *Simulation) bool

func (*Timer) ReadyAt

func (timer *Timer) ReadyAt() time.Duration

func (*Timer) Reset

func (timer *Timer) Reset()

func (*Timer) Set

func (timer *Timer) Set(t time.Duration)

func (*Timer) TimeToReady

func (timer *Timer) TimeToReady(sim *Simulation) time.Duration

type Unit

type Unit struct {
	Type UnitType

	// Index of this unit with its group.
	//  For Players, this is the 0-indexed raid index (0-24).
	//  For Enemies, this is its enemy index.
	//  For Pets, this is the same as the owner's index.
	Index int32

	// Unique index of this unit among all units in the environment.
	// This is used as the index for attack tables.
	UnitIndex int32

	// Unique label for logging.
	Label string

	Level int32 // Level of Unit, e.g. Bosses are 83.

	MobType proto.MobType

	// How far this unit is from its target(s). Measured in yards, this is used
	// for calculating spell travel time for certain spells.
	DistanceFromTarget float64

	// Environment in which this Unit exists. This will be nil until after the
	// construction phase.
	Env *Environment

	// Provides stat dependency management behavior.
	stats.StatDependencyManager

	PseudoStats stats.PseudoStats

	RunicPowerBar

	// All spells that can be cast by this unit.
	Spellbook []*Spell

	// Pets owned by this Unit.
	Pets []PetAgent

	// AutoAttacks is the manager for auto attack swings.
	// Must be enabled to use, with "EnableAutoAttacks()".
	AutoAttacks AutoAttacks

	// Statistics describing the results of the sim.
	Metrics UnitMetrics

	AttackTables                []*AttackTable
	DynamicDamageTakenModifiers []DynamicDamageTakenModifier

	GCD *Timer

	// Used for applying the effect of a hardcast spell when casting finishes.
	//  For channeled spells, only Expires is set.
	// No more than one cast may be active at any given time.
	Hardcast Hardcast

	CastSpeed float64

	CurrentTarget *Unit
	// contains filtered or unexported fields
}

Unit is an abstraction of a Character/Boss/Pet/etc, containing functionality shared by all of them.

func (*Unit) AddBonusRangedCritRating

func (unit *Unit) AddBonusRangedCritRating(amount float64)

func (*Unit) AddBonusRangedHitRating

func (unit *Unit) AddBonusRangedHitRating(amount float64)

func (*Unit) AddComboPoints

func (eb *Unit) AddComboPoints(sim *Simulation, pointsToAdd int32, metrics *ResourceMetrics)

func (*Unit) AddDynamicDamageTakenModifier

func (unit *Unit) AddDynamicDamageTakenModifier(ddtm DynamicDamageTakenModifier)

func (*Unit) AddEnergy

func (eb *Unit) AddEnergy(sim *Simulation, amount float64, metrics *ResourceMetrics)

func (*Unit) AddMana

func (unit *Unit) AddMana(sim *Simulation, amount float64, metrics *ResourceMetrics, isBonusMana bool)

func (*Unit) AddRage

func (rb *Unit) AddRage(sim *Simulation, amount float64, metrics *ResourceMetrics)

func (*Unit) AddStat

func (unit *Unit) AddStat(stat stats.Stat, amount float64)

func (*Unit) AddStatDynamic

func (unit *Unit) AddStatDynamic(sim *Simulation, stat stats.Stat, amount float64)

func (*Unit) AddStats

func (unit *Unit) AddStats(stat stats.Stats)

func (*Unit) AddStatsDynamic

func (unit *Unit) AddStatsDynamic(sim *Simulation, bonus stats.Stats)

func (*Unit) ApplyCastSpeed

func (unit *Unit) ApplyCastSpeed(dur time.Duration) time.Duration

func (*Unit) ApplyCastSpeedForSpell

func (unit *Unit) ApplyCastSpeedForSpell(dur time.Duration, spell *Spell) time.Duration

func (*Unit) Armor

func (unit *Unit) Armor() float64

func (*Unit) ArmorPenetrationPercentage

func (unit *Unit) ArmorPenetrationPercentage(armorPenRating float64) float64

func (*Unit) BlockValue added in v0.1.3

func (unit *Unit) BlockValue() float64

func (*Unit) CancelGCDTimer

func (unit *Unit) CancelGCDTimer(sim *Simulation)

Call this to stop the GCD loop for a unit. This is mostly used for pets that get summoned / expire.

func (*Unit) ComboPoints

func (eb *Unit) ComboPoints() int32

func (*Unit) CurrentEnergy

func (eb *Unit) CurrentEnergy() float64

func (*Unit) CurrentHealth

func (hb *Unit) CurrentHealth() float64

func (*Unit) CurrentHealthPercent

func (hb *Unit) CurrentHealthPercent() float64

func (*Unit) CurrentMana

func (unit *Unit) CurrentMana() float64

func (*Unit) CurrentManaPercent

func (unit *Unit) CurrentManaPercent() float64

func (*Unit) CurrentRage

func (rb *Unit) CurrentRage() float64

func (*Unit) DisableDynamicStatDep

func (unit *Unit) DisableDynamicStatDep(sim *Simulation, dep *stats.StatDependency)

func (*Unit) DoneWaitingForEnergy

func (unit *Unit) DoneWaitingForEnergy(sim *Simulation) bool

func (*Unit) DoneWaitingForMana

func (unit *Unit) DoneWaitingForMana(sim *Simulation) bool

Assumes that IsWaitingForMana() == true

func (*Unit) EnableAutoAttacks

func (unit *Unit) EnableAutoAttacks(agent Agent, options AutoAttackOptions)

func (*Unit) EnableDynamicStatDep

func (unit *Unit) EnableDynamicStatDep(sim *Simulation, dep *stats.StatDependency)

func (*Unit) EnableEnergyBar

func (unit *Unit) EnableEnergyBar(maxEnergy float64, onEnergyGain OnEnergyGain)

func (*Unit) EnableHealthBar

func (unit *Unit) EnableHealthBar()

func (*Unit) EnableRageBar

func (unit *Unit) EnableRageBar(options RageBarOptions, onRageGain OnRageGain)

func (*Unit) EnableRunicPowerBar

func (unit *Unit) EnableRunicPowerBar(currentRunicPower float64, maxRunicPower float64, runeCD time.Duration,
	onRuneSpend OnRune,
	onBloodRuneGain OnRune,
	onFrostRuneGain OnRune,
	onUnholyRuneGain OnRune,
	onDeathRuneGain OnRune,
	onRunicPowerGain OnRunicPowerGain)

func (*Unit) FinishedWaitingForManaAndGCDReady

func (unit *Unit) FinishedWaitingForManaAndGCDReady(sim *Simulation) bool

Returns true if the unit was waiting for mana but is now finished AND the GCD is also ready.

func (*Unit) GainHealth

func (hb *Unit) GainHealth(sim *Simulation, amount float64, metrics *ResourceMetrics)

func (*Unit) GetActiveAuraWithTag

func (at *Unit) GetActiveAuraWithTag(tag string) *Aura

func (*Unit) GetAura

func (at *Unit) GetAura(label string) *Aura

func (*Unit) GetAurasWithTag

func (at *Unit) GetAurasWithTag(tag string) []*Aura

func (*Unit) GetCurrentPowerBar

func (unit *Unit) GetCurrentPowerBar() PowerBarType

func (*Unit) GetDiminishedDodgeChance

func (unit *Unit) GetDiminishedDodgeChance() float64

func (*Unit) GetDiminishedMissChance

func (unit *Unit) GetDiminishedMissChance() float64

func (*Unit) GetDiminishedParryChance

func (unit *Unit) GetDiminishedParryChance() float64

func (*Unit) GetInitialStat

func (unit *Unit) GetInitialStat(stat stats.Stat) float64

func (*Unit) GetMetricsProto

func (at *Unit) GetMetricsProto() []*proto.AuraMetrics

func (*Unit) GetOpponents

func (unit *Unit) GetOpponents() []*Unit

func (*Unit) GetOrInitTimer

func (unit *Unit) GetOrInitTimer(timer **Timer) *Timer

Helper for shared timers that are not always needed, so it is only allocated if necessary.

func (*Unit) GetOrRegisterAura

func (unit *Unit) GetOrRegisterAura(aura Aura) *Aura

func (*Unit) GetOrRegisterSpell

func (unit *Unit) GetOrRegisterSpell(config SpellConfig) *Spell

Retrieves an existing spell with the same ID as the config uses, or registers it if there is none.

func (*Unit) GetSpell

func (unit *Unit) GetSpell(actionID ActionID) *Spell

Returns the first registered spell with the given ID, or nil if there are none.

func (*Unit) GetSpellsMatchingSchool

func (unit *Unit) GetSpellsMatchingSchool(school SpellSchool) []*Spell

func (*Unit) GetStat

func (unit *Unit) GetStat(stat stats.Stat) float64

func (*Unit) GetStats

func (unit *Unit) GetStats() stats.Stats

func (*Unit) HardcastWaitUntil

func (unit *Unit) HardcastWaitUntil(sim *Simulation, readyTime time.Duration, onComplete CastFunc)

func (*Unit) HasActiveAura

func (at *Unit) HasActiveAura(label string) bool

func (*Unit) HasActiveAuraWithTag

func (at *Unit) HasActiveAuraWithTag(tag string) bool

func (*Unit) HasActiveAuraWithTagExcludingAura

func (at *Unit) HasActiveAuraWithTagExcludingAura(tag string, excludeAura *Aura) bool

func (*Unit) HasAura

func (at *Unit) HasAura(label string) bool

func (*Unit) HasAuraWithTag

func (at *Unit) HasAuraWithTag(tag string) bool

func (*Unit) HasEnergyBar

func (unit *Unit) HasEnergyBar() bool

func (*Unit) HasHealthBar

func (unit *Unit) HasHealthBar() bool

func (*Unit) HasManaBar

func (unit *Unit) HasManaBar() bool

func (*Unit) HasRageBar

func (unit *Unit) HasRageBar() bool

func (*Unit) HasRunicPowerBar

func (unit *Unit) HasRunicPowerBar() bool

func (*Unit) HasTemporaryBonusForStat

func (unit *Unit) HasTemporaryBonusForStat(stat stats.Stat) bool

Returns whether the indicates stat is currently modified by a temporary bonus.

func (*Unit) HasTemporaryMeleeSwingSpeedIncrease

func (unit *Unit) HasTemporaryMeleeSwingSpeedIncrease() bool

Returns if melee swings have any temporary increases active.

func (*Unit) HasTemporaryRangedSwingSpeedIncrease

func (unit *Unit) HasTemporaryRangedSwingSpeedIncrease() bool

Returns if ranged swings have any temporary increases active.

func (*Unit) HasTemporarySpellCastSpeedIncrease

func (unit *Unit) HasTemporarySpellCastSpeedIncrease() bool

Returns if spell casting has any temporary increases active.

func (*Unit) InitialCastSpeed

func (unit *Unit) InitialCastSpeed() float64

func (*Unit) IsEnabled added in v0.1.14

func (unit *Unit) IsEnabled() bool

Units can be disabled for several reasons:

  1. Downtime for temporary pets (e.g. Water Elemental)
  2. Enemy units in various phases (not yet implemented)
  3. Dead units (not yet implemented)

func (*Unit) IsOpponent

func (unit *Unit) IsOpponent(other *Unit) bool

func (*Unit) IsWaiting

func (unit *Unit) IsWaiting() bool

func (*Unit) IsWaitingForEnergy

func (unit *Unit) IsWaitingForEnergy() bool

func (*Unit) IsWaitingForMana

func (unit *Unit) IsWaitingForMana() bool

func (*Unit) Log

func (unit *Unit) Log(sim *Simulation, message string, vals ...interface{})

func (*Unit) LogLabel

func (unit *Unit) LogLabel() string

func (*Unit) MHNormalizedWeaponDamage added in v0.1.1

func (unit *Unit) MHNormalizedWeaponDamage(sim *Simulation, attackPower float64) float64

func (*Unit) MHWeaponDamage

func (unit *Unit) MHWeaponDamage(sim *Simulation, attackPower float64) float64

func (*Unit) MP5ManaRegenPerSecond

func (unit *Unit) MP5ManaRegenPerSecond() float64

Returns the rate of mana regen per second from mp5.

func (*Unit) ManaRegenPerSecondWhileCasting

func (unit *Unit) ManaRegenPerSecondWhileCasting() float64

Returns the rate of mana regen per second, assuming this unit is considered to be casting.

func (*Unit) ManaRegenPerSecondWhileNotCasting

func (unit *Unit) ManaRegenPerSecondWhileNotCasting() float64

Returns the rate of mana regen per second, assuming this unit is considered to be not casting.

func (*Unit) ManaTick

func (unit *Unit) ManaTick(sim *Simulation)

Applies 1 'tick' of mana regen, which worth 2s of regeneration based on mp5/int/spirit/etc.

func (*Unit) MaxHealth

func (hb *Unit) MaxHealth() float64

func (*Unit) MaxMana

func (unit *Unit) MaxMana() float64

Gets the Maxiumum mana including bonus and temporary affects that would increase your mana pool.

func (*Unit) MultiplyAttackSpeed

func (unit *Unit) MultiplyAttackSpeed(sim *Simulation, amount float64)

Helper for when both MultiplyMeleeSpeed and MultiplyRangedSpeed are needed.

func (*Unit) MultiplyCastSpeed

func (unit *Unit) MultiplyCastSpeed(amount float64)

func (*Unit) MultiplyMeleeSpeed

func (unit *Unit) MultiplyMeleeSpeed(sim *Simulation, amount float64)

MultiplyMeleeSpeed will alter the attack speed multiplier and change swing speed of all autoattack swings in progress.

func (*Unit) MultiplyRangedSpeed

func (unit *Unit) MultiplyRangedSpeed(sim *Simulation, amount float64)

func (*Unit) NewBloodRuneMetrics

func (unit *Unit) NewBloodRuneMetrics(actionID ActionID) *ResourceMetrics

func (*Unit) NewComboPointMetrics

func (unit *Unit) NewComboPointMetrics(actionID ActionID) *ResourceMetrics

func (*Unit) NewDeathRuneMetrics

func (unit *Unit) NewDeathRuneMetrics(actionID ActionID) *ResourceMetrics

func (*Unit) NewEnergyMetrics

func (unit *Unit) NewEnergyMetrics(actionID ActionID) *ResourceMetrics

func (*Unit) NewFocusMetrics

func (unit *Unit) NewFocusMetrics(actionID ActionID) *ResourceMetrics

func (*Unit) NewFrostRuneMetrics

func (unit *Unit) NewFrostRuneMetrics(actionID ActionID) *ResourceMetrics

func (*Unit) NewHealthMetrics

func (unit *Unit) NewHealthMetrics(actionID ActionID) *ResourceMetrics

Convenience helpers for NewResourceMetrics.

func (*Unit) NewManaMetrics

func (unit *Unit) NewManaMetrics(actionID ActionID) *ResourceMetrics

func (*Unit) NewRageMetrics

func (unit *Unit) NewRageMetrics(actionID ActionID) *ResourceMetrics

func (*Unit) NewRunicPowerMetrics

func (unit *Unit) NewRunicPowerMetrics(actionID ActionID) *ResourceMetrics

func (*Unit) NewTimer

func (unit *Unit) NewTimer() *Timer

func (*Unit) NewUnholyRuneMetrics

func (unit *Unit) NewUnholyRuneMetrics(actionID ActionID) *ResourceMetrics

func (*Unit) NextEnergyTickAt

func (eb *Unit) NextEnergyTickAt() time.Duration

func (*Unit) NextGCDAt

func (unit *Unit) NextGCDAt() time.Duration

func (*Unit) NumActiveAurasWithTag

func (at *Unit) NumActiveAurasWithTag(tag string) int32

func (*Unit) OHNormalizedWeaponDamage added in v0.1.1

func (unit *Unit) OHNormalizedWeaponDamage(sim *Simulation, attackPower float64) float64

func (*Unit) OHWeaponDamage

func (unit *Unit) OHWeaponDamage(sim *Simulation, attackPower float64) float64

func (*Unit) OnAutoAttack

func (unit *Unit) OnAutoAttack(sim *Simulation, spell *Spell)

Empty handler so Agents don't have to provide one if they have no logic to add.

func (*Unit) OnCastComplete

func (at *Unit) OnCastComplete(sim *Simulation, spell *Spell)

Invokes the OnCastComplete event for all tracked Auras.

func (*Unit) OnHealDealt

func (at *Unit) OnHealDealt(sim *Simulation, spell *Spell, result *SpellResult)

Invokes the OnHeal event for all tracked Auras.

func (*Unit) OnHealTaken

func (at *Unit) OnHealTaken(sim *Simulation, spell *Spell, result *SpellResult)

func (*Unit) OnPeriodicDamageDealt

func (at *Unit) OnPeriodicDamageDealt(sim *Simulation, spell *Spell, result *SpellResult)

Invokes the OnPeriodicDamage

As a debuff when target is being hit by dot.
As a buff when caster's dots are ticking.

func (*Unit) OnPeriodicDamageTaken

func (at *Unit) OnPeriodicDamageTaken(sim *Simulation, spell *Spell, result *SpellResult)

func (*Unit) OnPeriodicHealDealt

func (at *Unit) OnPeriodicHealDealt(sim *Simulation, spell *Spell, result *SpellResult)

Invokes the OnPeriodicHeal

As a debuff when target is being hit by dot.
As a buff when caster's dots are ticking.

func (*Unit) OnPeriodicHealTaken

func (at *Unit) OnPeriodicHealTaken(sim *Simulation, spell *Spell, result *SpellResult)

func (*Unit) OnSpellHitDealt

func (at *Unit) OnSpellHitDealt(sim *Simulation, spell *Spell, result *SpellResult)

Invokes the OnSpellHit event for all tracked Auras.

func (*Unit) OnSpellHitTaken

func (at *Unit) OnSpellHitTaken(sim *Simulation, spell *Spell, result *SpellResult)

func (*Unit) OnSpellRegistered

func (unit *Unit) OnSpellRegistered(handler SpellRegisteredHandler)

func (*Unit) RangedSwingSpeed

func (unit *Unit) RangedSwingSpeed() float64

func (*Unit) RangedWeaponDamage

func (unit *Unit) RangedWeaponDamage(sim *Simulation, attackPower float64) float64

func (*Unit) RegisterAura

func (unit *Unit) RegisterAura(aura Aura) *Aura

func (*Unit) RegisterPrepullAction added in v0.1.14

func (unit *Unit) RegisterPrepullAction(doAt time.Duration, action func(*Simulation))

Registers a callback to this Unit which will be invoked on the prepull at the specified negative time.

func (*Unit) RegisterResetEffect

func (at *Unit) RegisterResetEffect(resetEffect ResetEffect)

Registers a callback to this Character which will be invoked on every Sim reset.

func (*Unit) RegisterSpell

func (unit *Unit) RegisterSpell(config SpellConfig) *Spell

Registers a new spell to the unit. Returns the newly created spell.

func (*Unit) RemoveHealth

func (hb *Unit) RemoveHealth(sim *Simulation, amount float64)

func (*Unit) ResetEnergyTick

func (eb *Unit) ResetEnergyTick(sim *Simulation)

Gives an immediate partial energy tick and restarts the tick timer.

func (*Unit) SetCurrentPowerBar

func (unit *Unit) SetCurrentPowerBar(bar PowerBarType)

func (*Unit) SetGCDTimer

func (unit *Unit) SetGCDTimer(sim *Simulation, gcdReadyAt time.Duration)

func (*Unit) SpellGCD

func (unit *Unit) SpellGCD() time.Duration

func (*Unit) SpendComboPoints

func (eb *Unit) SpendComboPoints(sim *Simulation, metrics *ResourceMetrics)

func (*Unit) SpendEnergy

func (eb *Unit) SpendEnergy(sim *Simulation, amount float64, metrics *ResourceMetrics)

func (*Unit) SpendMana

func (unit *Unit) SpendMana(sim *Simulation, amount float64, metrics *ResourceMetrics)

func (*Unit) SpendRage

func (rb *Unit) SpendRage(sim *Simulation, amount float64, metrics *ResourceMetrics)

func (*Unit) SpiritManaRegenPerSecond

func (unit *Unit) SpiritManaRegenPerSecond() float64

Returns the rate of mana regen per second from spirit.

func (*Unit) SwingSpeed

func (unit *Unit) SwingSpeed() float64

func (*Unit) TimeUntilManaRegen

func (unit *Unit) TimeUntilManaRegen(desiredMana float64) time.Duration

Returns the amount of time this Unit would need to wait in order to reach the desired amount of mana, via mana regen.

Assumes that desiredMana > currentMana. Calculation assumes the Unit will not take any actions during this period that would reset the 5-second rule.

func (*Unit) UpdateManaRegenRates

func (unit *Unit) UpdateManaRegenRates()

func (*Unit) WaitForEnergy

func (unit *Unit) WaitForEnergy(sim *Simulation, desiredEnergy float64)

func (*Unit) WaitForMana

func (unit *Unit) WaitForMana(sim *Simulation, desiredMana float64)

func (*Unit) WaitUntil

func (unit *Unit) WaitUntil(sim *Simulation, readyTime time.Duration)

type UnitMetrics

type UnitMetrics struct {
	CharacterIterationMetrics
	// contains filtered or unexported fields
}

func NewUnitMetrics

func NewUnitMetrics() UnitMetrics

func (*UnitMetrics) AddFinalPetMetrics

func (unitMetrics *UnitMetrics) AddFinalPetMetrics(petMetrics *UnitMetrics)

This should be called at the end of each iteration, to include metrics from Pets in those of their owner. Assumes that doneIteration() has already been called on the pet metrics.

func (*UnitMetrics) AddOOMTime

func (unitMetrics *UnitMetrics) AddOOMTime(sim *Simulation, dur time.Duration)

func (*UnitMetrics) MarkOOM

func (unitMetrics *UnitMetrics) MarkOOM(sim *Simulation)

func (*UnitMetrics) NewResourceMetrics

func (unitMetrics *UnitMetrics) NewResourceMetrics(actionID ActionID, resourceType proto.ResourceType) *ResourceMetrics

func (*UnitMetrics) ToProto

func (unitMetrics *UnitMetrics) ToProto() *proto.UnitMetrics

func (*UnitMetrics) UpdateDpasp added in v0.1.8

func (unitMetrics *UnitMetrics) UpdateDpasp(dpspSeconds float64)

type UnitStats added in v0.1.8

type UnitStats struct {
	Stats       stats.Stats
	PseudoStats []float64
}

func NewUnitStats added in v0.1.8

func NewUnitStats() UnitStats

func (*UnitStats) AddStat added in v0.1.8

func (s *UnitStats) AddStat(stat stats.UnitStat, value float64)

func (*UnitStats) Get added in v0.1.8

func (s *UnitStats) Get(stat stats.UnitStat) float64

func (UnitStats) ToProto added in v0.1.8

func (us UnitStats) ToProto() *proto.UnitStats

type UnitType

type UnitType int
const (
	PlayerUnit UnitType = iota
	EnemyUnit
	PetUnit
)

type Weapon

type Weapon struct {
	BaseDamageMin              float64
	BaseDamageMax              float64
	MeleeAttackRatingPerDamage float64
	SwingSpeed                 float64
	NormalizedSwingSpeed       float64
	SwingDuration              time.Duration // Duration between 2 swings.
	CritMultiplier             float64
	SpellSchool                SpellSchool
}

Represents a generic weapon. Pets / unarmed / various other cases dont use actual weapon items so this is an abstraction of a Weapon.

func (Weapon) AverageDamage

func (weapon Weapon) AverageDamage() float64

func (Weapon) BaseDamage

func (weapon Weapon) BaseDamage(sim *Simulation) float64

func (Weapon) CalculateAverageWeaponDamage

func (weapon Weapon) CalculateAverageWeaponDamage(attackPower float64) float64

func (Weapon) CalculateNormalizedWeaponDamage

func (weapon Weapon) CalculateNormalizedWeaponDamage(sim *Simulation, attackPower float64) float64

func (Weapon) CalculateWeaponDamage

func (weapon Weapon) CalculateWeaponDamage(sim *Simulation, attackPower float64) float64

func (Weapon) DPS added in v0.1.8

func (w Weapon) DPS() float64

func (Weapon) EnemyWeaponDamage

func (weapon Weapon) EnemyWeaponDamage(sim *Simulation, attackPower float64, tightenDamageRange bool) float64

func (Weapon) GetSpellSchool

func (weapon Weapon) GetSpellSchool() SpellSchool

func (Weapon) WithBonusDPS added in v0.1.8

func (w Weapon) WithBonusDPS(bonusDps float64) Weapon

Directories

Path Synopsis

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL