Skip to content

noahkhomer18/among-us-script

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

39 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🎮 Among Us Modding Collection

Among Us BepInEx License

A comprehensive collection of 23 BepInEx mods for Among Us that enhance gameplay, reduce trolling, and add exciting new features to improve the overall experience.

🚀 Quick Start📋 All Mods⚙️ Installation🎯 Features


🎯 Features

🛡️ Anti-Trolling & Moderation

  • Emergency Button Blocker - Prevents first-round button spam
  • Vote Kick System - Democratic player removal
  • Anti-Troll Tools - Chat filtering, AFK detection, spam protection
  • Admin Panel - Advanced host controls and permissions
  • Anti-Cheat System - Comprehensive cheat detection and prevention

🎭 Gameplay Enhancement

  • Role Assignment System - Custom roles with unique abilities
  • Task Progress Tracker - Real-time completion monitoring
  • Meeting Timer - Phase-based timing system
  • Death Animation Customizer - Personalized death effects
  • Auto-Ready System - Smart lobby management

📊 Analytics & Recording

  • Statistics Tracker - Comprehensive player statistics
  • Replay System - Game recording and playback
  • Player Behavior Analytics - Advanced behavior tracking

🎬 Content CreationNEW!

  • Replay Editor - Advanced replay editing and customization
  • Screenshot System - Automated screenshot capture and management
  • Video Recording Integration - Comprehensive gameplay recording
  • Stream Overlay Integration - Professional streaming features and overlays

🎨 Customization & UI

  • UI Customizer - Themes, colors, and scaling
  • Custom Map Loader - Map management and custom maps
  • Voice Chat Integration - Proximity-based voice chat
  • Lobby Settings Presets - Save/load configurations

🌍 InternationalizationNEW!

  • Translation System - Multi-language support with real-time translation

📊 Performance & MonitoringNEW!

  • Performance Monitor - FPS tracking, memory usage, and system performance metrics

🎮 Chaotic Game ModesNEW!

  • The Guesser - No imposters, one fake crewmate, crew must identify the fake or lose
  • Relaxed Crew - All crewmates, emergency button every 1:30, vote out = tasks completed
  • Speed Role - One player has flash speed while others are normal speed

📋 All Mods

🛡️ Anti-Trolling & Moderation 🎭 Gameplay Enhancement 📊 Analytics & Recording 🎬 Content Creation 🎨 Customization & UI 🌍 Internationalization 📊 Performance & Monitoring 🎮 Chaotic Game Modes
🚫 Emergency Button Blocker 🎭 Role Assignment System 📈 Statistics Tracker 🎬 Replay Editor 🎨 UI Customizer 🌍 Translation System 📊 Performance Monitor 🎯 The Guesser
🗳️ Vote Kick System 📊 Task Progress Tracker 🎬 Replay System 📸 Screenshot System 🗺️ Custom Map Loader 🌅 Relaxed Crew
🛡️ Anti-Troll Tools ⏰ Meeting Timer 📊 Player Behavior Analytics 🎥 Video Recording 🎤 Voice Chat Integration ⚡ Speed Role
⚙️ Admin Panel 💀 Death Animation Customizer 📺 Stream Overlay 💾 Lobby Settings Presets
🛡️ Anti-Cheat System 🚀 Auto-Ready System

🚀 Quick Start

1️⃣ Install BepInEx

# Download BepInEx from GitHub
# Extract to your Among Us directory
# Run Among Us once to generate folders

2️⃣ Install Mods

# Compile mods into DLLs
# Place in BepInEx/plugins/ folder
# Launch Among Us

3️⃣ Configure Settings

# Each mod creates its own config file
# Located in BepInEx/config/
# Customize settings as needed

⚙️ Installation

  1. Install BepInEx (if not already installed):

    • Download BepInEx from GitHub
    • Extract to your Among Us game directory
    • Run Among Us once to generate the BepInEx folder structure
  2. Install the Mod:

    • Compile this script into a DLL
    • Place the DLL in BepInEx/plugins/ folder
    • Launch Among Us

Project Structure

among-us-script/
├── mods/
│   ├── emergency-button-blocker/     # First round button protection
│   ├── vote-kick-system/            # Democratic player kicking
│   ├── role-assignment-system/      # Custom roles (Sheriff, Medic, etc.)
│   ├── anti-troll-tools/            # Chat filter, AFK detection, spam protection
│   ├── task-progress-tracker/       # Real-time task completion display
│   ├── meeting-timer/               # Discussion and voting phase timers
│   ├── death-animation-customizer/ # Custom death effects and sounds
│   ├── auto-ready-system/           # Smart auto-ready with lobby management
│   └── statistics-tracker/           # Player statistics and leaderboards
├── shared/
│   └── CommonUtilities.cs           # Shared utilities for all mods
└── README.md                        # This documentation

How It Works

Each mod uses Harmony patches to intercept and modify game behavior:

  • Harmony Patches: Runtime method interception and modification
  • BepInEx Framework: Plugin loading and configuration management
  • Shared Utilities: Common functions used across all mods
  • Configuration: Individual settings for each mod

Configuration

Each mod creates its own configuration file in BepInEx/config/:

  • com.yourname.emergencybuttonblocker.cfg - Emergency Button Blocker settings
  • com.yourname.votekicksystem.cfg - Vote Kick System settings
  • com.yourname.roleassignmentsystem.cfg - Role Assignment settings
  • com.yourname.antitrolltools.cfg - Anti-Troll Tools settings
  • com.yourname.taskprogresstracker.cfg - Task Progress settings
  • com.yourname.meetingtimer.cfg - Meeting Timer settings
  • com.yourname.deathanimationcustomizer.cfg - Death Animation settings
  • com.yourname.autoreadysystem.cfg - Auto-Ready settings
  • com.yourname.statisticstracker.cfg - Statistics settings

Example configuration:

[General]
## Enable/disable the mod
# Setting type: Boolean
# Default value: true
Enabled = true

[UI]
## Show visual elements
# Setting type: Boolean
# Default value: true
ShowUI = true

Building from Source

  1. Create a new C# Class Library project
  2. Add references to:
    • BepInEx.dll
    • 0Harmony.dll
    • Assembly-CSharp.dll (from Among Us)
  3. Compile and place the resulting DLL in the plugins folder

Compatibility

  • Among Us Version: 2023.11.28 or later
  • BepInEx Version: 5.4.21 or later
  • Platform: Windows (Steam/Epic Games)

💬 Chat Commands

🛡️ Moderation Commands

Command Description Mod
/votekick <player> Vote to kick a player Vote Kick System
/mute <player> Mute/unmute a player Anti-Troll Tools
/admin <password> Authenticate as admin Admin Panel
/kick <player> Kick a player (admin) Admin Panel
/ban <player> Ban a player (admin) Admin Panel

🎮 Gameplay Commands

Command Description Mod
/tasks or /progress Check task progress Task Progress Tracker
/timer or /time Show meeting time Meeting Timer
/ready, /unready Manage ready states Auto-Ready System
/stats or /statistics View your statistics Statistics Tracker
/leaderboard or /lb Show leaderboard Statistics Tracker

🎨 Customization Commands

Command Description Mod
/color <name> Set HUD color UI Customizer
/theme <name> Change UI theme UI Customizer
/scale <value> Set UI scale UI Customizer
/loadpreset <name> Load lobby preset Lobby Settings Presets
/savepreset <name> Save current settings Lobby Settings Presets

📊 Analytics Commands

Command Description Mod
/analytics Show behavior analytics Behavior Analytics
/flagged Show flagged players Behavior Analytics
/replays List available replays Replay System
/playreplay <id> Play a replay Replay System
/anticheat Show anti-cheat status Anti-Cheat System

🎬 Content Creation CommandsNEW!

Command Description Mod
/screenshot or /ss Take screenshot Screenshot System
/screenshots Show screenshot list Screenshot System
/record or /rec Start/pause recording Video Recording
/stop Stop recording Video Recording
/overlay Toggle stream overlay Stream Overlay
/streamalert Show test alert Stream Overlay
/replay Show replay list Replay Editor
/edit <id> Edit replay (host only) Replay Editor

🌍 Translation CommandsNEW!

Command Description Mod
/lang <code> Change language Translation System
/lang Show available languages Translation System
/translate <text> Translate text Translation System

📊 Performance CommandsNEW!

Command Description Mod
/fps Show FPS statistics Performance Monitor
/perf Show performance report Performance Monitor
/stats Show performance statistics Performance Monitor

🎮 Chaotic Game Mode CommandsNEW!

Command Description Mod
/guesser Check your role in Guesser mode The Guesser
/tasks Show task progress in Guesser mode The Guesser
/relaxed Check Relaxed Crew status Relaxed Crew
/progress Show task progress in Relaxed Crew Relaxed Crew
/nextemergency Show time until next emergency Relaxed Crew
/strategy Show strategy tips for Relaxed Crew Relaxed Crew
/speed Check speed status Speed Role
/speedstatus Show speed player status Speed Role
/speedhelp Show speed role commands Speed Role

📁 Project Structure

among-us-script/
├── 📁 mods/
│   ├── 🚫 emergency-button-blocker/     # First round protection
│   ├── 🗳️ vote-kick-system/            # Democratic player kicking
│   ├── 🎭 role-assignment-system/      # Custom roles (Sheriff, Medic, etc.)
│   ├── 🛡️ anti-troll-tools/            # Chat filter, AFK detection, spam protection
│   ├── 📊 task-progress-tracker/       # Real-time task completion display
│   ├── ⏰ meeting-timer/               # Discussion and voting phase timers
│   ├── 💀 death-animation-customizer/ # Custom death effects and sounds
│   ├── 🚀 auto-ready-system/           # Smart auto-ready with lobby management
│   ├── 📈 statistics-tracker/           # Player statistics and leaderboards
│   ├── 🎬 replay-system/               # Game recording and playback
│   ├── 📊 behavior-analytics/          # Player behavior tracking and analysis
│   ├── 🗺️ custom-map-loader/          # Map management and custom maps
│   ├── 🎤 voice-chat-integration/      # Proximity-based voice chat
│   ├── 🎨 ui-customizer/               # Themes, colors, and UI scaling
│   ├── ⚙️ admin-panel/                # Advanced host controls and permissions
│   ├── 🛡️ anti-cheat-system/          # Comprehensive cheat detection
│   ├── 💾 lobby-settings-presets/      # Save/load lobby configurations
│   ├── 🎬 replay-editor/              # Advanced replay editing ⭐ NEW!
│   ├── 📸 screenshot-system/           # Automated screenshot capture ⭐ NEW!
│   ├── 🎥 video-recording-integration/ # Comprehensive gameplay recording ⭐ NEW!
│   ├── 📺 stream-overlay-integration/  # Professional streaming features ⭐ NEW!
│   ├── 🌍 translation-system/         # Multi-language support ⭐ NEW!
│   ├── 📊 performance-monitor/          # Performance tracking and monitoring ⭐ NEW!
│   ├── 🎯 the-guesser/                # No imposters, one fake crewmate ⭐ NEW!
│   ├── 🌅 relaxed-crew/                # All crewmates, emergency every 1:30 ⭐ NEW!
│   └── ⚡ speed-role/                  # One player has flash speed ⭐ NEW!
├── 📁 shared/
│   └── 🔧 CommonUtilities.cs           # Shared utilities for all mods
└── 📄 README.md                        # This documentation

⚠️ Important Notes

  • Host-Only: Most mods only affect the host's game
  • Universal Benefits: All players in the lobby benefit from the mods
  • Auto-Reset: Mods automatically reset when a new game starts
  • Logging: All actions are logged for debugging purposes
  • Help Command: Use /help in-game to see available commands

🔧 Troubleshooting

Common Issues

Issue Solution
Mod not loading Check BepInEx installation and DLL placement
Configuration errors Verify config files in BepInEx/config/
Compatibility issues Ensure Among Us and BepInEx are updated
Performance problems Disable unnecessary mods or reduce settings

🆘 Getting Help

  1. Check Console: Look for error messages in BepInEx console
  2. Verify Installation: Ensure all files are in correct locations
  3. Update Dependencies: Keep BepInEx and Among Us updated
  4. Check Logs: Review log files for specific error details

📄 License

This project is for educational purposes only.

Among Us is owned by InnerSloth LLC.


🌟 Star this repository if you found it helpful! and be sure to follow me if you appreciate the work

GitHub stars GitHub forks

About

A comprehensive collection of 17 BepInEx mods for Among Us (#3 game on App Store) that enhance gameplay, reduce trolling, and add exciting new features to improve the overall experience.

Resources

License

Stars

1 star

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages