Discuss this page on this page's [[objDestroy Talk Page|Talk Page]]

=== objDestroy ===

See [[http://xelerus.de/index.php?s=functions&function=79|objDestroy at Xelerus]]

^ Syntax | (objDestroy obj [objSource]) -> True/Nil |
^ Arguments | obj: The spaceObject that you want to destroy. |
^ | [objSource]: An optional spaceObject that destroys the other object. |
^ Returns | boolean: True if successful, otherwise Nil. |
^ Category | [[spaceobject functions|spaceObject]] |
^ Description | If used with only one argument it simply removes the spaceobject from the game. If the optional argument is provided, the function acts as if the target object was destroyed by the source, triggering any OnDestroy events, friend/enemy relations etc... |

=== Example ===

Assuming that the player has a ship targeted, this will destroy that target:

<code lisp>(objDestroy (objGetTarget gPlayerShip))</code>

With the same assumption, this will destroy that target, and behave as if it was the player who did it:

<code lisp>(objDestroy (objGetTarget gPlayerShip) gPlayerShip)</code>

Return to [[:Functions]] list