Donut Team is a labor of love, built and maintained by a small group of passionate developers. We invest our own time and resources to offer our tools, mods, and web services completely free of charge.

We don't run ads, and we will never sell your data - period.

If you've enjoyed anything we've created, please consider supporting our work with a one-time or monthly donation via our Ko-fi page . Every contribution helps us continue building great experiences for the community.

Dismiss
  • Modding Tools
  • Lucas' Simpsons Hit & Run Mod Launcher
  • Hacks
  • Mod Requirable Hacks
  • Custom Files
  • Lua Functions
  • Game State Functions

IsPersistentObjectDestroyed

Available since Version 1.27.

Checks if the given persistent object in a sector has been destroyed.

Persistent objects include various props, such as cola crates and cola machines, as well as coins and wasp cameras.

Syntax

IsPersistentObjectDestroyed( sector, persistent_object )

Arguments

  • sector (integer): The sector to check.
  • persistent_object (integer): The persistent object to check.
    • Between 1 and 128 (the max amount of persistent objects in a sector).

Return Values

  • (boolean | nil): If the player has completed the gag or nil if unavailable.

Examples

-- This is l1_crate_Shape -> l1_crate4 in the base game
local DestroyedThatSpecificColaCrate = IsPersistentObjectDestroyed(PersistentObjectSector.L1Z1, 2)
if DestroyedThatSpecificColaCrate then
	-- Do something if Homer has destroyed that specific cola crate
end

Notes

Persistent object indices depend on the order of the relevant chunks in region P3Ds or, for wasp cameras, the order they are added in the level's initialisation script (via AddSpawnPoint or AddSpawnPointByLocatorScript)

To see which indice refers to which prop/coin/wasp in the base game, see Persistent Objects.