This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
4rpl:commands:setunitwantsern [2024/06/13 18:49] – Kalli | 4rpl:commands:setunitwantsern [2025/03/24 04:21] (current) – Mentioned undock issue in description and added function quick copy. Vertu | ||
---|---|---|---|
Line 11: | Line 11: | ||
===== Description ===== | ===== Description ===== | ||
Sets whether the unit with the specified UID desires an ERN. Pass `true` to make the unit desire ERN, or `false` to indicate it does not. | Sets whether the unit with the specified UID desires an ERN. Pass `true` to make the unit desire ERN, or `false` to indicate it does not. | ||
+ | |||
+ | Beware that when an ERN is docked to a unit, you can't use this API to have that unit release the ERN by having it no longer want one. See the workaround code if this is a concern. | ||
Line 23: | Line 25: | ||
<code 4rpl> | <code 4rpl> | ||
# A unit that has an ERN slotted and receives the 4rpl command to "not want an ERN", | # A unit that has an ERN slotted and receives the 4rpl command to "not want an ERN", | ||
- | # will not actually unequip the ERN. As a workaround it is possible to destroy the unit | + | # will not actually unequip the ERN. As a workaround, it is possible to destroy the unit |
- | # and recreate it without the ERN. That's what this function is for. The function supposes | + | # and recreate it without the ERN. That's what this function is for. |
- | # that the unit that has to lose the ERN, is already constructed, | + | |
- | # be the case. | + | |
- | <-uid GetUnitWantsErn not GetUnitErnState AND if | + | <-uid GetUnitWantsErn not < |
<-uid @freeErnFromUnit | <-uid @freeErnFromUnit | ||
endif | endif | ||
Line 34: | Line 34: | ||
: | : | ||
->UID | ->UID | ||
- | <-UID getunittype <-UID getunitposition <-UID getunitsettings createunit dup ->newUID 999 constructunit | + | |
+ | | ||
+ | # Resources that are on the way to the old unit will be lost. | ||
+ | |||
+ | # Enable/ | ||
+ | <-newUID <-UID | ||
+ | # dup2 getunitmaxammo setunitmaxammo | ||
+ | dup2 getunitammo setunitammo | ||
+ | dup2 getunitcandestroy setunitcandestroy | ||
+ | dup2 getunitselectable setunitselectable | ||
+ | dup2 getunitenabled setunitenabled | ||
+ | dup2 getunitarmed setunitarmed | ||
+ | dup2 getunitsupplied setunitsupplied | ||
+ | # dup2 getunithealrate setunithealrate | ||
+ | # dup2 getunitmaxhealth setunitmaxhealth | ||
+ | dup2 getunithealth setunithealth | ||
+ | # dup2 getunitrange setunitrange | ||
+ | dup2 getunitstuncount setunitstuncount | ||
+ | dup2 getunitmovecell dup -1 neq if setunitmovecell else pop pop pop pop endif | ||
+ | pop pop | ||
+ | |||
+ | <-UID 1 1 1 destroyunit | ||
+ | |||
+ | </ | ||
+ | Just the function (for quick copy and paste): | ||
+ | <code 4rpl> | ||
+ | : | ||
+ | ->UID | ||
+ | <-UID getunitconstructingdata ev2 pop dup -1 eq if pop 999 endif -> | ||
+ | <-UID getunittype <-UID getunitposition <-UID getunitsettings createunit dup ->newUID < | ||
+ | # Resources that are on the way to the old unit will be lost. | ||
| | ||
# Enable/ | # Enable/ |