EnoPM / BetterOtherRoles

Among Us mod based on TheOtherRoles with more roles & better Among Us experience
GNU General Public License v3.0
13 stars 5 forks source link

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.

To other mod devs: for usage of our code, please read and respect the license

Better Other Roles

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

Impostor Crewmate Neutral Modifier Gamemode
Godfather (Mafia) Mayor Jester Bloody Classic
Mafioso (Mafia) Engineer Arsonist Anti Teleport Guesser Modifier
Janitor (Mafia) Sheriff Jackal Tie Breaker Hide 'n' Seek
Morphling Deputy Sidekick Bait Vanilla Hide 'n' Seek
Camouflager Lighter Vulture Lovers
Vampire Detective Lawyer Sunglasses
Eraser Time Master Prosecutor Mini
Trickster Medic Pursuer VIP
Cleaner Swapper Thief Invert
Warlock Seer Chameleon
Bounty Hunter Hacker Shifter
Witch Tracker
Ninja Snitch
Bomber Spy
Evil Guesser Portalmaker
Undertaker Security Guard
Sticky Bomber Medium
Trapper
Nice Guesser

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

Releases

Among Us - Version Mod Version Link
2023.10.24 v1.5.2 Download
2023.07.12s v1.4.4 Download

Changelog

Click to show the Changelog **Version 1.5.x** - Updated to Among Us version 2023.10.24 **Version 1.4.x** - Updated to Among Us version 2023.07.12 - Fixed an issue where some users was disconnected in lobby - Added a new impostor role: Sticky Bomber **Version 1.3.x** - Added a new impostor role: Undertaker

Installation

Windows Installation Steam

  1. Download the newest release
  2. Find the folder of your game. You can right click on the game in your library, a menu will appear, click on properties, local data, browse
  3. Go back one folder to common and make a copy of your Among Us game folder and paste it somewhere on the same drive.
  4. Now unzip and drag or extract the files from the .zip into your Among Us game folder that you just copied, at the .exe level (just into the folder).
  5. Run the game by starting the .exe from this folder (the first launch might take a while).

Not working? You might want to install the dependency vc_redist

Windows Installation Epic

  1. Download the newest release
  2. Find the folder of your game. Should be stored in "Epic/AmongUs" (wherever you installed Epic on your PC)
  3. Now unzip and drag or extract the files from the .zip into the original Epic Among Us game folder.
  4. Run the game by starting the game in your Epic Games launcher (the first launch might take a while).

Not working? You might want to install the dependency vc_redist

Install

Linux Installation

  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/proton_wine.html)
  4. Launch the game via Steam

Better Other Roles Custom Servers

A custom server is not necessary and official servers are working just fine with the mod, but in case you want to set up and host your own server, here's a guide for you to follow.

Setup the Server:

  1. Get the Impostor release (https://github.com/Impostor/Impostor)
  2. Follow the steps (using the server release you just downloaded) on the official Impostor-Documentation (https://github.com/Impostor/Impostor/wiki/Running-the-server)
  3. Make sure to set the following values to false in the config.json file:
     'AntiCheat': {
       'Enabled': false,
      'BanIpFromGame': false
    }
  4. Make sure to forward the right ports on the hosting machine.
  5. 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 we need to set the environment variables to disable the AntiCheat feature. IMPOSTOR_AntiCheatEnabled=false IMPOSTOR_AntiCheatBanIpFromGame=false

Example to docker run command: docker run -p 22023:22023/udp --env IMPOSTOR_AntiCheatEnabled=false --env IMPOSTOR_AntiCheatBanIpFromGame=false aeonlucid/impostor:nightly

Or use to run it in the background docker run -d -p 22023:22023/udp --env IMPOSTOR_AntiCheatEnabled=false --env IMPOSTOR_AntiCheatBanIpFromGame=false aeonlucid/impostor:nightly

If you have any problems regarding custom servers, please contact https://github.com/Impostor/Impostor or https://discord.gg/ThJUGAsz

The Other Roles - Credits & Resources

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

Jackal and Sidekick - Original idea for the Jackal and Sidekick came from Dhalucard\ Among-Us-Love-Couple-Mod - Idea for the Lovers modifier came from Woodi-dev\ Jester - Idea for the Jester role came from Maartii\ ExtraRolesAmongUs - Idea for the Engineer and Medic role came from NotHunter101. Also some code snippets from their implementation were used.\ Among-Us-Sheriff-Mod - Idea for the Sheriff role came from Woodi-dev\ TooManyRolesMods - Idea for the Detective and Time Master roles came from Hardel-DW. Also some code snippets from their implementation were used.\ TownOfUs - Idea for the Swapper, Shifter, Arsonist and a similar Mayor role came from Slushiegoose\ Ottomated - Idea for the Morphling, Snitch and Camouflager role came from Ottomated\ Crowded-Mod - Our implementation for 10+ player lobbies were inspired by the one from the Crowded Mod Team\ Goose-Goose-Duck - Idea for the Vulture role came from Slushiegoose\ TheEpicRoles - Idea for the first kill shield (partly) and the tabbed option menu (fully + some code), by LaicosVK DasMonschta Nova\ Ninja, Thief, Lawyer / Pursuer, Deputy, Portalmaker, Guesser Modifier - Idea: K3ndo ; Developed by Gendelo & Mallöris

Settings

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

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

Random Maps

Play On A Random Map If enabled it allows you to set percentages for each current map.

Finish Tasks Before Haunting Or Zooming Out You have to finish your tasks before you get the possibility to zoom out.

Use Random Map Setting Presets: When this option is turned on, the game will switch to the Random Preset <MapName> when a game is started on a random map. This includes vanilla options!. This makes it possible to e.g. play with less tasks on large maps like Airship. The game will remain in the preset for that random map after the match.

The random map presets can still be used like normal presets, if you turn of Play On A Random Map (make sure you do this in all presets you are using).

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:

Colors

TOR Colors

Roles

Role Assignment

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:

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:

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:

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:

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:

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:

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:

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:

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:

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

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:

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:

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

Ninja

Team: Impostors

The Ninja is an Impostor who has the ability to kill another player all over the map.\ You can mark a player with your ability and by using the ability again, you jump to the position of the marked player and kill it.\ Depending on the options you know where your marked player is.\ If the Ninja uses its ability, it will leave a trace (leaves) for a configurable amount of time where it activated the ability and additionally where it killed the before marked player.\ When performing a ninja ability kill, the ninja can be invisible for some seconds (depends on options)\ \ NOTE:

Game Options

Name Description
Ninja Spawn Chance -
Ninja Mark Cooldown -
Ninja Knows Location Of Target -
Trace Duration -
Time Till Trace Color Has Faded -
Time The Ninja Is Invisible -

Bomber

Team: Impostors

The Bomber is an Impostor who has the ability to be very explosive. They have the ability to plant bombs to spread grouping Crewmates and also kill them.\ The Bomber also has the ability to perform a normal kill like all Impostors.\ The plant time of the bomb can be different to the kill cooldown depending on the settings.\ Crewmates can defuse a bomb depending on the settings.

NOTE:

Game Options

Name Description
Bomber Spawn Chance -
Bomb Destruction Time -
Bomb Destruction Range -
Bomb Hear Range -
Bomb Defuse Duration -
Bomb Cooldown -
Bomb Is Active After

Undertaker

Team: Impostors

The Undertaker is an impostor who has the ability to drag a corpse to move it. He can benefit from a bonus or a penalty of speed while he drags a body according to the options.

NOTE:

Game Options

Name Description
Undertaker Spawn Chance -
Speed Modifier While Dragging -
Disable Vent While Dragging -

Sticky Bomber

Team: Impostors

The Sticky Bomber is an imposter that can stick a bomb to a player. The player who has the bomb will be alerted after a configurable delay and can pass the bomb to someone else. The player who ends up with the bomb when the timer reaches zero will die.

NOTE:

Game Options

Name Description
Sticky Bomber Spawn Chance -
Bomb Cooldown -
Bomb First Delay -
Bomb Other Delay -
Bomb Duration Before Explosion -
Display Remaining Time -
Sticky Bomber Can Receive Bomb -
Shielded Players Can Receive Bomb -
Has Kill Button -
Trigger Both Cooldown -

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:

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 -
Guesser Can't Guess Snitch When Tasks Completed -

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

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.\ Also if a Spy or Impostor gets sidekicked, they still will appear red to the Impostors.

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

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:

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:

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

Vulture

Team: Neutral

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.\ If there is a Vulture in the game, there can't be a Cleaner.

NOTE

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.\ Depending on the options, the client can also be a Jester.\ The Lawyer needs their client to win in order to win the game.\ Their client doesn't know that it is their client.\ If their client gets voted out, the Lawyer dies with the client.\ If their client dies, the Lawyer changes their role and becomes the Pursuer, which has a different goal to win the game.\ \ How the Lawyer wins:

NOTE:

Game Options

Name Description
Lawyer Spawn Chance -
Chance That The Lawyer Is Prosecutor -
Lawyer/Prosecutor Vision Pursuer has normal vision
Lawyer/Prosecutor Knows Target Role -
Lawyer/Prosecutor Can Call Emergency Meeting -
Lawyer Target Can Be The Jester -

Prosecutor

Team: Neutral

The Prosecutor is a neutral role that resembles the Lawyer. The Prosecutor has a client who is a Crewmate.\ The Prosecutor needs their client to be voted out in order to win the game.\ The Prosecutor's client doesn't know that they are their client.\ If the client gets sidekicked, the Prosecutor changes their role and becomes the client's Lawyer and has to protect the client from now on.\ If the Prosecutor's client dies, the Prosecutor changes their role and becomes the Pursuer, which has a different goal to win the game.

NOTE:

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 and the Crew wins.\ In order to achieve this goal, the Pursuer has an ability called "Blank", where they can fill a killer's (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/Prosecutor), that count towards the task win for the Crewmates. If the Pursuer dies, their tasks won't be counted anymore.

Game Options

Name Description
Pursuer Blank Cooldown -
Pursuer Number Of Blanks -

Thief

Team: Neutral

The Thief has to kill another killer (Impostor, Jackal/Sidekick and if enabled Sheriff) in order to have a win condition.\ If the Thief doesn't kill another killer they will lose the game.\ If the Thief kills one of the other killers, the Thief overtakes their role (e.g. Ninja) and joins their team (in this case team Impostor). They then have the new Role's win condition (e.g. Impostor-Win).\ If the Thief tries to kill any non-killing role (Crewmate or Neutral), they die similar to a misfiring Sheriff.\ \ NOTE

Game Options

Name Description
Thief Spawn Chance -
Thief Countdown -
Thief Can Kill Sheriff -
Thief Has Impostor Vision -
Thief Can Use Vents -
Thief Can Guess To Steal Role -
Stolen Player Keeps His Team If disabled the stolen player will become "Fallen". He will have no way to win the game

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.\ The Mayor has a portable Meeting Button, depending on the options.\ The Mayor can see the vote colors after completing a configurable amount of tasks, depending on the options.\ The Mayor has the option to vote with only one vote instead of two (via a button in the meeting screen), depending on the settings.

Game Options

Name Description
Mayor Spawn Chance -
Mayor Can See Vote Colors -
Completed Tasks Needed To See Vote Colors -
Mobile Emergency Button -
Mayor Can Choose Single Vote Off, On (Before Voting), On (Until Meeting Ends)

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:

Game Options

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

Sheriff

Team: Crewmates

The Sheriff has the ability to kill Impostors or Neutral roles if enabled.\ If they try to kill a Crewmate, they die instead.\ \ NOTE:

Game Options

Name Description
Sheriff Spawn Chance -
Sheriff Cooldown -
Sheriff Can Kill Neutrals -
Sheriff Has A Deputy Deputy can not be in game without Sheriff

Deputy

Team: Crewmates

The Deputy has the ability to handcuff player.\ Handcuffs will be hidden until the handcuffed player try to use a disabled button/hotkey.\ Handcuffs disable:

Game Options

Name Description
Deputy Number Of Handcuffs -
Handcuff Cooldown -
Handcuff Duration -
Sheriff And Deputy Know Each Other -
Deputy Gets Promoted To Sheriff "Off", "On (Immediately)" or "On (After Meeting)"
Deputy Keeps Handcuffs When Promoted -

Lighter

Team: Crewmates

The Lighter has a different vision than everyone else depending on the settings.\ Their vision looks like a flashlight cone which can be moved around (known from the Hide'n'Seek mode).

Game Options

Name Description
Lighter Spawn Chance -
Vision On Lights On The vision the Lighter has when the lights are on
Vision On Lights Off The vision the Lighter has when the lights are down
Flashlight Width -

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:

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.

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:

Game Options

Name Description
Time Master Spawn Chance -
Time Master Cooldown -
Rewind Duration How much time to rewind
Time Master Shield 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:

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 Activated Sets when the shield will be active "Instantly", "Instantly, Visible After Meeting", "After Meeting"
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

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.\ The Swapper now has initial swap charges and can recharge those charges after completing a configurable amount of tasks.\ \ NOTE:

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
Initial Swap Charges -
Number Of Tasks Needed For Recharging -

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

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.\ While accessing those mobile gadgets, the Hacker is not able to move.

NOTE:

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
Can't Move During Cam Duration -

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.

NOTE

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 their tasks, they will get information in chat of the last location of all killers when the meeting starts.\ When the Snitch only has a configurable amount of tasks left, it will be revealed that there is a Snitch in the game with a text on evil player's screens.

NOTE:

Game Options

Name Description
Snitch Spawn Chance -
Task Count Where The Snitch Will Be Revealed -
Information Mode Whether the snitch will get info on the map and/or in the chat
Targets Snitch Will See All Evil Players or Killing Evil Players

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

NOTE:

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

Portalmaker

Team: Crewmates

The Portalmaker is a Crewmate that can place two portals on the map.\ These two portals are connected to each other.\ Those portals will be visible after the next meeting and can be used by everyone.\ Additionally to that, the Portalmaker gets information about who used the portals and when in the chat during each meeting, depending on the options.\ The Portalmaker can teleport themself to their placed portals from anywhere if the setting is enabled.

NOTE:

Game Options

Name Description
Portalmaker Spawn Chance -
Portalmaker Cooldown -
Use Portal Cooldown -
Portalmaker Log Only Shows Color Type -
Log Shows Time -
Can Port To Portal From Everywhere -

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:

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
Security Guard Duration -
Gadget Max Charges -
Number Of Tasks Needed For Recharging -
Can't Move During Cam Duration -

Medium

Team: Crewmates

The medium is a crewmate who can ask the souls of dead players for information. Like the Seer, the medium will see the souls of the players who have died (after the next meeting) and can question them. They 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. \ Questions: The souls will always prefer to answer with the role specific information first!

Role specific:

Else random:

Chance That The Answer Contains Additional Information:

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
Chance That The Answer Contains The Remaining Amount Of Killing Roles Chance includes Sheriff and Thief

Trapper

Team: Crewmates

The Trapper is a crewmate which can set up traps to trap player and gain information from them.\ The traps will stuck player for x-seconds (depends on the setting) and reveal information in chat about their "Role", if they are a "Good/Evil Role" or their "Name".\ The trap is not visible until a configurable amount of player were trapped.\ When the trap gets visible, the Trapper will gain the information in chat (in a random order).\ If a trap is triggered (and the option is enabled), the map of the Trapper will open up and show which trap was triggered.\ The traps have a maximum of charges (uses) and a configurable amount of tasks are needed to recharge.\ \ NOTE:

Game Options

Name Description
Trapper Spawn Chance -
Trapper Cooldown -
Max Traps Charges -
Number Of Tasks Needed For Recharging -
Trap Needed Trigger To Reveal -
Show Anonymous Map -
Trap Information Type "Name", "Role", "Good/Evil Role"
Trap Duration -

Modifier

A Modifier is an addition to your Impostor/Neutral/Crewmate role. Some Modifiers can be ingame more than once (Quantity option).

Bloody

If killed, the Bloody Modifier will leave a trail for x-seconds on their killer. The trail will have the color of the killed person.\ \ NOTE

Game Options

Name Description
Bloody Spawn Chance -
Bloody Quantity -
Trail duration -

Anti Teleport

The Anti Teleport Modifier prevents the player from getting teleported to the Meeting Table if a body gets reported or an Emergency Meeting is called.\ The player will start the round where the previous one ended (Emergency Meeting Call/Body Report).\ \ NOTE

Game Options

Name Description
Anti Teleport Spawn Chance -
Anti Teleport Quantity -

Tie Breaker

If the Voting ends in a tie, the Tie Breaker takes place and the player with the Tie Breaker Modifier gets an extra vote thats not visible to anyone.\ Everyone will know if the Tie Breaker was involved in the Meeting or not.\ \ NOTE

Game Options

Name Description
Tie Breaker Spawn Chance -

Bait

The Bait forces the killer to self report the body (you can configure a delay in the options).\ There can be more than one Bait.

NOTE:

Game Options

Name Description
Bait Spawn Chance -
Bait Quantity -
Bait Report Delay Min -
Bait Report Delay Max -
Warn The Killer With A Flash -

Lovers

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 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 an Impostor/Jackal + Crewmate 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.\ You can enable an exclusive chat only for Lovers.

NOTE: In a 2 Crewmates 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.

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
Enable Lover Chat -

NOTE:

Sunglasses

The Sunglasses will lower the Crewmate's vision by a small percentage. The percentage is configurable in the options.\ The vision will also be affected when lights out.

NOTE:

Game Options

Name Description
Sunglasses Spawn Chance -
Sunglasses Quantity -
Vision with sunglasses -

Mini

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/Jackal Mini:

Crewmate Mini:

Neutral Mini:

NOTE:

Game Options

Name Description
Mini Spawn Chance -
Mini Mini Growing Up Duration
Mini Grows Up In Meeting -

VIP

An Impostor, Jackal or Crewmate can be affected by the VIP (Very Important Player) Modifier.\ The VIP will show everyone when he dies with a flash similar to the Seer Flash.\ If the option Show Team Color is On, then everyone will get a flash in the color of the team the player was part of.

Teams:

Game Options

Name Description
VIP Spawn Chance -
VIP Quantity -
Show Team Color -

Invert

The Invert Modifier inverts your controls (no matter if keyboard or mouse).\ \ NOTE

Game Options

Name Description
Invert Spawn Chance -
Invert Quantity -

Chameleon

The Chameleon becomes (partially or fully) invisible when standing still for x-seconds (depends on the settings).\ \ NOTE

Game Options

Name Description
Chameleon Spawn Chance -
Chameleon Quantity -
Time Until Fading Starts -
Fade Duration -
Minimum Visibility -

Shifter

The Shifter is a Modifier that can shift with another player. If the other player is Crewmate as well, they will swap their roles.\ Swapping roles with an Impostor or Neutral fails and the Shifter commits suicide after the next meeting (there won't be a body).\ 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.\ \ NOTE:

Game Options

Name Description
Shifter Spawn Chance -

Gamemodes

Guesser Modifier

The Guesser-Gamemode is an extension to the Classic-Gamemode and gives you a multitude of new options for Guessers.\ The Guesser is now like an addition and can be applied to all players IF you want to. Settings are available to set the number of guessers for each team separately (Impostor, Neutral, Crewmate).\ When playing this game mode, the Guessers can have another role (e.g. Medic Guesser). The same applies of course for Impostor and/or Neutral roles.\ Players can additionally have a modifier, if enabled (e.g. Medic Guesser Mini).

Game Options

Name Description
Number of Crew Guessers -
Number of Neutral Guessers -
Number of Impostor Guessers -
Force Jackal Guesser If set to "On", the first neutral role who will be Guesser is the Jackal.
Force Thief Guesser If set to "On", the first (or second if Force Jackal Guesser) neutral role who will be Guesser is the Thief.
Guessers Can Have A Modifier -
Guesser Number Of Shots -
Guesser Can Shoot Multiple Times Per Meeting -
Guesses Ignore The Medic Shield -
Evil Guesser Can Guess The Spy -
Guesser Can't Guess Snitch When Tasks Completed -

NOTE

Hide 'n Seek

The Hide 'n Seek-Gamemode is a standalone Gamemode where Hunter have to catch their prey ("Hunted" players).\ The Hunter and Hunted player who are still alive are displayed to everyone in the bottom left corner (similar to the Arsonist display).\ When the game starts, the Hunter's movement is disabled for x-seconds (depends on the settings).\ There is a time-limit for each round, if the timer runs out and at least one Hunted is still alive, the Crew wins. The Hunted players can also win, if Taskwin is enabled and the Crew completes all tasks.\ If the Hunters kill all players before one of these conditions is triggered, the Hunters win.\

Hunter Abilities:

Hunted Ability:

Each Hunter action or finished Crew task will lower the timer by a configurable amount of time.\ \ NOTE:

Game Options

General Description Hunter Description Hunted Description
Map - Hunter Light Cooldown - Hunted Shield Cooldown -
Number Of Hunters - Hunter Light Duration - Hunted Shield Duration -
Kill Cooldown - Hunter Light Vision - Hunted Rewind Time -
Hunter Vision - Hunter Light Punish in Sec - Hunted Shield Number -
Hunted Vision - Hunter Admin Cooldown -
Common Tasks - Hunter Admin Duration -
Short Tasks - Hunter Admin Punish In Sec -
Long Tasks - Hunter Arrow Cooldown -
Timer In Min - Hunter Arrow Duration -
Task Win Is Possible - Hunter Arrow Punish In Sec -
Finish Tasks Punish In Sec -
Enable Sabotages -
Time The Hunter Needs To Wait -

License

EnoPM/BetterOtherRoles is licensed under the

GNU General Public License v3.0

Permissions of this strong copyleft license are conditioned on making available complete source code of licensed works and modifications, which include larger works using a licensed work, under the same license. Copyright and license notices must be preserved. Contributors provide an express grant of patent rights.

Bugs, suggestions and requests

If you found any bugs, have an idea for a new role or any other request, open an issue.

Credits

The source code of this mod is based on TheOtherRoles mod