Description

This package for Unreal Tournament (UT99) contains the Mutator SBFactoryMonsterCounter and an extended counter.

Mutator

Before game starts, this mutator iterates over all ThingFactories and its sub classes and checks, if their Prototype is a Pawn. If so, an existing counter for that factory is searched. If a counter is found and its message is empty or has its default value, it is set to my default message (see below). If its message is deactivated, it is activated. If no counter is found, an Extended Counter is spawned. The counter's NumToCount and Prototype is set to the ThingFactory values.

All Mutator's parameters in a nut shell

These settings are stored in the file .\System\SBFactoryMonsterCounter.ini:

Name	Values	Default	Description
bActive	true \| false	true	Set to FALSE to deactivate the mutator. Use it to disable this mutator temporarily.
bUseLogTimeStamp	true \| false	true	Add a time stamp in front of every log message?
CompleteMessage		%ps are history now!	"%p" will be replaced by the Pawn's class name.
CountMessage		Only %i more %p to go...	"%i" will be replaced by the amount, "%p" by the Pawn's class name.
DontTreatTheseFactories	A list of maximum 32 factories that should be ignored. Details see Factory Exceptions.
LogLevel	see LogLevel	LOG_Info	See LogLevel.

Factory Exceptions

You can exclude factories from adding a counter, for example, if a special custom factory is used that adapts the capacity to the player count at run time. Therefore you add the map name and the factory name the list DontTreatTheseFactories. Example:


DontTreatTheseFactories[0]=(MapName="ExampleMap",FactoryName="ExampleFactory123")

Default value is


DontTreatTheseFactories[0]=(MapName="MH-RoguesV4",FactoryName="")

(MH-RoguesV4 has only custom "ScalingCreatureFactories" and therefore all factories should be ignored.)

Nota bene:

The map name must be without the extension .unr.
The list may contain gaps.
All names are case insensitive.
If MapName is set but FactoryName is an empty string, ALL factories in that map are ignored - the mutator does nothing in this map.
If MapName is empty and FactoryName set to a factory class name, all these factories are always skipped.

LogLevel

Play with the Log level to see what is going on. Possible values and their meanings are:

LOG_None	Don't log anything. Not recommended.
LOG_Error	Log errors only. (An error prevents the code to continue.)
LOG_Warning	Log warnings also. (A warning is issued when an unexpected circumstance occur but the operation will not being compromised.)
LOG_Info	Additional information of what has happend is logged.
LOG_Debug	Additional information of what has NOT happend is logged. Use this to track down bugs.
LOG_All	All logging is send to the log file. For example if a special code block is entered or left.

ExtendedCounter

The most important differences of the new Counter to the stock Counter of the package 'Engine' are:

Supports until 2^31 (=2147483648, Data type 'int') counts instead of 2^8 (=256, data type 'byte').
The first n counter events can be skipped.
It can filter events by its Prototype.

A complete documentation of SBCounter is included in the archive.

Installation (Client and Server)

Put the files
.\System\SBFactoryMonsterCounterV1.u
.\System\SBCounterV5.u
.\System\SBFactoryMonsterCounter.ini
.\System\SBFactoryMonsterCounter.int
into the System directory of your UT installation. Change the values in file SBFactoryMonsterCounter.ini to your needs. Documentation can also be found in there.

Installation on a Server

Add SBFactoryMonsterCounterV0.SBFactoryMonsterCounter to the chain of your mutators. Details depends on your server configuration and addons.
An entry in ServerPackages is not needed, the mutator works on server side only.

Installation on a Client

Start UT and choose the Mutator "SBFactoryMonsterCounter V1" for a local game.

About

This package was created by Barbie.
Contact: SeriousBarbie AT barbies DOT world

Copyright

This package is copyleft - do whatever you want.

Changelog

SBFactoryMonsterCounterV1, 22 Apr 2024

If a SBCounter already exists for a factory, it will be skipped.
If the message of an existing counter is counter's default, it is set to my defaults.
if a DontTreatTheseFactories has an empty map name but a none empty factory name, it is interpreted as a factory class name that will be ignored for all maps.
Improved and optimized the debug messages.
Using SBCounterV5.

Filelist

Name	Size	Date	MD5 sum
./Help/SBCounter.htm	8956	2020-11-14	c9d46de4a071afd51479b919040c2b20
./Help/SBCounterPic.gif	1351	2016-06-03	94c403ea78604cfb8dd54d1fcff24cf6
./Help/SBCounterProperties.jpg	28415	2020-06-24	4a2dd9463478fc26be7d2a7a84d27277
./Help/SBFactoryMonsterCounter.htm	10274	2024-04-23	(this file)
./Sourcecode/Classes/SBFactoryMonsterCounter.uc	11403	2022-06-28	e29110f54efd2abf457fc6a0f59d97d5
./Sourcecode/make.ini	330	2022-07-04	4e4cf6b50f25db2e11bde6e375424ea8
./Sourcecode/readme.txt	69	2016-01-09	65e1642a4cd5f397e424d0521cca2d42
./System/SBCounterV5.u	12711	2022-07-04	8e0221ea1c1d918ce4e95309b5d873de
./System/SBFactoryMonsterCounter.ini	1363	2024-04-22	650e62d37ccacbfc5294e82bc253e5b6
./System/SBFactoryMonsterCounter.int	195	2021-08-06	a0cba4c82856cc1bcde45f476ed285c1
./System/SBFactoryMonsterCounterV1.u	20312	2022-07-04	82198a1582509d3924fcdb7783891c0b

SBFactoryMonsterCounterV0, 14 Jul 2020

first release

Filelist

Name	Size	Date	MD5 sum
./Help/SBCounter.htm	7559	2020-06-24	5b51ae5c0f35ddd94267ba08184f657c
./Help/SBCounterPic.gif	1351	2016-06-03	94c403ea78604cfb8dd54d1fcff24cf6
./Help/SBCounterProperties.jpg	28415	2020-06-24	4a2dd9463478fc26be7d2a7a84d27277
./Help/SBFactoryMonsterCounter.htm	7885	2020-07-14	8319680bddc1a35b920e684639b4d865
./redirect/SBFactoryMonsterCounterV0.u.uz	6442	2020-06-14	5bd21c03a2b267982e4c4ce40d969a78
./Sourcecode/Classes/SBFactoryMonsterCounter.uc	9617	2020-06-14	d02f07ea24f120669e0dad87a1607e61
./Sourcecode/make.ini	330	2020-06-09	58d6a63fe1dae4eb33cb674231f4ef4d
./System/SBCounterV3.u	10756	2020-06-24	44250782597e52cdc12fbde0b87c0ef6
./System/SBFactoryMonsterCounter.ini	1160	2020-07-14	c6d50ee359608d7845253dd6457df668
./System/SBFactoryMonsterCounter.int	195	2020-06-17	f370e29e4bb40e4568dca21f4147d523
./System/SBFactoryMonsterCounterV0.u	17182	2020-06-14	d7d31f6a20a4f7a4c666dfaa915840a7