Power Bits

From OuroDev
Revision as of 10:02, 6 February 2020 by Chet (talk | contribs) (1 revision imported: Importing Portal Corps Wiki pages and history - Feb 6, 2020)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

This is just my notes on power defs. It won't include stuff for boosts right now. 

Power category.powerset.power_name
{
	Name                             "power_name"//must match the last part of the power's full name.
	DisplayName                      "Display Name"//Power name shown in UI. Can be pstring or a plain string. Mapserver will give BAD TRANSLATION errors if you use a plain string.
	DisplayShortHelp                 "ShortHelp"//Short and long help strings. If they aren't defined for the target, it'll use the regular ones.
	DisplayHelp                      "LongHelp"
	DisplayTargetHelp                "TargetHelp"
	DisplayTargetShortHelp           "TargetShortHelp"
	DisplayAttackerAttack            "AttackerAttack"//Message displayed as chat to attacker when the power is executed
	DisplayAttackerAttackFloater     "Floater"//Floating message when attack is executed
	DisplayAttackerHit               "AttackerHit"//Message in chat to attacker when attack hits
	DisplayVictimHit                 "VictimHit"//Message to victim in chat when hit
	DisplayConfirm                   "Confirm"//Message displayed to target to confirm power
	FloatRewarded                    "Rewarded"//Message floated on screen when this power is granted as reward.
	DisplayPowerDefenseFloat         "whiff"//Message to float when this power is the defensive cause of a missed attack if attribmod doesn't specify its own float.
	IconName                         "power_icon.tga"//name of this power's icon
	Type                             kType//Power type: kAuto, kToggle or kClick
	NumAllowed                       0//Max number of copies of this power. Only used for Temp powers.
	AttackTypes                      kAttack_Type1, kAttack_Type2//Attack types of the power. Each one has a separate Defense value for hit rolls, though Toxic has no defense, and can only be resisted or not hit due to defense against another type the power has.
	BuyRequires                      Inherent.Inherent.Brawl $archetype @Class_Mastermind == ||//Requirements for power eligibility. If empty, only level is required. Else, it's a postfix expressions: arguments, then operator. This line is equivalent to ($archetype is @Class_Mastermind) or (has) Inherent.Inherent.Brawl.
	ActivateRequires                 filler.powerset.power//As above, but for activating rather than choosing or auto-issuing.
	TargetRequires                   $archetype @Class_Blaster !=//Requirements for target to be valid. If empty, there are no requirements.
	RewardRequires                   category.set.power//Requirement to be awarded the power through the reward system. If blank, there are no requirements.
	AuctionRequires                  category.set.power//As above, but for auctioning.
	RewardFallback                   //the power that will be awarded if this power's requirements aren't met. If blank, none will be awarded.
	Accuracy                         0.1//Chance to hit.
	NearGround                       kFalse//True or false: Does this power require you to be near the ground?
	TargetNearGround                 kTrue//As above, but for the target instead of caster. Assume false when missing
	CastableAfterDeath               kTrue//Boolean. Can this be cast when the caster has no HP? Assume false when missing
	CastThroughHold                  kFalse//These lines determine if the power can be used held, slept, stunned or terrorized. Assume false if missing.
	CastThroughSleep                 kFalse
	CastThroughStun                  kFalse
	CastThroughTerrorize             kFalse
	ToggleIgnoreHold                 kFalse//These lines determine if the power is detoggled when held, slept or stunned. Assume false if missing. Toggles only.
	ToggleIgnoreSleep                kFalse
	ToggleIgnoreStun                 kFalse
	ShootThroughUntouchable          kTrue//Can this power ignore untouchability?
	InterruptLikeSleep               kFalse//If true, this power is only interrupted by things that interrupt sleep: Damage, Healing, KB/KD/KU, Repel
	AIReport                         kNever//When to report a hit to AI: kNever, kAlways, kHitOnly,kMissOnly
	EffectArea                       kCharacter//Effect area type. See section "Effect Areas"
	MaxTargetsHit                    5//Maximum number of targets for a cone or sphere. If available targets exceed possible targets, then the most distant one fromthe source are ignored.
	Radius                           11//Radius in feet from target that the power effects.
	Arc                              3.14//Arc of the power's area. THIS IS IN RADIANS. NOT DEGREES. 
	BoxOffset                        //These are used to define a box offset relative to target and size. Used for the Box area.
	BoxSize
	Range                            //Power Range in feet.
	RangeSecondary                   //Range to secondary target on success
	TimeToActivate                   //Time in seconds from click to activate. 0 for Auto, Should be Interrupt Time + Animation Time for the FX of the power.
	RechargeTime                     10000//time in seconds to recharge
	Activate Period                  10//Time in seconds between automatic activations when the power is set to auto (green ring)
	EnduranceCost                    1//Cost in endurance. Appears to use double this value per second for toggles.
	InsightCost                      //Neither of these are used. Looks like they were intended for an earlier version of the invention system.
	IdeaCost
	TimeToConfirm                    100//Time in seconds for target to confirm power. Usually used for team TPs.
	SelfConfirm                      1//If 1, will ask the caster for confirmation. Default behavior excludes caster.
	ConfirmRequires                  Inherent.Fitness.Stamina//If the target fails this requirement, they auto-confirm.
	DestroyOnLimit                   kFalse//If true, the power is revoked if it reaches the usage limit.
	StackingUsage                    kFalse//If true, this power will extend existing powers when granted multiple times
	NumCharges                       1//Number of charges
	MaxNumCharges                    4//Maximum number of charges allowed
	UsageTime                        10//How long in seconds the power can be used. Toggle only.
	MaxUsageTime                     12//Maximum use time the power can be extended to in seconds.
	Lifetime                         300//Power's lifetime in seconds.
	MaxLifetime                      3000//How much the lifetime can be extended.
	LifetimeInGame                   30//As above, but only counting ingame time.
	MaxLifetimeInGame                30000
	InterruptTime                    45//The window from clicking that the power can be interrupted.
	TargetVisibility                 kNone//Required visibility of target to activate. kNone or kLineOfSight
	Target                           kFoe//What kinds of entities this can target. See section Power Target Types
	TargetSecondary                  kMyPet//As above, but for secondary targets. Default to kNone.
	EntsAutoHit                      kFoe, kMyPet//What kinds of targets don't require a hit roll to be hit? Uses Target's target types.
	EntsAffected                     kFoe,kMyPet//entities that can be affect by one or more effects of this power. Uses Target's target types.
	TargetsThroughVisionPhase        kFalse//If true, can target, affect, autohit thngs in different vision phases. Default to false.
	BoostsAllowed                    kRecovery//Types of boosts allowed in this power. See section Boost Types
	GroupMembership                  kStealthGroup//List of power groups this power belongs to. Only one of the powers in a power group can be on at a time. Using another power from the same group shuts off any other powers which are on.
	ModesRequired                    kModeName//If any modes are listed, you need to be in one or more modes to activate the power.
	ModesDisallowed                  kMode, kMode2, kModeETC//As above, but if you are in any of those modes, you CAN'T use the power
	AIGroups                         kAI_Group_A, kAI_Group_B//AI groups this power belongs to so the AI knows how to use it.
	IgnoreStrength                   kFalse//If true, ignore all strenght modifiers when calculating power strength. Default false.
	ShowBuffIcon                     kTrue//Show buff icon if true.
	ShowInInventory                  kDefault//Show this power in power list? kNever, kDefault, kAlways, kIfUsable, kIfOwned
	ShowInManage                     kTrue//if true, show in enhancement management screen.
	ShowInInfo                       kTrue//Show in player info if true.
	Deletable                        kFalse//If true and a Temp power, it can be deleted.
	Tradeable                        kFalse//If true, it can be traded to other players.
	MaxBoosts                        6//Maximum number of enhancment slots in this power, including basic enhancement. Default 6. Temp powers should have zero.
	DoNotSave                        kFalse//If true, this power won't be saved to the DB, meaning mapmoves, logouts and disconnects will wipe it out. Good for zone-only temp powers.         
	ToggleDroppable                  kNever//Can this toggle power be dropped by a kDropToggle AttribMod? kSometimes, kAlways, kFirst, kLast or kNever. default kSometimes
	StrengthsDisallowed              kRange, kRechargeTime//Strengths on this power that simply cannot be modified.
	ProcMainTargetOnly               kFalse//if true, only main target is hit by attached procs.
	AnimMainTargetOnly               kFalse//if True, only main target is animated and gets FX.
	HighlightEval                    cur.ToHit source> 12 <//If this expression is true, highlight the power.
	HighlightIcon                    //If highlighted, show this icon.
	HighlightRing                    100 100 0 255//If highlighted, show a ring with this RGBA color around the power
	TravelSuppression                0//If nonzero, add this to combat travel power suppression time
	PreferenceMultiplier             1.0//Seems to be used for weighting preference for AI.
	DontSetStance                    1//May have something to do with AI or Mastermind pet stance? Default 1.
	PointValue                       0//Value of power. Point value is only used in AE.
	PointMultiplier                  0
	ChainIntoPower                   NULL//Immediately forces the user to activate the note power. Mostly used for critters with wind-up powers like War Walkers.
	InstanceLocked                   1//Seems to determine if the power is only active in a specific instance.
	IsEnvironmentHit                 kFalse//Not exactly sure what it does, but it seems to be attached to emanator powers.
	ShuffleTargets                   kFalse//Seems to randomly shuffle targets of the power.
	ForceLevelBought                 -1//If greater than -1, forces the power to be counted as the level shown plus 1 for exemplaring. (Mostly just there to diable incarnate powers wqhen exemplared below 45).
	RefreshesOnActivePlayerChange    kFalse//Refreshes the power if the active player on the team changes.
	PowerRedirector                  kFalse//If true, this power redirects to one or more other powers under certain conditions. Most frequently seen in snipes post-i24.
	Cancelable                       kTrue//Not sure what it does, not well documented. May have to do with cancelling powers during activation.
	IgnoreToggleMaxDistance          kFalse//If true, ignore the normal maximum distance between toggle source and target.
	ServerTrayPriority               0//Seems to be tied to the popup tray for temp powers that are in some missions.
	AbusiveBuff                      kFalse//If true, attrib mods applied by this power will be cleared whenever entering a map that uses eRAT_ClearAbusiveBuffs.
	PositionCenter                   //Not certain what these do. Seem to be related to positional targeting, but are barely used at all.
	PositionDistance
	PositionHeight
	PositionYaw
	FaceTarget                       kFalse//if True, face the target when firing.
	VisualFX                         "path\to\power\fx\file.pfx"//the pfx file for the power.
	Include                          path\to\power\fx\file.pfx//This actually contains the FX info.
	
	AttribMod//This will probably need a whole section to itself.
	{...}	
}


Modes

A lot of the below is supposition, as very few modes are referenced in the source code. If any of this is found to be accurate or you have more information, please edit appropriately.

  • kDisable_All is obviously when all powers are disabled (such as a few of the missions where you control another character)
  • kDefiant appears to be linked to the Blaster's Defiance
  • kDisable_Pool, kDisable_Inspiration_Large and kDisable_Epic are for disabling all pool powers and epic pools respectively, and are usually found only on those powers.
  • kArena is for powers that don't function in arena matches.
  • kDisable_Inspiration, kDisable_Inspiration_Small, kDisable_Inspiration_Medium, kDisable_Inspiration_Large and kDisable_Inspiration_Special are for inspirations specifically. I won't cover making new inspirations in this article, but may do so in a separate article later.
  • kPeacebringer_Blaster_Mode, kPeacebringer_Tanker_Mode, kWarshade_Blaster_Mode and kWarshade_Tanker_Mode are for powers that are disabled when you are in the Peacebringer or Warshade transformations (Squids == Blaster Mode, Lobsters == Tanker Mode). A lot of these are travel or temp powers.
  • kProwlerMode and kHunterMode appear to be related to the unreleased Primalist archetype, and seem to be only found in their defs.
  • kDisable_Toggle for when toggles are to be disabled.
  • kDisable_Travel for disabling travel powers.
  • kDisable_Temp for disabling temporary powers.
  • kCoOpTeam: I think this has to do with teams of differing alignments (hero/villain/praetorian), and I've only found it on Team Teleport type powers. I think it's to prevent aligned zone breaking workaraounds with co-op teams.
  • kDisable_Walk: For disabling the Walk toggle, as well as the vanity pets and vanity travel powers
  • kDisable_SetBonus: Disables set bonuses. Only used for Set Enhancements, which this article also doesn't cover. Fun fact: All enhancements in the game code are considered powers, and are internally called boosts!

Attack Types

  • kAOE_Attack
  • kCold_Attack
  • kEnergy_Attack
  • kFire_Attack
  • kLethal_Attack
  • kMelee_Attack
  • kNegative_Energy_Attack
  • kPsionic_Attack
  • kRanged_Attack
  • kSmashing_Attack
  • kToxic_Attack

Power Target types

  • kNone: No target. Mostly used for powers that don't autohit anything.
  • kCaster: The caster (even if dead)
  • kPlayer: Any player characters except the caster
  • kPlayerHero: Any living player of type Hero except the caster
  • kPlayerVillain: Any living player of type Villain except the caster
  • kDeadPlayer: Any dead player characters INCLUDING caster
  • kDeadPlayerFriend: Any dead friendly players except the caster
  • kDeadPlayerFoe: Any dead hostile players except the caster
  • kTeammate: Any teammate or teammate's pet except the caster
  • kDeadTeammate: Any dead teammate or teammate's dead pet except the caster
  • kDeadOrAliveTeammate: Any teammate or teammate's pet except the caster, dead or alive
  • kVillain: Any AI-controlled evil villain except the caster
  • kDeadVillain: Any dead AI-controlled evil villain INCLUDING the caster
  • kNPC: Any NPC but villains
  • kEnemy: Seemingly deprecated. See kVillain
  • kDeadOrAliveFriend: Any Friendly or Friendly's pet except the caster, dead or alive
  • kDeadFriend: Any Friendly on the same "team" except the caster
  • kFriend: Any Friendly except the caster
  • kDeadOrAliveFoe: Any hostile except the caster, alive or dead
  • kDeadFoe: Any dead hostile except the caster
  • kFoe: Any unfriendly except the caster
  • kLocation: A specific location (the "target halo" for placeable powers)
  • kTeleport: as kLocation, but with constraints for teleporting
  • kAny: Any living entity.
  • kDeadOrAliveMyPet: Any target where the source is the owner (i.e. the caster's pets, or any of their pets, and so on, alive or dead)
  • kDeadMyPet: Any dead target where the source is the owner (i.e. the caster's dead pets, or any of their pets' dead pets, and so on)
  • kMyPet: Any living target where the source is the owner (i.e. the caster's living pets, or any of their pets' living pets, and so on)
  • kMyOwner: The caster's master's master's master's... up to the top level.
  • kMyCreator: The caster's immediate master, ignoring levels above.
  • kMyCreation: The source's living pets, but not any of their pets' pets
  • kDeadMyCreation: The source's dead pets, but not any of their pets' dead pets
  • kDeadOrAliveMyCreation: The source's pets, alive or dead, but not any of their pets' pets
  • kLeaguemate: Any living leaguemate and their pets except the caster
  • kDeadLeaguemate: Any dead leaguemate and all leaguemate's dead pets except the caster
  • kDeadOrAliveLeaguemate: All leaguemates and their pets, dead or alive except the caster
  • kPosition: A position relative to an entity specified by the designer

Effect Areas

  • kCharacter: Any targeted entity
  • kCone: A cone centered around the ray connecting the source to the target.
  • kSphere: A sphere surrounding the target.
  • kLocation: A single spot on the ground.
  • kVolume: In the same volume as the caster. Seems like it's used for environmental hazards like lava or acid.
  • kNamedVolume: In a volume named the same as the one the caster is in (not yet implemented)
  • kMap: Everybody on the same map as the caster. Mostly used by raid bosses and the like.
  • kRoom: In the same Tray (Room) as the caster. I have no idea what that means, and only one power uses it, Pets.Raid_Disruptor_Pylon_Kill.Destroy.
  • kTouch: Not sure what it does, code comments just say "Capsules touch". Seems similar to kVolume.
  • kBox: A box positioned relative to the target, oriented along the regular xyz axes. Doesn't appear to be used yet.

Boost Types

These are the actual enhancement boosts that are found in powers. There are a couple of other boost types, but those are specific to Incarnate powers, or are used to flag what origins can slot a given boost. There's also the Hamidon boost type, which apply to all the IO multi-aspects. (Hamidon, Titan and Hydra enhancements).

  • kAccuracy_Boost
  • kDamage_Boost
  • kEnduranceDiscount_Boost
  • kRange_Boost
  • kRecharge_Boost
  • kDebuff_Defense_Boost
  • kStunned_Boost
  • kImmobilized_Boost
  • kKnockback_Boost
  • kBuff_ToHit_Boost
  • kTaunt_Boost
  • kHeal_Boost
  • kSlow_Boost
  • kDebuff_ToHit_Boost
  • kInterrupt_Boost
  • kHold_Boost
  • kRecovery_Boost
  • kSleep_Boost
  • kFear_Boost
  • kBuff_Defense_Boost
  • kConfuse_Boost
  • kRes_Damage_Boost
  • kSpeedrunning_Boost
  • kJump_Boost
  • kSpeedFlying_Boost
  • kIntangible_Boost
  • kSpeedRunning_Boost
  • kDeBuff_ToHit_Boost
  • kDeBuff_Defense_Boost
Retrieved from "https://wiki.ourodev.com/index.php?title=Power_Bits&oldid=1847"