Node UTStats 2

Unreal Tournament stats tracking website using node.js and mysql.

Important Change

• From Version 2.8.0 and onwards Node UTStats 2 is not compatible with previous versions, running node upgrade will not work.

Current Features

• Match reports
• Player Match reports
• Player profiles
• Ranking system
• Records system
• Maps system
• Cap records for ctf maps
• User Accounts (in future builds you will be able to save matches, players to your favourites for easy tracking)
• Admin management system, change what the site displays and how it's displayed. You can also give a user permission to upload map images
• ACE support
• SFTP Support
• Basic ACE HWID

Current Supported Gametypes

• Deathmatch
• Team Deathmatch
• Capture The Flag
• Domination
• Assault
• Last Man Standing
• MonsterHunt
• CTF4

Thanks to

• Many thanks to the original creators of the UTStats mutators azazel, )°DoE°(-AnthraX and toa
• Thanks to Krull0r for the Monster Icons.

Requirements

• Node.js 14.17 or greater.
• Mysql

Install

• Extract the contents of the archive into a folder.
• Open command prompt in the folder.
• Run the command npm install to install all the dependencies.
• Open config.json, and change the mysql settings to match your mysql setup.
• Also in config.json you will see the variable called importInterval, this will tell the importer how long to wait(in seconds) between looking for new logs to import. IF you set this to 0 the import will run once only.
• Now run the command node install this will create the database and all the tables needed by node utstats 2.

Install Unreal Tournament mutators

• Go to the Mutators folder of the nodeutstats2 archive.
• Copy the contents to your UnrealTournament system's folder.
• Now open your UnrealTournament server's UnrealTournament.ini and find the block [Engine.GameEngine].
• Now add the following line at the bottom of the block:

ServerPackages=UTSAccuBeta4_2
ServerActors=UTStatsBeta4_2.UTStatsSA
ServerActors=NodeUTStats2.NodeUTStatsServerActor

• In the same file under the block [Engine.GameInfo], make sure bLocalLog is set to false like this bLocalLog=False.
• If you are running UT469A, or UT469B on your server, check the block [Engine.StatLog] and make sure WorldLogDir is set to ../Logs(There was a bug where it was set to blank making the logs being written to the root directory of the drive)
• Restart your UnrealTournament server if it's running

Starting the website

• You have two options of running the website, development mode(slow, but easier for debugging) or production mode.
• To run in development mode open command prompt in the installed folder and run the command npm run dev
• To run in production mode run the following commands in this order, npm run build this will create the production version of the website(will take a few seconds), once that has finished run the command npm run start to run the production website.
• Open http://localhost:3000 with your browser to see the result.
• If you have enabled classic mode you will find it http://localhost:3000/classic

Creating an admin account

• If there are no users in the database, create an account by going to the site's login page, then press the "Not a member? Register now!" button, the next created account will automatically set to admin, and will be activated.

Adding S/FTP servers

• FTP accounts require read, write, and delete privileges.
• To add FTP servers to node utstats 2, go to the admin area of the website, then "Importer Manager", then finally "Add Server", there is no limit in the amount of servers you can add.
• Target Folder must link to your UnrealTournament main folder(CASE SENSITIVE), e.g /Servers/UnrealTournament/ for an FTP user with entry point of C:/
• You can later edit settings if required.

Running the importer

• Go to the folder you installed node utstats 2
• Open command prompt, type node importer to start the import process(you can put stat logs in the /Logs folder to skip the ftp download).
• Once completed you should see on your website new matches & players being displayed in their respected pages.

NexgenStatsViewer Support

• There are many more data types to be displayed instead of the standard top player rankings for each gametype, you can create lists in the admin control panel.
• To setup nexgenstatsviewer to work with Node UTstats 2 you must edit/add the following to Nexgen.ini in your UnrealTournament/System folder

[NexgenStatsViewer105.NSVConfigExt]
lastInstalledVersion=105
enableUTStatsClient=True
utStatsHost=localhost
utStatsPort=3000
utStatsPath=/api/nexgenstatsviewer

Experimental IPToCountry Support

To add this feature to your server add the following entries in IpToCountry.ini in your UnrealTournament system folder.

• QueryServerHost 127.0.0.1(The ip you host node utstats on)
• QueryServerFilePath /api/iptocountry
• QueryServerPort 3000(The port node ustats site uses)

Setting up ACE

• By default ACE doesn't save player information to log files, to get the most out of this module you will have to change a few lines in UnrealTournament.ini so ACE will save player information that will help admins ban trouble makers.
• Find the ACE section in UnrealTournament.ini [ACEvXXX_S.ACEActor].
• Now find the following lines and change them to the following

bExternalLog=true
bExternalLogJoins=true
JoinLogPath=../Logs/
JoinLogPrefix=ACE_JOIN