Knuckle Cracker Wiki

User Tools

Site Tools

Trace:
4rpl:commands:setfieldcell

Differences

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

Link to this comparison view

Next revision		Previous revision
4rpl:commands:setfieldcell [2021/02/07 22:33] – created virgilw4rpl:commands:setfieldcell [2025/02/14 14:57] (current) – external edit 127.0.0.1
Line 1: Line 1:
 ~~NOTOC~~ ~~NOTOC~~
 <=[[4rpl:start| Index]] <=[[4rpl:start| Index]]
 +<WRAP tabs> 
 +  * [[4rpl:commands:getfieldcell|Get]] 
 +  * [[4rpl:commands:setfieldcell|Set]] 
 +</WRAP>
 :!: Available in version 1.3 and later. :!: Available in version 1.3 and later.
 ====== SetFieldCell ====== ====== SetFieldCell ======
Line 8: Line 11:
 ===== Description ===== ===== Description =====
 Sets the field cell as the specified location.  If 'AC' is true, then the AC affecting fields will be altered. If false, then the creeper affecting field will be altered. The fieldValue is a V2 in non normalized form (so it has high values, like 1000000 in it). Sets the field cell as the specified location.  If 'AC' is true, then the AC affecting fields will be altered. If false, then the creeper affecting field will be altered. The fieldValue is a V2 in non normalized form (so it has high values, like 1000000 in it).
 +
 +**Fields are reset on map load, so any fields must be recreated in the [[func_awake|:awake]] method.**
 +
 +This method will **set** the field on the specified cell to a certain value. That means if there already was a field underneath, its effect will be erased. If you're not careful, you will erase the effect of nearby shields, singularity or other custom fields with this. This is something you should never allow to happen, as shields/singularity/custom fields will attempt to add a field of opposite force to erase their effect when they are no longer working, which will create an opposite field in the area that was previously reset with [[SetFieldCell]].
 +
 +In order to add to a field rather than set it, retrieve its current values first using [[GetFieldCell]], add to those values, then set those values as the new field. To erase the new field, do the same thing, but instead subtract what was previously added. Alternatively, you can use [[SetFieldRect]], which adds fields rather than sets them.
 +
 +For reference:\\
 +Shields have a field (total "strength") of 2000 throughout its radius.
  
 ===== Examples ===== ===== Examples =====
 <code 4rpl> <code 4rpl>
-SetFieldCell(50 40 false V2(1000000 1000000)+:Awake 
 +   SetFieldCell(50 40 false V2(1000000 1000000))
 </code> </code>
  
 <=[[4rpl:start| Index]] <=[[4rpl:start| Index]]
4rpl/commands/setfieldcell.1612737221.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