Giter Club home page Giter Club logo

theotherroles's Introduction

eisbison banner

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.

Discord eisbison infographic

The Other Roles

The The Other Roles, is a mod for Among Us which adds many new roles, new Settings, new Custom Hats and support for 10+ Player Lobbies to the game. Even more roles are coming soon :)

Impostors Crewmates Neutral Secondary
Evil Mini Nice Mini Arsonist Lover
Evil Guesser Nice Guesser Jester
Bounty Hunter Detective Jackal
Camouflager Engineer Sidekick
Cleaner Hacker Vulture
Eraser Lighter Lawyer
Godfather (Mafia) Mayor
Mafioso (Mafia) Medic
Janitor (Mafia) Security Guard
Morphling Seer
Trickster Sheriff
Vampire Shifter
Warlock Snitch
Witch Spy
Swapper
Time Master
Tracker
Bait
Medium

The Role Assignment sections explains how the roles are being distributed among the players.

Releases

Among Us - Version Mod Version Link
2021.12.15s v3.3.3 Download
2021.12.15s v3.3.2 Download
2021.12.14s v3.3.1 Download
2021.12.14s v3.3.0 Download
2021.11.9.5s v3.2.4 Download
2021.11.9.5s v3.2.3 Download
2021.11.9.5s v3.2.2 Download
2021.11.9.5s v3.2.1 Download
2021.11.9.5s v3.2.0 Download
2021.11.9.5s v3.1.2 Download
2021.11.9.5s v3.1.1 Download
2021.11.9.5s v3.1.0 Download
2021.11.9.5s v3.0.0 Download
2021.6.30s v2.9.2 Download
2021.6.30s v2.9.1 Download
2021.6.30s v2.9.0 Download
2021.6.30s v2.8.1 Download
2021.6.30s v2.8.0 Download
2021.6.30s v2.7.3 Download
2021.6.15s v2.7.1 Download
2021.6.15s v2.7.0 Download
2021.5.25.2s v2.6.7 Download
2021.5.10s v2.6.6 Download
2021.5.10s v2.6.5 Download
2021.5.10s v2.6.4 Download
2021.5.10s v2.6.3 Download
2021.5.10s v2.6.2 Download
2021.4.14s v2.6.1 Download
2021.4.14s v2.6.0 Download
2021.4.14s v2.5.1 Download
2021.4.14s v2.5.0 Download
2021.4.14s v2.4.0 Download
2021.4.14s v2.3.0 Download
2021.4.14s v2.2.2 Download
2021.4.12s v2.2.1 Download
2021.4.12s v2.2.0 Download
2021.3.31.3s v2.1.0 Download
2021.3.31.3s v2.0.1 beta Download
2021.3.31.3s v2.0.0 beta Download
2021.3.5s v1.8.2 Download
2021.3.5s v1.8.1 Download
2021.3.5s v1.8 Download
2021.3.5s v1.7 Download
2021.3.5s v1.6 Download
2021.3.5s v1.5 Download
2021.3.5s v1.4 Download
2021.3.5s v1.3 Download
2020.12.19s v1.1 Download
2020.12.19s v1.0 Download

Changelog

Click to show the Changelog

Version 3.3.3

  • Fixed a bug where a guessed Guesser could guess
  • Fixed a bug where buttons were visible during the meeting
  • Removed Hacker vitals for Skeld & dlekS
  • Changed the Guesser option "Other Guesser Spawn Rate" to "Both Guesser Spawn Rate" (now only take effect when the chance for the first guesser was successful)
  • Changed Hacker vitals to doorlog for MIRA HQ

Version 3.3.2

  • Fixed a bug where you can't create a lobby on Among Us 2021.12.15

Version 3.3.1

  • Fixed a bug where sometimes the Evil Guesser could not guess. Thanks @tomarai

Version 3.3.0

  • Update to Among Us version 2021.12.14s
  • Fixed a bug where the Pursuer won if the Pursuer was the last killed or voted player
  • Fixed a bug where the option "Enable Mod Roles And Block Vanilla Roles" was not set correctly
  • New option for the Guesser "Evil Guesser can guess spy"
  • New option for the Guesser "Other Guesser Spawn Rate"
  • New ability for the Hacker "Mobile Gadgets" (including vitals & admin table)
  • New option for the Hacker "Max Mobile Gadget Charges"
  • New option for the Hacker "Number Of Tasks Needed For Recharging"
  • Fixed some UI bugs during the meeting

Version 3.2.4

  • Fixed a bug where the Vampire teleported when the bitten player died
  • The settings UI has been improved by Amsyar Rasyiq
  • New option to the Bait "Warn The Killer With A Flash", created by gendelo3

Version 3.2.3

  • Fixed a bug where the role of a dead client was visible to the Pursuer
  • Fixed a bug where the Morphling changed their color when killing players
  • Fixed a bug where voting the Lover partner of a Lover Witch did not safe the spellbound players
  • When the Lawyer dies, the client doesn't have the client mark (§) anymore, making the client aware of the fact that the Lawyer can't steal the win anymore (only relevant if the "Client Knows" option is on)

Version 3.2.2

  • Add new option "Play On A Random Map" created by Alex2911
  • Add Witch option "Voting The Witch Saves All The Targets"
  • Add Lawyer option "Lawyer Knows Target Role"
  • We changed the win conditions of the Lawyer, to make it more viable
  • Bug fix: The Medium now shows the roles of players in the right format
  • The name and the role of all winners is now being displayed on the end screen
  • We changed the way settings are being shared among the players (which caused some people to be unable to join the lobby). This might resolve the problem or make it even worse... we'll see.

Version 3.2.1

  • Hotfix for 3.2.0
  • Bug fix: The Warlock is again able to kill with the curse abilty

Version 3.2.0

  • New Role: Witch created by Alex2911
  • New Role: Lawyer
  • Bug fix: Choosing an Impostor as a Sidekick won't resulted in an Impostor/Sidekick mix anymore.
  • Bug fix: The Guesser info now shows the right information, when the Guesser guesses the wrong role and kills himself.
  • Bug fix: Hats are being displayed in alphabetic order. Hats demo in freeplay is working again. Fixed a bug where hats would not load when accessed from the main menu.
  • Bug fix: The Detective now shows the name of the players in any case.

Hotfix 3.1.2

  • Don't ask, just update. I messed up.

Hotfix 3.1.1

  • Bug fix: You're again able to connect to custom servers
  • Bug fix: The option "Guesses Visible In Ghost Chat" doesn't result in a ban of the Guesser anymore
  • Bug fix: The position of the Spy on the intro screen is again random
  • Bug fix: Re-added some venting rules that were lost (Spy can't move between vents, only Trickster can use boxes, ...)

Version 3.1.0

  • Hopefully temporary fixing the issue of being kicked by Innersloth servers for regular kills, until Innersloth fixes it on their side.
  • NOTE: Do not combine modded and unmodded versions of the game (even if you don't activate anything). Because of the kicking fix, your kills won't be performed for players that do not share the exact same modded version. Due to this you now can't start a game as the host, if not everyone in the lobby has the same version of the mod. Additionally you'll be kicked out of a lobby after 10 seconds, if the host doesn't have the mod installed (or the same mod version).
  • Tracker: The Tracker has been reworked by Alex2911. The Tracker now has an additional optional ability that tracks all corpses on the map for a few seconds.
  • Add new option: Allow Parallel MedBay Scans
  • Add new Guesser option: "Guesses Visible In Ghost Chat"
  • Add new Guesser option: "Guesses Ignore The Medic Shield". If this option is set to false, no matter what the Guesser guessed, no one will die and the shielded player/Medic might be notified
  • Add new Medic option: "Medic Sees Murder Attempt On Shielded Player". This includes attempts from any kind of killer (Sheriff, Jackal, Guesser if the shield is not being ignored, ...)
  • During meetings the Detective, Hacker and Medium now display, whether a player wears a darker or lighter color
  • Bug fix: Bounty Hunter, Mini and Engineer in vent kills do not result in players being kicked anymore
  • Bug fix: The Trickster vent button now doesn't show the text "vent" twice anymore
  • Bug fix: Fixed the visual bug where both Lovers always showed dead during the meeting after a correct guess of one of them even if the option "Both Lovers Die" was disabled

Version 3.0.0

  • Updated to Among Us version v2021.11.9.5s
  • Note: We wanted to update as fast as possible, that's why you can't use both the Innersloth and mod roles at the same time. We'll make that possible in the future, but there are various things that need to be modified (e.g. Shifter, Guesser, ...) to make that work, so that'll take a little longer. Also, be aware that this version might contain more bugs than usual because Innersloth changed a lot of things and we might have missed some of them.
  • Ability buttons are now bind to the Q key (if it's a killing ability) or to the F key (otherwise). We'll make the binds adaptable in the future.
  • For now we removed the option "Jester Can Sabotage"
  • The Sheriff now always dies, when they try to kill a not fully grown Mini

Hotfix 2.9.2

  • Fixed a bug where the names of all players were visible during camouflage
  • Fixed a bug where the Morphling didn't take over the name of its target

Version 2.9.1

  • Fixed a bug where Camouflager & Morphling caused performance issues
  • Fixed a bug where Medium did not exlude the Evil Mini
  • Vulture "Number Of Corpses Needed To Be Eaten" max value extended to 10
  • Added Vulture Option: "Show Arrows Pointing Towards The Corpes"
  • Removed Medium Question: "What is your name?" (name of the soul is added after each question)

Version 2.9.0

  • New Role: Medium
  • New Role: Vulture
  • Added Jackal Option: "Jackal Can See If Engineer Is In A Vent"
  • Added Guesser Option: "Guesser Can Shoot Multiple Times Per Meeting"
  • Fixed a bug that occured when the Shifter shifted the Bait

Hotfix 2.8.1

  • Fixed a game breaking bug where killing the Bait resulted in a ban of the Bait

Version 2.8.0

  • New Role: Bait
  • Added Tracker Option: "Tracker Reset Target After Meeting" (feature created by MaximeGillot)
  • Added Snitch Options: "Include Team Jackal" and "Use Different Arrow Color For Team Jackal"
  • Added Medic Option: "Shield Will Be Set After Next Meeting"

Version 2.7.3

  • Updated to Among Us v2021.6.30
  • Updated BepInEx version
  • Updated Credentials
  • Fixed some Colors being considered darker, when they should be lighter
  • Added /size command for Lobby
  • Added /color and /murder command to Freeplay (for the Hat Designers)

Version 2.7.1

  • Fixed a bug where swapped votes were sometimes counted wrongly
  • Fixed the positioning of the player name while morphed
  • Fixed a bug where the window of the Guesser sometimes showed no "close button"
  • Fixed a bug where the garlics were not displayed properly

Version 2.7.0

Version 2.6.7

  • New Role: Guesser
  • We changed the colors of some of our roles
  • We renamed the Child to Mini
  • Fixed a bug where a Jester win was triggered, when the partner of a Jester Lover was voted out
  • Fixed a bug where a Mini lose was triggered, when the partner of a Crew Mini Lover was voted out

Version 2.6.6

  • Fixed a bug introduced in v2.6.5 that caused all player to be able to use vents when the new option for spy was enabled

Version 2.6.5

  • Added the ability to increase the number of tasks assigned to crewmates
  • New option: A role summary in the end screen (Client option)
  • Spy: New option for spy to have the same vision as impostors
  • Spy: New option for spy to be able to jump into vents (but they can't move between them)
  • Fixed a bug causing a crewmate task win when lovers were in the game even when not all crewmates had completed all their tasks
  • Restored the original Among Us color for crewmates in the intro cutscene

Version 2.6.4

  • Lovers: You can now select that Lovers may have a second role (could be a Crewmate, Neutral or Impostor role)
  • Seer: Fixed souls and flash sometimes not being visible (Thanks to orangeNKeks)
  • New option: Swapper can only swap others
  • New option: Ghosts can see votes
  • New option: Jackal and Sidekick have Impostor vision
  • New option: Jester can sabotage
  • Changed Freeplay mode to not assign custom roles anymore
  • Fixed a bug with directional hats not using their flip image after a while

Version 2.6.3

  • Changed the role limits options to allow for minimum and maximum bounds
  • Changed the role assignment to be more random when assigning roles (previously assigned the neutral roles before assigning the crewmate roles)
  • Added new flip option to Custom Hats

Version 2.6.2

  • The Other Roles now supports the new Among Us version 2021.5.10s
  • Added a chat command to kick players as the host of a lobby (/kick playerName)

Version 2.6.1

  • Fixed a bug where the Sheriff was unable to kill the Arsonist
  • Fixed a bug in the role assignment system
  • Added the option to select the Dleks map
  • Improved the overlay of the Arsonist

Version 2.6.0

  • New Role: Arsonist
  • Added an In-Game Updater, to make it easier to update the Mod
  • Added synchronization for Airship toilet doors. Doors now open/close for everyone
  • Changed Shifter to also die when shifting a neutral role (Jester, Arsonist, Jackal, ...)
  • Changed the option "Jester Can Die To Sheriff" to "Neutrals Can Die To Sheriff"
  • Changed the role assignment system. You can now set how many neutral roles you want in your game
  • Changed Hacker to see colors more clearly on Admin Table
  • Changed version handshake to give more clear info
  • Fixed a problem with the Hat Tab leaving too much space between categories
  • Fixed an Among Us bug, which made the selected region always show "North America"
  • Fixed an Among Us bug, which made the disconnect info be off-screen. (hopefully)

Version 2.5.1

  • New Hats: We added the support for custom hats and there are already a few hats inside the game. We can add new hats without updating the mod and we're awaiting your hat designs on our discord server.
  • Changed Lovers to ignore Lover's Tasks for task win, while an ImpLover is alive
  • Fixed a bug where garlic was not visible in some places
  • The Security Guard can't place cameras on MiraHQ anymore
  • Fixed a bug on the Airship, where the view of the cameras that the Security Guard placed wasn't centered on the camera.

Version 2.5.0

  • New Role: Security Guard
  • Fixed a bug where the game would stop after the first meeting
  • Fixed a bug where killing with the hotkey Q ignored shields

Version 2.4.0

  • New Role: Warlock
  • Added an option that allows ghosts to see the roles and remaining tasks of other players
  • Added options to configure Morph & Camo duration
  • Added hotkeys to the custom buttons (Q for the buttons that are on the same place as the kill button, F for the buttons that are above the kill button)
  • Fixed an oversight which made StreamerMode only work as host
  • Fixed an oversight which required Jackals to finish Tasks, after Sidekick was promoted
  • Fixed an oversight which made Sidekicks not promote, if the Jackal disconnected
  • Fixed a bug where the Trickster box was invisible
  • Fixed a bug where changes to the server ip and port would only be applied if the game was restarted
  • Added a way to get the 2 Hidden Colors

Version 2.3.0

  • New Role: Cleaner
  • Added 12 new Colors
  • We added support for creating Custom Hats. New hats are coming with the next version, but you can already create and submit your own hats on Discord.
  • Added the option to hide the name of players with an unknown role
  • Added Trickster Box vent animation. Thanks to Drakoni
  • You can now change the custom server ip/port right inside the game
  • The Jackal, the Sidekick and the Jester now have fake tasks
  • Added outlines, to show who you're targeting with your ability. Thanks to Sihaack for part of the code.
  • Added a streamer mode to Among Us, which hides lobby codes, the ip of your custom server and the port of your custom server. You can also modify the text that replaces the lobby code, check Settings for more details.
  • Changed Meeting HUD Layout when playing with more than 10 players
  • Fixed a bug where ImpLovers would hardly spawn
  • Fixed a bug where players could get stuck on ladders/platforms when being rewound
  • Fixed a bug where players could only use quickchat
  • Fixed a bug which prevented to play in Freeplay mode
  • Fixed a bug which moved the Ping info off-screen

Version 2.2.2

  • Among Us version 2021.4.14s compatibility
  • Improved the block votes on emergency meeting option

Version 2.2.1

  • Trickster: The vent button now has a custom texture. Fixed a bug where the Trickster could clip out of bounds when their box was close to a wall.
  • Fixed a bug where the Bad Mini's kill button went on cooldown when someone else performed a kill
  • Fixed a few bugs with footprints, Seer souls and the Vampire delayed kill
  • Fixed a bug where the Mini was banned for hacking (because of its reduced kill cooldown)
  • Improved the version handshake

Version 2.2.0

  • Works with the latest Among Us version (2021.4.12s)
  • Added support for 10+ player lobbies on custom servers: Check the Custom Servers and 10+ Players section. During meetings use the up/down keys, on vitals use the left/right keys.
  • Added a new Impostor role: The Trickster check the Trickster section for more info
  • You can now set how long the Time Master shield lasts
  • The host now sees for how long the lobby will remain open
  • We changed the look/layout of the settings
  • Added a new option that deactivates skipping in meetings (if the player does not vote, they vote themself)
  • You can now choose whether the Eraser is able to erase the Spy/Impostors or not
  • Fixed a bug where a Lovers win wasn't displayed properly
  • Fixed the Among Us bug where people were unable to move after meetings
  • We added a version checking system: The host can only start the game if everyone in their lobby has the same version of the mod installed (they will see, who is using a wrong version). This prevents hacking in public lobbies and bugs because of version mismatches.
  • Fixed a bug where the Mini Impostor had the same cooldowns as normal Impostors
  • Fixed a bug where the Vampire/Janitor/Mafioso would lose their kill button after being erased
  • The Mini is now able to use ladders and it can do all the tasks right away

Version 2.1.0

  • New Role: Spy
  • Eraser: The Eraser can now also remove the role of other Impostors. This enables them to reveal the Spy, but might result in removing the special ability of their partner.
  • Camouflager: The Mini age/size will now also be hidden, to allow the Mini Impostor to kill during camouflage

Hotfix 2.0.1

  • Fixed a bug where camouflaged players would get stuck on ladders/platforms on the airship
  • Introduced a one-second cooldown after the Morphling sampled another player
  • The Mini can now always reach all usables (ladders, tasks, ...)
  • We removed a bug, where some footprints remained on the ground forever
  • We removed a bug, where the Detective didn't see the right color type when reporting a player
  • We changed the Jester win and Mini lose conditions, they're not being affected by server delays anymore

Changes in 2.0.0

  • New button art created by Bavari
  • New mod updater/installer tool created by Narua and Jolle. Check the Installation section for more details.
  • Custom options: Introduced customizable presets. Starting with 2.0.0, settings can be copied and used with higher versions (2.0.0).
  • Time Master rework: Check Time Master for more information
  • Medic: The Medic report changed, it only shows the time since death (see Detective)
  • Detective: The Detective now sees the name/color type of the killer when they report a dead body (ability moved from the Medic to the Detective)
  • Lighter: We changed and tried to nerf the Lighter, see the Lighter section for more details.
  • Seer: As the role didn't work the way it was, we completely changed it. We're still working on the role, for now we're trying a few things. Check the Seer section to get more details about the new Seer.
  • Shifter: We reworked the Shifter, they are now part of the crew. Check out the Shifter sections for more details.
  • Hacker: The Hacker is basically the old Spy. We added the option to only show the color type instead of the color on the admin table.
  • Camouflager: Now also overrides the information of other roles, check the Camouflager section for more details.
  • Morphling: Now also overrides the information of other roles, check the Morphling section for more details
  • Mini: The Mini can now be a Crewmate Mini or an Impostor Mini, check the Mini section for more details
  • Eraser: The Eraser, a new Impostor role, is now part of the mod. Check the Eraser section for more details
  • New options:
    • You can now set the maximum number of meetings in a game: Every player still only has one meeting. The Mayor can always use their meeting (even if the maximum number of meetings was reached). Impostor/Jackal meetings also count.

Hotfix 1.8.2

  • Add map and Impostor count to lobby settings.
  • Fixed bugs where changing players to be the Sidekick didn't reset all the effects of their previous role.

Hotfix 1.8.1 Resolves bugs that occurred when the Jackal recruited a Medic, Swapper and Tracker

Changes in v1.8:

  • New Roles: Added the Jackal and Sidekick roles
  • Vampire: Medic report shows the right info now. A bitten Swapper is not able to swap if they die at the beginning of a meeting. One can now set the cooldown and whether a normal kill is possible when a target is next to a garlic or not.
  • Lover: New option that sets how often an ImpLover appears. If a Lover is exiled, their partner doesn't spawn a dead body anymore.
  • Cooldowns now stop cooling down, if a player sits inside a vent.
  • Fixed a bug that prevented the game from continuing after a meeting (for an edge case with Lovers)
  • If two players try to kill each other at the same time both should die (e.g. Sheriff vs Impostor)
  • We added a description for your current role right above the task list
  • Added a description for the Role Assignment System


Changes in v1.7:

  • New Roles: The Vampire, the Tracker and the Snitch are now in the game
  • The role assignment system has been changed
  • Impostors now see a blue outline around all vents of the map, if the Engineer sits inside one of them


Changes in v1.6:

  • This update is a small hotfix, fixing the bug where some people were unable to join lobbies.
  • The Mini can't be voted out anymore before it turns 18, hence games can't end anymore because the Mini died.
  • Footprints are no longer visible to the Detective, if players are inside vents.


Changes in v1.5:

  • Time Master - Buff: They are not affected by their rewind anymore, which gives them more utility. Players will now be rewound out of vents.
  • Mini - Nerf: The Mini now grows up (see Mini) and becomes a normal Crewmate at some point. A growing Mini is not killable anymore. Some tasks are still not doable for the small Mini, we are working on that. But eventually when growing up it can do all the tasks as it's size increases.
  • Seer - Nerf: Added an option that sets how often the Seer mistakes the player for another.
  • Hacker - Nerf: The Hacker now only sees the additional information when they activate their "Hacker mode". That should stop the Hacker from camping the admin table/vitals.
  • Other: Camouflager/Morphling cooldowns were fixed. Custom regions code was removed to enable 3rd party tools. Some minor bugfixes.

Changes in v1.4:

  • Fixing a Camouflager/Morphling animation bug
  • Fixing a bug where the Swapper could swap votes even if they are dead
  • The custom cooldown buttons now render the cooldown progress (the grey overlay) in the right way (v1.3 introduced the bug)
  • Players in vents are not targetable anymore by the role actions, the button does not activate (e.g. Seer revealing, Morphling sample). Exception: Impostor killing an Engineer in a vent

Changes in v1.3:

  • Adds support for the Among Us version 2021.3.5s
  • Fixes a bug where an edge case caused all players to start the game with the camouflaged look
  • There might be a few bugs, since I focused on getting the update out fast. A new version resolving the bugs will be published tomorrow.

Changes in v1.1:

  • Morphling: The color of pet now also morphs. The skin animation now starts at the right point.
  • The game over screen now shows if the Jester/Mini/Lovers won.
  • A bug was removed where the Jester won together with the Crewmates.
  • A bug was removed where the game of the Lovers crashed if they were the last players killed by the host of the lobby.

Installation

Windows Auto Installation/Updating Using The AmongUsModUpdater

This tool was made by Narua and Jolle. It automatically installs/updates the TheOtherRoles mod to the newest version, runs the game and syncs your game options automatically.

  1. Simply get the newest release of the AmongUsModUpdater
  2. Unzip the folder and run the setup.exe

If you have problems with the AmongUsModUpdater, make sure to contact us.

Windows Manual Installation

  1. Download and unzip the newest release
  2. Find the folder of your game, for Steam players you can right click in Steam, on the game, a menu will appear proposing you to go to the folders.
  3. Make a copy of your game, it's not obligatory but advised, put it where you want.
  4. Drag or extract the files from the zip into your game, at the .exe level.
  5. Run the game (the first launch might take a while)

Not working? You might want to install the dependency vc_redist

Install

Linux Manual

  1. Install Among Us via Steam
  2. Download newest release and extract it to ~/.steam/steam/steamapps/common/Among Us
  3. Enable winhttp.dll via the proton winecfg (https://docs.bepinex.dev/articles/advanced/steam_interop.html#open-winecfg-for-the-target-game)
  4. Launch the game via Steam

Custom Servers and 10+ Players

We always recommend you to play on custom servers rather than on the official ones. If you want to play with more than 10 players in one lobby, you're required to use a custom server. Credits for the original implementation that allowed 10+ player lobbies go to the creators of the CrowdedMod.

Setup the Clients:

  1. Open the region menu where you can choose between the different regions
  2. Select the region Custom
  3. Enter the ip/domain and the port of your custom server in the corresponding text fields

Setup the Server:

  1. Get the Impostor release for the Among Us version 2021.3.31 - 2021.4.2
  2. Follow the steps (using the server release you just downloaded) on the official Impostor-Documentation
  3. Make sure to set the following values to false in the config.json file:
    ...
    "AntiCheat": {
      "Enabled": false,
      "BanIpFromGame": false
    }
  1. Make sure to forward the right ports on the hosting machine
  2. Run the server and setup the client

Setting up Server as Docker Container:
If you want to run the server as a docker container you'll need to use the image

aeonlucid/impostor:nightly

(Currently only the "nightly" tag is starting a server supporting 2021.3.31 or later)

In addition to running it, the environment variables to disable the AntiCheat feature need to be set.

IMPOSTOR_AntiCheat__Enabled=false
IMPOSTOR_AntiCheat__BanIpFromGame=false

Example to docker run command:

docker run -p 22023:22023/udp --env IMPOSTOR_AntiCheat__Enabled=false --env IMPOSTOR_AntiCheat__BanIpFromGame=false aeonlucid/impostor:nightly

Or use to run it in the background

docker run -d -p 22023:22023/udp --env IMPOSTOR_AntiCheat__Enabled=false --env IMPOSTOR_AntiCheat__BanIpFromGame=false aeonlucid/impostor:nightly

Credits & Resources

OxygenFilter - For all the version v2.3.0 to v2.6.1, we were using the OxygenFilter for automatic deobfuscation
Reactor - The framework used for all version before v2.0.0
BepInEx - Used to hook game functions
Essentials - Custom game options by DorCoMaNdO:

  • Before v1.6: We used the default Essentials release
  • v1.6-v1.8: We slightly changed the default Essentials. The changes can be found on this branch of our fork.
  • v2.0.0 and later: As we're not using Reactor anymore, we are using our own implementation, inspired by the one from DorCoMaNdO

Jackal and Sidekick - Original idea for the Jackal and Sidekick comes from Dhalucard
Among-Us-Love-Couple-Mod - Idea for the Lovers role comes from Woodi-dev
Jester - Idea for the Jester role comes from Maartii
ExtraRolesAmongUs - Idea for the Engineer and Medic role comes from NotHunter101. Also some code snippets come of the implementation were used.
Among-Us-Sheriff-Mod - Idea for the Sheriff role comes from Woodi-dev
TooManyRolesMods - Idea for the Detective and Time Master roles comes from Hardel-DW. Also some code snippets of the implementation were used.
TownOfUs - Idea for the Swapper, Shifter, Arsonist and a similar Mayor role come from Slushiegoose
Ottomated - Idea for the Morphling, Snitch and Camouflager role come from Ottomated
Crowded-Mod - Our implementation for 10+ player lobbies is inspired by the one from the Crowded Mod Team
Goose-Goose-Duck - Idea for the Vulture role come from Slushygoose

Settings

The mod adds a few new settings to Among Us (in addition to the role settings):

  • Streamer Mode: You can activate the streamer mode in the Among Us settings. It hides the lobby code, the custom server ip and the custom server port. You can set a custom lobby code replacement text, by changing the Streamer Mode Replacement Text in the BepInEx\config\me.eisbison.theotherroles.cfg file.
  • Number of Impostors: The number of Impostor count be set inside a lobby
  • Map: The map can be changed inside a lobby
  • Maximum Number Of Meetings: You can set the maximum number of meetings that can be called in total (Every player still has personal maximum of buttons, but if the maximum number of meetings is reached you can't use your meetings even if you have some left. Impostor and Jackal meetings also count)
  • Allow Skips On Emergency Meetings: If set to false, there will not be a skip button in emergency meetings. If a player does not vote, they'll vote themself.
  • Hide Player Names: Hides the names of all players that have role which is unknown to you. Team Lovers/Impostors/Jackal still see the names of their teammates. Impostors can also see the name of the Spy and everyone can still see the age of the mini.
  • Allow Parallel MedBay Scans: Allows players to perform their MedBay scans at the same time
  • Ghosts Can See Roles
  • Ghosts Can See Votes
  • Ghosts Can See The Number Of Remaining Tasks
  • Dleks: You are now able to select the Dleks map.
  • Task Counts: You are now able to select more tasks.
  • Role Summary: When a game ends there will be a list of all players and their roles and their task progress

Task Count Limits per map

You can configure:

  • Up to 4 common tasks
  • Up to 23 short tasks
  • Up to 15 long tasks

Please note, that if the configured option exceeds the available number of tasks of a map, the tasks will be limited to that number of tasks.
Example: If you configure 4 common tasks on Airship crewmates will only receive 2 common tasks, as airship doesn't offer more than 2 common tasks.

Map Common Tasks Short Tasks Long Tasks
Skeld / Dleks 2 19 8
Mira HQ 2 13 11
Polus 4 14 15
Airship 2 23 15

Custom Hats

Create and submit new hat designs

We're awaiting your creative hat designs and we'll integrate all the good ones in our mod. Here are a few instructions, on how to create a custom hat:

  • Creation: A hat consists of up to three textures. The aspect ratio of the textures has to be 4:5, we recommend 300px:375px:

    • Main texture (required):
      • This is the main texture of your hat. It will usually be rendered in front of the player, if you set the behind parameter it will be rendered behind the player.
      • The name of the texture needs to follow the pattern hatname.png, but you can also set some additional parameters in the file name by adding _parametername to the file name (before the .png).
      • Parameter bounce: This parameter determines whether the hat will bounce while you're walking or not.
      • Parameter adaptive: If this parameter is set, the Among Us coloring shader will be applied (the shader that replaces some colors with the colors that your character is wearing in the game). The color red (#ff0000) will be replaced with the primary color of your player and the color blue (#0000ff) with the secondary color. Also other colors will be affected and changed, you can have a look at the texture of the Crewmate Hat to see how this feature should be used.
      • Parameter behind: If this parameter is set, the main texture will be rendered behind the player.
    • Flipped texture (optional):
      • This texture will be rendered instead of the Main texture, when facing the left.
      • The name of the texture needs to follow the pattern hatname_flip.png.
    • Back texture (optional):
      • This texture will be rendered behind the player.
      • The name of the texture needs to follow the pattern hatname_back.png.
    • Flipped Back texture (optional):
      • This texture will be rendered instead of the Back texture, when facing the left.
      • The name of the texture needs to follow the pattern hatname_back_flip.png.
    • Climb texture (optional):
      • This texture will be rendered in front of the player, when they're climbing.
      • The name of the texture needs to follow the pattern hatname_climb.png.
  • Testing: You can test your hat design by putting all the files in the \TheOtherHats\Test subfolder of your mod folder. Then whenever you start a Freeplay game, you and all the dummies will be wearing the new hat. You don't need to restart Among Us if you change the hat files, just exit and reenter the Freeplay mode.

  • Submission: If you got a hat design, you can submit it on our Discord server. We'll look at all the hats and add all the good ones to the game.

Colors

TOR Colors

Roles

Role Assignment

We are still improving the role assignment system. It's not that intuitive right now, but it's more flexible than the older one if you're using it right.

First you need to choose how many special roles of each kind (Impostor/Neutral/Crewmate) you want in the game. The count you set will only be reached, if there are enough Crewmates/Impostors in the game and if enough roles are set to be in the game (i.e. they are set to > 0%). The roles are then being distributed as follows:

  • First all roles that are set to 100% are being assigned to arbitrary players.
  • After that each role that has 10%-90% selected adds 1-9 tickets to a ticket pool (there exists a ticket pool for Crewmates, Neutrals and Impostors). Then the roles will be selected randomly from the pools as long it's possible (until the selected number is reached, until there are no more Crewmates/Impostors or until there are no more tickets). If a role is selected from the pool, obviously all the tickets of that role are being removed.
  • The Mafia, Lovers and Mini are being selected independently (without using the ticket system) according to the spawn chance you selected. After that the Crewmate, Neutral and Impostor roles are selected and assigned in a random order.

Example:
Settings: 2 special Crewmate roles, Snitch: 100%, Hacker: 10%, Tracker: 30%
Result: Snitch is assigned, then one role out of the pool [Hacker, Tracker, Tracker, Tracker] is being selected
Note: Changing the settings to Hacker: 20%, Tracker: 60% would statistically result in the same outcome .

Mafia

Team: Impostors

The Mafia are a group of three Impostors.
The Godfather works like a normal Impostor.
The Mafioso is an Impostor who cannot kill until the Godfather is dead.
The Janitor is an Impostor who cannot kill, but they can hide dead bodies instead.

NOTE:

  • There have to be 3 Impostors activated for the mafia to spawn.

Game Options

Name Description
Mafia Spawn Chance -
Janitor Cooldown -

Morphling

Team: Impostors

The Morphling is an Impostor which can additionally scan the appearance of a player. After an arbitrary time they can take on that appearance for 10s.
NOTE:

  • They shrink to the size of the Mini when they copy its look.
  • The Hacker sees the new color on the admin table.
  • The color of the footprints changes accordingly (also the ones that were already on the ground).
  • The other Impostor still sees that they are an Impostor (the name remains red).
  • The shield indicator changes accordingly (the Morphling gains or loses the shield indicator).
  • Tracker and Snitch arrows keep working.

Game Options

Name Description
Morphling Spawn Chance -
Morphling Cooldown -
Morph Duration Time the Morphling stays morphed

Camouflager

Team: Impostors

The Camouflager is an Impostor which can additionally activate a camouflage mode. The camouflage mode lasts for 10s and while it is active, all player names/pets/hats are hidden and all players have the same color.

NOTE:

  • The Mini will look like all the other players
  • The color of the footprints turns gray (also the ones that were already on the ground).
  • The Hacker sees gray icons on the admin table
  • The shield is not visible anymore
  • Tracker and Snitch arrows keep working

Game Options

Name Description
Camouflager Spawn Chance -
Camouflager Cooldown -
Camo Duration Time players stay camouflaged

Vampire

Team: Impostors

The Vampire is an Impostor, that can bite other player. Bitten players die after a configurable amount of time.
If the Vampire spawn chance is greater 0 (even if there is no Vampire in the game), all players can place one garlic.
If a victim is near a garlic, the "Bite Button" turns into the default "Kill Button" and the Vampire can only perform a normal kill.

NOTE:

  • If a bitten player is still alive when a meeting is being called, they die at the start of the meeting.
  • The cooldown is the same as the default kill cooldown (+ the kill delay if the Vampire bites the target).
  • If there is a Vampire in the game, there can't be a Warlock.

Game Options

Name Description
Vampire Spawn Chance -
Vampire Kill Delay -
Vampire Cooldown Sets the kill/bite cooldown
Vampire Can Kill Near Garlics The Vampire can never bite when their victim is near a garlic. If this option is set to true, they can still perform a normal kill there.

Eraser

Team: Impostors

The Eraser is an Impostor that can erase the role of every player.
The targeted players will lose their role after the meeting right before a player is exiled.
After every erase, the cooldown increases by 10 seconds.
The erase will be performed, even if the Eraser or their target die before the next meeting.
By default the Eraser can erase everyone but the Spy and other Impostors. Depending on the options they can also erase them (Impostors will lose their special Impostor ability).
NOTE:

  • The Shifter shift will always be triggered before the Erase (hence either the new role of the Shifter will be erased or the Shifter saves the role of their target, depending on whom the Eraser erased)
  • Erasing a Lover automatically erases the other Lover as well (if the second Lover is an ImpLover, they will turn into an Impostor)
  • Erasing a Jackal that has a Sidekick, triggers the Sidekick promotion if it's activated in the settings
  • As the erase is being triggered before the ejection of a player, erasing and voting out a Lover in the same round, would result in the ex-Lover surviving, as the partnership was erased before. Also a Jester win would not happen, as the erase will be triggered before.

Game Options

Name Description
Eraser Spawn Chance -
Eraser Cooldown The Eraser's cooldown will increase by 10 seconds after every erase.
Eraser Can Erase Anyone If set to false, they can't erase the Spy and other Impostors

Trickster

Team: Impostors

The Trickster is an Impostor that can place 3 jack-in-the-boxes that are invisible at first to other players.
If the Trickster has placed all of their boxes they will be converted into a vent network usable only by the Trickster themself, but the boxes are revealed to the others.
If the boxes are converted to a vent network, the Trickster gains a new ability "Lights out" to limit the visibility of Non-Impostors, that cannot be fixed by other players. Lights are automatically restored after a while.\


NOTE:

  • Impostors will get a text indicator at the bottom of the screen to notify them if the lights are out due to the Trickster ability, as there is no sabotage arrows or task to sabotage text to otherwise notify them about it.

Game Options

Name Description
Trickster Spawn Chance -
Trickster Box Cooldown Cooldown for placing jack-in-the-boxes
Trickster Lights Out Cooldown Cooldown for their "lights out" ability
Trickster Lights Out Duration Duration after which the light is automatically restored

Cleaner

Team: Impostors

The Cleaner is an Impostor who has the ability to clean up dead bodies.\


NOTE:

  • The Kill and Clean cooldown are shared, preventing them from immediately cleaning their own kills.

Game Options

Name Description
Cleaner Spawn Chance -
Cleaner Cooldown Cooldown for cleaning dead bodies

Warlock

Team: Impostors

The Warlock is an Impostor, that can curse another player (the cursed player doesn't get notified).
If the cursed person stands next to another player, the Warlock is able to kill that player (no matter how far away they are).
Performing a kill with the help of a cursed player, will lift the curse and it will result in the Warlock being unable to move for a configurable amount of time.
The Warlock can still perform normal kills, but the two buttons share the same cooldown.\


NOTE:

  • The Warlock can always kill their Impostor mates (and even themself) using the "cursed kill"
  • If there is a Warlock in the game, there can't be a Vampire
  • Performing a normal kill, doesn't lift the curse

Game Options

Name Description
Warlock Spawn Chance -
Warlock Cooldown Cooldown for using the Curse and curse Kill
Warlock Root Time Time the Warlock is rooted in place after killing using the curse

Bounty Hunter

Team: Impostors


Created by Mallöris

The Bounty Hunter is an Impostor, that continuously get bounties (the targeted player doesn't get notified).
The target of the Bounty Hunter swaps after every meeting and after a configurable amount of time.
If the Bounty Hunter kills their target, their kill cooldown will be a lot less than usual.
Killing a player that's not their current target results in an increased kill cooldown.
Depending on the options, there'll be an arrow pointing towards the current target.\


NOTE:

  • The target won't be an Impostor or a Spy
  • Killing the target resets the timer and a new target will be selected.

Game Options

Name Description
Bounty Hunter Spawn Chance -
Duration After Which Bounty Changes -
Cooldown After Killing Bounty -
Additional Cooldown After Killing Others Time will be added to the normal impostor cooldown if the Bounty Hunter kills a not-bounty player
Show Arrow Pointing Towards The Bounty If set to true an arrow will appear (only visiable for the Bounty Hunter)
Bounty Hunter Arrow Update Interval Sets how often the position is being updated

Witch

Team: Impostors

The Witch is an Impostor who has the ability to cast a spell on other players.
During the next meeting, the spellbound player will be highlighted and they'll die right after the meeting.
There are multiple options listed down below with which you can configure to fit your taste.
Similar to the Vampire, shields and blanks will be checked twice (at the end of casting the spell on the player and at the end of the meeting, when the spell will be activated).
This can result in players being marked as spelled during the meeting, but not dying in the end (when they get a shield or the Witch gets blanked after they were spelled by the Witch).
If the Witch dies before the meeting starts or if the Witch is being guessed during the meeting, the spellbound players will be highlighted but they'll survive in any case.
Depending on the options you can choose whether voting the Witch out will save all the spellbound players or not.\


NOTE:

  • The spellbound players will die before the voted player dies (which might trigger e.g. trigger an Impostor win condition, even if the Witch is the one being voted)

\

Game Options

Name Description
Witch Spawn Chance -
Witch Spell Casting Cooldown -
Witch Additional Cooldown The spell casting cooldown will be increased by the amount you set here after each spell
Witch Can Spell Everyone If set to false, the witch can't spell the Spy and other Impostors
Witch Spell Casting Duration The time that you need to stay next to the target in order to cast a spell on it
Trigger Both Cooldowns If set to true, casting a spell will also trigger cooldown of the kill button and vice versa (but the two cooldowns may vary)
Voting The Witch Saves All The Targets If set to true, all the cursed targets will survive at the end of the meeting

Guesser

Team: Crewmates or Impostors

The Guesser can be a Crewmate or an Impostor (depending on the settings).
The Guesser can shoot players during the meeting, by guessing its role. If the guess is wrong, the Guesser dies instead.
You can select how many players can be shot per game and if multiple players can be shot during a single meeting.
The guesses Impostor and Crewmate are only right, if the player is part of the corresponding team and has no special role.
You can only shoot during the voting time.
Depending on the options, the Guesser can't guess the shielded player and depending on the Medic options the Medic/shielded player might be notified (no one will die, independently of what the Guesser guessed).

NOTE:

  • The vote of a shot player, won't be counted
  • You can't guess the role Nice Mini for obvious reasons
  • You can't guess the role Lover, you'll have to guess the primary role of one of the Lovers, to kill both of them
  • Jester wins won't be triggered, if the Guesser shoots the Jester before the Jester gets voted out

Game Options

Name Description
Guesser Spawn Chance -
Chance That The Guesser Is An Impostor -
Guesser Number Of Shots Per Game -
Guesser Can Shoot Multiple Times Per Meeting -
Guesses Visible In Ghost Chat -
Guesses Ignore The Medic Shield -
Evil Guesser Can Guess The Spy -
Both Guesser Spawn Rate -

Lovers

Team: Lovers (and secondary team)

There are always two Lovers which are linked together.
Their primary goal is it to stay alive together until the end of the game.
If one Lover dies (and the option is activated), the other Lover suicides.
You can select if Lovers are able to have a second role (could be a Neutral, Crewmate or Impostor Role)
You can specify the chance of one Lover being an Impostor.
The Lovers never know the role of their partner, they only see who their partner is.
The Lovers win, if they are both alive when the game ends. They can also win with their original team (e.g. a dead Impostor Lover can win with the Impostors, an Arsonist Lover can still achieve an Arsonist win)
If one of the Lovers is a killer (i.e. Jackal/Sidekick/Impostor), they can achieve a "Lovers solo win" where only the Lovers win.
If there is no killer among the Lovers (e.g. an Arsonist Lover + Crewmate Lover) and they are both alive when the game ends, they win together with the Crewmates.
If there's a team Impostor/Jackal Lover in the game, the tasks of a Crewmate Lover won't be counted (for a task win) as long as they're alive. If the Lover dies, their tasks will also be counted.

NOTE:

  • In a 2 Cremates vs 2 Impostors (or 2 members of team Jackal) and the Lovers are not in the same team, the game is not automatically over since the Lovers can still achieve a solo win. E.g. if there are the following roles Impostor + ImpLover + Lover + Crewmate left, the game will not end and the next kill will decide if the Impostors or Lovers win.
  • The Lovers can change if the Shifter takes the role of a Lovers

Game Options

Name Description
Lovers Spawn Chance -
Chance That One Lover Is Impostor -
Both Lovers Die Whether the second Lover suicides, if the first one dies
Lovers Can Have Another Role If set to true, the Lovers can have a second role

Sheriff

Team: Crewmates

The Sheriff has the ability to kill Impostors. If they try to kill a Crewmate, they die instead.

NOTE:

  • If the Sheriff shoots the person the Medic shielded, the Sheriff and the shielded person both remain unharmed.
  • If the Sheriff shoots a Mini Impostor, the Sheriff dies if the Mini is still growing up. If it's 18, the Mini Impostor dies.

Game Options

Name Description
Sheriff Spawn Chance -
Sheriff Cooldown -
Neutrals Can Die To Sheriff -

Jester

Team: Neutral

The Jester does not have any tasks. They win the game as a solo, if they get voted out during a meeting.

Game Options

Name Description
Jester Spawn Chance -
Jester Can Call Emergency Meeting Option to disable the emergency button for the Jester

Arsonist

Team: Neutral

The Arsonist does not have any tasks, they have to win the game as a solo.
The Arsonist can douse other players by pressing the douse button and remaining next to the player for a few seconds.
If the player that the Arsonist douses walks out of range, the cooldown will reset to 0.
After dousing everyone alive the Arsonist can ignite all the players which results in an Arsonist win.

Game Options

Name Description
Arsonist Spawn Chance -
Arsonist Countdown -
Arsonist Douse Duration The time it takes to douse a player

Seer

Team: Crewmates

The Seer has two abilities (one can activate one of them or both in the options). The Seer sees the souls of players that died a round earlier, the souls slowly fade away. The Seer gets a blue flash on their screen, if a player dies somewhere on the map.

Game Options

Name Description
Seer Spawn Chance -
Seer Mode Options: Show death flash and souls, show death flash, show souls
Seer Limit Soul Duration Toggle if souls should turn invisible after a while
Seer Soul Duration Sets how long it will take the souls to turn invisible after a meeting

Engineer

Team: Crewmates

The Engineer (if alive) can fix a certain amount of sabotages per game from anywhere on the map.
The Engineer can use vents.
If the Engineer is inside a vent, depending on the options the members of the team Jackal/Impostors will see a blue outline around all vents on the map (in order to warn them). Because of the vents the Engineer might not be able to start some tasks using the "Use" button, you can double-click on the tasks instead.

NOTE:

  • The kill button of Impostors activates if they stand next to a vent where the Engineer is. They can also kill them there. No other action (e.g. Morphling sample, Shifter shift, ...) can affect players inside vents.

Game Options

Name Description
Engineer Spawn Chance -
Number Of Sabotage Fixes -
Impostors See Vents Highlighted -
Jackal and Sidekick See Vents Highlighted -

Detective

Team: Crewmates

The Detective can see footprints that other players leave behind. The Detective's other feature shows when they report a corpse: they receive clues about the killer's identity. The type of information they get is based on the time it took them to find the corpse.
NOTE:

  • When people change their colors (because of a morph or camouflage), all the footprints also change their colors (also the ones that were already on the ground). If the effects are over, all footprints switch back to the original color.
  • The Detective does not see footprints of players that sit in vents
  • More information about the colors
  • During the meetings you can see, whether a player wears a darker or a lighter color, represented by (D) or (L) in the names.

Game Options

Name Description
Detective Spawn Chance -
Anonymous Footprints If set to true, all footprints will have the same color. Otherwise they will have the color of the respective player.
Footprint Interval The interval between two footprints
Footprint Duration Sets how long the footprints remain visible.
Time Where Detective Reports Will Have Name The amount of time that the Detective will have to report the body since death to get the killer's name.
Time Where Detective Reports Will Have Color Type The amount of time that the Detective will have to report the body since death to get the killer's color type.

Lighter

Team: Crewmates

The Lighter can turn on their Lighter every now and then, which increases their vision by a customizable amount.

Game Options

Name Description
Lighter Spawn Chance -
Lighter Mode Vision On Lights On The vision the Lighter has when the lights are on and the Lighter mode is on
Lighter Mode Vision On Lights Off The vision the Lighter has when the lights are down and the Lighter mode is on
Lighter Cooldown -
Lighter Duration -

Mini

Team: Crewmates or Impostors

The Mini can be a Crewmate (67% chance) or an Impostor (33% chance).
The Mini's character is smaller and hence visible to everyone in the game.
The Mini cannot be killed until it turns 18 years old, however it can be voted out.
Impostor Mini:

  • While growing up the kill cooldown is doubled. When it's fully grown up its kill cooldown is 2/3 of the default one.
  • If it gets thrown out of the ship, everything is fine.

Crewmate Mini:

  • The Crewmate Mini aims to play out the strength its invincibility in the early game.
  • If it gets thrown out of the ship before it turns 18, everyone loses. So think twice before you vote out a Mini.

NOTE:

  • If the Sheriff tries to kill the Mini before it's fully grown, they die, no matter if the Mini is a Crewmate or Impostor
  • The Sheriff can kill the Impostor Mini, but only if it's fully grown up

Game Options

Name Description
Mini Spawn Chance -
Mini Mini Growing Up Duration

Medic

Team: Crewmates

The Medic can shield (highlighted by an outline around the player) one player per game, which makes the player unkillable.
The shielded player can still be voted out and might also be an Impostor.
If set in the options, the shielded player and/or the Medic will get a red flash on their screen if someone (Impostor, Sheriff, ...) tried to murder them. If the Medic dies, the shield disappears with them.
The Sheriff will not die if they try to kill a shielded Crewmate and won't perform a kill if they try to kill a shielded Impostor.
Depending on the options, guesses from the Guesser will be blocked by the shield and the shielded player/medic might be notified.
The Medic's other feature shows when they report a corpse: they will see how long ago the player died.
NOTE:

  • If the shielded player is a Lover and the other Lover dies, they nevertheless kill themselves.
  • If the Shifter has a shield or their target has a Shield, the shielded player switches.
  • Shields set after the next meeting, will be set before a possible shift is being performed.

Game Options

Name Description Options
Medic Spawn Chance - -
Show Shielded Player Sets who sees if a player has a shield "Everyone", "Shielded + Medic", "Medic"
Shielded Player Sees Murder Attempt Whether a shielded player sees if someone tries to kill them True/false
Shield Will Be Set After Next Meeting - True/false
Medic Sees Murder Attempt On Shielded Player - If anyone tries to harm the shielded player (Impostor, Sheriff, Guesser, ...), the Medic will see a red flash

Mayor

Team: Crewmates

The Mayor leads the Crewmates by having a vote that counts twice.
The Mayor can always use their meeting, even if the maximum number of meetings was reached.

Game Options

Name Description
Mayor Spawn Chance -

Hacker

Team: Crewmates

If the Hacker activates the "Hacker mode", the Hacker gets more information than others from the admin table and vitals for a set duration.
Otherwise they see the same information as everyone else. Admin table: The Hacker can see the colors (or color types) of the players on the table.
Vitals: The Hacker can see how long dead players have been dead for.
The Hacker can access his mobile gadgets (vitals & admin table), with a maximum of charges (uses) and a configurable amount of tasks needed to recharge.

NOTE:

  • If the Morphling morphs or the Camouflager camouflages, the colors on the admin table change accordingly
  • More information about the colors
  • During the meetings you can see, whether a player wears a darker or a lighter color, represented by (D) or (L) in the names.

Game Options

Name Description
Hacker Spawn Chance -
Hacker Cooldown -
Hacker Duration Sets how long the "Hacker mode" remains active
Hacker Only Sees Color Type Sets if the Hacker sees the player colors on the admin table or only white/gray (for Lighter and darker colors)
Max Mobile Gadget Charges -
Number Of Tasks Needed For Recharging Number of tasks to get a charge

Shifter

Team: Crewmates

The Shifter can take over the role of another Crewmate, the other player will transform into a Crewmate.
The Shift will always be performed at the end of the next meeting right before a player is exiled. The target needs to be chosen during the round.
Even if the Shifter or the target dies before the meeting, the Shift will still be performed.
Swapping roles with an Impostor or Neutral fails and the Shifter commits suicide after the next meeting (there won't be any body).
The Shifter aims to save roles from leaving the game, by e.g. taking over a Sheriff or Medic that is known to the Impostors.
This works especially well against the Eraser, but also gives the Eraser the possibility to act like a Shifter.
The special interactions with the Shifter are noted in the chapters of the respective roles.

NOTE:

  • The Shifter shift will always be triggered before the Erase (hence either the new role of the Shifter will be erased or the Shifter saves the role of their target, depending on whom the Eraser erased)
  • If the Shifter takes over a role, their new cooldowns will start at the maximum cooldown of the ability
  • One time use abilities (e.g. shielding a player or Engineer sabotage fix) can only used by one player in the game (i.e. the Shifter can only use them, if the previous player did not use them before)

Game Options

Name Description
Shifter Spawn Chance -
Shifter Shifts Modifiers Sets if Lovers and/or Medic Shield will be shifted

Time Master

Team: Crewmates

The Time Master has a time shield which they can activate. The time shield remains active for a configurable amount of time.
If a player tries to kill the Time Master while the time shield is active, the kill won't happen and the time will rewind for a set amount of time.
The kill cooldown of the killer won't be reset, so the Time Master has to make sure that the game won't result in the same situation.
The Time Master won't be affected by the rewind.

NOTE:

  • Only the movement is affected by the rewind.
  • A Vampire bite will trigger the rewind. If the Time Master misses shielding the bite, they can still shield the kill which happens a few seconds later.
  • If the Time Master was bitten and has their shield active before when a meeting is called, they survive but the time won't be rewound.
  • If the Time Master has a Medic shield, they won't rewind.
  • The shield itself ends immediately when triggered. So the Time Master can be attacked again as soon as the rewind ends.

Game Options

Name Description
Time Master Spawn Chance -
Time Master Cooldown -
Rewind Duration How much time to rewind
Time Master Shield Duration

Swapper

Team: Crewmates

During meetings the Swapper can exchange votes that two people get (i.e. all votes that player A got will be given to player B and vice versa).
Because of the Swapper's strength in meetings, they might not start emergency meetings and can't fix lights and comms.

Game Options

Name Description
Swapper Spawn Chance -
Swapper can call emergency meeting Option to disable the emergency button for the Swapper
Swapper can only swap others Sets whether the Swapper can swap themself or not

Tracker

Team: Crewmates

The Tracker can select one player to track. Depending on the options the Tracker can track a different person after each meeting or the Tracker tracks the same person for the whole game. An arrow points to the last tracked position of the player. The arrow updates its position every few seconds (configurable). Depending on the options, the Tracker has another ability: They can track all corpses on the map for a set amount of time. They will keep tracking corpses, even if they were cleaned or eaten by the Vulture.

Game Options

Name Description
Tracker Spawn Chance -
Tracker Update Interval Sets how often the position is being updated
Tracker Reset Target After Meeting -
Tracker Can Track Corpses -
Corpses Tracking Cooldown -
Corpses Tracking Duration -

Snitch

Team: Crewmates

When the Snitch finishes all the tasks, arrows will appear (only visible to the Snitch) that point to the Impostors (depending on the options also to members of team Jackal). When the Snitch has one task left (configurable) the Snitch will be revealed to the Impostors (depending on the options also to members of team Jackal) with an arrow pointing to the Snitch.

Game Options

Name Description
Snitch Spawn Chance -
Task Count Where The Snitch Will Be Revealed -
Include Team Jackal -
Use Different Arrow Color For Team Jackal -

Jackal

Team: Jackal

The Jackal is part of an extra team, that tries to eliminate all the other players.
The Jackal has no tasks and can kill Impostors, Crewmates and Neutrals.
The Jackal (if allowed by the options) can select another player to be their Sidekick. Creating a Sidekick removes all tasks of the Sidekick and adds them to the team Jackal. The Sidekick loses their current role (except if they're a Lover, then they play in two teams). The "Create Sidekick Action" may only be used once per Jackal or once per game (depending on the options). The Jackal can also promote Impostors to be their Sidekick but, depending on the options the Impostor will either really turn into the Sidekick and leave the team Impostors or they will just look like the Sidekick to the Jackal and remain as they were.

The team Jackal enables multiple new outcomes of the game, listing some examples here:

  • The Impostors could be eliminated and then the crew plays against the team Jackal.
  • The Crew could be eliminated, then the Team Jackal fight against the Impostors (The Crew can still make a task win in this scenario)

The priority of the win conditions is the following:

  1. Crewmate Mini lose by vote
  2. Jester wins by vote
  3. Arsonist win
  4. Team Impostor wins by sabotage
  5. Team Crew wins by tasks (also possible if the whole Crew is dead)
  6. Lovers among the last three players win
  7. Team Jackal wins by outnumbering (When the team Jackal contains an equal or greater amount of players than the Crew and there are 0 Impostors left and team Jackal contains no Lover)
  8. Team Impostor wins by outnumbering (When the team Impostors contains an equal or greater amount of players than the Crew and there are 0 players of the team Jackal left and team Impostors contains no Lover)
  9. Team Crew wins by outnumbering (When there is no player of the team Jackal and the team Impostors left)

NOTE:

  • The Jackal (and their Sidekick) may be killed by a Sheriff.
  • A Jackal cannot target the Mini, while it's growing up. After that they can kill it or select it as its Sidekick.
  • The Crew can still win, even if all of their members are dead, if they finish their tasks fast enough (That's why converting the last Crewmate with tasks left into a Sidekick results in a task win for the crew.)

If both Impostors and Jackals are in the game the game, continues even if all Crewmates are dead. Crewmates may still win in this case by completing their tasks. Jackal and Impostor have to kill each other.

Game Options

Name Description
Jackal Spawn Chance -
Jackal/Sidekick Kill Cooldown Kill cooldown
Jackal Create Sidekick Cooldown Cooldown before a Sidekick can be created
Jackal can use vents Yes/No
Jackal can create a Sidekick Yes/No
Jackals promoted from Sidekick can create a Sidekick Yes/No (to prevent the Jackal team from growing)
Jackals can make an Impostor to their Sidekick Yes/No (to prevent a Jackal from turning an Impostor into a Sidekick, if they use the ability on an Impostor they see the Impostor as Sidekick, but the Impostor isn't converted to Sidekick. If this option is set to "No" Jackal and Sidekick can kill each other.)
Jackal and Sidekick have Impostor vision -

Sidekick

Team: Jackal

Gets assigned to a player during the game by the "Create Sidekick Action" of the Jackal and joins the Jackal in their quest to eliminate all other players.
Upon the death of the Jackal (depending on the options), they might get promoted to Jackal themself and potentially even assign a Sidekick of their own.
NOTE:

  • A player that converts into a Sidekick loses their previous role and tasks (if they had one), except the Lover role.
  • The Sidekick may be killed by a Sheriff.
  • The Sidekick cannot target the Mini, while it's growing up.

Game Options

Name Description
Jackal/Sidekick Kill Cooldown Uses the same kill cooldown setting as the Jackal
Sidekick gets promoted to Jackal on Jackal death Yes/No
Sidekick can kill Yes/No
Sidekick can use vents Yes/No

Spy

Team: Crewmates

The Spy is a Crewmate, which has no special abilities.
The Spy looks like an additional Impostor to the Impostors, they can't tell the difference.
There are two possibilities (depending on the set options):

  • The Impostors can't kill the Spy (because otherwise their kill button would reveal, who the Spy is)
  • The Impostors can kill the Spy but they can also kill their Impostor partner (if they mistake another Impostor for the Spy) You can set whether the Sheriff can kill the Spy or not (in order to keep the lie alive).

Game Options

Name Description
Spy Spawn Chance
Spy Can Die To Sheriff
Impostors Can Kill Anyone If There Is A Spy This allows the Impostors to kill both the Spy and their Impostor partners
Spy Can Enter Vents Allow the Spy to enter/exit vents (but not actually move to connected vents)
Spy Has Impostor Vision Give the Spy the same vision as the Impostors have

Security Guard

Team: Crewmates

The Security Guard is a Crewmate that has a certain number of screws that they can use for either sealing vents or for placing new cameras.
Placing a new camera and sealing vents takes a configurable amount of screws. The total number of screws that a Security Guard has can also be configured.
The new camera will be visible after the next meeting and accessible by everyone.
The vents will be sealed after the next meeting, players can't enter or exit sealed vents, but they can still "move to them" underground.
NOTE:

  • Trickster boxes can't be sealed
  • The Security Guard can't place Cameras on MiraHQ
  • The remaining number of screws can be seen above their special button
  • On Skeld the four cameras will be replaced every 3 seconds (with the next four cameras). You can also navigate manually using the arrow keys.

Game Options

Name Description
Security Guard Spawn Chance
Security Guard Cooldown
Security Guard Number Of Screws The number of screws that a Security Guard can use in a game
Number Of Screws Per Cam The number of screws it takes to place a camera
Number Of Screws Per Vent The number of screws it takes to seal a vent

Bait

Team: Crewmates


Created by Mallöris

The Bait is a Crewmate that if killed, forces the killer to self report the body (you can configure a delay in the options). Additionally, the Bait can see if someone is inside a vent (depending on the options the exact vent gets an outline or all vents do).

Game Options

Name Description
Bait Spawn Chance -
Bait Highlight All Vents If set to true, all vents will be highlighted if a player is inside of one of them. If set to false, only the vents where players are siting in will be highlighted.
Bait Report Delay -
Warn The Killer With A Flash -

Medium

Team: Crewmates


Created by Mallöris

The medium is a crewmate who can ask the souls of dead players for information. Like the Seer, it sees the places where the players have died (after the next meeting) and can question them. It then gets random information about the soul or the killer in the chat. The souls only stay for one round, i.e. until the next meeting. Depending on the options, the souls can only be questioned once and then disappear. During the meetings you can see, whether a player wears a darker or a lighter color, represented by (D) or (L) in the names.

Questions: What is your Role? What is your killer's color type? When did you die? What is your killers role? (mini exluded)

Game Options

Name Description
Medium Spawn Chance -
Medium Cooldown -
Medium Duration The time it takes to question a soul
Medium Each Soul Can Only Be Questioned Once If set to true, souls can only be questioned once and then disappear

Vulture

Team: Neutral


Created by Mallöris

The Vulture does not have any tasks, they have to win the game as a solo.
The Vulture is a neutral role that must eat a specified number of corpses (depending on the options) in order to win.
Depending on the options, when a player dies, the Vulture gets an arrow pointing to the corpse.

Game Options

Name Description
Vulture Spawn Chance -
Vulture Countdown -
Number Of Corpses Needed To Be Eaten Corpes needed to be eaten to win the game
Vulture Can Use Vents -
Show Arrows Pointing Towards The Corpes -

Lawyer

Team: Neutral

The Lawyer is a neutral role that has a client. The client might be an Impostor or Jackal which is no Lover. The Lawyer needs their client to win in order to win the game. If their client dies or gets voted out, the Lawyer changes their role and becomes the Pursuer, which has a different goal to win the game. The main goal of the Lawyer is to win as Lawyer, as it is not allowed to betray their client.

The Lawyer can win in multiple ways:

  • Lawyer dead, client alive and client team won: The Lawyer wins together with the team of the client
  • Lawyer and client alive and client team won: The Lawyer wins with the team of the client. The client doesn't win (even if their Impostor/Team Jackal mate wins), the Lawyer steals their win. Hence the client should keep the Lawyer alive for some time, to get some help during the meetings, but has to eliminate them soon enough to not get their win stolen.

NOTE:

  • If the client disconnects, the Lawyer will also turn into the Pursuer
  • If "Lawyer Target Knows" is set to true, the client will know that someone is their Lawyer, but won't know who.

Game Options

Name Description
Lawyer Target Knows The target knows that it is the target (marked with "§", if the Lawyer dies, the mark will disappear)
Lawyer Wins After Meetings If set to true, the Lawyer wins after a configurable amount of meetings (can't start meetings himself)
Lawyer Needed Meetings To Win -
Lawyer Vision Pursuer has normal vision
Lawyer Knows Target Role -
Pursuer Blank Cooldown -
Pursuer Number Of Blanks -

Pursuer

Team: Neutral

The Pursuer is still a neutral role, but has a different goal to win the game; they have to be alive when the game ends (no matter who causes the win). In order to achieve this goal, the Pursuer has an ability called "Blank", where they can fill a killers (this also includes the Sheriff) weapon with a blank. So, if the killer attempts to kill someone, the killer will miss their target, and their cooldowns will be triggered as usual. If the killer fires the "Blank", shields (e.g. Medic shield or Time Master shield) will not be triggered. The Pursuer has tasks (which can already be done while being a Lawyer), that count towards the task win for the Crewmates. If the Pursuer dies, their tasks won't be counted anymore.

Source code

It's bad I know, this is a side project and my second week of modding. So there are no best practices around here. You can use parts of the code but don't copy paste the whole thing. Make sure you give credits to the other developers, because some parts of the code are based on theirs.

Bugs, suggestions and requests

If you found any bugs, have an idea for a new role or any other request, join our Discord server.

Copyedit

Thanks for fixing our typos jacktose ✌️

theotherroles's People

Contributors

acesfullofkings avatar amsyarasyiq avatar developer626 avatar dwd0tcom avatar eisbison avatar eof-1141 avatar gendelo3 avatar gsoneill avatar mallaris avatar nicholas-marty-f24 avatar thunderstorm584 avatar tomarai avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.