Pathfinder 1e for Foundry VTT
    Preparing search index...

    Class AttackModel

    Hierarchy (View Summary)

    Index

    General

    actions ammo armorProf? baseTypes broken changeFlags? changes? class? classSkills contextNotes? description enh flags held languages? links masterwork material notes parent? proficient properties scriptCalls showInCombat? showInQuickbar? sources subType tag? tags technology uses weapon? weaponGroups weaponProf? activeState addonMaterial attackNotes autoDeductCharges baseMaterial canUse charges effectNotes hasFiniteCharges isActive isBroken isCharged isPhysical isProficient isQuasiPhysical isSingleUse maxCharges normalMaterial isPhysical _activeStateChange _chargePreUpdate _prepareTraits _rechargeActions _rechargeUses _updateChargeLinking _updateInheritedCharges getDefaultChargeCost getDefaultChargeFormula getLabels getName getProficiency getRollData prepareBaseData prepareDependentData prepareDerivedData recharge setActive _adjustNewItem fromItem migrateParentData pruneData

    Document

    metadata

    General

    actions: Record<string, Action>
    ammo: AmmoData
    armorProf?: Trait<"med" | "lgt" | "hvy" | "shl" | "twr">
    baseTypes: Set<string>
    broken: boolean
    changeFlags?: Set<
        | "haste"
        | "lowLightVision"
        | "seeInDarkness"
        | "seeInvisibility"
        | "immuneToMorale"
        | "loseDexToAC"
        | "noMediumEncumbrance"
        | "noHeavyEncumbrance"
        | "mediumArmorFullSpeed"
        | "heavyArmorFullSpeed"
        | "noAblScore.str"
        | "noAblScore.dex"
        | "noAblScore.con"
        | "noAblScore.int"
        | "noAblScore.wis"
        | "noAblScore.cha"
        | "pointBlankShot"
        | "rapidShot"
        | "manyshot",
    >
    changes?: Record<string, ItemChange>
    class?: Slug
    classSkills: Set<
        | "int"
        | "crf"
        | "acr"
        | "swm"
        | "clm"
        | "fly"
        | "lor"
        | "art"
        | "per"
        | "apr"
        | "blf"
        | "dip"
        | "dev"
        | "dis"
        | "esc"
        | "han"
        | "hea"
        | "kar"
        | "kdu"
        | "ken"
        | "kge"
        | "khi"
        | "klo"
        | "kna"
        | "kno"
        | "kpl"
        | "kre"
        | "lin"
        | "prf"
        | "pro"
        | "rid"
        | "sen"
        | "slt"
        | "spl"
        | "ste"
        | "sur"
        | "umd",
    >
    contextNotes?: Record<string, ContextNote>
    description: { instructions: HTML; summary: FreeText; value: HTML }
    enh: number | null
    flags: { boolean: Set<Slug>; dictionary: Record<Slug, FreeText | number> }
    held: "2h" | "oh" | "1h"
    languages?: Set<
        | "dark"
        | "aboleth"
        | "abyssal"
        | "aklo"
        | "ancientosiriani"
        | "androffan"
        | "aquan"
        | "auran"
        | "azlanti"
        | "boggard"
        | "brethedan"
        | "canto"
        | "catfolk"
        | "celestial"
        | "common"
        | "cyclops"
        | "draconic"
        | "drowsign"
        | "druidic"
        | "dtang"
        | "dwarven"
        | "dziriak"
        | "ekekeh"
        | "elderthing"
        | "elven"
        | "erutaki"
        | "firstspeech"
        | "gholgan"
        | "giant"
        | "gnoll"
        | "gnome"
        | "goblin"
        | "grippli"
        | "grioth"
        | "gug"
        | "halfling"
        | "hallit"
        | "honla"
        | "hwan"
        | "ib"
        | "ignan"
        | "infernal"
        | "iobaran"
        | "jandelayan"
        | "jistka"
        | "kasatha"
        | "kelish"
        | "kuru"
        | "lashunta"
        | "migo"
        | "minatan"
        | "minkaian"
        | "munavri"
        | "nagaji"
        | "necril"
        | "orc"
        | "orvian"
        | "osiriani"
        | "polyglot"
        | "protean"
        | "reptoid"
        | "rougarou"
        | "sakvroth"
        | "samsaran"
        | "sasquatch"
        | "senzar"
        | "shadowtongue"
        | "shae"
        | "shoanti"
        | "shobhad"
        | "skald"
        | "sphinx"
        | "strix"
        | "sylvan"
        | "syrinx"
        | "taldane"
        | "tekritanin"
        | "tengu"
        | "terran"
        | "thassilonian"
        | "tien"
        | "treant"
        | "triaxian"
        | "undercommon"
        | "urdefhan"
        | "vanaran"
        | "varisian"
        | "varki"
        | "vegepygmy"
        | "vishkanya"
        | "vudrani"
        | "wayang"
        | "yaddithian"
        | "yithian",
    >
    links: { children: LinkModel[]; supplements: LinkModel[] }
    masterwork: boolean
    material: MaterialData
    notes: Record<string, NoteEntry>
    parent?: ItemPF
    proficient: boolean
    properties: Record<WeaponProperty, boolean>
    scriptCalls: Record<string, ItemScriptCall>
    showInCombat?: boolean

    Show item in combat tab.

    showInQuickbar?: boolean

    Display item and its actions in quick actions and token HUD.

    sources: SourceModel[]
    subType: "item" | "misc" | "ability" | "weapon" | "natural" | "racialAbility"
    tag?: Slug
    tags: Set<FreeText>
    technology: boolean
    uses: ResourceData
    weapon?: {
        category?:
            | "misc"
            | "simple"
            | "siege"
            | "martial"
            | "exotic"
            | "firearm"
            | "heavy";
        type?: string;
    }
    weaponGroups: Set<
        | "double"
        | "natural"
        | "close"
        | "axes"
        | "bladesHeavy"
        | "bladesLight"
        | "bows"
        | "crossbows"
        | "firearms"
        | "flails"
        | "hammers"
        | "monk"
        | "polearms"
        | "siegeEngines"
        | "spears"
        | "thrown"
        | "tribal",
    >
    weaponProf?: Trait<"simple" | "siege" | "martial" | "firearm" | "heavy">
    • get activeState(): boolean

      Active state as per what setActive would correspond with.

      Returns boolean

    • get addonMaterial(): Set<string>

      The item's material addons.

      Returns Set<string>

    • get attackNotes(): HTML[]

      Returns HTML[]

    • get autoDeductCharges(): boolean

      Consumes are adds charges by default.

      Returns boolean

    • get baseMaterial(): string | null

      Base material

      Returns string | null

    • get canUse(): boolean

      Is this item usable at base level, disregarding per-action details.

      Returns boolean

    • get charges(): number

      Remaining charges

      Returns number

    • get effectNotes(): HTML[]

      Returns HTML[]

    • get hasFiniteCharges(): boolean

      Finite charges

      Returns boolean

    • get isActive(): boolean

      Is Active

      This returns composite result of if the item is equipped, has quantity, is not disabled, is not out of charges, etc. and is not representative if the item can be set active or not via setActive.

      Returns boolean

      activeState

    • get isCharged(): boolean

      Returns boolean

    • get isPhysical(): boolean

      Is this a physical item?

      Returns boolean

    • get isProficient(): boolean

      Is the owning actor proficiency at using this as weapon.

      Returns boolean

      PF1 v10

    • get isQuasiPhysical(): boolean

      Pretend-physical item.

      Used in action handling only.

      Returns boolean

    • get isSingleUse(): boolean

      Returns boolean

    • get maxCharges(): number

      Maximum possible charges this item can have.

      Returns number

      • Can return zero. Usually signifying something has reduced the potential uses below usability.
      • Can return infinity, signifying lack of limits.
    • get normalMaterial(): string | null

      The item's actual material.

      Returns string | null

    • get isPhysical(): boolean

      {@inheritDoc BaseItemModel#isPhysical}

      Returns boolean

    Abstract_activeStateChange

    • _activeStateChange(changed: object): boolean
      Internal Experimental

      Return active state change from data if present

      This is a hack to allow item-type agnostic active state change detection.

      Parameters

      • changed: object

      Returns boolean

    _chargePreUpdate

    • _chargePreUpdate(changed: object, context: object): Promise<void>
      Internal

      Handle charge update sanity checking, constraining them to reasonable values, and propagating to parent items if charges are shared.

      Parameters

      • changed: object

        Changed data

      • context: object

        Context

      Returns Promise<void>

    _prepareTraits

    • _prepareTraits(): void
      Internal

      Returns void

    Protected_rechargeActions

    • _rechargeActions(
          options?: { exact: boolean; period?: string; rollData?: object },
      ): object | undefined
      Protected

      Update action limited uses

      {@inheritDoc ItemPF.recharge}

      TODO: Move this to the action itself.

      Parameters

      • options: { exact: boolean; period?: string; rollData?: object } = {}

        Options

        • exact: boolean

          Exact time period only

        • Optionalperiod?: string

          Recharge only if matching this time period

        • OptionalrollData?: object

          Roll data

      Returns object | undefined

      • Update data or undefined if no update is needed.

    Protected_rechargeUses

    • _rechargeUses(
          options?: {
              exact?: boolean;
              maximize?: boolean;
              period?: string;
              rollData?: object;
              value?: number;
          },
      ): Promise<object | undefined>
      Protected

      Recharges item's uses, if any.

      Parameters

      • options: {
            exact?: boolean;
            maximize?: boolean;
            period?: string;
            rollData?: object;
            value?: number;
        } = {}

        Options

        • Optionalexact?: boolean

          Match only exact time period

        • Optionalmaximize?: boolean

          Maximize instead of using recharge formula

        • Optionalperiod?: string

          Recharge only if it matches this time period

        • OptionalrollData?: object

          Roll data instance

        • Optionalvalue?: number

          Set charges to specific value

      Returns Promise<object | undefined>

      • Promise for the update, update data object, or undefined (no update needed).

    _updateChargeLinking

    • _updateChargeLinking(): void
      Internal

      Update Charge Linking

      Returns void

    _updateInheritedCharges

    • _updateInheritedCharges(source: Item<"base" | ModuleSubType>): void
      Internal

      Update this item's charges based on provided item.

      Parameters

      • source: Item<"base" | ModuleSubType>

        Charge source

      Returns void

    • Get default charge cost for all actions.

      Parameters

      • Optionaloptions: { rollData?: object } = {}

        Additional options

        • OptionalrollData?: object

          Roll data instance

      Returns number

      Number for default cost.

    • Default charge formula.

      Returns string

      • Charge formula
    • Protected

      Called by ()

      Parameters

      • labels: object
      • Optionaloptions: { isolated?: boolean; rollData?: object } = {}

      Returns void

    • Visible item name

      Parameters

      • OptionalasPlayer: boolean = false

        If true, return value players see.

      Returns string

      • Item name

    • Parameters

      • weapon: boolean = true

        Get proficiency as a weapon. Armor otherwise.

      Returns boolean

      • Whether or not the owner of the item is proficient.
      • If item type does not support proficiency.

      PF1 v10

    • DataModel specific roll data

      Parameters

      • result: object

        Roll data

      Returns void

    • Prepare data dependent on other items

      Called in actor.prepareDerivedData() when all items are guaranteed to be prepared.

      Parameters

      • final: boolean = false

      Returns void

    • Recharges item's uses, if any.

      Parameters

      • options: {
            commit?: boolean;
            context?: object;
            exact?: boolean;
            maximize?: boolean;
            period?: "round" | "minute" | "hour" | "day" | "week" | "any";
            rollData?: object;
            value?: number;
        } = {}

        Options

        • Optionalcommit?: boolean

          Commit update directly. If false, returns the update data instead.

        • Optionalcontext?: object

          Update context

        • Optionalexact?: boolean

          Use exact time period. Otherwise "week" for example will also recharge items with "day" period.

        • Optionalmaximize?: boolean

          Recharge to full regardless of recharge formula.

        • Optionalperiod?: "round" | "minute" | "hour" | "day" | "week" | "any"

          Recharge period. Use "any" to ignore item's configuration.

        • OptionalrollData?: object

          Roll data instance to use for formulas.

        • Optionalvalue?: number

          Recharge to specific value, respecting maximum and minimum bounds.

      Returns Promise<object | AttackModel | undefined>

      • Promise for the update, update data object, or undefined (no update needed).

    • Set item's active state.

      Parameters

      • active: boolean

        Active state

      • Optionalcontext: object

        Optional update context

      Returns Promise<AttackModel>

      • Update promise if item type supports the operation.
      • If item does not support the operation.

    Protected Static Abstract_adjustNewItem

    • _adjustNewItem(item?: ItemPF, data?: object, override?: boolean): void
      Protected

      Adjust temporary item before creation

      Parameters

      • Optionalitem: ItemPF

        Temporary document

      • Optionaldata: object

        Creation data

      • Optionaloverride: boolean = false

        Override values even if defined

      Returns void

    • Creates attack from provided item.

      Parameters

      • item: Item<"base" | ModuleSubType>

        Source item

      Returns object

      • Attack item data
      • Only supports weapon item type.
      • On unsupported type

    • Parent datamodel (item document) migration

      AVOID USING THIS

      Parameters

      • _source: object

        Document source data

      Returns void

    • Parameters

      • source: any

      Returns void

    Document

    metadata: Readonly<
        {
            classAssociation: true;
            isPhysical: false;
            label: "CONFIG.Item.typeLabels.attack";
            supplementLevel: false;
            type: "attack";
        },
    > = ...

    Settings

    Member Visibility

    On This Page

    General
    Document