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, it is set to the default message. If its message is deactivated, it is activated. If no counter is found, an Extended Counter is spawned. The counter's NumToCount is set to the Capacity of the ThingFactory, and Counter's Prototype is set accordingly.

All Mutator's parameters in a nut shell

These settings are stored in the file .\System\SBFactoryMonsterCounterV0.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.
The names are case insensitive.
If you set FactoryName to an empty string, ALL factories are ignored - the mutator does nothing in this case.

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\SBFactoryMonsterCounterV0.u
.\System\SBCounterV3.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 V0" for a local game.

About

This package was created by Barbie.
Contact: SeriousBarbie at googlemail dot com

Copyright

This package is copyleft - do whatever you want.

Changelog

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	(this file)
./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