-
Notifications
You must be signed in to change notification settings - Fork 16
How to install the gamemode
Thank you for your interest in running Microgames in TF2 on your game server! This guide will assist you step by step in setting up the gamemode to run.
Please be aware that this gamemode will only work for Team Fortress 2 servers - a version of the gamemode for other Source Engine games is not planned or supported by gemidyne.
This guide assumes you have already installed MetaMod:Source and SourceMod (at least version 1.11).
The first step of the installation is to ensure that the gamemode's dependencies are installed. The following extensions / plugins must be installed and running in order to boot the gamemode:
-
SteamWorks: Required for changing the game description in the server browser.
- AM Thread: https://forums.alliedmods.net/showthread.php?t=229556
- Builds available at: https://github.com/hexa-core-eu/SteamWorks
- TF2Items: Download & follow the instructions at: https://forums.alliedmods.net/showthread.php?t=115100
- TF2Attributes: Required for weapons given by the gamemode. Download and install the latest release from: https://github.com/FlaminSarge/tf2attributes
- TFEconData: Required for weapons given by the gamemode. Download and install the latest release: https://github.com/nosoop/SM-TFEconData
- (Windows Only) host_timescale_fix: This plugin fixes an issue with host_timescale on Windows SRCDS installs. This plugin allows the timescale to be changed without serverside cheats being enabled. Download and install from: https://forums.alliedmods.net/showthread.php?t=324264
Once these have been installed and you see no errors in your SourceMod server error logs, then you can move onto the next step.
Navigate to https://github.com/gemidyne/microtf2/releases/latest. Download the warioware zip file and the BSP file to a folder on your computer.
Once downloaded, copy the BSP file to your gameserver's tf/maps folder.
If you have a fast download service enabled (sv_downloadurl), you should also upload the BSP file to that mirror. Once you've done that, compress to BZip2 (.bz2) format and place the bz2 file in tf/maps on your game server and your fast download server.
The gamemode's BSP map file contains all the sounds, textures and custom models required for running the gamemode. Players will only download this BSP file when joining the server - this means that downloading should be quicker, and keeps all gamemode assets "versioned" in a sense.
With the gamemode's map (BSP file) installed onto your game server, you now need to install the SourceMod plugin and it's data files.
Using the zip file you downloaded in the previous step, extract that to a new folder on your computer.
In the folder that you extracted the zip file to, you should now see a "tf" folder inside. Copy that "tf" folder to your gameserver, and merge it with your server's tf folder. It will place all plugin files where they need to be in order to run.
And with that, the gamemode should now be installed. Restart your game server, and keep an eye on the SourceMod error logs again to make sure no plugin or extension errors when starting up.
If you see no errors after the server has restarted, then change the map to the map BSP you downloaded earlier. If all goes well, if you join your game server now, you should be presented with a Waiting for players screen with music playing, showing instructions on how to play the gamemode. After the waiting for players timer hits 0:00, the first round should commence.
If you have issues running the gamemode, the first place to check is your tf/addons/sourcemod/logs folder on the gameserver.
Check the latest error log for any errors from the gamemode's plugin (AS-MicroTF2.smx). This should give you an indication to why the gamemode could not load or run.
If an extension is not loaded or running, the gamemode will log this as an error and not run.
However, if you have checked everything and there seems to be an error that you are unable to figure out, get in contact with us:
- Raise a GitHub issue: https://github.com/gemidyne/microtf2/issues/new?labels=support
- Contact us through Steam Community: https://steamcommunity.com/groups/gemidyne
- Tweet at us: https://twitter.com/gemidyne
Microgames in Team Fortress 2 is a project brought to you by Gemidyne. For more information, visit https://www.gemidyne.com/projects/microtf2