UsePuzzleItem

129:UsePuzzleItem (item, script, s_arg1, s_arg2, s_arg3)

• item: Puzzle artifact number
• script: Script to execute
• s_arg1: First argument to pass to script
• s_arg2: Second argument to pass to script
• s_arg3: Third argument to pass to script

Executes a specified script on the current map if the player holds the specified puzzle artifact, and removes the artifact in the process. If the player does not have the artifact, this plays the “*puzzfail” player sound instead. This special must be placed on a thing or a line and cannot be used in a script.

Standard puzzle artifacts (class names):

• 0: Skull
• 1: GemBig
• 2: GemRed
• 3: GemGreen1
• 4: GemGreen2
• 5: GemBlue1
• 6: GemBlue2
• 7: Book1
• 8: Book2
• 9: FlameMask
• 10: FWeapon
• 11: CWeapon
• 12: MWeapon
• 13: Gear1
• 14: Gear2
• 15: Gear3
• 16: Gear4

This special can also be put on any thing in the map. If that is the case and the player uses the item near this thing the special is also executed.