KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #ai-agent #developer-tools #codex #typescript #cli #deepseek-harness #claude-code #ai-agents #mcp #rust

microtf2

★ 33 Open GitHub ↗

A custom gamemode for Team Fortress 2 - Players compete against each other to get the most points by playing a series of rapid fire microgames in order to win the round!

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Microgames in TF2 // microtf2

A custom gamemode for Team Fortress 2 - Players compete against each other to get the most points by playing a series of rapid fire microgames in order to win the round!

![GitHub Downloads (all assets, all releases)](https://img.shields.io/github/downloads/gemidyne/microtf2/total) ![GitHub Actions Workflow Status](https://img.shields.io/github/actions/workflow/status/gemidyne/microtf2/ci.yml)

This repository is currently in read-only mode. PRs to fix bugs are appreciated however we recommend forking the repo - v6.0 is the last official gemidyne release version of the gamemode.

The master branch contains code for v6.x of the gamemode. The v5 branch contains code for v5.x of the gamemode and was branched prior to merging v6 dev into master.

## How to install the gamemode
We have created an install guide to help you install the gamemode - see wiki page here: https://github.com/gemidyne/microtf2/wiki/How-to-install-the-gamemode

## Commands 
See wiki page for more information: https://github.com/gemidyne/microtf2/wiki/Console-Commands

## Console Variables
See wiki page for more information: https://github.com/gemidyne/microtf2/wiki/Console-Variables

## Repository info

The /src folder contains the plugin source-code. 
The /assets folder contains data relating to the map, plugin overlays and sounds. It is strongly recommended that you use https://www.gemidyne.com/projects/tsukuru/ to build the map and pack in the necessary assets.

The "master" branch is the latest stable version of the gamemode. We recommend you use this branch on your game servers.
The "dev" branch is used for the latest development version of the gamemode. This branch contains work in progress projects so may be uncompilable, untested and not be the best experience for your players. We recommend you use the master branch over the dev branch.

## SourceMod Extension / Plugin Dependencies

The gamemode utilises the following extensions and plugins to run:

- SDKHooks extension (2.1 or above)
- SteamWorks extension - https://forums.alliedmods.net/showthread.php?t=229556 (Used for setting the game description)
- TF2Items extension - https://forums.alliedmods.net/showthread.php?t=115100 (Used for blocking wearables)
- TF2Attributes plugin - https://github.com/FlaminSarge/tf2attributes (Used for applying attributes to weapons)
- TFEconData plugin - https://github.com/nosoop/SM-TFEconData (Used for giving weapons to players)
- (Windows only) host_timescale_fix plugin - https://forums.alliedmods.net/showthread.php?t=324264 (Fixes a host_timescale issue only on Windows SRCDS installs. Not required if you are running the gamemode on Linux)

If you intend to use the SDK plugin for developing your own gamemodes or minigames, you will need:

- Sound Info Library extension: https://forums.alliedmods.net/showthread.php?t=105816   https://github.com/bcserv/soundlib (Used for determining sound file length for themes and minigames)

## Map Development

The map's master VMF file lives in /assets/warioware_redux_master.vmf - we use https://www.gemidyne.com/projects/tsukuru/ to build dev & release versions of the map and pack in data. You can import our map compile settings into Tsukuru by importing the warioware_redux_master.tsumc in the /assets/ folder - and then fix the file paths to be correct for your repository path.

Our workflow for dev maps / release maps is to pack all necessary data into the BSP file, and then repack the BSP file. You can do all this by using Tsukuru. Packing all sounds, textures, models into the BSP file and repacking it means players will only need to download a single file to play the gamemode.

We use [Hammer++](https://ficool2.github.io/HammerPlusPlus-Website/index.html) for map development, as this version of Hammer has many fixes over the stock version of Hammer bundled with TF2.

# Contributing

## Testing

We appreciate your interest in wanting to help test the gamemode. We have a tester group on Steam Community where we will be communicating test sessions. The group chat within this steam group is where we will communicate upcoming test sessions due to Steam's broken event functionality.

[Steam Group](https://steamcommunity.com/groups/microtf2_testers)

[Join Steam Group Chat](https://steamcommunity.com/chat/invite/FuU64wth)

## Translations

We'd love to have you on board! If you are interested in contributing translations, there are two ways you can do it:

1. We can add you onto our gemidyne.com Translator Tool which makes editing translations super quick and easy - [click this link](https://github.com/gemidyne/microtf2/issues/new/choose) and choose **Become a translator**. Once submitted we will add your Steam ID onto our tool and you will be able to add and edit your translations. If you ever lose the link to the translator tool, it is hosted at: https://translator.gemidyne.com/ 
2. You can add your own language "microtf2.phrases.txt" file built from the english file into your own translation folder - this way is more manual but you can contribute via pull requests if you want

#### We currently have translators for the following languages:

- [X] French
- [X] Italian
- [X] Spanish
- [X] Russian
- [X] Portuguese
- [X] Brazilian Portuguese
- [X] Polish
- [X] German
- [X] Korean

## Credits

View the full gamemode credits here: https://www.gemidyne.com/projects/microtf2/credits

#### Disclaimer
Microgames in Team Fortress 2 is a fan project and is strictly not for profit. All logos and brands are property of their respective owners.

microtf2

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README