Description

This collection contains the Actor SBPropertyChanger for Unreal Tournament. 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 SBPropertyChangerV2.u to the SYSTEM directory of UT; all other files of this package are optional and can be deleted.
Then add SBPropertyChangerV2.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 arrays may contain gaps.

The SBPropertyChanger has to be activated by an Event; for example generated by a Trigger or the death of a ScriptedPawn.
If a WantedActor is not found or a property could not be set, a warning is written to the log file.
See Maps\TestSBPropertyChangerV2.unr for an example.

If you release your map to public don't forget to add the file SBPropertyChangerV2.u to your package and set bDebug to FALSE.

Usage Details

All relevant settings are at "PropertyChanger":

Name	Data Type	Default	Description
bDebug	Boolean	FALSE	Set to TRUE to get information in log file what is done.
bTriggerOnceOnly	Boolean	FALSE	As the name says: if TRUE, SBPropertyChanger only reacts on the first time triggered.
Properties[…]	Name	(empty)	The names of the properties. Gaps are allowed (and ignored) between array members. 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. See also Special Cases.
PropertyValues[…]	String	(empty)	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	(empty)	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`	`WASB_Name`	What does WantedActor mean: the Name of the one Actor (`WASB_Name`) or a Tag (`WASB_Tag`) of one or multiple Actors. Former can be used if only one Actor should be treated. If you want to look up the name with UnrealEd, 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. Also this variant should be slightly faster than looking up by name.

Data Types

Boolean: Literally allowed values are "True" and "False". The case doesn't matter.
Name: A Name 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: A String may contain any except the NULL character. The length is limited to 1023; on network games even less.

Special cases

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

bBlockActors
bBlockPlayers
bCollideActors
CollisionHeight
CollisionRadius
InitialState
Enable() and Disable(), use name of function for value)
GotoState(), use name of state for value)
Log() and Warn(), set the message as value

If you need other special handlings, let me know.

What you cannot do

Because the function SetPropertyText() is used for changing single ("scalar") values, arrays or vectors 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 to clients, they will not notice the change. This is a limitation of network play.
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.
You want to use the same SpawnPoints for different Factories? Set SpawnPoint's Tag to matching factory Tag before it is activated.
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, ZoneGroundFriction,
A monster should only take damage after some other things have happened? Set ReducedDamageType and ReducedDamagePct accordingly on an Event.

About

Contact: SeriousBarbie AT Barbies MAKEADOT World

Changelog

SBPropertyChangerV2, Release 16 Feb 2025

Main reason for changes was that SBPropertyChanger should be able to be added and controlled by code.

removed unnecessary CONST declaration for EWantedActorSearchBy
added function DebugOutput()
moved the check if 'WantedActor' is empty from event PostBeginPlay() to BeginState() of state 'ChangeProperties'

Filelist

Name	Size	Date	SHA1 hash
./Help/SBPropertyChanger.htm	11015	2025-02-16	(this file)
./Help/SBPropertyChangerProperties.jpg	42355	2020-02-17	9be1afd3d4698d0906b2b6bd803572ae4d26f059
./Maps/TestSBPropertyChangerV2.unr	7606	2024-08-18	6863363ffb265141ebe8ae77fd65df3e70ce23e5
./redirect/SBPropertyChangerV2.u.uz	5462	2024-09-20	f3502dcbe14b26712190db9f73be6f376987cce1
./Sourcecode/Classes/SBPropertyChanger.uc	7616	2024-09-20	3ea68cc8071528f833ca132de3b58d7d36e77d91
./Sourcecode/copyleft.txt	96	2025-02-16	02daefffdd3898e3512c19361e83fbfd41dfce71
./Sourcecode/make.ini	285	2024-07-26	ec667d982fa2c5883ef79134911534b397e90acc
./Sourcecode/readme.txt	82	2016-08-21	1cbd672638085e4b53142ebdd86454b23e79cb69
./System/SBPropertyChangerV2.u	14229	2024-09-20	03bbe75236cc122a83bf64e1e22f63266809ef05

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	447985ae53b20b5177115fbbce8bf85b
./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