search

Town-of-Impostors / TownOfImpostors

TownOfImpostors Mod for Among Us
124 stars 17 forks source link

readme

Town Of Impostors

We now have a discord server! Join the discord server: https://discord.gg/xpsKVpUf4T

Follow me on twitter: https://twitter.com/itsAJMix

Town Of Impostors Mod is a modification for Among Us - PC/Windows (Steam). This mod aims to add new roles, modifiers & abilities to enhance gameplay, while also providing a full range of options to allow for customising and playing games your way.

Every player in the room must have the mod installed for it to work correctly. Please DO NOT play this mod on public lobbies, it is intended for private organised lobbies.

Table of Contents

Installation

Verifying installation success

If you don't see this message or have any other issues, please take a look at the troubleshooting section.

Version Mismatch Checker:

Before raising an issue, please double check that you have accurately followed the installation instructions and you are not using any mod manager or other mods.

Starting from v1.5.0 onwards, there is a new reset custom settings button in the lobby. Please use it if your settings are bugged. Settings can bug when you update from version to version, it's best practice to reset settings.

Starting from v1.6.0 onwards, this mod should now be compatible with Mod Manager by MatuxGG. Please note that using the Mod Manager to install the mod still does not guarantee that the mod will work as intended.

Saving and Loading

Starting from v1.8.1, you can now save and load your settings. This is to help lower the issue of settings completely messing up between versions. You should find a new TownOfImpostorsSettings.txt in the Among Us folder where the mod is installed. This can also be passed onto others so they can play with your settings!

From v1.8.6 onwards, there are now 5 Save & Load slots. You can use these to save multiple settings. You will be able to find them as TownOfImpostorsSettings_1.txt, TownOfImpostorsSettings_2.txt etc. inside of the TownOfImpostors_Data folder. Please launch the game or create the folder yourself if you don't see it. These settings can be passed onto others. If you were using the previous TownOfImpostorsSettings.txt before, please move this into the folder and rename it to TownOfImpostorsSettings_1.txt.

Uninstalling the Mod

Releases and Compatibility

Among Us Version Mod Version Link
v2021.6.15s v2.0.8 Download
v2021.6.15s v2.0.7 Download
v2021.5.25s & v2021.5.25e v2.0.6 Download
v2021.5.10s v2.0.5 Download
v2021.5.10s v2.0.3 Download
v2021.5.10s v2.0.1 Download
v2021.4.12s & v2021.4.14s v2.0.0 Download
v2021.4.12s & v2021.4.14s v1.9.2 Download
v2021.4.12s & v2021.4.14s v1.8.6.1 Download
v2021.4.12s & v2021.4.14s v1.8.6 Download
v2021.4.12s & v2021.4.14s v1.8.2.1 Download
v2021.3.31.3s v1.8.1 Download
v2021.3.31.3s v1.7.1 Download
v2021.3.31.3s v1.7.0 Download
v2021.3.5s v1.6.1 Download
v2021.3.5s v1.6.0 Download
v2021.3.5s v1.5.0 Download
v2021.3.5s v1.4.0 Download
v2021.3.5s v1.3.0 Download
v2020.12.9s v1.2.0 Download
v2020.12.9s v1.1.0 Download
v2020.12.9s v1.0.0 Download
Changelog
v2.0.8

v2.0.8

  • Fixed voting issues breaking the game
v2.0.7

v2.0.7

  • Compatibility with v2021.6.15s of Among Us
  • Various small bug fixes
v2.0.6

v2.0.6

  • Fixed bug with custom hat system
  • Fixed issue with meetings not ending correctly with sniping/poison
  • Fixed issue with Tiny/Giant modifier kills leading to players going into walls
  • Added more custom hats
v2.0.5

v2.0.5

  • Fixed and optimised bugs regarding custom options
  • Further optimised custom button system
  • Sniper reveal arrow duration can now be set to 0 (so it doesn't appear at all)
  • dded extra safety checks to Hat System to prevent everything breaking
  • Fixed speed issues with Tiny
  • Fixed Tiny not being able to do some tasks
  • Fixed HidePlayerModel still hiding players on comms sabotage anonymity
  • Fixed exploit that allowed people to go through walls when morphing into Giant/Tiny
  • [Balance Change] Comms Anonymous Sabotage now also updates player scale to take into account Giant/Tiny modifiers for consistency
v2.0.3

v2.0.3

  • Morphing fix
v2.0.1

v2.0.1

  • New Home Update Button, Easier Updating Of Mod
  • Fixed Sniper Kill Button exploit
  • Fixed vote not ending if Sniper dies
  • Fixed Sniper guess text not displaying properly
  • Lobby Host Buttons should now appear for new host when previous host leaves
  • Custom Color txt and Settings txt are now renamed to backup files
v2.0.0

v2.0.0

  • Sniper Role (Unique Impostor Role)
  • Hat System 2.0 (Animated Hats, More Possibilities)
  • Dead Players Seeing All Roles now also see Lover Icons
  • Art updates by Con No 1 (Twitter @Con_No_1)
  • Giant Modifier, Tiny Modifier, Nightowl Modifier
  • Impostors can now see poisoned players in meetings
  • [Custom Option] Speed Modifier % for dragging bodies
  • [Custom Option] Poison Continues In Meeting
  • Fixed a bug with venting with Plumber & Jester
  • Fixed bug with blind traps not being disabled when toggle off
  • Fixed bug with sabotages not ending game in some cases with All Crewmates Must Die Mode On
  • Fixed Jester Footprints not disappearing on death
  • Fixed bug with revived Informants losing role and seeing everyone as their own name
  • Fixed bug with Poison Kills on Decoys not properly setting cooldown
  • Fixed exploit allowing Impostors to reset cooldown after poison ability
v1.9.2

v1.9.2

  • Settings 2.0
  • [Custom Option] Enable Impostor Abilities (only if Impostor Roles are off)
  • [Custom Option] Mayor Cannot Be Lover
  • ALL MUST DIE Gamemode (Impostors only win if ALL crewmates are dead)
  • Impostor Blind Trap Ability
  • Impostor Poison Ability
  • Detective Body Scan Ability
  • Detective Body Report shows whether victim was poisoned
  • Impostor Viper Role (Tier 1)
  • Impostor Assassin Role (Tier 2)
  • Impostor Predator Role (Tier 3)
  • New warning for when settings are bugged (messed up values)
  • Added foolproof checks to prevent errors in custom colors, settings and hats from stopping the mod from loading
  • Using chat (between meetings) no longer freezes kill cooldown, this should encourage more Impostor Comms/Lover chat
  • Jester can see their own footprints if paint ability toggled on
  • Game Continues With Arsonist is now a "Gamemode"
  • Mayor Hats will no longer show in meeting hud if player is dead
  • Fixed bug with ghosts still having issues with vision
  • Arsonist douse time now defaults to 2 seconds
  • Detective Anonymous Footprints defaults off, footprint time default 15 seconds
  • Fixed bug with uninteractable bodies
  • Fixed exploit that allowed Doctors to revive & report someone at the same time
  • Fixed bug with Arsonist dousing players in vents
  • QoL update, hats tab mentions hat pages
  • Progress Bar QoL update
  • Fixed small bug with loaded settings not synced between players
  • Various small bug fixes
  • Even more optimisations for even smoother performance
v1.8.6.1

v1.8.6.1

  • Fixed major game breaking bugs with voting
  • Fixed issue with bodies disappearing if player dies while dragging a body through vent
  • Fixed potential issues with trickster disguised decoy
  • Various small bug fixes and optimisations
v1.8.6

v1.8.6

  • Mayor Role
  • Map Randomisation Game Mode
  • Brought back "dlekS ehT" map
  • Hat Pages to store more custom hats
  • Arsonist can now douse players in vents
  • Optional hat name modifiers for hats to display better in menu __ (example _0.0f_0.1f)
  • Sheriff kill timer will start at 10 seconds, matching Impostors
  • Impostors inside of vents can now kill Plumbers & Jesters inside of vents
  • Moved "Can Vent With Body" to General Options
  • Trickster Disguise Ability
  • Hitman & Joker Impostor Roles
  • Fixed bug associated with disguise & start meeting
  • Fixed color name bug
  • Fixed Impostors setting names as red in messages even with Impostors Do Not Know Each Other option
  • Fixed desyncs with dispose body
  • Fixed Streamer Mode
  • Implemented Host Checks for Sheriff & Impostor kills to prevent kill desyncs (this will introduce host advantage and delay to kills if you're not the host, but this fixes all desyncs on kills)
  • Fixed gamebreaking bugs with impostors kills
  • Fixed bug with lover death not removing disguise
  • Compatibilities with Reactor & Reactor.Essentials
  • Impostor Retrieve Body Ability
  • Plumber Retrieve Body Ability
  • Doctor Retrieve Body Ability
  • Jester Retrieve Body Ability
  • [Custom Option] Vents Hold Multiple Bodies
  • [Custom Option] Imps Can Kill Inside Vents
  • Massive optimisations
  • Various other null ref and bug fixes
v1.8.2.1

v1.8.2.1

  • Separate Impostor roles (Dragger, Morphling, Deceiver)
  • Custom Hats can now match Crewmate color with _anycolor modifier
  • More custom hats from community
  • Fixed issue with Lover getting stuck in Airship
  • Name fixes (fixed issue with host role being revealed sometimes)
  • Fixed issues with colours of certain hats messing up in ladder climb in airship
  • Fixed issues with people seeing Lover's chat
  • Bug fixes and polishes
  • [Custom Option] Dead Player See All Roles
  • [Custom Option] Sheriff Does Not Die
  • [Custom Option] Imps Do Not Know Each Other
v1.8.1

v1.8.1

  • Bunch of awesome custom hats from the community
  • Operative Role
  • More colours to select from
  • Improved Naming/Role, colorblind-friendly
  • Save/Load Settings Button In Lobby
  • Fixed game breaking bugs with custom colours
  • Fixed Text: Lovers Wins -> Lovers Win
  • Fixed specific hats not working with Decoys
  • Impostors can now use destroy decoy, disguise and dispose body again in vents (Sorry for breaking this before)
  • Fixed an issue with "Impostors Can Kill Each Other" somehow causing infinite disguise
  • Fixed a small issue with some hats & disguise
  • Fixed issue with agent cams ability broken on airship
  • Fixed an issue with arsonist continuing douse even while dead
  • Fixed sabotage comms anonymity not working on decoys
  • Fixed an issue where player's hats would appear for a frame while anonymous when climbing ladders/performing a kill
  • [Custom Option] Jester Bloody Footprints
  • [Custom Option] Jester Body Drag
  • [Custom Option] Jester Can Use Vents
v1.7.1

v1.7.1

  • Compatibility with 2021.3.31.3s
  • CUSTOM HATS! (See instructions on how this works at the top)
  • Streamer Mode (See instructions on how this works at the top)
  • Fixed role selection not properly randomising player list (host always got a role no matter what)
  • Bloodstains on vents should now properly disappear after meetings
  • Detective footprints now properly disappear after they lose their role from revives)
  • Fixed ghost crewmate vision that broke in the latest version
  • Made Informant arrows bigger
  • Fixed issue with disguise revealing impostors before meetings
  • Fixed role description text not appearing properly
  • Fixed a bug that caused infinite duration for some abilities
  • Fixed agent abilities being broken in some maps
  • [Modifier] Lover Modifier
  • [Custom Option] Disguised Footprints: Toggles whether Disguised Impostors leave Disguised Footprints
  • [Custom Option] Agent Abilities Share Cooldown: Toggles whether all Agent abilities should go into cooldown when using one ability
  • [Custom Option] Game Continues With Arsonist: Toggles whether the game continues if Arsonist is still alive
  • [Custom Option] Disable Body Report: Toggles whether body reports are enabled or not
v1.7.0

v1.7.0

  • Compatibility with 2021.3.31.3s
  • Compatibilities with Airship
  • Trickster Role
  • Impostor Decoy Abilities (Like Trickster)
  • Lobby Role Summary for Chances and Count
  • Lobby Improvements (Role Bookmarks)
  • Colorblind Friendly Updates
  • Fixed bugs with Impostor Comms
  • Dousing & Reviving now show progress bars instead
  • Fixed bugs with dead bodies using wrong colours on Comms Sabotage
  • Fixed some buttons resetting CDs on opening windows
  • Fixed issue with toggle buttons blocking scrolling/clickable anywhere (don't know why Innersloth made it like this)
  • Various bug fixes & optimisations
v1.6.1

v1.6.1

  • Fixed issue with DLL plugin no longer working
  • Disguise issues with Meetings and KillOverlay fixed
  • Fixed revived players losing "Douse" state
  • Fixed hotkeys still working while other windows are opened
  • Fixed abilities being able to be used while doing other things
v1.6.0

v1.6.0

  • Informant role
  • Doctor Medbay only fix for Polus
  • DNA Sample button improved
  • Mod Manager (by MatuxGG)/Reactor.Essentials compatibility
  • Fixed disguising-pet-vent bug
  • Custom Option: Crewmate Ghosts Use Crewmate Vision
  • Percentage Chance for Roles
  • New 1,2,3,4.. Keybinds for Abilities
  • Arsonist better end visuals
  • Custom Option for killers to leave bloody footprints for detective
  • Custom Option to allow Impostors to kill each other
  • Custom Option for Arsonist to refuel
  • Custom Option for Jester to win from Sheriff Kill
  • Custom Option for Doctor Revive to remove Crewmate special role
  • Custom Option to change whether Impostor can vent with body or not
  • Custom Option for Doctor Revive Time
  • Fixed bug with Detective seeing Impostor colour footprints despite being disguised
  • Fixed bug with Pets reappearing during comms sabotage after meeting
  • Fixed bug with buttons being used in meetings
  • Balance Fix: Custom Buttons cooldowns no longer continue going down during meetings
  • Removed CUSTOM server option (please look into Unify by MoltenMods)
  • Various null fixes
  • Optimisations
v1.5.0

v1.5.0

  • Impostor Drag & Drop Body Ability toggle
  • Arsonist Role
  • Plumber Role
  • Detective Role
  • Doctor Drag & Drop Body Ability
  • Doctor Option: Medbay revives only
  • Impostor Comms
  • Comms sabotage causes anonymity
  • Jester Victory Screen Fix
  • Dead bodies won't play kill animation on vent exit
  • You can now sample DNA from dead bodies
  • Fake tasks for Jester & Arsonist
  • Role description in task list
  • Reset custom settings button in lobby
  • Updated role selection process
  • Dispose Bodies leave bloodsplat
  • Button bug fixes
  • Anonymous Votes resetting fix
  • Various null fixes
  • Optimisations
v1.4.0

v1.4.0

  • Agent Role
  • Fixed settings resetting bug
  • Added CUSTOM server option
  • Sheriff custom kill button sprite
  • Option for same roles to know each other
  • Option for Sheriff to kill non-impostors
  • Sheriff Kill CD changes
  • Various null fixes
v1.3.0

v1.3.0

  • Compatibility with v2021.3.5s
  • Updated custom options to be more clean & clear
  • New ability to cycle through options HUD display
  • Jester role
  • Fixed issue with Sheriff being able to kill through walls
  • Fixed detection through walls for other abilities
  • Fixed issue with dragging body sometimes not rendering on top of ground
  • Various null fixes
v1.2.0

v1.2.0

  • Fixed Sheriff being able to kill Impostor in vent
  • Disguise should now work properly with pets
  • Several other null bugs
v1.1.0

v1.1.0

  • Fixed taskbar not updating and removing "you are dead" line when revived
  • Fixed bug with Sheriff not being able to kill Impostor
  • Several nullpointer bugfixes

Updating the Mod

It is recommended to keep separate folders for each version of Town Of Impostors instead of overwriting, even if the Among Us version between them is the same and it appears that the bundled files are the same in each release. But if you're intent on updating an existing version of the mod with a new version that is compatible to that version of Among Us:

Curseforge

You can download the mod on Curseforge here.

Custom Hats

Only for versions v1.7.1 onwards

How do I add my own Custom Hat?

New System:

Old System:

Example Names: Wing_Spaced-AJMix_back.png, Bouncy-Hat_AJMix_bounce.png, BouncyWings_AJMix_back_bounce.png, Simple-Hat_AJMix.png, Advanced-Hat_AJMix_bounce_anycolor_-1.1f_+2.3f.png

Modifiers

All hat modifiers are case sensitive!

_back

If you want your hat to be behind the crewmate (i.e. wings).

_bounce

If you want it to bounce while the crewmate walks.

_anycolor

From v1.8.2 onwards, you'll be able to also add this as an additional modifier to have your hat match the colour of your crewmate. You'll need to use Red (Hex: FF0000) for the base colour, and Blue (Hex: 0000FF) for the shading. See example of how this is done here:

ExampleByDark

Advanced Modifiers

All hat modifiers are case sensitive!

_0.0f_0.0f

From v1.8.6 onwards, you can now add X and Y offsets to the name to position the hat more accurately in the menu i.e. Simple-Hat_AJMix_-0.5f_+0.3f. You need to specify both an X and a Y offset. Placing a + or - in front will indicate whether it should be positive or negative. Placing no symbols will default it to positive. The offsets must follow the exact example as shown, with a decimal number followed by an "f".

Want to add your hat as part of the mod so everyone can use it?

Where can I download more custom hats from the community?

Please join the discord to find more custom hats from the community, as well as download links!

Custom Colors

From v1.8.6 onwards, you will be able to add your own custom colors.

Add your custom colors to the file TownOfImpostors_CustomColors.txt which can be found in the TownOfImpostors_Data folder. Please launch the game and create a lobby once if you don't see the folder or file, or manually create them yourselves.

Follow this example to add a color:

255,255,255,255 220,220,220,255 Pure_White PWH

Each part of the entry stands for this:

MainColor ShadingColor LongName ShortName

For the colors the format is: R,G,B,A (values between 0-255)

Separate each part with a space, use _ to represent spaces in the long name.

In multiplayer, everyone must have the same TownOfImpostors_CustomColors.txt to see and use the same custom colors!

Streamer Mode

From v1.7.1 onwards, there is a new streamer mode that can be toggled on.

This makes it easier for streamers as they won't have to manually hide the code anymore on stream, it will be hidden automatically.

How do I get the room code?

When you create a room, the room code will be copied to your clipboard. Simply paste it somewhere and pass it onto others.

If you accidentally copied something else before pasting the room code somewhere, you can get your copy/clipboard history by using Windows Key + V. Or you can just make another room.

Roles, Abilities, Modifiers & Custom Options

Keybindings

From 1.6.0 onwards, you can now use keys 1, 2, 3, 4, Z, X to activate abilities.

Gamemodes

Extra Settings

Crewmate Team

The special roles in the Crewmate Team. The goal of the Crewmate Team is to combine their abilities and knowledge to find the Impostors. The Crewmate Team will win if all Impostors are ejected or killed.

Sheriff

The Sheriff is a role that has the ability to kill Impostors. However, if they attempt to kill a fellow crewmate, they will lose their own life instead as a punishment.

Custom Options + **% Sheriff Chance:** Chance of a Sheriff being added to the role selection pool + **# Max Sheriff Count:** The maximum number of Sheriffs that can be added to the role selection pool + **Sheriff Kill Cooldown:** Kill cooldown for the Sheriff + **Show Sheriff:** Shows the Sheriff to other players (via a highlighted name) + **Innocent Target Also Dies:** The Innocent target will also be killed along with the Sheriff + **Jester Is Enemy:** Jester will no longer count as "Innocent" + **Arsonist Is Enemy:** Arsonist will no longer count as "Innocent" + **Sheriff Does Not Die:** Toggles whether Sheriff will die as a punishment or not

Doctor

The Doctor is a role that has the ability to revive dead players. However, this means they are also able to revive Impostors that have been killed by the Sheriff.

Custom Options + **% Doctor Chance:** Chance of a Doctor being added to the role selection pool + **# Max Doctor Count:** The maximum number of Doctors that can be added to the role selection pool + **Doctor Revive Cooldown:** Cooldown for the Doctor Revive Ability + **Doctor Revive Time:** The time is takes for a Doctor to successfully revive a player + **Start Cooldown On Failed Revives:** Start Revive Ability Cooldown if revive fails (if body is removed or disposed) + **Medbay Revive Only:** Only allow revives in the Medbay location of a map + **Lose Role On Revive:** Crewmates with special roles lose their role if revived (Does not affect Jester & Arsonist) + **Retrieve Body Ability:** Toggle the Retrieve Body Ability + **Retreive Body Cooldown:** Cooldown for the Retrieve Body Ability

Agent

The Agent is a powerful role that has abilities allowing them to access map intel from anywhere. This includes the admin table map, security cameras, door logs and vitals if any are accessible. This gives them much more information on what is going on around the map, but they shouldn't neglect their tasks either.

Custom Options + **% Agent Chance:** Chance of a Agent being added to the role selection pool + **# Max Agent Count:** The maximum number of Agents that can be added to the role selection pool + **Agent Tech Cooldown:** The cooldown of Agent's abilities (the cooldowns are separate between the abilities, but they will all have the same cooldown time) + **Can Use Admin Map:** Agent can activate Admin Map + **Can Use Cameras:** Agent can activate Cameras _(Skeld and Polus Only)_ + **Can Use Door Logs:** Agent can activate Door Logs _(MIRA HQ Only)_ + **Can Use Vitals:** Agent can activate Vitals _(Polus Only)_ + **Agent Abilities Share Cooldown:** Toggle whether all agent abilities go into cooldown after using one ability

Detective

The Detective is a role that can see footprints and get extra information when reporting bodies (They will get a body report in chat only they can see, which shows time of death and if the body was moved or not). They should use this ability to track down Impostors, but they should also be careful not to frame the wrong person.

Custom Options + **% Detective Chance:** Chance of a Detective being added to the role selection pool + **# Max Detective Count:** The maximum number of Detectives that can be added to the role selection pool + **Enable Body Scan Ability:** Toggles body scan ability for Detective + **Body Scan Cooldown:** Body scan ability cooldown + **Body Scan Radius:** Body scan radius + **Footprint Duration:** How long the footprints will last in seconds + **Anonymous Footprints:** Whether the footprints should be anonymous or not + **Extra Information On Report:** If Detective reports a body, they will get an additional "Body Report" via messages (which only they can see). Shows how long the player has been dead for, as well as whether the body has been moved or not. Also shows whether the body was poisoned. + **Killers Leave Bloody Prints:** Killers _(includes both Sheriffs & Impostors)_ will leave bloody footprints after a kill + **Bloody Prints Duration:** Duration for how long Killers should have bloody footprints + **Disguised Footprints:** Toggles whether Impostors leave behind disguised footprints if they are disguised

Plumber

The Plumber is a role that can use vents to travel around. They can also stay in vents to observe the room. But they should be careful not to be suspected as the Impostor or noticed by the Impostor.

Custom Options + **% Plumber Chance:** Chance of a Plumber being added to the role selection pool + **# Max Plumber Count:** The maximum number of Plumbers that can be added to the role selection pool + **Retrieve Body Ability:** Toggle the Retrieve Body Ability + **Retreive Body Cooldown:** Cooldown for the Retrieve Body Ability

Informant

The Informant is a role that can see other roles after they are finished with ALL their tasks. They will be "Informed" after finishing tasks, but should also be careful of Impostors that are notified about them. The Informant can only be informed or revealed after completing at least one task.

NOTE: Comms Anonymous Sabotage (if toggled on) will prevent Informant from seeing roles, even in meetings. This is the counterplay to Informant.

Custom Options + **% Informant Chance:** Chance of a Informant being added to the role selection pool + **# Max Informant Count:** The maximum number of Informants that can be added to the role selection pool + **Impostors Are Notified:** Toggles whether Impostors will be notified and also have the Informant revealed to them + **Tasks Left When Impostors Notified:** How many tasks left for the Informant before Impostors are notified about them + **Show Arrows (Informants And Impostors):** Show arrows pointing to Informants/Impostors if either have been revealed. These can only be seen by Informants or Impostors depending on options that are enabled + **See Jester After Tasks:** Toggles whether Informants can see Jesters after tasks + **See Arsonists After Tasks:** Toggles whether Informants can see Arsonists after tasks + **See Crewmate Roles After Tasks:** Toggles whether Informants can see Crewmate special roles _(if any)_ after tasks + **Highlight Names In Meetings:** Toggles whether names are highlighted in meetings too _(for Informants & Impostors)_

Trickster

The Trickster is a role that can create a decoy to trick the Impostor. If the Impostor kills the decoy, they will go into kill cooldown which will slow them down. However, the Sheriff is also able to kill decoys. The Trickster may also swap positions with their decoys to avoid danger or cover more ground quicker.

Custom Options + **% Trickster Chance:** Chance of a Trickster being added to the role selection pool + **# Max Trickster Count:** The maximum number of Tricksters that can be added to the role selection pool + **Trickster Decoy Cooldown:** Cooldown duration for the Trickster Decoy ability + **Trickster Decoy Duration:** Duration of how long the decoy should last + **Enable Trickster Swap Ability:** Allow Trickster to swap positions with the decoy + **Trickster Swap Cooldown:** Cooldown duration for the Trickster Swap ability + **Trickster Disguise Ability:** Toggles whether triggers can disguise as other players + **Trickster Disguise Cooldown:** Cooldown for Trickster disguise + **Trickster Disguise Duration:** Duration for Trickster's disguise

Operative

The Operative is a role that can place down gadgets that allow them to track other players. A sticky tracker can be placed down that'll stick to other players and reveal them for the duration. An AOE sensor can be placed down to reveal players in an area (revealed players will be anonymous) for a duration. All revealed players will be shown on the map. The Operative gadgets are only visible to the Operative.

Custom Options + **% Operative Chance:** Chance of an Operative being added to the role selection pool + **# Max Operative Count:** The maximum number of Operatives that can be added to the role selection pool + **# Max Tracker Storage:** Maximum number of trackers that can be stored + **Tracker Duration:** How long Trackers should last before disappearing + **Tracker Cooldown:** Cooldown to gain a tracker charge + **# Max Sensor Storage:** Maximum number of sensors that can be stored + **Sensor Radius:** Size of the sensor radius for revealing players + **Sensor Duration:** How long Sensors should last before disappearing + **Sensor Cooldown:** Cooldown to gain a sensor charge + **Show Tracking Arrows:** Toggle whether the tracker should also show a tracking arrow when tracking someone + **Track Dead Bodies:** Toggle whether trackers/sensors should continue tracking dead players

Mayor

The Mayor is a role that gets additional votes they can use to influence the results of a meeting. They are able to store votes each meeting and can add votes to any player in the meeting (or skip vote) at any time, as long as they have not locked in their final vote. They should use this if they want to force someone to be voted out or force a skip vote. But they should be careful not to reveal themselves too early.

Custom Options + **% Mayor Chance:** Chance of a Mayor being added to the role selection pool + **Enable Mayor:** Toggle whether Mayor is enabled or not + **Mayor Cannot Be Lover:** Toggles whether a Mayor can be lover or not + **Starting Vote Bank:** How many votes should Mayor start with + **Votes Gained Per Meeting:** How many votes Mayor should gain per meeting + **Enable Emergency Ability:** Toggle Mayor's Emergency Meeting Ability + **Emergency Ability Cooldown:** Mayor Emergency Meeting Ability cooldown + **Emergency Ability Limit:** Maximum number of times Mayor can use the ability

Neutral Team

Jester

The Jester is a role with no abilities and no tasks to do (they get fake tasks like Impostors). They are in their own team, and their goal is to get themselves ejected from the ship and make sure not to get killed by the Impostors. They will win instantly if ejected from the ship. However, if they are killed, they will have no way to win and essentially lose. The have extra abilities to help them act suspicious, such as dragging bodies, leaving bloody footprints and using vents.

Custom Options + **% Jester Chance:** Chance of a Jester being added to the role selection pool + **Enable Jester:** Allow Jester to be added to the role selection pool + **Jester Can Fix Sabotages:** Allow Jester to fix sabotages + **Jester Wins From Sheriff Kill:** Jester will win if killed by the Sheriff + **Jester Bloody Footprints Ability:** Toggles whether the Jester can leave bloody footprints to trick the detective + **Jester Body Drag Ability:** Toggles whether the Jester can drag bodies + **Jester Can Use Vents:** Toggles whether the Jester can use vents + **Retrieve Body Ability:** Toggle the Retrieve Body Ability + **Retreive Body Cooldown:** Cooldown for the Retrieve Body Ability

Arsonist

The Arsonist is a role that aims to douse everyone alive and igniting them all to win alone. They need to do this before the Crewmate Team wins by finding all the Impostors. They have no tasks (they get fake tasks like Impostors), but should be careful not to be suspected as they have to say close for the duration of time they are dousing. They should also be careful not to be killed by the Impostor.

Custom Options + **% Arsonist Chance:** Chance of a Arsonist being added to the role selection pool + **Enable Arsonist:** Allow Arsonist to be added to the role selection pool + **Douse Time:** How long it takes for Arsonist to douse a target + **Arsonist Can Fix Sabotages:** Toggles whether Arsonists can fix sabotages + **Arsonist Must Refuel:** Toggles whether Arsonists must refuel after set amount of douses + **# Douses Stored:** Number of successful Douses before Arsonists must refuel _(if refuel option is toggled on)_

Impostor Team

New Abilities:

Impostor Settings

Custom Options + **Enable Impostor Roles:** Enable separate Impostor roles. If this is toggled off, the Impostor is a "Super Impostor" with all abilities + **Enable Impostor Abilities:** This option is available is Impostor Roles is toggled off. Enables/Disables abilities for the normal Impostor + **Impostors Can Kill Each Other:** Allows Impostors to target and kill each other + **Impostors Do Not Know Each Other:** Toggles whether Impostors know each other + **Impostors Can Kill Inside Vents:** Toggles whether Impostors can kill any other players inside of vents (if they are in the vent too) + **Enable Impostor Messaging:** Toggle on/off Impostor Comms. Impostor Comms allows Impostors to chat to each other in-game via the chat messaging system, outside of meetings

Dragger

The Dragger is an Impostor role that can drag & drop dead bodies. They are also able to dispose the dead bodies in vents.

Custom Options + **% Dragger Chance:** Chance of a Dragger being added to the role selection pool + **Dragger Count:** The maximum number of Draggers that can be added to the role selection pool + **Drag And Drop Ability:** Toggle the Drag and Drop Ability + **Dispose Body Ability:** Toggle the Dispose Body Ability + **Dispose Body Cooldown:** Cooldown for the Dispose Body Ability + **Retrieve Body Ability:** Toggle the Retrieve Body Ability + **Retreive Body Cooldown:** Cooldown for the Retrieve Body Ability + **Vents Hold Multiple Bodies:** Toggles whether multiple bodies can be disposed in one vent (default is 1 body maximum if toggled off)

Morphling

The Morphling is an Impostor role that can sample DNA of other players and disguise into them, confusing everyone.

Custom Options + **% Morphling Chance:** Chance of a Morphling being added to the role selection pool + **Morphling Count:** The maximum number of Morphlings that can be added to the role selection pool + **Disguise Ability:** Toggle the Disguise Ability + **Disguise Cooldown:** Cooldown for the Disguise Ability + **Disguise Duration:** How long the Disguise lasts for in seconds

Deceiver

The Deceiver is an Impostor role that can leave decoys and swap to them, confusing players and allowing them to reposition themselves.

Custom Options + **% Deceiver Chance:** Chance of a Deceiver being added to the role selection pool + **Deceiver Count:** The maximum number of Deceivers that can be added to the role selection pool + **Enable Decoy Ability:** Toggle the Decoy Ability for Impostors + **Decoy Cooldown:** Cooldown for the Decoy ability + **Decoy Duration:** Duration for how long the Decoy will last + **Enable Decoy Swap Ability:** Toggle the Decoy Swap Ability for Impostors + **Decoy Swap Cooldown:** Cooldown for the Decoy Swap Ability

Viper

The Viper is an Impostor role that can blind and poison other players.

Custom Options + **% Viper Chance:** Chance of a Viper being added to the role selection pool + **Viper Count:** The maximum number of Vipers that can be added to the role selection pool + **Blind Trap Ability:** Toggle the blind trap ability + **Blind Trap Charges:** Max charges of blind traps Viper can hold + **Blind Trap Cooldown:** Blind trap cooldown to regain a charge + **Blind Trap Duration:** How long the blind trap should last + **Blind Duration:** How long players are blinded for + **Poison Ability:** Toggle the poison ability + **Poison Duration:** Duration before player is killed by poison + **Poison Additional Kill Cooldown:** How much extra cooldown is added to the kill button + **Poison Cure Duration:** How long it takes to cure the poison in medbay + **Poison Continues In Meeting:** Toggles whether Poison Timer should continue ticking in meetings

Sniper

The Sniper has the ability to kill players during meetings if they are able to guess their roles. But they may be punished for wrong guesses. They may also use a Sniper in-game if toggled on. (Note: Sniper Rotation is not synced between players, so you will not see where the player is aiming)

REMINDER: Toggling on the Sniper Rifle will hide/replace the original Kill Button

Custom Options + **% Sniper Chance:** Chance of a Sniper being added to the role selection pool + **Sniper Count:** The maximum number of Snipers that can be added to the role selection pool + **Max Snipe Per Meeting:** The number of times the Sniper can attempt to kill players in meetings with role guesses + **Sniper Dies On Wrong Guess:** Punish the Sniper with death if they guess wrong + **Sniper Rifle Ability:** Toggled On/Off the Sniper Rifle to use between meetings, a long range killing ability _**(NOTE: This hides/replaces the normal kill)**_ + **Sniper Rifle Cooldown:** Cooldown for Sniper Rifle Shots + **Rifle Unholster Cooldown:** Cooldown to unholster the Sniper Rifle + **Rifle Holster Cooldown:** Cooldown to holster the Sniper Rifle + **Gunshot Revealed Duration:** Duration for how the Sniper Shot Reveal Arrow lasts

If seperate Impostor Roles are disabled, the normal Impostors will use all abilities (configured with the same custom options as the separate roles). Basically every Impostor is a "Predator"

If separate Impostor Roles are enabled:

Tier 1 Impostors:

Tier 2 Impostors:

Tier 3 Impostors:

Any Impostor without a special Impostor role will be a normal vanilla Impostor with no abilities. Impostor Role abilities are configured with the same options used to configure the normal Impostor

Modifiers

Lovers

This activates the Lovers modifier. Two players are selected as random to be lovers (if applicable). Impostors can also be selected as Lovers. Jesters & Arsonists cannot be selected as Lovers. There can not be more than 1 Impostor Lover.

Lovers can still get their own special roles, and can still win as normal with their respective teams.

However, the Lovers can achieve a special "Lovers Win". The goal of the Lovers is to stay alive together and win together at the end. Lovers will achieve the special Lovers Win if they are both among the last 3 players standing. The only exception to this is if the custom option Game Continues With Arsonist is toggled on and the Arsonist is among the last 3. The game will continue as long as the Arsonist is alive.

Lovers are given the ability to chat with each other via a special Lovers Chat in-between meetings.

Custom Options + **% Lovers Chance:** Chance for Lovers to appear + **Enable Lovers:** Toggles Lovers on/off + **Lovers Die Together:** Toggles whether Lovers should die together (if one dies, the other dies, like a life link)

Giant

This activates the Giant modifier. A Giant player will have a larger sight radius to see more things, but will suffer from slower movement speed.

Custom Options + **% Giant Chance:** Chance for Giant to appear + **Enable Giant:** Toggles Giant on/off + **% Movement Modifier:** Percentage movement modifier for Giant + **% Vision Modifier:** Percentage vision modifier for Giant

Tiny

This activates the Tiny modifier. A Tiny player will be able to move around faster, but will suffer from lower vision (opposite of Giant)

Custom Options + **% Tiny Chance:** Chance for Tiny to appear + **Enable Tiny:** Toggles Tiny on/off + **% Movement Modifier:** Percentage movement modifier for Tiny + **% Vision Modifier:** Percentage vision modifier for Tiny

Nightowl

This activates the Nightowl modifier. A Nightowl will be able to see better when lights are out compared to other players, but will suffer from worse vision when lights are on.

Custom Options + **% Nightowl Chance:** Chance for Nightowl to appear + **Enable Nightowl:** Toggles Nightowl on/off + **% Lights On Vision Modifier:** Percentage Lights On Vision modifier for Nightowl + **% Lights Off Vision Modifier:** Percentage Lights Off Vision modifier for Nightowl

How does role assignment work?

The role selection works as follows: For each role, it will attempt to add that to the selection pool X number of times, where X is the maximum count. The chance of the role being added to the selection pool each time is based on the percentage chance set in the custom options for the specified role.

Once the selection pool is filled, the roles in there will then be randomly assigned to Crewmates (who are not already Impostors and don't already have a special role). As long as there are roles in the pool to assign and Crewmates to assign them to, they will be assigned out. If there are no more roles to be assigned out, the remaining players will just stay as normal Crewmates.

Example: Sheriffs - # Max Count: 3 | % Chance: 50

This means that the role selection will try to put 3 sheriffs into the pool, at 50% chance each time. So the pool can end up with 0, 1, 2 or even the maximum of 3 Sheriffs.

FAQ

Can you play Proximity Chat (Crewlink) with it?

Yes, Crewlink supports Among Us Modifications

Can this mod work with other mods?

I cannot guarantee that this mod will work with other mods. There will likely be conflicts. You will have to test yourself.

Do my friends need to install the mod to play it together?

Yes. Every player in the lobby must have the mod installed. Please don't use and play mods in unorganised public lobbies.

Can you get banned for playing on public servers?

At the current state of the game there is no perma ban system, though this may change depending on the stance of the Among Us developers. The mod is designed in a way that it does not send prohibited server requests. In a public lobby with randoms, with only you having the mod installed, you would either be kicked for strange behaviour or have a desync between you and other users that do not have the same mods, or both. In short, as long as this mod is played among friends in your own private lobby, you're safe.

If you are really worried, I recommend checking out Impostor to start your own custom, private server. (You may have to disable their AntiCheat implementation for it to work with mods like this). Still, a disclaimer that you use this mod at your own risk and I am not responsible for any account suspensions that may occur from the use of this mod.

How can I join servers of a custom region?

This functionality has been removed from 1.6.0 onwards. Please look into using Unify

Can this mod work with controllers?

This mod was not made to be compatible with controllers in mind; it was intended to be played with keyboard and mouse.

Troubleshooting

The mod isn't installed or game doesn't launch

The mod still doesn't work or found a bug?

You can raise an issue within GitHub documenting your issue. You will need to be logged into GitHub to do this. For any bugs, take a quick check if your bug has already been listed under the below Known Issues or if it has already been reported. Please give as much detail as possible regarding the issue, including steps to reproduce it if possible. If it exists, please also attach your LogOutput.log, generated in the Among Us\BepInEx\ folder.

Known Issues

Contact & Donations

Contact:

Updates:

Donations:

Donate with PayPal button

Buy me a coffee at Ko-fi

All donations are appreciated and will go towards the development of mods.

Credits

Please let me know if you'd like me to attach a social media next to your name, change your name or remove your name from the list.

Big thanks to the following Donator(s):

Bernie Choy

Big thanks to the following for supporting in the development of the mod:

License

BepinEx is distributed under LGPL-2.1 License.