Description

This collection contains an Actor for Unreal Tournament 99. When this Actor is triggered, it can change up to 8 properties of another Actor.
Source code is included.

Usage for Mappers

Add the file "SBPropertyChangerV1.u" to your SYSTEM directory of UT; all other files of this package are optional and can be deleted.
Then add "SBPropertyChangerV1.u" to the Actor Class Browser, navigate to Actor > Triggers > SBPropertyChanger, add it to your map and set its properties in section PropertyChanger and its Tag as desired. Both array may contain gaps.
The SBPropertyChanger has to be activated by an Event; for example generated by a Trigger. If a target Actor could be not be found or a property could not be set, a warning is written to the log file.
See the Maps directory for an example.

Don't forget to add "SBPropertyChangerV1.u" to your package if you release your map to public.

Usage Details

All relevant settings are at "PropertyChanger":

Name	Data Type	Description
bTriggerOnceOnly	Boolean	As the name says: if TRUE, SBPropertyChanger only reacts on the first time triggered.
Properties[…]	Name	The names of the properties. Gaps are allowed. Not all properties of an Actor can be changed, for example const values (e.g. "Base") or members of an array are impossible to change.
PropertyValues[…]	String	The values of the properties. Although this data type is String, the string must represent the correct data type given by the property. If the data type does not match, the game engine tries to convert the string. If the property value could not be assigned literally, SBPropertyChanger writes a warning message to the log file. This may not be really an error, because for example if you assign "40" to a float property, the final value will be "40.000000". That's numerical the same but obviously not the same string value.
WantedActor	Name	The Actor which properties should be changed. This value is required. You can either enter the name of that Actor or the Tag of the Actor(s) (see WantedActorSearchBy below).
WantedActorSearchBy	`WASB_Name` or `WASB_Tag`	What does WantedActor mean: the name of the Actor (`WASB_Name`) or the Tag (`WASB_Tag`) of the Actor(s). Former can be used if only one Actor should be treated. If you want to look up the name, this Actor must of course already exist at mapping time. The latter is useful if you want treat more than one Actor or if the Actor(s) do not exist at mapping time.

Data Types

Boolean: Literally allowed values are "True" and "False". The case doesn't matter.
Name: Names may contain the letters A to Z, both upper and lowercase, the numbers 0 to 9, the underscore character _, the hyphen character -, and the space character. It may not exceed 63 characters.
string: Strings may contain any character (except the NULL character). The length is limited to 1023.

Special cases

Some properties can only be set with function calls, but not by assigning a value. I added support for setting the following properties:

CollisionRadius
CollisionHeight
bCollideActors
bBlockActors
bBlockPlayers

What you cannot do

Because the function SetPropertyText() is used for changeing values, arrays cannot be acessed. So changing the events of Dispatchers for example is not possible.
If this mutator is running on a server and you change settings that are not replicated, clients will not notice the change.
Const values can not be changed.

Examples

You want to finish a Thing- or CreatureFactory after a certain event: set the property Capacity of the factory to zero.
A Mover should be activated by damage, but not before a certain event? Set Mover's bDamageTriggered to true.
Play with Zone settings: change for example DamagePerSec, VPan, ZoneGravity, ...

About

Contact: SeriousBarbie AT googlemail MAKEADOT com

Changelog

SBPropertyChangerV1, Release 30 Mar 2020

introduced WantedActorSearchBy
removed Delay
added help (took longer than coding)

Filelist

Name	Size	Date	MD5 sum
./Help/SBPropertyChanger.htm	7047	2020-03-30	(this file>
./Help/SBPropertyChangerProperties.jpg	42355	2020-02-17	cd69a6298812608f13f1ceb05e7ea561
./Maps/TestSBPropertyChangerV1.unr	6098	2020-02-17	af2b0cdf877e7d799310b38b7bd5bd9b
./redirect/SBPropertyChangerV1.u.uz	3120	2020-02-17	58fc67fa44387e05647926e15f666298
./Sourcecode/Classes/SBPropertyChanger.uc	3563	2020-02-17	652a4c058541afadccc706ffef5cff47
./Sourcecode/make.ini	271	2020-02-14	f45a4eda401df9997524966ab8e4a9f0
./System/SBPropertyChangerV1.u	6822	2020-02-17	40270d667f08b6cbb63e2c07c9f69cb1

SBPropertyChangerV0, Release 10 Mar 2017

no public release

Filelist

Name	Size	Date	MD5 sum
./redirect/SBPropertyChangerV0.u.uz	2516	2017-03-10	777712592729c189197bb4b08afaf00a
./Sourcecode/Classes/SBPropertyChanger.uc	2665	2017-03-10	3fac0a7ff0dfd26854380c1d1705b354
./Sourcecode/make.ini	271	2017-03-08	1438907e06dbcd63b79d29750400712f
./System/SBPropertyChangerV0.u	5389	2017-03-10	b8fa331982e5c3fb70fbc9023e4c06ee