~~NOTOC~~
<=[[4rpl:start| Index]]

<WRAP tabs>
  * [[4rpl:commands:GetUnitAmmo|Get]]
  * [[4rpl:commands:SetUnitAmmo|Set]]
</WRAP>

====== SetUnitAmmo ======
SetUnitAmmo(<-unit <-amt)

===== Description =====
Sets the ammo of the unit. A value of 1 is how much a packet normally delivers.\\
The ammo can not exceed the max ammo, so set max ammo first. Amt values less than zero are changed to zero.

:WARNING: If you are using this API in [[4rpl:commands:func_awake|:Awake]], if the unit's ammo ware is not energy it will be internally swapped to the correct ware after [[4rpl:commands:func_awake|:Awake]] processes. This will reset the unit's ammo back to 0 and have a visual glitch of the ammo dots appearing although the unit's ammo is 0. To avoid this, simply avoid using this API in [[4rpl:commands:func_awake|:Awake]].

===== Examples =====
<code 4rpl>
SetUnitMaxAmmo(self 100)
SetUnitAmmo(self 100)
</code>
<=[[4rpl:start| Index]]