Knuckle Cracker Wiki

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
~~NOTOC~~
<=[[4rpl:start| Index]]
<WRAP tabs>
  * [[4rpl:commands:getunitammoware|Get]]
  * [[4rpl:commands:setunitammoware|Set]]
</WRAP>
:!: Available in version 1.3 and later.
====== SetUnitAmmoWare======
SetUnitAmmoWare(<-unit  <-unitAmmoWare)

===== Description =====

Set the ammo ware type of the unit to the stack. 0 = energy, 1 = anticreeper, 2 = arg, 3 = liftic. When used on a Porter, it will do nothing.


===== Examples =====
<code 4rpl>
SetUnitAmmoWare(self 1)
</code>

===== Programming Notes =====

Do not use SetUnitAmmoWare in the ''[[func_Awake|:Awake]]'' function. This causes all further units in the map to fail to load.

When using SetUnitAmmoWare on a unit, it is advised to make sure that in the unit's blueprint (CMOD Settings), the initial Ammo Ware is set to Energy. Should it be set to one of the special wares (Liftic / Arg / Anticreeper), if the unit is later changed to use Energy, a reload of the game from a save file will cause the unit to request both Energy and the ware set in the unit's initial blueprint at the same time.

Minimum reproducible example of the issue. Create a unit whose initial Ammo Ware is Liftic, and have the unit request ammo. Then give it this code.
<code 4rpl>
GetTimer0 1 eq if
   SetUnitAmmo(Self 0)
   SetUnitAmmoWare(Self 0)
endif

:once
  300 SetTimer0
</code>
In the finalized map, wait out a little over 10 seconds until the unit swaps to Energy, then save and load. The unit now requests both Energy and Liftic.

To avoid this issue, ensure the unit's initial Ammo Ware in CMOD Settings is Energy, then if the desired initial Ware is e.g. Liftic, that is later to be swapped to Energy, use ''[[func_GameLoaded|:GameLoaded]]'' as follows to set the unit to use Liftic from the start, while leaving it as Energy in the unit's CMOD Settings.
<code 4rpl>
:GameLoaded
   @init
:Once
   @init
:init
   once
      SetUnitAmmoWare(Self 3)
   endonce
</code>

<=[[4rpl:start| Index]]
Knuckle Cracker Wiki

User Tools

Site Tools

Page Tools
