Skip to content

How to install the gamemode

Safalin edited this page May 29, 2024 · 12 revisions

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.

Preparing your gameserver

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).


Installing prerequisites

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:

Once these have been installed and you see no errors in your SourceMod server error logs, then you can move onto the next step.


Getting the latest version of the gamemode & installing the map BSP file

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.


Installing the gamemode plugin & data files

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.


Help & Support

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: