Knuckle Cracker Wiki

User Tools

Site Tools

Trace:
4rpl:commands:damageunit

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Next revision		Previous revision
4rpl:commands:damageunit [2021/01/08 16:01] – external edit 127.0.0.14rpl:commands:damageunit [2025/02/14 14:57] (current) – external edit 127.0.0.1
Line 1: Line 1:
 ~~NOTOC~~ ~~NOTOC~~
-<=[[4rpl:start| Index]]+<=[[4rpl:start| Index]]\\ 
 +<= [[4rpl:start#Unit]] 
  
 ====== DamageUnit ====== ====== DamageUnit ======
Line 9: Line 11:
 Typical health values for most units are either 0 or 1. Units that have a health of 0 will be destroyed when Damage is called. Typical health values for most units are either 0 or 1. Units that have a health of 0 will be destroyed when Damage is called.
 Other units will have damage deducted from their health. Note that positive values cause damage. If a negative value is passed in, the resulting unit's health increases. Other units will have damage deducted from their health. Note that positive values cause damage. If a negative value is passed in, the resulting unit's health increases.
 +
 +:NOTE: Interestingly enough, when this API is used on a unit that is constructing, it will subtract the construction ammo rather than instantly destroying the unit (and the reverse when causing negative damage). If this is undesired, be sure to amp-up the damage value or call [[4rpl:commands:destroyunit|DestroyUnit]] by checking [[4rpl:commands:getunitconstructing|GetUnitConstructing]] for the targeted unit as a Cannon costs 25 energy to build yet has only 2 health. That is a very large "health increase" while building. It would also be better coding grammar to use [[4rpl:commands:constructunit|ConstructUnit]] to subtract the build ammo of a constructing unit using a negative value than with this API.
 +
 +:WARNING: If using this API for something like a custom missile and applying this API after getting a list of units to damage, __make sure the unit that's doing this __**<color #FF5555>__is not part of the list of units to damage__</color>** otherwise this API will damage the unit that called it and possibly end the loop prematurely by destroying it. This will either make the unit very unreliable in using this API effectively or reliably destroy the unit using this API before applying it to the intended units. So for the sake of your sanity please be mindful of this if it appears this API isn't working super reliably.\\
 +-Vertu | Who temporarily lost his mind to this.
 ===== Examples ===== ===== Examples =====
 <code 4rpl> <code 4rpl>
4rpl/commands/damageunit.1610121708.txt.gz · Last modified: 2025/02/14 14:56 (external edit)

Page Tools

Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki