KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

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

Town-Of-Us

★ 879 Open GitHub ↗

An Among Us mod containing a bunch of roles

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

## *Note. This repository is depricated in favour of Polus.gg, and is now read-only as it will not be recieving updates. Please visit our [steam page](https://store.steampowered.com/app/1653240/Polusgg/) and our [discord](https://discord.gg/polus) for all updates**

[![Discord](https://raw.githubusercontent.com/slushiegoose/Town-Of-Us/master/Images/Polus.png)](https://discord.gg/polus)

![LOGO](https://raw.githubusercontent.com/slushiegoose/Town-Of-Us/master/Images/TOU-logo.png)
![Roles](https://raw.githubusercontent.com/slushiegoose/Town-Of-Us/master/Images/Roles3.png)

An Among Us mod that adds a bunch of roles, modifiers and game settings

**Crewmate Roles**
- [Mayor](#mayor)
- [Lovers](#lovers)
- [Sheriff](#sheriff)
- [Engineer](#engineer)
- [Swapper](#swapper)
- [Investigator](#investigator)
- [Time Lord](#time-lord)
- [Medic](#medic)
- [Seer](#seer)
- [Spy](#spy)
- [Snitch](#snitch)
- [Altruist](#altruist)

**Neutral Roles**
- [Jester](#jester)
- [Shifter](#shifter)
- [The Glitch](#the-glitch)
- [Executioner](#executioner)
- [Arsonist](#arsonist)
- [Phantom](#phantom)

**Impostor Roles**
- [Janitor](#janitor)
- [Morphling](#morphling)
- [Camouflager](#camouflager)
- [Miner](#miner)
- [Swooper](#swooper)
- [Assassin](#assassin)
- [Underdog](#underdog)
- [Undertaker](#undertaker)

**Modifiers**
- [Torch](#torch)
- [Diseased](#diseased)
- [Flash](#flash)
- [Tiebreaker](#tiebreaker)
- [Drunk](#drunk)
- [Giant](#giant)
- [Button Barry](#button-barry)

-----------------------
# Releases
| Among Us - Version| Mod Version | Link |
|----------|-------------|-----------------|
| 2021.6.30s & 2021.6.30e & 2021.7.20e | v2.2.1 | [Download](https://github.com/polusgg/Town-Of-Us/releases/download/v2.2.1/TOU_221.zip) |
| 2021.6.30s & 2021.6.30e & 2021.7.20e | v2.2.0 | [Download](https://github.com/polusgg/Town-Of-Us/releases/download/v2.2.0/TOU_220.zip) |
| 2021.6.15s & 2021.6.15e | v2.1.4 | [Download](https://github.com/polusgg/Town-Of-Us/releases/download/v2.1.4/TOU_214.zip) |
| 2021.6.15s & 2021.6.15e | v2.1.3 | [Download](https://github.com/polusgg/Town-Of-Us/releases/download/v2.1.3/TownOfUs213_1.zip) |
| 2021.6.15s & 2021.6.15e | v2.1.2 | [Download](https://github.com/polusgg/Town-Of-Us/releases/download/v2.1.2/TownOfUs212_1.zip) |
| 2021.6.15s & 2021.6.15e | v2.1.1 | [Download](https://github.com/polusgg/Town-Of-Us/releases/download/v2.1.1/TownOfUs211_1.zip) |
| 2021.5.10s | v2.0.4 | [Download](https://github.com/polusgg/Town-Of-Us/releases/download/v2.0.4/TownOfUs-v2.0.4.zip) |
| 2021.5.10s | v2.0.3 | [Download](https://github.com/polusgg/Town-Of-Us/releases/download/v2.0.3/TownOfUs-v2.0.3.zip) |
| 2021.4.12s & 2021.4.14s | v2.0.2 | [Download](https://github.com/polusgg/Town-Of-Us/releases/download/v2.0.2/TownOfUs-v2.0.2.zip) |
| 2021.4.12s | v2.0.1 | [Download](https://github.com/polusgg/Town-Of-Us/releases/download/v2.0.1/TownOfUs-v2.0.1.zip) |
| 2021.3.31.3s | v2.0.0 | [Download](https://github.com/polusgg/Town-Of-Us/releases/download/v2.0.0/TownOfUs-v2.0.0.zip) |
| 2021.3.5s | v1.2.0 | [Download](https://github.com/polusgg/Town-Of-Us/releases/download/v1.2.0/TownOfUs-v1.2.0.zip) |
| 2021.3.5s | v1.1.0 | [Download](https://github.com/polusgg/Town-Of-Us/releases/download/v1.1.0/TownOfUs-v1.1.0-2021.3.5s.zip) |
| 2020.12.19s | v1.1.0 | [Download](https://github.com/polusgg/Town-Of-Us/releases/download/v1.1.0/TownOfUs-v1.1.0-2020.12.9s.zip) |
| 2020.12.19s | v1.0.3 | [Download](https://github.com/polusgg/Town-Of-Us/releases/download/v1.0.3/TownOfUs-v1.0.3.zip) |
| 2020.12.19s | v1.0.2 | [Download](https://github.com/polusgg/Town-Of-Us/releases/download/v1.0.2/TownOfUs-v1.0.2.zip) |
| 2020.12.19s | v1.0.1 | [Download](https://github.com/polusgg/Town-Of-Us/releases/download/v1.0.1/TownOfUs-v1.0.1.zip) |
| 2020.12.19s | v1.0.0 | [Download](https://github.com/polusgg/Town-Of-Us/releases/download/v1.0.0/TownOfUs-v1.0.0.zip) |

<details>
 <summary> Changelog </summary>
 <details>
 <summary> v2.2.1 </summary>
 <ul> <li>Fix for the credits removed in v2.0.3 </li> </ul>
 </details>
 <details>
 <summary> v2.2.0 </summary>
 <ul> <li> Compatibility for v2021.6.30 </li> </ul>
 <ul> <li> Role percentages now change by 10%, or 5% if you hold shift </li> </ul>
 <ul> <li> New Drag/Drop Buttons for the Undertaker </li> </ul>
 <ul> <li> New Button Image for the Button Barry </li> </ul>
 <ul> <li> Phantom can't switch between vents </li> </ul>
 <ul> <li> Increased Max Cooldown for the Shifter to 60s </li> </ul>
 <ul> <li> Swapper can no longer get the Button Barry Modifier </li> </ul>
 <ul> <li> Glitch can no longer get the Button Barry Modifier </li> </ul>
 <ul> <li> Mayor votes are refunded if the player disconnects </li> </ul>
 <ul> <li> Mayor votes are refunded if the player is killed by the assassin </li> </ul>
 <ul> <li> Handshake refactor </li> </ul>
 <ul> <li> Fix for the Crashing Issues </li> </ul>
 <ul> <li> Fix for the Interaction Shifter/Giant </li> </ul>
 <ul> <li> Fix for the Interaction Shifter/Engineer </li> </ul> 
 <ul> <li> Fix for the Interaction Glitch/Jester </li> </ul>
 <ul> <li> Fix for the Interaction Morphling/Giant </li> </ul>
 <ul> <li> Fix for the Altruist Body Issues </li> </ul>
 <ul> <li> Fix for the Assassin DC Issues </li> </ul>
 <ul> <li> Fix for the Executioner Spawn Issues </li> </ul>
 <ul> <li> Fix for the Phantom Vent Spawn Issues </li> </ul> 
 <ul> <li> Fix for the Phantom Walking Through Walls Issues </li> </ul>
 <ul> <li> Fix for the Phantom Doors Issues </li> </ul>
 <ul> <li> Fix for the Phantom Tasks Issues </li> </ul>
 <ul> <li> Fix for the Swooper Invisible Issues </li> </ul> 
 <ul> <li> Fix for the Time Lord Flashing Ability Issues </li> </ul>
 <ul> <li> Fix for the Time Lord Rewind Vent Issues </li> </ul>
 <ul> <li> Fix for the Undertaker Dragging Issues </li> </ul> 
 <ul> <li> Fix for the Underdog Cooldown Issues </li> </ul>
 <ul> <li> Fix for the Giant Modifier Size Issues </li> </ul>
 <ul> <li> Fix for the State Of Dead/DC Bodies In Meeting Issues </li> </ul> 
 <ul> <li> Fix for the Voting Visual Issues </li> </ul> 
 <ul> <li> Minor enhancements and bug fixes </li> </ul>
 </details>
 <details>
 <summary> v2.1.4 </summary>
 <ul> <li> New Role (Phantom, Undertaker, Underdog) </li> </ul>
 <ul> <li> Custom Color </li> </ul>
 <ul> <li> Hats </li> </ul>
 <ul> <li> Fix for launching issues </li> </ul>
 <ul> <li> Fix for the Voting issues </li> </ul>
 <ul> <li> Fix for the disconnect issue</li> </ul>
 <ul> <li> Fix for the username placement </li> </ul>
 <ul> <li> Fix for the Medic </li> </ul>
 <ul> <li> Fix for the Spy </li> </ul>
 <ul> <li> Fix for the Mayor </li> </ul>
 <ul> <li> Fix for the Arsonist </li> </ul>
 <ul> <li> Fix for the Assassin </li> </ul>
 <ul> <li> Fix for the Phantom </li> </ul>
 <ul> <li> Modded Handshake </li> </ul>
 <ul> <li> Child is removed </li> </ul>
 <ul> <li> Minor enhancements and bug fixes </li> </ul>
 </details>
 <details>
 <summary> v2.1.3 </summary>
 <ul> <li> Fix the launch issue </li> </ul>
 <ul> <li> Fix for the swooper role </li> </ul>
 <ul> <li> Fix for the janitor role </li> </ul>
 <ul> <li> Minor enhancements and bug fixes </li> </ul>
 </details>
 <details>
 <summary> v2.1.2 </summary>
 <ul> <li> Crucial bug fixes </li> </ul>
 </details>
 <details>
 <summary> v2.1.1 </summary>
 <ul> <li> 2021.6.15 support, Epic Games compatibility and Assassin Role </li> </ul>
 </details>
 <details>
 <summary> v2.0.4 </summary>
 <ul> <li> Crucial bug fixes </li> </ul>
 </details>
 <details>
 <summary> v2.0.3 </summary>
 <ul> <li> 2021.5.10s support </li> </ul>
 </details>
 <details>
 <summary> v2.0.2 </summary>
 <ul> <li> 2021.4.14s support and temporary auth fixes </li> </ul>
 </details>
 <details>
 <summary> v2.0.1 </summary>
 <ul> <li> 2021.4.12s support </li> </ul>
 </details>
 <details>
 <summary> v2.0.0 </summary>
 <ul>
 <li> Airship support! </li>
 <li> New role - Altruist </li>
 <li> New modifiers - Giant & Button Barry </li>
 <li> Airship comms fix built-in </li>
 <li> Bug fixes with Lovers, Time Lord etc. </li>
 <li> New hats based on streamers! </li>
 <li> Investigator cannot spawn on airship due to too much lag with handling footprints </li>
 </ul>
 </details>
 
 <details>
 <summary> v1.2.0 </summary>
 <ul>
 <li> New roles (see above)</a>
 <li> New modifiers (see above)</li>
 <li> Exporting and Importing game settings which sync between versions 1.2.0 and future versions</li>
 <li> Disconnect fix </li>
 <li> Mayor additions - Abstain button, Option for Mayor's extra votes to be anonymous </li>
 <li> Option for dead to see the roles of everyone </li>
 <li> Custom colours now work! </li>
 </ul>
 </details>
 <details>
 <summary> v1.1.0 </summary>
 <ul>
 <li> New roles (see above)</a>
 <li> New modifiers (see above)</li>
 <li> The Engineer has been changed to the <a href="https://github.com/NotHunter101/ExtraRolesAmongUs">ExtraRoles</a> version </li>
 <li> Backend overhaul! This will make it easier to add new roles </li>
 <li> New Button Art! </li>
 <li> Maps and Impostor Count can be changed from the Lobby! </li>
 <li> Shadows for the Custom Colours </li>
 <li> Fixes </li>
 <ul>
 <li> The Jester and The Shifter unable to fix Sabotages </li>
 <li> The Time Lord's Rewind not auto-force closing tasks </li>
 <li> The Q button not working for Sheriff </li>
 <li> The Shifter's Shift looking too much like a Kill </li>
 <li> Changing colours would render you weirdly green in normal Among Us </li>
 </ul>
 </ul>
 </details>

<details>
 <summary> v1.0.3 </summary>
 Fixes: 
 <ul>
 <li> Engineer being able to Fix every sabotage </li>
 <li> The Investigator being able to revive people voted out (and instead made it an option) </li>
 <li> Footprints not appearing if a person walks over old footprints </li>
 <li> Graphical glitch where Jester and Lovers simultaneously win </li>
 <li> Players spawning back into positions from the last game when time is rewound right at the beginning of a new game </li>
 <li> Graphical Bug of Time Lord's name not being blue in Meetings </li>
 <li> Fixed Medbay Scan not working for custom colours </li>
 </ul>
 </details>

<details>
 <summary> v1.0.2 </summary>
 Fixes: 
 <ul>
 <li> The Swapper being unable to vote </li>
 Swapper unable to vote
 <li> Mayor Vote Bank ending up negative </li>
 <li> Anonymous Voting not working when Mayor is in a game </li>
 <li> Chats not working in the lobby </li>
 <li> Sheriff desync (I think) </li>
 <li> Buttons being able to be used during meetings </li>
 </ul>
 <hr>
 </details>

<details>
 <summary> v1.0.1 </summary>
 Fixes errors of not being able to launch. 
 </details>
</details>

-----------------------
# Installation
## Requirements 
- Among Us
- Steam or Epic Games

## Installation Guide (Steam)
**1. [Download](#releases) the Town of Us version corresponding to the installed Among Us version.**\
\
**2. Go to your Steam library.**\
\
**3. Right-click Among Us > click `Manage` > click `Browse local files`.**\
\
**4. In the File Explorer, delete the entire `Among Us` folder.**\
\
**5. Go back to your Steam library.**\
\
**6. Right-Click Among Us > click `Properties...` > click `LOCAL FILES`.**\
\
**7. Click on `VERIFY INTEGRITY OF GAME FILES...`.**\
\
**8. Wait for Steam to download a clean version of Among Us.**\
\
**9. Duplicate the new Among Us Folder.**\
\
**10. Rename it to `Among Us - ToU`.**\
\
**11. Double-click on the zip file you downloaded.**\
\
**12. Drag all the files from the zip file in the new ToU folder.**\
\
**13. Finally, launch `Among Us.exe` from that folder.**\
\
A first launch may take up to 5 minutes, so be patient if it doesn't launch immediately.

## Installation Guide (Epic Games)
**1. [Download](#releases) the Town of Us version corresponding to the installed Among Us version.**\
\
**2. Go to your Epic Games library.**\
\
**3. Find Among Us and click on the 3 dots `...` > click `Uninstall`.**\
\
**4. Confirm you want to Uninstall Among Us.**\
\
**5. In the Epic library, click on Among Us to install.**\
\
**6. Copy the Folder Path.**\
\
**7. Uncheck Auto-Update.**\
\
**8. Click on Install.**\
\
**9. Click Yes on the Windows popup.**\
\
**10. Paste the folder path in Windows search bar.**\
\
**11. Click on Enter.**\
\
**12. Copy or move the contents of the Town Of Us zip file into the AmongUs folder.**\
\
**13. Finally, launch Among Us from Epic Games library.**\
\
A first launch may take up to 5 minutes, so be patient if it doesn't launch immediately.

![Install](https://i.imgur.com/pvBAyZN.png)
 
## Issues
If you have issues installing Town of Us, you can join our [Discord](https://discord.gg/polus) to receive help.

-----------------------
# Roles
# Crewmate Roles
## Mayor
### **Team: Crewmates**
The Mayor is a Crewmate that can vote multiple times.\
The Mayor has a Vote Bank, which is the number of times they can vote.\
They have the option to abstain their vote during a meeting, adding that vote to the Vote Bank.\
As long as not everyone has voted, the Mayor can use as many votes from their Vote Bank as they please.

### Game Options
| Name | Description | Type | Default |
|----------|:-------------:|:------:|:------:|
| Mayor | The percentage probability of the Mayor appearing | Percentage | 0% |
| Initial Mayor Vote Bank | The number of votes in the Vote Bank at the start of a game | Number | 1 |
| Mayor Votes Show Anonymous | Whether the Mayor's extra votes will show up anonymously | Toggle | False |

-----------------------
## Lovers
### **Team: Crewmates or Impostors**
The Lovers are two players who are linked together.\
These two players get picked randomly between Crewmates and Impostors.\
They gain the primary objective to stay alive together.\
If they are both among the last 3 players, they win.\
In order to so, they gain access to a private chat, only visible by them in between meetings.\
However, they can also win with their respective team, hence why the Lovers do not know the role of the other lover.

### Game Options
| Name | Description | Type | Default |
|----------|:-------------:|:------:|:------:|
| Lovers | The percentage probability of the Lovers appearing | Percentage | 0% |
| Both Lovers Die | Whether the other Lover automatically dies if the other does | Toggle | True |

-----------------------
## Sheriff
### **Team: Crewmates**
The Sheriff is a Crewmate that has the ability to eliminate the Impostors using their kill button.\
However, if they kill a Crewmate or a Neutral player they can't kill, they instead die themselves.

### Game Options
| Name | Description | Type | Default |
|----------|:-------------:|:------:|:------:|
| Sheriff | The percentage probability of the Sheriff appearing | Percentage | 0% |
| Show Sheriff | Whether everybody can see who the Sheriff is | Toggle | False |
| Sheriff Miskill Kills Crewmate | Whether the other player is killed if the Sheriff Misfires | Toggle | False |
| Sheriff Kills Jester | Whether the Sheriff is able to kill the Jester | Toggle | False |
| Sheriff Kills The Glitch | Whether the Sheriff is able to kill The Glitch | Toggle | False |
| Sheriff Kills Arsonist | Whether the Sheriff is able to kill the Arsonist | Toggle | False |
| Sheriff Kill Cooldown | The cooldown on the Sheriff's kill button | Time | 25s |
| Sheriff can report who they've killed | Whether the Sheriff is able to report their own kills | Toggle | True |

-----------------------
## Engineer
### **Team: Crewmates**
The Engineer is a Crewmate that can fix sabotages from anywhere on the map.\
They can use vents to get across the map easily.

### Game Options
| Name | Description | Type | Default |
|----------|:-------------:|:------:|:------:|
| Engineer | The percentage probability of the Engineer appearing | Percentage | 0% |
| Engineer Fix Per | Whether the Engineer can fix 1 sabotage per round or per game | Round / Game | Round |

-----------------------
## Swapper
### **Team: Crewmates**
The Swapper is a Crewmate that can swap the votes on 2 players during a meeting.\
All the votes for the first player will instead be counted towards the second player and vice versa.

### Game Options
| Name | Description | Type | Default |
|----------|:-------------:|:------:|:------:|
| Swapper | The percentage probability of the Swapper appearing | Percentage | 0% |

-----------------------
## Investigator
### **Team: Crewmates**
The Investigator is a Crewmate that can see the footprints of players.\
Every footprint disappears after a set amount of time.

### Game Options
| Name | Description | Type | Default |
|----------|:-------------:|:------:|:------:|
| Investigator | The percentage probability of the Investigator appearing | Percentage | 0% |
| Footprint Size | The size of the footprint on a scale of 1 to 10 | Number | 4 |
| Footprint Interval | The time interval between two footprints | Time | 1s |
| Footprint Duration | The amount of time that the footprint stays on the ground for | Time | 10s |
| Anonymous Footprint | When enabled, all footprints are grey instead of the player's colors | Toggle | False
| Footprint Vent Visible | Whether footprints near vents are shown | Toggle | False

-----------------------
## Time Lord
### **Team: Crewmates**
The Time Lord is a Crewmate that can rewind time and reverse the positions of all players.\
If enabled, any players killed during this time will be revived.\
Nothing but movements and kills are affected.\
If enabled, the Time Lord can't use Vitals to make things more balanced.

### Game Options
| Name | Description | Type | Default |
|----------|:-------------:|:------:|:------:|
| Time Lord | The percentage probability of the Time Lord appearing | Percentage | 0% |
| Revive During Rewind | Whether the Time Lord revives dead players when rewinding | Toggle | False |
| Rewind Duration | How far the rewind goes back in time | Time | 3s |
| Rewind Cooldown | The cooldown of the Time Lord's Rewind button | Time | 25s |
| Time Lord can use Vitals | Whether the Time Lord has the ability to use Vitals | Toggle | False |

-----------------------
## Medic
### **Team: Crewmates**
The Medic is a Crewmate that can give any player a shield that will make them immortal until the Medic dies.\
A Shielded player cannot be Shifted into, Hacked or Killed by anyone, unless by suicide.\
If the Medic reports a dead body, they can get a report containing clues to the Killer's identity.\
A report can contain the name of the killer or the color type (Darker/Lighter)
### Colors
- Red - Darker
- Blue - Darker
- Green - Darker
- Pink - Lighter
- Orange - Lighter
- Yellow - Lighter
- Black - Darker
- White - Lighter
- Purple - Darker
- Brown - Darker
- Cyan - Lighter
- Lime - Lighter
- Maroon - Darker
- Rose - Lighter
- Banana - Lighter
- Gray - Lighter
- Tan - Darker
- Coral - Lighter
- Watermelon - Darker
- Chocolate - Darker
- Sky Blue - Lighter
- Beige - Darker
- Hot Pink - Lighter
- Turquoise - Lighter
- Lilac - Lighter
- Rainbow - Lighter
- Azure - Lighter

### Game Options
| Name | Description | Type | Default |
|----------|:-------------:|:------:|:------:|
| Medic | The percentage probability of the Medic appearing | Percentage | 0% |
| Show Shielded Player | Who should be able to see who is Shielded | Self / Medic / Self + Medic / Everyone | Self |
| Show Medic Reports | Whether the Medic should get information when reporting a body | Toggle | True |
| Time Where Medic Reports Will Have Name | If a body has been dead for shorter than this amount, the Medic's report will contain the killer's name | Time | 0s |
| Time Where Medic Reports Will Have Color Type | If a body has been dead for shorter than this amount, the Medic's report will have the type of color | Time | 15s |
| Who gets murder attempt indicator | Who will receive an indicator when someone tries to Shift into, Hack or Kill them | Medic / Shielded / Everyone / Nobody | Medic |
| Shield breaks on murder attempt | Whether the Shield breaks when someone attempts to Shift into, Hack or Kill them | Toggle | False |

-----------------------
## Seer
### **Team: Crewmates**
The Seer is a Crewmate that can reveal the roles of other players.\
Based on settings, the Seer can find out whether a role is Good, Evil or Neutral, or they can find out the role itself.\
A player's name will change color to their team or role.\
If the Seer investigates someone, the Seer's name will change color to inform that player who the Seer is.
### Game Options
| Name | Description | Type | Default |
|----------|:-------------:|:------:|:------:|
| Seer | The percentage probability of the Seer appearing | Percentage | 0% |
| Seer Cooldown | The Cooldown of the Seer's Reveal button | Time | 25s |
| Info that Seer sees | Whether the Seer sees the Role or the Team of a player | Role / Team | Role |
| Who Sees That They Are Revealed | Which roles see the Seer's identity once the Seer has seen their role | Crewmates / Impostors + Neutral / All / Nobody | Crewmates |
| Neutrals show up as Impostors | When the Info is set to Team, Neutral roles show up as Red, like Impostors | Toggle | False |

-----------------------
## Spy
### **Team: Crewmates**

The Spy is a Crewmate that gains more information when on Admin Table and Vitals.\
On Admin Table, the Spy can see the colors of every person on the map.\
On Vitals, the Spy can see how long killed bodies have been dead for.
### Game Options
| Name | Description | Type | Default |
|----------|:-------------:|:------:|:------:|
| Spy | The percentage probability of the Spy appearing | Percentage | 0% |

-----------------------
## Snitch
### **Team: Crewmates**

The Snitch is a Crewmate that can get arrows pointing towards the Impostors, once all their tasks are finished.\
The names of the Impostors will also show up as red on their screen.\
Based on game settings, the Snitch may not know who they are until they have one task left.\
However, when they only have a single task left, the Impostors get an arrow pointing towards the Snitch.
### Game Options
| Name | Description | Type | Default |
|----------|:-------------:|:------:|:------:|
| Snitch | The percentage probability of the Snitch appearing | Percentage | 0% |
| Snitch knows who they are on Game Start | Whether the Snitch knows their role at the start of a game | Toggle | False |

-----------------------
## Altruist
### **Team: Crewmates**

The Altruist is a Crewmate that is capable of reviving dead players.\
Upon finding a dead body, the Altruist can hit their revive button, risking sacrificing themselves for the revival of another player.\
If enabled, the dead body disappears, so only they Altruist's body remains at the scene.\
After a set period of time, the player will be resurrected, if the revival isn't interrupted.
### Game Options
| Name | Description | Type | Default |
|----------|:-------------:|:------:|:------:|
| Altruist | The percentage probability of the Altruist appearing | Percentage | 0% |
| Altruist Revive Duration | The time it takes for the Altruist to revive a dead body | Time | 10s |
| Target's body disappears on beginning of revive | Whether the dead body of the player the Altruist is reviving disappears upon revival | Toggle | False |

-----------------------
# Neutral Roles
## Jester
### **Team: Neutral**
The Jester is a Neutral role with its own win condition.\
If they are voted out after a meeting, the game finishes and they win.\
However, the Jester does not win if the Crewmates, Impostors or another Neutral role wins.

### Game Options
| Name | Description | Type | Default |
|----------|:-------------:|:------:|:------:|
| Jester | The percentage probability of the Jester appearing | Percentage | 0% |

-----------------------
## Shifter
### **Team: Neutral**
The Shifter is a Neutral role with no win condition.\
They have zero tasks and are essentially roleless.\
However, they can swap roles with other players.\
Swapping roles with a custom role gives the Shifter their role and tasks and turns the other player into a Crewmate.\
Swapping roles with a Crewmate swaps tasks.\
Swapping roles with an Impostor fails and kills the Shifter.

### Game Options
| Name | Description | Type | Default |
|----------|:-------------:|:------:|:------:|
| Shifter | The percentage probability of the Shifter appearing | Percentage | 0% |
| Shifter Cooldown | The cooldown on the Shifter's Shift button | Time | 30s |
| Who gets the Shifter role on Shift | Who will receive the Shifter role upon getting Shifted into | Non-Impostors / Regular Crewmates / Nobody | Non-Impostors |

-----------------------
## The Glitch
### **Team: Neutral**

The Glitch is a Neutral role with its own win condition.\
The Glitch's aim is to kill __everyone__ and be the last person standing.\
The Glitch can Hack players, resulting in them being unable to report bodies and do tasks.\
Hacking prevents the hacked player from doing anything but walk around the map.\
The Glitch can Mimic someone, which results in them looking exactly like the other person.

### Game Options
| Name | Description | Type | Default |
|----------|:-------------:|:------:|:------:|
| The Glitch | The percentage probability of The Glitch appearing | Percentage | 0% |
| Mimic Cooldown | The cooldown of The Glitch's Mimic button | Time | 30s |
| Mimic Duration | How long The Glitch can Mimic a player | Time | 10s |
| Hack Cooldown | The cooldown of The Glitch's Hack button | Time | 30s |
| Hack Duration | How long The Glitch can Hack a player | Time | 10s |
| Glitch Kill Cooldown | The cooldown of the Glitch's Kill button | Time | 30s |
| Initial Glitch Kill Cooldown | The cooldown of The Glitch's Kill button at the start of a game | Time | 10s |
| Glitch Hack Distance | How far away The Glitch can Hack someone from | Short / Normal / Long | Short |

-----------------------
## Executioner
### **Team: Neutral**

The Executioner is a Neutral role with its own win condition.\
Their goal is to vote out a player, specified in the beginning of a game.\
If that player gets voted out, they win the game.
### Game Options
| Name | Description | Type | Default |
|----------|:-------------:|:------:|:------:|
| Executioner | The percentage probability of the Executioner appearing | Percentage | 0% |
| Executioner becomes on Target Dead | Which role the Executioner becomes when their target dies | Crewmate / Jester | Crewmate |

-----------------------
## Arsonist
### **Team: Neutral**

The Arsonist is a Neutral role with its own win condition.\
They have the ability to douse other players with gasoline.\
Once they have doused every player remaining, they can Ignite everyone at once.\
Upon Igniting every player, they win the game.
### Game Options
| Name | Description | Type | Default |
|----------|:-------------:|:------:|:------:|
| Arsonist | The percentage probability of the Arsonist appearing | Percentage | 0% |
| Douse Cooldown | The cooldown of the Arsonist's Douse button | Time | 25s |
| Game keeps going so long as Arsonist is alive | Whether the game keeps going while the Arsonist remains | Toggle | False |

-----------------------
## Phantom
### **Team: Neutral**

The Phantom is a Neutral role with its own win condition.\
They become half-invisible when they die and has to complete all their tasks without getting caught.
### Game Options
| Name | Description | Type | Default |
|----------|:-------------:|:------:|:------:|
| Phantom | The percentage probability of the Phantom appearing | Percentage | 0% |

-----------------------
# Impostor Roles
## Janitor
### **Team: Impostors**
The Janitor is an Impostor that can clean up bodies.\
Both their Kill and Clean ability have a shared cooldown, meaning they have to choose which one they want to use.

### Game Options
| Name | Description | Type | Default |
|----------|:-------------:|:------:|:------:|
| Janitor | The percentage probability of the Janitor appearing | Percentage | 0% |

-----------------------
## Morphling
### **Team: Impostors**

The Morphling is an Impostor that can Morph into another player.\
At the beginning of the game and after every meeting, they can choose someone to Sample.\
They can then Morph into that person at any time for a limited amount of time.\
To balance the role, they can't vent.

### Game Options
| Name | Description | Type | Default |
|----------|:-------------:|:------:|:------:|
| Morphling | The percentage probability of the Morphling appearing | Percentage | 0% |
| Morph Cooldown | The cooldown of the Morphling's Morph button | Time | 25s |
| Morph Duration | How long the Morph lasts for | Time | 10s |

-----------------------
## Camouflager
### **Team: Impostors**

The Camouflager is an Impostor that can turn everyone into colorless characters.\
Everyone then goes grey for a certain period of time, along with their names disappearing, making them become unrecognizable.

### Game Options
| Name | Description | Type | Default |
|----------|:-------------:|:------:|:------:|
| Camouflager | The percentage probability of the Camouflager appearing | Percentage | 0% |
| Camouflage Cooldown | The cooldown of the Camouflager's Camouflage button | Time | 25s |
| Camouflage Duration | How long the Camouflage lasts for | Time | 10s |

-----------------------
## Miner
### **Team: Impostors**

The Miner is an Impostor that can create new vents.\
These vents only connect to each other, forming a new passway.

### Game Options
| Name | Description | Type | Default |
|----------|:-------------:|:------:|:------:|
| Miner | The percentage probability of the Miner appearing | Percentage | 0% |
| Mine Cooldown | The cooldown of the Miner's Mine button | Time | 25s |

-----------------------
## Swooper
### **Team: Impostors**

The Swooper is an Impostor that can temporarily turn invisible.\
To balance the role, they can't vent.

### Game Options
| Name | Description | Type | Default |
|----------|:-------------:|:------:|:------:|
| Swooper | The percentage probability of the Swooper appearing | Percentage | 0% |
| Swooper Cooldown | The cooldown of the Swooper's Swoop button | Time | 25s |
| Swooper Duration | How long the Swooping lasts for | Time | 10s |

-----------------------
## Assassin
### **Team: Impostors**

The Assassin is an Impostor that can kill during meetings by guessing the role of non-Impostors.\
If they guessed wrong, they die instead.

### Game Options
| Name | Description | Type | Default |
|----------|:-------------:|:------:|:------:|
| Assassin | The percentage probability of the Assassin appearing | Percentage | 0% |
| Assassin Kill | The number of kill the Assassin can do with his ability | Number | 1 |
| Assassin Guess Crewmate | Whether the Assassin can Guess "Crewmate" | Toggle | False |
| Assassin Guess Neutral  | Whether the Assassin can Guess Neutral roles | Toggle | False |
| Assassin Multiple Kill  | Whether the Assassin can kill more than once per meeting | Toggle | True |

-----------------------
## Undertaker
### **Team: Impostors**

The Undertaker is an Impostor that can drag and drop bodies.

### Game Options
| Name | Description | Type | Default |
|----------|:-------------:|:------:|:------:|
| Undertaker | The percentage probability of the Undertaker appearing | Percentage | 0% |
| Undertaker Drag Cooldown | The cooldown of the Undertaker Drag ability | Time | 25s |

-----------------------
## Underdog
### **Team: Impostors**

The Underdog is an Impostor with a prolonged kill cooldown.\
When they are the only remaining Impostor, they will have their kill cooldown shortened.

### Game Options
| Name | Description | Type | Default |
|----------|:-------------:|:------:|:------:|
| Underdog | The percentage probability of the Underdog appearing | Percentage | 0% |

-----------------------

# Modifiers
Modifiers are added on top of players' roles.
## Torch
### **Applied to: Crewmates**
The Torch's vision doesn't get reduced when the lights are sabotaged.
### Game Options
| Name | Description | Type | Default |
|----------|:-------------:|:------:|:------:|
| Torch | The percentage probability of the Torch appearing | Percentage | 0% |

-----------------------
## Diseased
### **Applied to: Crewmates**
Killing the Diseased triples the killer's Kill cooldown.
### Game Options
| Name | Description | Type | Default |
|----------|:-------------:|:------:|:------:|
| Diseased | The percentage probability of the Diseased appearing | Percentage | 0% |

-----------------------
## Flash
### **Applied to: All**
The Flash travels at twice the speed of a normal player.
### Game Options
| Name | Description | Type | Default |
|----------|:-------------:|:------:|:------:|
| Flash | The percentage probability of the Flash appearing | Percentage | 0% |

-----------------------
## Tiebreaker
### **Applied to: All**
If any vote is a draw, the Tiebreaker's vote will go through.\
If they voted another player, they will get voted out.\
If the Tiebreaker is the Mayor, it applies to the Mayor's __first__ vote.
### Game Options
| Name | Description | Type | Default |
|----------|:-------------:|:------:|:------:|
| Tiebreaker | The percentage probability of the Tiebreaker appearing | Percentage | 0% |

-----------------------
## Drunk
### **Applied to: All**
The Drunk's controls are inverted.
### Game Options
| Name | Description | Type | Default |
|----------|:-------------:|:------:|:------:|
| Drunk | The percentage probability of the Drunk appearing | Percentage | 0% |

-----------------------
## Giant
### **Applied to: All**
The Giant is a gigantic Crewmate, that has a decreased walk speed.
### Game Options
| Name | Description | Type | Default |
|----------|:-------------:|:------:|:------:|
| Giant | The percentage probability of the Giant appearing | Percentage | 0% |

-----------------------
## Button Barry
### **Applied to: All**
Button Barry has the ability to call a meeting from anywhere on the map, even during sabotages.
They have the same amount of meetings as a regular player.
### Game Options
| Name | Description | Type | Default |
|----------|:-------------:|:------:|:------:|
| Button Barry | The percentage probability of Button Barry appearing | Percentage | 0% |

-----------------------
# Custom Game Options
| Name | Description | Type | Default |
|----------|:-------------:|:------:|:------:|
| Camouflaged Comms | Whether everyone becomes camouflaged when Comms are sabotaged | Toggle | False |
| Camouflaged Meetings | Whether everyone is camouflaged during meetings while Comms are sabotaged | Toggle | False |
| Impostors can see the roles of their team | Whether Impostors are able to see which Impostor roles their teammates have | Toggle | False |
| Dead can see everyone's roles | Whether dead players are able to see the roles of everyone else | Toggle | False |
| Max Impostor Roles | The maximum number of custom Impostor roles a game can have | Number | 1 |
| Max Neutral Roles | The maximum number of Neutral roles a game can have | Number | 1 |
| Role Appears Under Name | Whether your own role appears under your name | Toggle | True |
| Probability of a completely vanilla game | The percentage probability of a vanilla Among Us game happening | Percentage | 0% |

-----------------------
# Extras
## New Colors!
New colors are added for crewmates to pick from: watermelon, chocolate, sky blue, beige, hot pink, turquoise and lilac.
## Rainbow Color!
A rainbow color has also been added. Anyone who equips this color will constantly switch between the colors of the rainbow.
## Custom Hats!
Custom hats have been added, made by some very talented artists. These are mostly hats for streamers.

-----------------------
# Bug / Suggestions
If you have any bugs or any need to contact me, join the [Discord server](https://discord.gg/polus) or create a ticket on GitHub.

-----------------------
# Credits & Resources
[Reactor](https://github.com/NuclearPowered/Reactor) - The framework of the mod\
[BepInEx](https://github.com/BepInEx) - For hooking game functions\
[Among-Us-Sheriff-Mod](https://github.com/Woodi-dev/Among-Us-Sheriff-Mod) - For the Sheriff role.\
[Among-Us-Love-Couple-Mod](https://github.com/Woodi-dev/Among-Us-Love-Couple-Mod) - For the inspiration of Lovers role.\
[ExtraRolesAmongUs](https://github.com/NotHunter101/ExtraRolesAmongUs) - For the Engineer & Medic roles.\
[TooManyRolesMods](https://github.com/Hardel-DW/TooManyRolesMods) - For the Investigator & Time Lord roles.\
[TorchMod](https://github.com/tomozbot/TorchMod) - For the inspirtation of the Torch Mod.\
[XtraCube](https://github.com/XtraCube) - For the RainbowMod.\
[PhasmoFireGod](https://twitch.tv/PhasmoFireGod) - Button Art.\
[TheOtherRoles](https://github.com/Eisbison/TheOtherRoles) - For the inspiration of the Child and Spy roles.

[Essentials](https://github.com/DorCoMaNdO/Reactor-Essentials) - For created custom game options.\
v1.0.3 uses [Essentials](https://github.com/DorCoMaNdO/Reactor-Essentials) directly.\
v1.1.0 uses a modified version of Essentials that can be found [here](https://github.com/slushiegoose/Reactor-Essentials).\
v1.2.0 has Essentials embedded and can be found [here](https://github.com/slushiegoose/Town-Of-Us/tree/master/source/Patches/CustomOption).

#
This mod is not affiliated with Among Us or Innersloth LLC, and the content contained therein is not endorsed or otherwise sponsored by Innersloth LLC. Portions of the materials contained herein are property of Innersloth LLC.
© Innersloth LLC.

Town-Of-Us

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README