@minecraft
    Preparing search index...

    Class FogSettings

    Provides access to the fog definitions stack of a player entity, allowing scripts to push, pop, remove, and query active fog definitions.

    Index
    getStack getTags pop push remove setStack
    • World mutation

      Returns string[]

      An array of fog definition identifiers currently on the stack.

      Returns the list of fog identifiers currently on the player's fog stack, ordered from bottom to top.

      Throws if the entity is invalid.

      InvalidEntityError

    • World mutation

      Returns string[]

      An array of tag strings associated with fog settings on the stack.

      Returns the list of tags currently present on the player's fog stack.

      Throws if the entity is invalid.

      InvalidEntityError

    • World mutation

      Parameters

      • Optionaltag: string

        An optional tag identifying which entry to pop. If provided, searches the stack from top to bottom and removes the most recently pushed entry with this tag. If omitted, removes the most recently pushed entry regardless of tag.

      Returns string

      Returns the identifier of the popped fog definition, or undefined if the stack was unchanged.

      Removes the most recently pushed fog definition from the player's fog stack.

      Throws if the entity is invalid.

      InvalidEntityError

    • World mutation

      Parameters

      • fogId: string

        The identifier of the fog definition to push onto the stack (e.g. 'minecraft:fog_bamboo_jungle').

      • Optionaltag: string

        An optional tag used to label this fog definition on the stack, allowing it to be targeted by pop or remove. If omitted, the entry is stored with the tag 'untagged'.

      Returns number

      Returns the zero-based index at which the fog definition was inserted into the stack.

      Pushes a new fog definition onto the player's fog stack.

      Throws if the entity is invalid, the fog identifier is invalid, or if the stack limit of 16 has been exceeded.

      FogSettingsError

      InvalidEntityError

    • World mutation

      Parameters

      • Optionaltag: string

        An optional tag identifying which the entries to remove. If omitted, clears all fog definitions regardless of tag.

      Returns boolean

      Returns true if at least one entry was removed, or false if the stack was unchanged.

      Removes all fog definitions with the given tag from the player's fog stack. If no tag is provided, clears all fog definitions.

      Throws if the entity is invalid.

      InvalidEntityError

    • World mutation

      Parameters

      • fogIds: string[]

        A stack of fog definition identifiers to set on the player's fog stack (e.g. ['minecraft:fog_bamboo_jungle']). Maximum of 16 entries.

      • Optionaltag: string

        An optional tag to associate with the new entries, used to target them with pop or remove.

      Returns void

      Sets the player's fog stack to the given list of fog identifiers, replacing any existing entries.

      Throws if the entity is invalid, if more than 16 fog identifiers are provided, or if any fog identifier is invalid.

      FogSettingsError

      InvalidEntityError

    Settings
    Member Visibility

    On This Page
    Methods