{"id":24128354,"url":"https://github.com/rattlesn4k3/ut3-mutator-botbalancer","last_synced_at":"2026-03-08T14:34:12.671Z","repository":{"id":28240387,"uuid":"31745535","full_name":"RattleSN4K3/UT3-Mutator-BotBalancer","owner":"RattleSN4K3","description":"Mutator which balances the teams for bots based on set conditions","archived":false,"fork":false,"pushed_at":"2018-02-18T16:00:52.000Z","size":186,"stargazers_count":1,"open_issues_count":0,"forks_count":1,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-01-11T18:51:40.110Z","etag":null,"topics":["balance","bot","game","player","skill"],"latest_commit_sha":null,"homepage":"","language":"UnrealScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/RattleSN4K3.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGES.txt","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-03-06T01:04:29.000Z","updated_at":"2018-02-18T16:12:33.000Z","dependencies_parsed_at":"2022-09-04T13:01:01.722Z","dependency_job_id":null,"html_url":"https://github.com/RattleSN4K3/UT3-Mutator-BotBalancer","commit_stats":null,"previous_names":[],"tags_count":21,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RattleSN4K3%2FUT3-Mutator-BotBalancer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RattleSN4K3%2FUT3-Mutator-BotBalancer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RattleSN4K3%2FUT3-Mutator-BotBalancer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RattleSN4K3%2FUT3-Mutator-BotBalancer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/RattleSN4K3","download_url":"https://codeload.github.com/RattleSN4K3/UT3-Mutator-BotBalancer/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241315123,"owners_count":19942785,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["balance","bot","game","player","skill"],"created_at":"2025-01-11T18:50:30.214Z","updated_at":"2026-03-08T14:34:12.619Z","avatar_url":"https://github.com/RattleSN4K3.png","language":"UnrealScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"BotBalancer\r\n==========================\r\n\r\nA mutator for **Unreal Tournament 3** which balances the teams based on set conditions (Players vs. Bots, Bot-ratio, Map recommended players, ...).\r\n\r\n\r\n# Install\r\n\r\n - Download the [lastest version](/../../releases/latest)\r\n - Extract the zip file to your UT3 folder. For instance:  \r\n  `%userprofile%\\Documents\\My Games\\Unreal Tournament 3\\UTGame`  \r\n  or manually move the content to the following subfolders:\r\n- `UTBotBalancer.ini` to `.\\Config`\r\n- `BotBalancer.u` to `.\\Published\\CookedPC\\Script`\r\n- `BotBalancer.int` to `.\\Published\\CookedPC\\Localization`\r\n\r\n\r\n# Usage\r\n\r\n__Method 1:__\r\n - Start the game\r\n - Add the following mutator: `BotBalancer`\r\n - Enjoy.\r\n\r\n__Method 2:__\r\n - Add the following line to the command line arguments (or your shortcut, server command line, ...):  \r\n   `?mutator=BotBalancer.BotBalancerMutator`\r\n - **Note:** Split multiple mutators by the character `,` (*comma*)\r\n   \r\n__Method 3:__\r\n - Open the *WebAdmin* interface\r\n - Navigate to the following address `/ServerAdmin/current/change`\r\n - Enable `BotBalancer`\r\n - Click *Change game*\r\n - After the reload, the mutator will be active.\r\n\r\n\r\n# Compiling\r\n\r\nThe mutator comes with all the needed files. Before the code can be compiled, the engine must be aware of the installed source files and the source files must be placed into the correct folder.\r\n\r\n## Setup\r\n\r\nFor easy referencing, `%basedir%` would be the local profile folder `%userprofile%\\Documents\\My Games\\Unreal Tournament 3\\UTGame`\r\n\r\n- Download the [latest source files](/../../archive/master.zip)\r\n- Extract the zipped source files\r\n- Create a folder named `BotBalancer` into the source folder `%basedir%\\Src`\r\n- Copy/symlink the **`Classes`** folder of the source files into `%basedir%\\Src\\BotBalancer`\r\n  (if the source folder is not already extracted into `%basedir%\\Src`)\r\n- Copy/symlink `Config\\UTBotBalancer.ini` to `%basedir%\\Src\\Config`\r\n- Copy/symlink `Localization\\BotBalancer.int` to **both** folders:  \r\n - `%basedir%\\Published\\CookedPC\\Localization`\r\n - `%basedir%\\Unpublished\\CookedPC\\Localization`\r\n\r\nAnd finally add the package to the compiling packages of the engine.\r\n\r\n- Open `%basedir%\\Config\\UTEditor.ini`\r\n- Search for the section `[ModPackages]`\r\n- Add **`ModPackages=BotBalancer`** at the end of the section\r\n(before the next section starts)\r\n\r\n## Make\r\n\r\nThe script files contain several lines of debug code. The code can be compiled in two ways which one would strip any of these debug lines from the code - this would be the *final release* mutator.\r\n\r\n### Debug \r\n\r\n- Compile the packages with:\r\n`ut3 make -debug`\r\n\r\n\r\n### Final release\r\n\r\n- Compile the packages with:\r\n`ut3 make -final_release`\r\n\r\n## Testing\r\n\r\nCopy/move `%basedir%\\Unpublished\\CookedPC\\Script\\BotBalancer.u` to the public script folder `%basedir%\\Published\\CookedPC\\Script\\` and run the game.\r\n\r\nWithout copying/moving the file, the game must be started with the *UseUnpublished* command line argument:\r\n`ut3 -useunpublished`\r\n\r\n\r\n# License\r\nAvailable under [the MIT license](http://opensource.org/licenses/mit-license.php).\r\n\r\n# Author\r\nRattleSN4K3\r\n\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frattlesn4k3%2Fut3-mutator-botbalancer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frattlesn4k3%2Fut3-mutator-botbalancer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frattlesn4k3%2Fut3-mutator-botbalancer/lists"}