Correct order of CheatCategory items (#748)

Impostor 1.10.8 introduced PacketSize as a category, which was added in
front of "Other". This caused the value of "Other" to shift, which is a
problem for AC checks. Let's prevent making this mistake again in 1.10.9

Previous commit already moved the Other category back, this commit puts in the note for future developers

.config/dotnet-tools.json

@@ -0,0 +1,12 @@
+{
+  "version": 1,
+  "isRoot": true,
+  "tools": {
+    "cake.tool": {
+      "version": "2.2.0",
+      "commands": [
+        "dotnet-cake"
+      ]
+    }
+  }
+}

.github/ISSUE_TEMPLATE/1--bug-reporting.md

@@ -1,13 +1,17 @@
 ---
-name: Bug Reporting
-about: Bugs within Imposter
+name: 1. Bug reporting
+about: Bugs within Impostor
+title: ''
+labels: ''
+assignees: ''
+
 ---
 
 # Bug Report
 
 ## Base Information
 - Operating System
-- Imposter Version
+- Impostor Version
 - Among Us Version
 
 ## I confirm:

.github/ISSUE_TEMPLATE/2--feature-request.md

@@ -1,6 +1,10 @@
 ---
-name: Feature Request
+name: 2. Feature request
 about: To ask and request new features with Impostor
+title: ''
+labels: ''
+assignees: ''
+
 ---
 
 # Feature Request

.github/ISSUE_TEMPLATE/3--api-suggestion.md

@@ -0,0 +1,20 @@
+---
+name: 3. Api suggestion
+about: To make suggestions for the plugin api
+title: ''
+labels: api
+assignees: ''
+
+---
+
+# Api Suggestion
+
+## Suggestion
+<!--
+Describe your suggestion as detailed as possible.
+-->
+
+## Use case
+<!--
+Describe what you need it for.
+-->

.github/ISSUE_TEMPLATE/4--api-invalid-data.md

@@ -0,0 +1,25 @@
+---
+name: 4. Api invalid data
+about: To let us know about invalid data in the api
+title: ''
+labels: api
+assignees: ''
+
+---
+
+# Api missing data
+
+## Data
+<!--
+Describe about the missing data that you need.
+-->
+
+## Expectations
+<!--
+Describe what the api gave you and what you expected.
+-->
+
+## Reproduce
+<!--
+Describe how to reproduce the issue.
+-->

.github/ISSUE_TEMPLATE/5--api-unavailable-data.md

@@ -0,0 +1,20 @@
+---
+name: 5. Api unavailable data
+about: To let us know about unavailable data from the api that you would like to use
+title: ''
+labels: api
+assignees: ''
+
+---
+
+# Api missing data
+
+## Data
+<!--
+Describe about the unavailable data that you need.
+-->
+
+## Use-case
+<!--
+Describe what you need it for.
+-->

.github/ISSUE_TEMPLATE/6--api-other.md

@@ -0,0 +1,10 @@
+---
+name: 6. Api other
+about: For anything about the api that does not fit in the other issues
+title: ''
+labels: api
+assignees: ''
+
+---
+
+

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,16 @@
+### Description
+
+
+<!-- 
+
+If your pull request closes any issues, add them below with the `closes` keyword before them 
+
+Example: closes #101
+
+See the following article for more information: https://docs.github.com/en/free-pro-team@latest/github/managing-your-work-on-github/linking-a-pull-request-to-an-issue#linking-a-pull-request-to-an-issue-using-a-keyword
+
+-->
+
+### Closes issues
+
+- closes #

.github/workflows/ci.yml

@@ -0,0 +1,53 @@
+name: CI
+
+on:
+  push:
+    paths:
+      - '.github/workflows/ci.yml'
+      - 'src/**/**'
+      - 'build.cake'
+  pull_request:
+    paths:
+      - '.github/workflows/ci.yml'
+      - 'src/**/**'
+      - 'build.cake'
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - uses: actions/cache@v3
+        with:
+          path: ~/.nuget/packages
+          key: ${{ runner.os }}-nuget-${{ hashFiles('**/packages.lock.json') }}
+          restore-keys: |
+            ${{ runner.os }}-nuget-
+
+      - name: Setup .NET
+        uses: actions/setup-dotnet@v2
+        with:
+          dotnet-version: 8.x
+
+      - name: Run the Cake script
+        uses: cake-build/cake-action@v1
+        with:
+          verbosity: Diagnostic
+
+      - uses: softprops/action-gh-release@v1
+        if: github.ref_type == 'tag'
+        with:
+          draft: true
+          files: |
+            ./build/*.zip
+            ./build/*.tar.gz
+            ./build/*.nupkg
+            ./build/*.snupkg
+
+      - name: Push NuGet package
+        if: github.ref_type == 'tag'
+        run: |
+          dotnet nuget push ./build/*.nupkg --source https://api.nuget.org/v3/index.json --api-key ${{ secrets.NUGET_IMPOSTOR }}

.github/workflows/deploy.yml

@@ -1,156 +0,0 @@
-name: Deploy
-
-on:
-  push:
-    tags:
-    - 'v*'
-
-jobs:
-  build:
-    name: Build
-    runs-on: windows-latest
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v2
-        with:
-          submodules: true
-      - name: Setup MSBuild.exe
-        uses: microsoft/setup-msbuild@v1.0.1
-      - name: Setup .NET Core
-        uses: actions/setup-dotnet@v1
-        with:
-          dotnet-version: 5.0.100-rc.1.20452.10
-      - name: Install dependencies
-        run: dotnet restore ./src
-      # - name: Build Impostor.Client
-      #   run: msbuild ./src/Impostor.Client/Impostor.Client.csproj /p:Configuration=Release /p:DebugSymbols=false /p:DebugType=None
-      - name: Build Impostor.Server
-        run: dotnet build --no-restore -c Release -f net5.0 ./src/Impostor.Server/Impostor.Server.csproj
-      - name: Test
-        run: dotnet test --no-restore -v normal -f net5.0 ./src
-      # - name: Zip Impostor.Client
-      #   shell: bash
-      #   run: |
-      #     cd ./src/Impostor.Client/bin/Release/net452/win-x64
-      #     7z a -r $GITHUB_WORKSPACE/build/win-x64-client.zip *
-      #     cd $GITHUB_WORKSPACE
-      - 
-        name: Publish Impostor.Server (win-x64)
-        run: dotnet publish -c release -o ./build/win-x64 -f net5.0 -r win-x64 --self-contained --no-restore ./src/Impostor.Server/Impostor.Server.csproj /p:PublishSingleFile=true
-      - name: Zip Impostor.Server (win-x64)
-        shell: bash
-        run: |
-          cd ./build/win-x64
-          7z a -r ../win-x64.zip *
-          cd $GITHUB_WORKSPACE
-      - 
-        name: Publish Impostor.Server (linux-x64)
-        run: dotnet publish -c release -o ./build/linux-x64 -f net5.0 -r linux-x64 --self-contained --no-restore ./src/Impostor.Server/Impostor.Server.csproj /p:PublishSingleFile=true
-      - name: Zip Impostor.Server (linux-x64)
-        shell: bash
-        run: |
-          cd ./build/linux-x64
-          7z a -r ../linux-x64.zip *
-          cd $GITHUB_WORKSPACE
-      - 
-        name: Publish Impostor.Server (linux-arm)
-        run: dotnet publish -c release -o ./build/linux-arm -f net5.0 -r linux-arm --self-contained --no-restore ./src/Impostor.Server/Impostor.Server.csproj /p:PublishSingleFile=true
-      - name: Zip Impostor.Server (linux-arm)
-        shell: bash
-        run: |
-          cd ./build/linux-arm
-          7z a -r ../linux-arm.zip *
-          cd $GITHUB_WORKSPACE
-      - 
-        name: Publish Impostor.Server (linux-arm64)
-        run: dotnet publish -c release -o ./build/linux-arm64 -f net5.0 -r linux-arm64 --self-contained --no-restore ./src/Impostor.Server/Impostor.Server.csproj /p:PublishSingleFile=true
-      - name: Zip Impostor.Server (linux-arm64)
-        shell: bash
-        run: |
-          cd ./build/linux-arm64
-          7z a -r ../linux-arm64.zip *
-          cd $GITHUB_WORKSPACE
-      - 
-        name: Publish Impostor.Server (osx-x64)
-        run: dotnet publish -c release -o ./build/osx-x64 -f net5.0 -r osx-x64 --self-contained --no-restore ./src/Impostor.Server/Impostor.Server.csproj /p:PublishSingleFile=true
-      - name: Zip Impostor.Server (osx-x64)
-        shell: bash
-        run: |
-          cd ./build/osx-x64
-          7z a -r ../osx-x64.zip *
-          cd $GITHUB_WORKSPACE
-      - 
-        name: Create Release
-        id: create_release
-        uses: actions/create-release@v1
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-        with:
-          tag_name: ${{ github.ref }}
-          release_name: Release ${{ github.ref }}
-          body: |
-            Changes in this Release
-            - First Change
-            - Second Change
-          draft: true
-          prerelease: false
-      # - 
-      #   name: Upload Release Asset (win-x64) Client
-      #   uses: actions/upload-release-asset@v1
-      #   env:
-      #     GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-      #   with:
-      #     upload_url: ${{ steps.create_release.outputs.upload_url }}
-      #     asset_path: ./build/win-x64-client.zip
-      #     asset_name: Impostor-Client-win-x64.zip
-      #     asset_content_type: application/zip
-      - 
-        name: Upload Release Asset (win-x64) Server
-        uses: actions/upload-release-asset@v1
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-        with:
-          upload_url: ${{ steps.create_release.outputs.upload_url }}
-          asset_path: ./build/win-x64.zip
-          asset_name: Impostor-Server-win-x64.zip
-          asset_content_type: application/zip
-      - 
-        name: Upload Release Asset (linux-x64) Server
-        uses: actions/upload-release-asset@v1
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-        with:
-          upload_url: ${{ steps.create_release.outputs.upload_url }}
-          asset_path: ./build/linux-x64.zip
-          asset_name: Impostor-Server-linux-x64.zip
-          asset_content_type: application/zip
-      - 
-        name: Upload Release Asset (linux-arm) Server
-        uses: actions/upload-release-asset@v1
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-        with:
-          upload_url: ${{ steps.create_release.outputs.upload_url }}
-          asset_path: ./build/linux-arm.zip
-          asset_name: Impostor-Server-linux-arm.zip
-          asset_content_type: application/zip
-      - 
-        name: Upload Release Asset (linux-arm64) Server
-        uses: actions/upload-release-asset@v1
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-        with:
-          upload_url: ${{ steps.create_release.outputs.upload_url }}
-          asset_path: ./build/linux-arm64.zip
-          asset_name: Impostor-Server-linux-arm64.zip
-          asset_content_type: application/zip
-      - 
-        name: Upload Release Asset (osx-x64) Server
-        uses: actions/upload-release-asset@v1
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-        with:
-          upload_url: ${{ steps.create_release.outputs.upload_url }}
-          asset_path: ./build/osx-x64.zip
-          asset_name: Impostor-Server-osx-x64.zip
-          asset_content_type: application/zip

.github/workflows/docker.yml

@@ -2,11 +2,10 @@ name: Docker
 
 on:
   push:
-    branches: dev
+    branches: master
     paths:
       - 'src/Impostor.Server/**'
       - 'src/Impostor.Shared/**'
-      - '.gitmodules'
       - '.github/workflows/docker.yml'
       - 'Dockerfile'
     tags:
@@ -15,7 +14,6 @@ on:
     paths:
       - 'src/Impostor.Server/**'
       - 'src/Impostor.Shared/**'
-      - '.gitmodules'
       - '.github/workflows/docker.yml'
       - 'Dockerfile'
 
@@ -25,37 +23,35 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
-        uses: actions/checkout@v2
-        with:
-          submodules: true
+        uses: actions/checkout@v4
       - name: Prepare
         id: prep
         run: |
           DOCKER_IMAGE=aeonlucid/impostor
           VERSION=noop
+          VERSIONSUFFIX=docker
           if [[ $GITHUB_REF == refs/tags/* ]]; then
             VERSION=${GITHUB_REF#refs/tags/}
+            VERSIONSUFFIX=none
           elif [[ $GITHUB_REF == refs/heads/* ]]; then
-            VERSION=$(echo ${GITHUB_REF#refs/heads/} | sed -r 's#/+#-#g')
-            if [ "${{ github.event.repository.default_branch }}" = "dev" ]; then
-              VERSION=nightly
-            fi
+            VERSION=nightly
+            VERSIONSUFFIX=docker.${{ github.run_number }}
           elif [[ $GITHUB_REF == refs/pull/* ]]; then
             VERSION=pr-${{ github.event.number }}
+            VERSIONSUFFIX=pr.${{ github.event.number }}
           fi
           TAGS="${DOCKER_IMAGE}:${VERSION}"
           if [[ $VERSION =~ ^v[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}$ ]]; then
-            MINOR=${VERSION%.*}
-            MAJOR=${MINOR%.*}
-            TAGS="$TAGS,${DOCKER_IMAGE}:${MINOR},${DOCKER_IMAGE}:${MAJOR},${DOCKER_IMAGE}:latest"
+            TAGS="$TAGS,${DOCKER_IMAGE}:latest"
           fi
-          echo ::set-output name=version::${VERSION}
-          echo ::set-output name=tags::${TAGS}
-          echo ::set-output name=created::$(date -u +'%Y-%m-%dT%H:%M:%SZ')
+          echo version=${VERSION} >> $GITHUB_OUTPUT
+          echo tags=${TAGS} >> $GITHUB_OUTPUT
+          echo versionsuffix=${VERSIONSUFFIX} >> $GITHUB_OUTPUT
+          echo created=$(date -u +'%Y-%m-%dT%H:%M:%SZ') >> $GITHUB_OUTPUT
       - name: Set up QEMU
-        uses: docker/setup-qemu-action@v1
+        uses: docker/setup-qemu-action@v3
       - name: Set up Docker Buildx
-        uses: docker/setup-buildx-action@v1
+        uses: docker/setup-buildx-action@v3
       - name: Login to DockerHub
         if: github.event_name != 'pull_request'
         uses: docker/login-action@v1
@@ -63,10 +59,12 @@ jobs:
           username: ${{ secrets.DOCKERHUB_USERNAME }}
           password: ${{ secrets.DOCKERHUB_TOKEN }}
       - name: Build and push
-        uses: docker/build-push-action@v2
+        uses: docker/build-push-action@v5
         with:
           context: .
           file: ./Dockerfile
           platforms: linux/amd64,linux/arm/v7,linux/arm64
           push: ${{ github.event_name != 'pull_request' }}
           tags: ${{ steps.prep.outputs.tags }}
+          build-args: |
+            VERSIONSUFFIX=${{ steps.prep.outputs.versionsuffix }}

.github/workflows/main.yml

@@ -1,53 +0,0 @@
-name: Build
-
-on:
-  push:
-    branches: [ master, dev ]
-    paths:
-      - 'src/**'
-      - '.gitmodules'
-      - '.github/workflows/main.yml'
-  pull_request:
-    branches: [ master, dev ]
-    paths:
-      - 'src/**'
-      - '.gitmodules'
-      - '.github/workflows/main.yml'
-
-jobs:
-  build-client:
-    name: Build Client
-    runs-on: windows-latest
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v2
-        with:
-          submodules: true
-      - name: Setup MSBuild.exe
-        uses: microsoft/setup-msbuild@v1.0.1
-      - name: Setup .NET Core
-        uses: actions/setup-dotnet@v1
-        with:
-          dotnet-version: 3.1.402
-      - name: Install dependencies
-        run: dotnet restore ./src
-      - name: Build Impostor.Client
-        run: msbuild ./src/Impostor.Client/Impostor.Client.csproj /p:Configuration=Release
-  build-server:
-    name: Build Server
-    runs-on: windows-latest
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v2
-        with:
-          submodules: true
-      - name: Setup .NET Core
-        uses: actions/setup-dotnet@v1
-        with:
-          dotnet-version: 5.0.100-rc.1.20452.10
-      - name: Install dependencies
-        run: dotnet restore ./src
-      - name: Build Impostor.Server
-        run: dotnet build --no-restore -c Release -f net5.0 ./src/Impostor.Server/Impostor.Server.csproj /p:PublishTrimmed=false
-      - name: Test
-        run: dotnet test --no-restore -v normal -f net5.0 ./src

.gitignore

@@ -1 +1,7 @@
-/.vscode
+/.vscode
+/build
+/.vs
+/src/Impostor.Plugins.Debugger/Properties/launchSettings.json
+/tools
+
+.local/

.gitmodules

@@ -1,3 +0,0 @@
-[submodule "submodules/Hazel-Networking"]
-	path = submodules/Hazel-Networking
-	url = https://github.com/AeonLucid/Hazel-Networking.git

CONTRIBUTING.md

@@ -0,0 +1,22 @@
+# Contribute guidelines
+
+We are always looking for people to help improve Impostor.
+
+## Code
+
+- If you are implementing or fixing an issue, please comment on the issue so work is not duplicated.
+- If you want to implementing a new feature, create an issue first describing the issue so we know about it. We are always open for discussion or questions on [Discord](https://discord.gg/Mk3w6Tb).
+- Don't commit unnecessary changes to the codebase or debugging code.
+- Write meaningful commits or squash them.
+- Please try to follow the code style of the rest of the codebase. An `.editorconfig` file has been provided to keep consistency.
+- Stylecop is also enabled: please make sure your PR compiles without warnings.
+
+## Pull requests
+
+- Only make pull requests to the `dev` branch.
+- Only implement one feature per pull request to keep it easy to understand.
+- Expect comments or questions on your pull request from the project maintainers. We try to keep the code as consistent and maintainable as possible.
+- Each pull request should come from a new branch in your fork, it should have a meaningful name.
+- We try to respond to pull requests as fast as possible. If you think we might have missed it, let us know on [Discord](https://discord.gg/Mk3w6Tb).
+
+If you have any questions, let us know.

Dockerfile

@@ -1,15 +1,18 @@
-FROM --platform=$BUILDPLATFORM mcr.microsoft.com/dotnet/sdk:5.0 AS build
+FROM --platform=$BUILDPLATFORM mcr.microsoft.com/dotnet/sdk:8.0 AS build
 
 # See for all possible platforms
 # https://github.com/containerd/containerd/blob/master/platforms/platforms.go#L17
 ARG TARGETARCH
 
+ARG VERSIONSUFFIX="docker"
+
 WORKDIR /source
 
 # Copy csproj and restore.
 COPY src/Impostor.Server/Impostor.Server.csproj ./src/Impostor.Server/Impostor.Server.csproj
-COPY src/Impostor.Shared/Impostor.Shared.csproj ./src/Impostor.Shared/Impostor.Shared.csproj
-COPY submodules/Hazel-Networking/Hazel/Hazel.csproj ./submodules/Hazel-Networking/Hazel/Hazel.csproj
+COPY src/Impostor.Api.Innersloth.Generator/Impostor.Api.Innersloth.Generator.csproj ./src/Impostor.Api.Innersloth.Generator/Impostor.Api.Innersloth.Generator.csproj
+COPY src/Impostor.Api/Impostor.Api.csproj ./src/Impostor.Api/Impostor.Api.csproj
+COPY src/Directory.Build.props ./src/Directory.Build.props
 
 RUN case "$TARGETARCH" in \
     amd64)  NETCORE_PLATFORM='linux-x64';; \
@@ -18,11 +21,10 @@ RUN case "$TARGETARCH" in \
     *) echo "unsupported architecture"; exit 1 ;; \
   esac && \
   dotnet restore -r "$NETCORE_PLATFORM" ./src/Impostor.Server/Impostor.Server.csproj && \
-  dotnet restore -r "$NETCORE_PLATFORM" ./src/Impostor.Shared/Impostor.Shared.csproj && \
-  dotnet restore -r "$NETCORE_PLATFORM" ./submodules/Hazel-Networking/Hazel/Hazel.csproj
+  dotnet restore -r "$NETCORE_PLATFORM" ./src/Impostor.Api.Innersloth.Generator/Impostor.Api.Innersloth.Generator.csproj && \
+  dotnet restore -r "$NETCORE_PLATFORM" ./src/Impostor.Api/Impostor.Api.csproj
 
 # Copy everything else.
-COPY submodules/. ./submodules/
 COPY src/. ./src/
 RUN case "$TARGETARCH" in \
     amd64)  NETCORE_PLATFORM='linux-x64';; \
@@ -30,11 +32,16 @@ RUN case "$TARGETARCH" in \
     arm)    NETCORE_PLATFORM='linux-arm';; \
     *) echo "unsupported architecture"; exit 1 ;; \
   esac && \
-  dotnet publish -c release -o /app -r "$NETCORE_PLATFORM" --no-restore ./src/Impostor.Server/Impostor.Server.csproj
+  [ $VERSIONSUFFIX = "none" ] && VERSIONSUFFIX=; \
+  dotnet publish -c release -o /app -r "$NETCORE_PLATFORM" -p:VersionSuffix="$VERSIONSUFFIX" --no-restore ./src/Impostor.Server/Impostor.Server.csproj
 
 # Final image.
-FROM --platform=$TARGETPLATFORM mcr.microsoft.com/dotnet/runtime-deps:5.0
+FROM --platform=$TARGETPLATFORM mcr.microsoft.com/dotnet/aspnet:8.0
 WORKDIR /app
 COPY --from=build /app ./
-EXPOSE 22023/udp
-ENTRYPOINT ["./Impostor.Server"]
+
+# Override ASPNETCORE_URLS to stop warning.
+ENV ASPNETCORE_URLS=
+
+EXPOSE 22023/tcp 22023/udp
+ENTRYPOINT ["./Impostor.Server"]

README.md

@@ -1,49 +1,37 @@
 # Impostor
 
-Impostor is one of the first **Among Us** private servers, written in C#.
+[![Discord](https://img.shields.io/badge/Discord-chat-blue?style=flat-square)](https://discord.gg/Mk3w6Tb)
+[![CI](https://github.com/Impostor/Impostor/workflows/CI/badge.svg)](https://github.com/Impostor/Impostor/actions)
 
-The latest version supported is `2020.9.22`, both desktop and mobile.
+Impostor is the first working **Among Us** private server, written in C#.
 
-There are no special features at this moment, the goal is aiming to be as close as possible to the real server, for now. In a later stage, making modifications to game logic by modifying `GameData` packets can be looked at.
+As Among Us is actively updated, you may want to use the latest build from the master branch if you want to play on the latest version of Among Us that supported by Impostor.
 
-[Discord server for Impostor](https://discord.gg/Mk3w6Tb)
+If you want to play on an older version of Among Us, you can download old releases from [here](https://github.com/Impostor/Impostor/releases/), however these versions are less supported.
 
 ## Features
 
-All Among Us features are implemented. It is a full replacement for the official server.
-
-- [x] Create game
-- [x] Join game
-- [x] Start game
-- [x] Game listing
-- [x] V1 GameCodes (AAAA)
-- [x] V2 GameCodes (AAAAAA)
-- [x] Kick player
-- [x] Ban player
-- [x] Server redirection
-- [ ] Multiple master servers
+- All Among Us features are implemented. It is a full replacement for the official server.
+- Plugin support.
+- Server-sided anticheat.
 
 ## Installation
 
 ### Client
 
-If you just want to play on a server hosted by someone else, you need to follow these instructions.
-
-1. Find the [latest release](https://github.com/AeonLucid/Impostor/releases/latest).
-2. Download `Impostor-Client-win-x64.zip`.
-3. Extract the zip.
-4. Run `Impostor.Client.exe`.
-5. Follow the instructions inside the application.
-
-![Client](docs/images/client.jpg)
+If you just want to play on a server hosted by someone else, you need to configure your client to connect to an Impostor server. Please go to [this website](https://impostor.github.io/Impostor) to set up your client by following the instructions for your OS there.
 
 ### Server
 
-See the [wiki](https://github.com/AeonLucid/Impostor/wiki/Running-the-server) for instructions on how to set it up.
+See the [docs](docs/Running-the-server.md) for instructions on how to set it up.
+
+## Troubleshooting
+
+See [TROUBLESHOOTING](docs/TROUBLESHOOTING.md) to solve issues with the Impostor client or the server.
 
 ## Contributing
 
-If you want to contribute to Impostor, make sure you work on and target the `dev` branch. That is where the latest changes will be. 
+See [CONTRIBUTING](CONTRIBUTING.md).
 
 ## License
 

build.cake

@@ -0,0 +1,165 @@
+#addin "nuget:?package=SharpZipLib&Version=1.3.3"
+#addin "nuget:?package=Cake.Compression&Version=0.3.0"
+#addin "nuget:?package=Cake.FileHelpers&Version=5.0.0"
+
+var workflow = BuildSystem.GitHubActions.Environment.Workflow;
+var buildId = workflow.RunNumber;
+var tag = workflow.RefType == GitHubActionsRefType.Tag ? workflow.RefName : null;
+
+var buildVersion = FindRegexMatchGroupInFile("./src/Directory.Build.props", @"\<VersionPrefix\>(.*?)\<\/VersionPrefix\>", 1, System.Text.RegularExpressions.RegexOptions.None).Value;
+var buildDir = MakeAbsolute(Directory("./build"));
+
+var target = Argument("target", "Test");
+var configuration = Argument("configuration", "Release");
+
+var msbuildSettings = new DotNetMSBuildSettings();
+
+if (tag != null) 
+{
+    if (tag[1..] != buildVersion) throw new Exception("Tag version has to be the same as VersionPrefix in Directory.Build.props");
+    msbuildSettings.Version = buildVersion;
+}
+else if (buildId != 0) 
+{
+    buildId += 500; 
+    msbuildSettings.VersionSuffix = "ci." + buildId;
+    buildVersion += "-ci." + buildId;
+} 
+else 
+{
+    buildVersion += "-dev";
+}
+
+//////////////////////////////////////////////////////////////////////
+// UTILS
+//////////////////////////////////////////////////////////////////////
+
+// Remove unnecessary files for packaging.
+private void ImpostorPublish(string name, string project, string runtime, bool isServer = false) {
+    var projBuildDir = buildDir.Combine(name + "_" + runtime);
+    var projBuildName = name + "_" + buildVersion + "_" + runtime;
+
+    DotNetPublish(project, new DotNetPublishSettings {
+        Configuration = configuration,
+        NoRestore = true,
+        Runtime = runtime,
+        SelfContained = false,
+        PublishSingleFile = true,
+        PublishTrimmed = false,
+        OutputDirectory = projBuildDir,
+        MSBuildSettings = msbuildSettings
+    });
+
+    if (isServer) {
+        CreateDirectory(projBuildDir.Combine("plugins"));
+        CreateDirectory(projBuildDir.Combine("libraries"));
+
+        if (runtime == "win-x64") {
+            FileWriteText(projBuildDir.CombineWithFilePath("run.bat"), "@echo off\r\nImpostor.Server.exe\r\npause");
+        }
+    }
+
+    if (runtime == "win-x64") {
+        Zip(projBuildDir, buildDir.CombineWithFilePath(projBuildName + ".zip"));
+    } else {
+        GZipCompress(projBuildDir, buildDir.CombineWithFilePath(projBuildName + ".tar.gz"));
+    }
+    
+    if (BuildSystem.GitHubActions.IsRunningOnGitHubActions) {
+        BuildSystem.GitHubActions.Commands.UploadArtifact(projBuildDir, projBuildName);
+    }
+}
+
+private void ImpostorPublishNF(string name, string project) {
+    var runtime = "win-x64";
+    var projBuildDir = buildDir.Combine(name + "_" + runtime);
+    var projBuildZip = buildDir.CombineWithFilePath(name + "_" + buildVersion + "_" + runtime + ".zip");
+
+    DotNetPublish(project, new DotNetPublishSettings {
+        Configuration = configuration,
+        NoRestore = true,
+        Framework = "net472",
+        OutputDirectory = projBuildDir,
+        MSBuildSettings = msbuildSettings
+    });
+
+    Zip(projBuildDir, projBuildZip);
+}
+
+//////////////////////////////////////////////////////////////////////
+// TASKS
+//////////////////////////////////////////////////////////////////////
+
+Task("Clean")
+    .Does(() => {
+        if (DirectoryExists(buildDir)) {
+            DeleteDirectory(buildDir, new DeleteDirectorySettings {
+                Recursive = true
+            });
+        }
+    });
+
+Task("Restore")
+    .Does(() => {
+        DotNetRestore("./src/Impostor.sln");
+    });
+
+Task("Replay")
+    .Does(() => {
+        // D:\Projects\GitHub\Impostor\Impostor\src\Impostor.Tools.ServerReplay\sessions
+        DotNetRun(
+            "./src/Impostor.Tools.ServerReplay/Impostor.Tools.ServerReplay.csproj", 
+            "./src/Impostor.Tools.ServerReplay/sessions", new DotNetRunSettings {
+                Configuration = configuration,
+                NoRestore = true,
+            });
+    });
+
+Task("Build")
+    .IsDependentOn("Clean")
+    .IsDependentOn("Restore")
+    .IsDependentOn("Replay")
+    .Does(() => {
+        // Tests.
+        DotNetBuild("./src/Impostor.Tests/Impostor.Tests.csproj", new DotNetBuildSettings {
+            Configuration = configuration,
+        });
+            
+        // Server.
+        ImpostorPublish("Impostor-Server", "./src/Impostor.Server/Impostor.Server.csproj", "win-x64", true);
+        ImpostorPublish("Impostor-Server", "./src/Impostor.Server/Impostor.Server.csproj", "osx-x64", true);
+        ImpostorPublish("Impostor-Server", "./src/Impostor.Server/Impostor.Server.csproj", "linux-x64", true);
+        ImpostorPublish("Impostor-Server", "./src/Impostor.Server/Impostor.Server.csproj", "linux-arm", true);
+        ImpostorPublish("Impostor-Server", "./src/Impostor.Server/Impostor.Server.csproj", "linux-arm64", true);
+
+        // API.
+        DotNetPack("./src/Impostor.Api/Impostor.Api.csproj", new DotNetPackSettings {
+            Configuration = configuration,
+            OutputDirectory = buildDir,
+            IncludeSource = true,
+            IncludeSymbols = true,
+            MSBuildSettings = msbuildSettings
+        });
+
+        if (BuildSystem.GitHubActions.IsRunningOnGitHubActions) {
+            foreach (var file in GetFiles(buildDir + "/*.{nupkg,snupkg}"))
+            {
+                BuildSystem.GitHubActions.Commands.UploadArtifact(file, "Impostor.Api");
+            }
+        }
+    });
+
+Task("Test")
+    .IsDependentOn("Build")
+    .Does(() => {
+        DotNetTest("./src/Impostor.Tests/Impostor.Tests.csproj", new DotNetTestSettings {
+            Configuration = configuration,
+            NoBuild = true
+        });
+    });
+
+//////////////////////////////////////////////////////////////////////
+// EXECUTION
+//////////////////////////////////////////////////////////////////////
+
+RunTarget(target);

docs/Building-from-source.md

@@ -0,0 +1,29 @@
+# Building from source
+
+The solution contains the Impostor server and its dependencies, like Hazel and the plugin API. The server is built using [.NET 8](https://dotnet.microsoft.com/download/dotnet/8.0).
+
+## Cloning Impostor
+
+You need to clone Impostor using git:
+
+```bash
+git clone https://github.com/Impostor/Impostor.git
+```
+
+## Building the server
+
+### Dependencies
+
+- [.NET 8 SDK](https://dotnet.microsoft.com/download/dotnet/8.0)
+- [Rider](https://www.jetbrains.com/rider/) or [Visual Studio](https://visualstudio.microsoft.com/vs/) (Optional, only if you want the full IDE experience)
+
+### Build using the CLI
+
+```bash
+cd src/Impostor.Server/
+dotnet build
+# Or if you want a single file, ready for production: (change linux-x64 to win-x64 if you use Windows)
+dotnet publish -c Release -r linux-x64 -p:PublishSingleFile=true
+```
+
+To setup the server, please look at [Running the server](Running-the-server.md).

docs/FAQ.md

@@ -0,0 +1,23 @@
+# Frequently Answered Questions
+
+## What is this?
+
+The Impostor project is a reverse engineered and open source server for the game Among Us. The game itself is developed by [Innersloth](http://www.innersloth.com/) while this project is maintained by the community. This project was built out of frustration for the lack of server availability in certain regions and the inability for the core developer, [AeonLucid](https://github.com/AeonLucid), to join a public game. As of this time, it has not been officially endorsed by the studio.
+
+## Can this be used with the mobile version of the game?
+
+Yes, Impostor can be used with both the Android and iOS versions of the game. You can add a custom server via a link, you can do this using the [site](https://impostor.github.io/Impostor)
+
+## Can this be used with the console version of the game?
+
+Sadly not, as these don't allow adding custom servers.
+
+## Can this be used with Among Us 3D/VR?
+
+No, it's an entirely different game with a completely different network stack. So we'd need to develop another server completely from scratch. We're currently not interested in doing this.
+
+## How can I get started?
+
+See [Setting up your Server](Running-the-server.md) for more information on running the server and [Client Setup](https://impostor.github.io/Impostor/) for helping your friends join in!
+
+If you're having issues with the server software, check the [Troubleshooting page](TROUBLESHOOTING.md).

docs/Http-server.md

@@ -0,0 +1,82 @@
+# HTTP Server
+
+Since Impostor 1.9.0 a HTTP service is included for matchmaking, which is required for clients to connect to the Impostor server.
+
+Starting from Among Us 16.0.5, you need to set up HTTPS for players to connect to your server.
+Unfortunately Impostor doesn't handle SSL certificates, so you need to set up a reverse proxy.
+
+## Use a reverse proxy
+
+A reverse proxy allows you to forward HTTP requests from users to multiple services. If you already have one, you should configure it to add Impostor. 
+
+If you have never set up a reverse proxy before, we recommend you to set up [Caddy](https://caddyserver.com/). It is easy to set up and comes with support for requesting SSL certificates out of the box.
+
+To prevent people from connecting directly to Impostor, we recommend changing the "ListenIp" in the "HttpServer" section to "127.0.0.1". This makes sure people can't connect to your HTTP server other than via your reverse proxy. Keep the "ListenIp" in the "Server" section at "0.0.0.0" though, running the normal game traffic through a proxy is not supported.
+
+### Caddy
+
+To install Caddy, follow the [official installation guide](https://caddyserver.com/docs/install). Then use the following lines as your `Caddyfile` configuration file:
+
+```
+example.com # replace example.com with your domain name
+
+reverse_proxy :22023
+```
+
+Now run `caddy run` in the folder with this Caddyfile and it should set up a server for you with a free SSL certificate.
+If this works, you should set up [Caddy to run in the background](https://caddyserver.com/docs/running)
+
+### Nginx
+
+Nginx is an alternative to Caddy that is a bit harder to set up. If you already use Nginx, you can use our snippet to add Impostor:
+
+<details><summary>Nginx configuration</summary>
+
+```nginx
+server {
+    listen 443 ssl http2;
+    server_name example.com; # replace example.com with your domain name
+
+    # Assuming you're using Certbot, replace example.com with your domain name
+    ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem;
+    ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;
+    ssl_trusted_certificate /etc/letsencrypt/live/example.com/fullchain.pem;
+
+    location / {
+        proxy_pass http://localhost:22023; # Change the port to your HttpServer's ListenPort
+        proxy_set_header X-Forwarded-For $remote_addr;
+        proxy_set_header X-Forwarded-Proto $scheme;
+    }
+}
+
+# Redirect all traffic to HTTPS
+server {
+    listen 80 default_server;
+    location / {
+        return 307 https://$host$request_uri;
+    }
+}
+```
+
+</details>
+
+## Stop exposing Impostor's HTTP server to the internet directly
+
+To only allow connections to Impostor's HTTP servers via the reverse proxy, we recommend to set the ListenIp of the HTTP server to 127.0.0.1:
+
+```json
+{
+ // NOTE: merge this snippet into the rest of your configuration
+ "HttpServer": {
+   "ListenIp": "127.0.0.1"
+ }
+}
+```
+
+Or if you're configuring Impostor with environment variables:
+
+```sh
+IMPOSTOR_HttpServer__ListenIp=127.0.0.1
+```
+
+For more information on server configuration, see [Server-configuration.md](Server Configuration).

docs/README.md

@@ -0,0 +1,7 @@
+# Impostor Documentation
+
+1. [Running the server](Running-the-server.md)
+2. [Server configuration](Server-configuration.md)
+3. [Building from source](Building-from-source.md)
+4. [Writing a plugin](Writing-a-plugin.md)
+5. [Frequently answered questions](FAQ.md)

docs/Running-the-server.md

@@ -0,0 +1,67 @@
+# Running the server
+
+There are currently two install methods for Impostor: You can install it normally or inside of a Docker container. If you do not have a particular preference, we recommend the normal installation over the Docker container method.
+
+## General remarks for both install methods
+
+This section applies to both the normal installation as well as the Docker (Compose) installation
+
+To connect to the server, you need to configure and install a region file on https://impostor.github.io/Impostor/
+
+Among Us connects to the server using two network services: the (TCP) HTTP service points Among Us to the UDP service, then the UDP service hosts the actual game traffic. Because of this, Impostor uses port 22023 using **both** the TCP and UDP protocols.
+
+To connect to your Among Us version from another PC, you need to set up a HTTP reverse proxy to support HTTPS. If you're just running a version of Impostor for testing Setup instructions for this are in the [Http Server documentation](Http-server.md).
+
+If you want to test if your Among Us HTTP server is working, open `http://localhost:22023` (assuming you're using the default settings, change the IP and port respectively) in a browser
+
+Depending on your host you may also need to port forward Impostor to the internet or pass Impostor traffic by your firewall. Port 22023 UDP needs to be accessible for everyone that wants to play on the server, then you also need to portforward your HTTP reverse proxy or port 22023 TCP if you don't use a reverse proxy. As port forwarding changes per host or router configuration, port forwarding is not covered by this guide.
+
+## Normal installation
+
+1. Install [.NET 8.0](https://dotnet.microsoft.com/download/dotnet/8.0). We recommend either the ASP.NET Core Runtime or the SDK. The SDK is necessary in case you want to develop Impostor or Impostor plugins.
+2. Download the [latest release](https://github.com/Impostor/Impostor/releases) or the [latest CI build](https://nightly.link/Impostor/Impostor/workflows/ci/master). Note that Impostor is built for multiple CPU-architectures and operating systems, you most likely want the x64 version, unless you are running on a Raspberry Pi or another device/VPS with an Arm processor.
+3. Extract the zip.
+4. Modify `config.json` to your liking. Documentation can be found [here](Server-configuration.md). You need to at least change `PublicIp` to the address people will connect to your server to.
+5. Run `Impostor.Server` (Linux/macOS) or `Impostor.Server.exe` (Windows)
+6. Set up a reverse proxy to support HTTPS, so you can connect to your server from another device. See [reverse proxy configuration](Http-server.md)
+7. (OPTIONAL - Linux) Configure a systemd definition file and enable the service to start on boot, see [systemd configuration](Server-configuration.md#systemd)
+
+
+## Using Docker
+
+[![Docker Image](https://img.shields.io/docker/v/aeonlucid/impostor?sort=semver)](https://hub.docker.com/r/aeonlucid/impostor)
+[![Docker Image](https://img.shields.io/docker/v/aeonlucid/impostor/nightly)](https://hub.docker.com/r/aeonlucid/impostor)
+
+Docker is a program that allows you to run programs like Impostor in a container.
+
+After installing Docker, you can just start a Docker container with `docker run`:
+
+```
+docker run -p 127.0.0.1:22023:22023/tcp -p 22023:22023/udp -e IMPOSTOR_Server__PublicIp=your.public.ip.here aeonlucid/impostor:nightly
+```
+
+Please replace `your.public.ip.here` with the public IP address of your server. This is the address Among Us will try to reach your server at.
+
+To configure the docker container, either use environment variables or mount config.json in your container.
+
+## Using Docker Compose
+
+Docker Compose allows you to start a Docker container using a predefined configuration. This is an example configuration you can continue on:
+
+```
+version: '3.4'
+
+services:
+  impostor:
+    image: aeonlucid/impostor:nightly
+    container_name: impostor
+    ports:
+      - 127.0.0.1:22023:22023/tcp # Set up your own reverse proxy to terminate HTTPS
+      - 22023:22023/udp
+    environment: # Either configure Impostor using environment variables or mount config.json in your container
+      - IMPOSTOR_Server__PublicIp=your.public.ip.here
+    volumes:
+      - /path/to/local/config.json:/app/config.json # Mount config.json
+      - /path/to/local/plugins:/app/plugins         # Only needed if using plugins
+      - /path/to/local/libraries:/app/libraries     # Only needed if using external libraries (some plugins may need this)
+```

docs/Server-configuration.md

@@ -0,0 +1,185 @@
+# Server configuration
+
+## Options
+
+### Required Server Configuration
+
+| Key            | Default     | Description                                                                                                                                                                                                                                                                                                                                                                                            |
+| -------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| **PublicIp**   | `127.0.0.1` | This needs to the public IPv4 address of the server which you give to others to connect. You can find your IPv4 address [on this website](http://whatismyip.host/). Unless you are only planning to use Impostor privately, on your local network, you should change this to your public ip. It is also possible to use hostnames instead of IPv4 addresses, which will be resolved to IPv4 addresses. |
+| **PublicPort** | `22023`     | The public port of the server which you give to others to connect. (**This is the external port you configure on your router when port forwarding.**) Usually `22023`.                                                                                                                                                                                                                                 |
+| **ListenIp**   | `0.0.0.0`   | The network interface to listen on. If you do not know what to put here, use `0.0.0.0`. Since 1.2.2 it is also possible to use hostnames instead of IPv4 addresses, these must resolve to a valid IPv4 address.                                                                                                                                                                                        |
+| **ListenPort** | `22023`     | The listen port of the server, usually `22023`. For port forwarding purposes: this is an UDP port                                                                                                                                                                                                                                                                                                                                                       |
+
+### HttpServer
+
+Impostor has an Http Server that is used by recent versions of Among Us to connect to. See [the Http Server page](Http-server.md) for more details on how to set this up.
+
+| Key            | Default   | Description                                                                                                                                                                |
+|----------------|-----------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| **Enabled**    | `true`    | Whether the http server should be enabled.                                                                                                                                 |
+| **ListenIp**   | `0.0.0.0` | The network interface to listen on. Use `127.0.0.1` if you use a reverse proxy or just run locally. Use `0.0.0.0` if you are directly exposing this server to the internet |
+| **ListenPort** | `22023`   | The listen port of this server. For port forwarding purposes, this is an TCP port.                                                                                         |
+
+### AntiCheat
+
+Impostor has an Anticheat that makes it possible to kick cheaters from games automatically. Note that the anticheat is tuned on the vanilla version of the game, so client-side modifications could trigger the Anticheat if you're playing with them.
+
+| Key                           | Default       | Value                                                                                                                                                                                                               |
+|-------------------------------|---------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| **Enabled**                   | `true`        | Whether the anticheat should be enabled.                                                                                                                                                                            |
+| **BanIpFromGame**             | `true`        | When anticheat is enabled and a player is caught hacking, they will be kicked from the server. If this value is set to `true`, the player will be banned instead and will not be able to rejoin that specific game. |
+| **AllowCheatingHosts**        | `"Never"`     | Configure whether hosts are allowed to cheat. "Never" forbids it, "Always" allows it. "IfRequested" allows hosts to cheat if they connect with the DisableServerAuthorityFlag set.                                  |
+| **AllowHostOnlyExtensions**   | "IfRequested" | Configure whether [Host-Only extensions](https://github.com/Innersloth-LLC/AmongUsModdingInformation#host-only-mods) are allowed in all games ("Always"), +25 games only ("IfRequested") or by nobody ("Never")     |
+| **EnableGameFlowChecks**      | `true`        | Enable checks that check if certain actions are done in the appropriate order or at the appropriate moment in the game. This includes changing cosmetics while in game or murdering too fast.                       |
+| **EnableInvalidObjectChecks** | `true`        | Enables checks that check if network objects are spawned properly. Disabling this option also implies disabling EnableRoleChecks.                                                                                   |
+| **EnableMustBeHostChecks**    | `true`        | Enables checks that check if players are the host before they can do actions that require them to be host of the game. This includes starting the game and spawning objects.                                        |
+| **EnableColorLimitChecks**    | `true`        | Enables checks that checks if players request colors that are already in use.                                                                                                                                       |
+| **EnableNameLimitChecks**     | `true`        | Enables checks that checks if player names have a length that is possible to set using the user interface.                                                                                                          |
+| **EnableItemLimitChecks**     | `true`        | Enables checks for item counts that cannot be exceeded in the official clients.                                                                                                                                     |
+| **EnableOwnershipChecks**     | `true`        | Enables checks that check if players are allowed to perform a certain action on themself or another player.                                                                                                         |
+| **EnableRoleChecks**          | `true`        | Enables checks that check if players have the correct role when performing certain role abilities like venting or murdering.                                                                                        |
+| **EnableTargetChecks**        | `true`        | Enables checks that check if certain packets to everyone that should only have been sent to certain players or vice versa. This includes sending votes or network objects.                                          |
+| **EnableIdentifierChecks**    | `true`        | Enables checks that verify if the friendcode and puid a host claims for a player in their PlayerInfo match the ones known for that player.                                                                         |
+| **ForbidProtocolExtensions**  | `true`        | If disabled allows players to send network packets that go beyond the network packets sent by the vanilla game. This is necessary for most mods that need all players to install it.                                |
+| **EnablePacketSizeChecks**    | `true`        | Enables checks that verify if network messages exceed the maximum allowed size.                                                                                                                                     |
+| **PacketSizeLimit**           | `1203`        | The maximum allowed size (in bytes) for a network message. The official servers of Among Us requires that a Hazel packet is < 1204 bytes, excluding headers.                                                        |
+
+### Compatibility
+
+Impostor has some compatibility options which allow some extra flexibility but may not work properly. Enabling any of these options is not recommended. When contacting support, please mention which of these options are enabled.
+
+| Key                         | Default | Value                                                                                                                                                                                                                                                            |
+|-----------------------------|---------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| **AllowFutureGameVersions** | `false` | Warning: Setting this option to `true` is unsupported and may cause issues when large updates to Among Us are released, but can be useful when a small patch is released. Allows future versions of Among Us to join your server.                                |
+| **AllowHostAuthority**      | `false` | Certain Among Us mods allow disabling some server-authoritative features, which also changes some code paths in the client. These code paths have not undergone as much testing and contain bugs, which can't be fixed from the Impostor side. Use with caution. |
+| **AllowVersionMixing**      | `false` | Allows players using different game versions to play in one lobby that have not been marked by the Impostor developers as compatible.                                                                                                                            |
+
+### Debug
+
+The Debug configuration is used to enable the game recorder. This is mostly useful when developing Impostor.
+
+| Key                     | Default | Value                                        |
+| ----------------------- | ------- | -------------------------------------------- |
+| **GameRecorderEnabled** | `false` | Enables the Game Recorder.                   |
+| **GameRecorderPath**    | _empty_ | Path where the recorded games will be saved. |
+
+### Serilog (Logging)
+
+Impostor's log framework, Serilog, can be configured in the config file. You can change its default log level and you can add additional sinks.
+
+| Key              | Default       | Value                                                                                                                                                                                                                          |
+| ---------------- | ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| **MinimumLevel** | `Information` | Minimum log level for a message to be printed. If a log entry is as severe or more severe than this level, it will be printed. From most severe to least severe: `Fatal`,`Error`, `Warning`, `Information`, `Debug`, `Verbose` |
+| **Using**        | `[]`          | List of additional Serilog Sinks assemblies to load.                                                                                                                                                                           |
+| **WriteTo**      | `[]`          | Additional logging sinks. See the Serilog documentation or the example in this section. Serilog                                                                                                                                |
+
+For more information, check the [Serilog.Settings.Configuration](https://github.com/serilog/serilog-settings-configuration) documentation.
+
+For example, to add logging to a file, you should add the following snippet to your configuration:
+
+```json
+"Serilog": {
+  "Using": [
+    "Serilog.Sinks.File"
+  ],
+  "WriteTo": [
+    {
+      "Name": "File",
+      "Args": {
+        "path": "logs/log.txt",
+        "rollingInterval": "Day"
+      }
+    }
+  ]
+}
+```
+
+Next to that, you also need to copy over Serilog.Sinks.File.dll from [NuGet](https://www.nuget.org/packages/Serilog.Sinks.File/). See the [Serilog.Sinks.File documentation](https://github.com/serilog/serilog-sinks-file#json-appsettingsjson-configuration) for a list of parameters that can be configured.
+
+Other Serilog sinks are also supported, but are out of scope for this documentation.
+
+## Config providers
+
+### File
+
+The `config.json` file contains all the configurable options.
+
+### Environment variables
+
+If you're unable to edit the `config.json` file, you can instead set Environment variables to configure Impostor. The general pattern for each variable is `IMPOSTOR_SectionName__VariableName`. For example, to disable the anticheat, you can set the environment variable `IMPOSTOR_AntiCheat__Enabled=false`. Here are some more examples:
+
+```
+IMPOSTOR_Server__PublicIp=127.0.0.1
+IMPOSTOR_Server__PublicPort=22023
+IMPOSTOR_Server__ListenIp=0.0.0.0
+IMPOSTOR_Server__ListenPort=22023
+IMPOSTOR_AntiCheat__Enabled=true
+IMPOSTOR_AntiCheat__BanIpFromGame=true
+```
+
+# systemd
+
+Linux users will likely want to create a systemd service definition to manage running the Impostor application.  Benefits to using a systemd service include the following:
+
+- The server process can automatically restart if the process dies
+- Impostor can be set to start on boot (handy if you do system updates regularly)
+- You can use systemd targets to ensure the process doesn't start until the system dependencies are met
+
+Using your favorite text editor, create the following service file:
+
+```
+sudoedit /etc/systemd/system/impostor.service
+```
+
+Modify the following template to your needs and populate the service file.
+
+```
+[Unit]
+Description=Impostor private Among Us server - https://github.com/Impostor/Impostor
+
+[Service]
+# Directory where Impostor is installed
+WorkingDirectory=/opt/impostor
+# Path to Impostor binary
+ExecStart=/opt/impostor/Impostor.Server
+Restart=always
+# Restart service after 10 seconds if the dotnet service crashes
+RestartSec=10
+KillSignal=SIGTERM
+SyslogIdentifier=impostor
+
+# User and group that will run the Impostor server process -- ensure that user is allowed to execute the binary
+User=impostor
+Group=impostor
+TimeoutStopSec=10
+
+[Install]
+# Wait until most system services have started before starting Impostor
+After=multi-user.target
+WantedBy=multi-user.target
+```
+
+Reload all systemd unit files to source in the new file you've created.
+
+```
+sudo systemctl daemon-reload
+```
+
+Start the service. 
+
+```
+sudo systemctl start impostor.service
+```
+
+Check the log for the service and verify it has started correctly -- Hint: Use the Q key to quit out of journalctl.
+
+```
+sudo journalctl -u impostor.service
+```
+
+If everything has started correctly, ensure the service is set to start on boot.
+
+```
+sudo systemctl enable impostor.service
+```

docs/TROUBLESHOOTING.md

@@ -0,0 +1,63 @@
+# Troubleshooting
+
+If you're reading this, something went wrong.
+Don't worry though, as this is the most thorough guide to help you!
+
+## `./Impostor.Server: line 1: ELF: not found` (plus other errors)
+
+No idea where you got that system. But we clearly do **NOT** support it.
+
+## `cannot execute binary file: Exec format error`
+
+Please check that you have downloaded the right version of Impostor, as we mantain two CPU architectures (x64 and ARM).
+Unless you are running Impostor on a computer like the Raspberry Pi, you most likely want to use the x64 version.
+
+## `./Impostor.Server: Permission denied`
+
+This is an error related to Linux file permissions.
+Some files do not hold their executable bit (the permission that allows them to run) during a download.
+You can solve this by doing: `chmod +x Impostor.Server`
+
+## Disconnected with `Your client is too new, please update your Impostor to play`
+
+This happens when your game is too new for your copy of Impostor to support.
+
+If you're using an Impostor release, check if there is a newer release available that supports your version. If this doesn't exist, you can try the [latest build from CI](https://nightly.link/Impostor/Impostor/workflows/ci/master).
+
+If even that build doesn't work, you can try looking through the Pull Requests to see if there is a pending pull request that aims to update it to the next version, but note these may be unstable and may contain malicious code, as they haven't been vetted by the Impostor development team yet.
+
+## Disconnected with `Please update your game to play on this server`
+
+This happens when you're using a version of Impostor that is too new for your game version. You can download an older version from [the GitHub release page](https://github.com/Impostor/Impostor/releases). We however don't support older versions of Impostor with new API's and bugfixes so we recommend to update your game instead.
+
+## Disconnected with `You are using an older version of the game`
+
+You are using a version of Impostor that is not designed for the version of the game you're playing. The game does not really check who is outdated and blames it on the user. Newer versions (v1.5.0+) do warn correctly and send the correct message.
+
+Look at which version of the game you're playing, which you can see in the top left corner of the main menu, then download an Impostor version for that game. Every [release on the release page](https://github.com/Impostor/Impostor/releases) shows which version of the game it is compatible with. If your game version is newer than the latest release, check if the [latest build from CI works](https://nightly.link/Impostor/Impostor/workflows/ci/master).
+
+## Disconnected with `You disconnected from the server. Reliable Packet 1 ...`
+
+Please double-check that you have followed the [Server Configuration](Server-configuration.md) correctly.
+**NOTE: Your public ip does not start with `10`, `127` or `192`**
+Also check if the port Impostor (ListenPort) is listening on is correctly port-forwarded for UDP (or TCP/UDP).
+
+## `Could not load file or assembly...`
+
+Please check that you only have **working** plugins in the `plugins` folder.
+This error can be caused by non-plugin files or plugins that are not working correctly.
+
+## Disconnected with `You disconnected from the server. If this happens often, check your network strength. This may also be a server issue`
+
+Usually this means that Among Us couldn't connect to Impostor's HTTP server.
+
+Open the address of your server in a web browser, it should show you a small page confirming that Impostor is available.
+
+## My question is not yet answered and I'm still having problems!
+
+That's unfortunate. Join the [Impostor Discord](https://discord.gg/Mk3w6Tb), ask your question there and we'll try to help you out. Note that we're not always available, so it may take some time to get an answer. To make answering your question easier, please add the following details:
+
+- Which version of Impostor are you using?
+- Which version or Among Us are you using?
+- Which operating system are you running Impostor on?
+- If you have console logs, attaching these will also help.

docs/Upgrading.md

@@ -0,0 +1,12 @@
+# Upgrading Impostor
+
+Sometimes we make incompatible changes to existing code. This document lists these changes and which changes you should make as a server administrator.
+
+## Impostor 1.9.0
+
+Previously we recommended using the Impostor.Http plugin for HTTP matchmaking. Because Among Us now relies on HTTP matchmaking, this plugin is now part of the default installation. As a result, you should change your server as follows:
+
+- If you have Impostor.Http installed, you should remove that plugin. If you have changed the default settings, you need to move these changes to the [HttpServer section in config.json](Server-configuration.md#HttpServer).
+- If you have plugins that required Impostor.Http's API (like Reactor.Impostor.Http), you should check that plugin for updates
+- It is no longer necessary to add the ASP.NET Core folder to the PluginLoader's LibraryPaths
+

docs/Writing-a-plugin.md

@@ -0,0 +1,332 @@
+# Writing a plugin
+
+Impostor has support for plugins. This document will help you to setup a development environment for writing a plugin.
+
+- [1. Install .NET Core SDK](#1-install-net-core-sdk)
+- [2. Create a C# project](#2-create-a-c-project)
+- [3. Add the Impostor.Api library](#3-add-the-impostorapi-library)
+  - [Quick](#quick)
+  - [Visual Studio](#visual-studio)
+- [4. The plugin class](#4-the-plugin-class)
+- [5. Adding an event listener](#5-adding-an-event-listener)
+- [6. Registering the event listener](#6-registering-the-event-listener)
+- [7. Build and run your plugin](#7-build-and-run-your-plugin)
+- [8. Extra](#8-extra)
+  - [Event listeners](#event-listeners)
+  - [Dependency injection](#dependency-injection)
+  - [Server configuration](#server-configuration)
+  - [Using other libraries](#using-other-libraries)
+  - [Impostor versions](#impostor-versions)
+- [9. Missing/invalid data or want more functions?](#9-missinginvalid-data-or-want-more-functions)
+
+## 1. Install .NET SDK
+
+Download and install the latest .NET SDK.
+
+https://dotnet.microsoft.com/download
+
+## 2. Create a C# project
+
+The first step is creating a new C# project, it must be a **Class Library (.NET Standard)**. The target framework can be any of those compatible with .NET 8, but we recommend sticking with **.NET 8.0**.
+
+For more information about compatibility, see https://docs.microsoft.com/en-us/dotnet/standard/net-standard.
+
+When the project has been created, you should have `Class.cs` and `Project.csproj` files. Your `Project.csproj` should look something like this.
+
+```xml
+<Project Sdk="Microsoft.NET.Sdk">
+    <PropertyGroup>
+        <TargetFramework>net8.0</TargetFramework>
+    </PropertyGroup>
+</Project>
+```
+
+## 3. Add the Impostor.Api library
+
+You only have to follow the instructions of one below. 
+
+### Quick
+
+Install the `Impostor.Api` NuGet package.  
+Make sure to get a prerelease if you are writing a plugin for a dev release of the server.
+
+### Visual Studio
+
+1. Right click your project.
+2. Click `Manage NuGet Packages`.
+3. Click `Browse`.
+4. Search for `Impostor.Api`.
+5. Click the `Impostor.Api` result and press install on the right side.
+
+### Dotnet CLI
+
+1. Open your project folder in command prompt / bash.
+2. Run `dotnet add package Impostor.Api`.
+
+## 4. The plugin class
+
+Now the `Impostor.Api` is installed, you need to create a class for your plugin. A plugin **must** contain exactly one. See the code below for an example.
+
+```csharp
+using System.Threading.Tasks;
+using Impostor.Api.Events.Managers;
+using Impostor.Api.Plugins;
+using Microsoft.Extensions.Logging;
+
+namespace Impostor.Plugins.Example
+{
+    /// <summary>
+    ///     The metadata information of your plugin, this is required.
+    /// </summary>
+    [ImpostorPlugin(
+        package: "gg.impostor.example",
+        name: "Example",
+        author: "AeonLucid",
+        version: "1.0.0")]
+    public class ExamplePlugin : PluginBase // This is also required ": PluginBase".
+    {
+        /// <summary>
+        ///     A logger that works seamlessly with the server.
+        /// </summary>
+        private readonly ILogger<ExamplePlugin> _logger;
+
+        /// <summary>
+        ///     The constructor of the plugin. There are a few parameters you can add here and they
+        ///     will be injected automatically by the server, two examples are used here.
+        ///
+        ///     They are not necessary but very recommended.
+        /// </summary>
+        /// <param name="logger">
+        ///     A logger to write messages in the console.
+        /// </param>
+        /// <param name="eventManager">
+        ///     An event manager to register event listeners.
+        ///     Useful if you want your plugin to interact with the game.
+        /// </param>
+        public ExamplePlugin(ILogger<ExamplePlugin> logger, IEventManager eventManager)
+        {
+            _logger = logger;
+        }
+
+        /// <summary>
+        ///     This is called when your plugin is enabled by the server.
+        /// </summary>
+        /// <returns></returns>
+        public override ValueTask EnableAsync()
+        {
+            _logger.LogInformation("Example is being enabled.");
+            return default;
+        }
+
+        /// <summary>
+        ///     This is called when your plugin is disabled by the server.
+        ///     Most likely because it is shutting down, this is the place to clean up any managed resources.
+        /// </summary>
+        /// <returns></returns>
+        public override ValueTask DisableAsync()
+        {
+            _logger.LogInformation("Example is being disabled.");
+            return default;
+        }
+    }
+}
+```
+
+## 5. Adding an event listener
+
+Currently you should have a plugin that loads and does nothing. In order to get some actual functionality, you need to add an event listener.
+
+Create a new class called `GameEventListener`. Example code:
+
+```csharp
+using Impostor.Api.Events;
+using Impostor.Api.Events.Player;
+using Microsoft.Extensions.Logging;
+
+namespace Impostor.Plugins.Example.Handlers
+{
+    /// <summary>
+    ///     A class that listens for two events.
+    ///     It may be more but this is just an example.
+    ///
+    ///     Make sure your class implements <see cref="IEventListener"/>.
+    /// </summary>
+    public class GameEventListener : IEventListener
+    {
+        private readonly ILogger<ExamplePlugin> _logger;
+
+        public GameEventListener(ILogger<ExamplePlugin> logger)
+        {
+            _logger = logger;
+        }
+
+        /// <summary>
+        ///     An example event listener.
+        /// </summary>
+        /// <param name="e">
+        ///     The event you want to listen for.
+        /// </param>
+        [EventListener]
+        public void OnGameStarted(IGameStartedEvent e)
+        {
+            _logger.LogInformation($"Game is starting.");
+
+            // This prints out for all players if they are impostor or crewmate.
+            foreach (var player in e.Game.Players)
+            {
+                var info = player.Character.PlayerInfo;
+                var isImpostor = info.IsImpostor;
+                if (isImpostor)
+                {
+                    _logger.LogInformation($"- {info.PlayerName} is an impostor.");
+                }
+                else
+                {
+                    _logger.LogInformation($"- {info.PlayerName} is a crewmate.");
+                }
+            }
+        }
+
+        [EventListener]
+        public void OnGameEnded(IGameEndedEvent e)
+        {
+            _logger.LogInformation($"Game has ended.");
+        }
+
+        [EventListener]
+        public void OnPlayerChat(IPlayerChatEvent e)
+        {
+            _logger.LogInformation($"{e.PlayerControl.PlayerInfo.PlayerName} said {e.Message}");
+        }
+    }
+}
+```
+
+## 6. Registering the event listener
+
+The last step to get your plugin working is to register the event listener, so the server knows about it. Go back to your plugin class and modify it as below.
+
+```csharp
+using System;
+using System.Threading.Tasks;
+using Impostor.Api.Events.Managers;
+using Impostor.Api.Plugins;
+using Impostor.Plugins.Example.Handlers;
+using Microsoft.Extensions.Logging;
+
+namespace Impostor.Plugins.Example
+{
+    [ImpostorPlugin(
+        package: "gg.impostor.example",
+        name: "Example",
+        author: "AeonLucid",
+        version: "1.0.0")]
+    public class ExamplePlugin : PluginBase
+    {
+        private readonly ILogger<ExamplePlugin> _logger;
+        // Add the line below!
+        private readonly IEventManager _eventManager;
+        // Add the line below!
+        private IDisposable _unregister;
+
+        public ExamplePlugin(ILogger<ExamplePlugin> logger, IEventManager eventManager)
+        {
+            _logger = logger;
+            // Add the line below!
+            _eventManager = eventManager;
+        }
+
+        public override ValueTask EnableAsync()
+        {
+            _logger.LogInformation("Example is being enabled.");
+            // Add the line below!
+            _unregister = _eventManager.RegisterListener(new GameEventListener(_logger));
+            return default;
+        }
+
+        public override ValueTask DisableAsync()
+        {
+            _logger.LogInformation("Example is being disabled.");
+            // Add the line below!
+            _unregister.Dispose();
+            return default;
+        }
+    }
+}
+
+```
+
+## 7. Build and run your plugin
+
+Now your plugin is ready to be tested.
+
+1. Right click your project and press `Build`.
+2. Right click your project and press `Open Folder in File Explorer`.
+3. Go to `bin/Debug/net8.0/`.
+4. In this directory, you should find your plugin named `Project.dll`.
+5. Copy the `Project.dll` to the `plugins` directory in your Impostor server directory.
+6. (Re)start your Impostor server.
+7. Open Among Us, create a game and send a chat message. In the console you should see your plugin being loaded and the messages from the example.
+
+## 8. Extra
+
+Some extra information that might be useful for those developing plugins.
+
+### Event listeners
+
+- You can have multiple event listener on the same event.
+- An event listener can be given a priority `[EventListener(EventPriority.Normal)]` and is called in order.
+- It is not recommended to block for a long time inside `EventListener` because the events are called from inside the packet handlers. Blocking too long causes the client to time out. You should create a new `Task` for operations that will take a lot of time. 
+
+### Dependency injection
+
+- The main plugin class is constructed by the `IServiceProvider` of the server and can inject everything the server uses. A few examples are:
+  - `ILogger<T>`
+  - `IEventManager`
+  - `IClientManager`
+  - `IOptions<ServerConfig>`
+- You can add your own classes and `EventListener` implementation to the `IServiceProvider` by creating a new class and implementing `IPluginStartup`. Make sure to register them as a singleton `services.AddSingleton<IEventListener, GameEventListener>();`.
+
+### Server configuration
+
+Constantly copying the plugin dll to your server directory can be pretty annoying. Luckily we have a solution for that. In your Impostor server open the `config.json` and add the `PluginLoader` from the example below, replace the path with the build destination of your plugin.
+
+```json
+{
+  "Server": {
+    "PublicIp": "127.0.0.1",
+    "PublicPort": 22023,
+    "ListenIp": "0.0.0.0",
+    "ListenPort": 22023
+  },
+  "PluginLoader": {
+    "Paths": [
+      "D:\\Projects\\Impostor\\src\\Impostor.Plugins.Example\\bin\\Debug\\net8.0"
+    ],
+    "LibraryPaths": []
+  }
+}
+```
+
+### Using other libraries
+
+Sometimes you need to use libraries that the original Impostor server does not provide. The dll files of these libraries must be placed in the `libraries` folder next to the server executable. You could also provide them by modifying the `PluginLoader.LibraryPaths` option in the `config.json`, similarly to the `PluginLoader.Paths` option.
+
+### Impostor versions
+
+It is important to use the correct versions when working with `Impostor.Api` prereleases and the `Impostor` dev builds to reduce the chances of mismatching assemblies. 
+
+**Example** 
+
+The prerelease `Impostor.Api` package `1.2.0-ci.54` belongs to build `54` on AppVeyor, which can be found here https://ci.appveyor.com/project/Impostor/Impostor/build/54. Notice the `54` on the end of the url.
+
+## 9. Missing/invalid data or want more functions?
+
+The `Impostor.Api` is currently in beta. There are a lot of things still missing and we would like to hear from you what you need to develop a plugin.
+
+Create an issue:
+
+- [Suggest a function](https://github.com/Impostor/Impostor/issues/new?template=3--api-suggestion.md)
+- [Data is invalid](https://github.com/Impostor/Impostor/issues/new?template=4--api-invalid.md)
+- [Data is unavailable](https://github.com/Impostor/Impostor/issues/new?template=5--api-missing.md)
+- [Other](https://github.com/Impostor/Impostor/issues/new?template=6--api-other.md)

src/.editorconfig

@@ -0,0 +1,239 @@
+# top-most EditorConfig file
+root = true
+
+# Don't use tabs for indentation.
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+indent_style = space
+
+# Code files
+[*.{cs,csx,vb,vbx}]
+indent_size = 4
+insert_final_newline = true
+
+# XML project files
+[*.{csproj,vbproj,vcxproj,vcxproj.filters,proj,projitems,shproj}]
+indent_size = 2
+
+# XML config files
+[*.{props,targets,ruleset,config,nuspec,resx,vsixmanifest,vsct}]
+indent_size = 2
+
+# JSON files
+[*.json]
+indent_size = 2
+
+# Dotnet code style settings:
+[*.{cs,vb}]
+
+# Sort using and Import directives with System.* appearing first
+dotnet_sort_system_directives_first = true
+dotnet_separate_import_directive_groups = false
+# Avoid "this." and "Me." if not necessary
+dotnet_style_qualification_for_field = false:refactoring
+dotnet_style_qualification_for_property = false:refactoring
+dotnet_style_qualification_for_method = false:refactoring
+dotnet_style_qualification_for_event = false:refactoring
+
+# Use language keywords instead of framework type names for type references
+dotnet_style_predefined_type_for_locals_parameters_members = true:suggestion
+dotnet_style_predefined_type_for_member_access = true:suggestion
+
+# Suggest more modern language features when available
+dotnet_style_object_initializer = true:suggestion
+dotnet_style_collection_initializer = true:suggestion
+dotnet_style_coalesce_expression = true:suggestion
+dotnet_style_null_propagation = true:suggestion
+dotnet_style_explicit_tuple_names = true:suggestion
+
+# Non-private static fields are PascalCase
+dotnet_naming_rule.non_private_static_fields_should_be_pascal_case.severity = suggestion
+dotnet_naming_rule.non_private_static_fields_should_be_pascal_case.symbols = non_private_static_fields
+dotnet_naming_rule.non_private_static_fields_should_be_pascal_case.style = non_private_static_field_style
+
+dotnet_naming_symbols.non_private_static_fields.applicable_kinds = field
+dotnet_naming_symbols.non_private_static_fields.applicable_accessibilities = public, protected, internal, protected_internal, private_protected
+dotnet_naming_symbols.non_private_static_fields.required_modifiers = static
+
+dotnet_naming_style.non_private_static_field_style.capitalization = pascal_case
+
+# Non-private readonly fields are PascalCase
+dotnet_naming_rule.non_private_readonly_fields_should_be_pascal_case.severity = suggestion
+dotnet_naming_rule.non_private_readonly_fields_should_be_pascal_case.symbols = non_private_readonly_fields
+dotnet_naming_rule.non_private_readonly_fields_should_be_pascal_case.style = non_private_readonly_field_style
+
+dotnet_naming_symbols.non_private_readonly_fields.applicable_kinds = field
+dotnet_naming_symbols.non_private_readonly_fields.applicable_accessibilities = public, protected, internal, protected_internal, private_protected
+dotnet_naming_symbols.non_private_readonly_fields.required_modifiers = readonly
+
+dotnet_naming_style.non_private_readonly_field_style.capitalization = pascal_case
+
+# Constants are PascalCase
+dotnet_naming_rule.constants_should_be_pascal_case.severity = suggestion
+dotnet_naming_rule.constants_should_be_pascal_case.symbols = constants
+dotnet_naming_rule.constants_should_be_pascal_case.style = constant_style
+
+dotnet_naming_symbols.constants.applicable_kinds = field, local
+dotnet_naming_symbols.constants.required_modifiers = const
+
+dotnet_naming_style.constant_style.capitalization = pascal_case
+
+# Static readonly fields are PascalCase
+dotnet_naming_rule.static_fields_should_be_camel_case.severity = suggestion
+dotnet_naming_rule.static_fields_should_be_camel_case.symbols = static_fields
+dotnet_naming_rule.static_fields_should_be_camel_case.style = static_field_style
+
+dotnet_naming_symbols.static_fields.applicable_kinds = field
+dotnet_naming_symbols.static_fields.required_modifiers = static, readonly
+
+dotnet_naming_style.static_field_style.capitalization = pascal_case
+
+# Instance fields are camelCase and start with _
+dotnet_naming_rule.instance_fields_should_be_camel_case.severity = suggestion
+dotnet_naming_rule.instance_fields_should_be_camel_case.symbols = instance_fields
+dotnet_naming_rule.instance_fields_should_be_camel_case.style = instance_field_style
+
+dotnet_naming_symbols.instance_fields.applicable_kinds = field
+
+dotnet_naming_style.instance_field_style.capitalization = camel_case
+dotnet_naming_style.instance_field_style.required_prefix = _
+
+# Locals and parameters are camelCase
+dotnet_naming_rule.locals_should_be_camel_case.severity = suggestion
+dotnet_naming_rule.locals_should_be_camel_case.symbols = locals_and_parameters
+dotnet_naming_rule.locals_should_be_camel_case.style = camel_case_style
+
+dotnet_naming_symbols.locals_and_parameters.applicable_kinds = parameter, local
+
+dotnet_naming_style.camel_case_style.capitalization = camel_case
+
+# Local functions are PascalCase
+dotnet_naming_rule.local_functions_should_be_pascal_case.severity = suggestion
+dotnet_naming_rule.local_functions_should_be_pascal_case.symbols = local_functions
+dotnet_naming_rule.local_functions_should_be_pascal_case.style = local_function_style
+
+dotnet_naming_symbols.local_functions.applicable_kinds = local_function
+
+dotnet_naming_style.local_function_style.capitalization = pascal_case
+
+# By default, name items with PascalCase
+dotnet_naming_rule.members_should_be_pascal_case.severity = suggestion
+dotnet_naming_rule.members_should_be_pascal_case.symbols = all_members
+dotnet_naming_rule.members_should_be_pascal_case.style = pascal_case_style
+
+dotnet_naming_symbols.all_members.applicable_kinds = *
+
+dotnet_naming_style.pascal_case_style.capitalization = pascal_case
+
+# Async methods should have "Async" suffix
+dotnet_naming_rule.async_methods_end_in_async.symbols = any_async_methods
+dotnet_naming_rule.async_methods_end_in_async.style = end_in_async
+dotnet_naming_rule.async_methods_end_in_async.severity = warning
+
+dotnet_naming_symbols.any_async_methods.applicable_kinds = method
+dotnet_naming_symbols.any_async_methods.applicable_accessibilities = *
+dotnet_naming_symbols.any_async_methods.required_modifiers = async
+
+dotnet_naming_style.end_in_async.required_prefix = 
+dotnet_naming_style.end_in_async.required_suffix = Async
+dotnet_naming_style.end_in_async.capitalization = pascal_case
+dotnet_naming_style.end_in_async.word_separator = 
+
+# error RS2008: Enable analyzer release tracking for the analyzer project containing rule '{0}'
+dotnet_diagnostic.RS2008.severity = none
+
+# IDE0005: Remove unnecessary import
+dotnet_diagnostic.IDE0005.severity = warning
+
+# IDE0007: Use `var` instead of explicit type
+dotnet_diagnostic.IDE0007.severity = warning
+
+# IDE0035: Remove unreachable code
+dotnet_diagnostic.IDE0035.severity = warning
+
+# IDE0036: Order modifiers
+dotnet_diagnostic.IDE0036.severity = warning
+
+# IDE0043: Format string contains invalid placeholder
+dotnet_diagnostic.IDE0043.severity = warning
+
+# IDE0044: Make field readonly
+dotnet_diagnostic.IDE0044.severity = warning
+
+# CSharp code style settings:
+[*.cs]
+# Newline settings
+csharp_new_line_before_open_brace = all
+csharp_new_line_before_else = true
+csharp_new_line_before_catch = true
+csharp_new_line_before_finally = true
+# csharp_new_line_before_members_in_object_initializers = true TODO seems like Rider/ReSharper has the value inverted, uncomment when its fixed
+csharp_new_line_before_members_in_anonymous_types = true
+csharp_new_line_between_query_expression_clauses = true
+
+# Indentation preferences
+csharp_indent_block_contents = true
+csharp_indent_braces = false
+csharp_indent_case_contents = true
+csharp_indent_case_contents_when_block = false
+csharp_indent_switch_labels = true
+csharp_indent_labels = flush_left
+
+# Prefer "var" everywhere
+csharp_style_var_for_built_in_types = true:suggestion
+csharp_style_var_when_type_is_apparent = true:suggestion
+csharp_style_var_elsewhere = true:suggestion
+
+# Prefer method-like constructs to have a block body
+csharp_style_expression_bodied_methods = false:none
+csharp_style_expression_bodied_constructors = false:none
+csharp_style_expression_bodied_operators = false:none
+
+# Prefer property-like constructs to have an expression-body
+csharp_style_expression_bodied_properties = true:none
+csharp_style_expression_bodied_indexers = true:none
+csharp_style_expression_bodied_accessors = true:none
+
+# Suggest more modern language features when available
+csharp_style_pattern_matching_over_is_with_cast_check = true:suggestion
+csharp_style_pattern_matching_over_as_with_null_check = true:suggestion
+csharp_style_inlined_variable_declaration = true:suggestion
+csharp_style_throw_expression = true:suggestion
+csharp_style_conditional_delegate_call = true:suggestion
+
+# Space preferences
+csharp_space_after_cast = false
+csharp_space_after_colon_in_inheritance_clause = true
+csharp_space_after_comma = true
+csharp_space_after_dot = false
+csharp_space_after_keywords_in_control_flow_statements = true
+csharp_space_after_semicolon_in_for_statement = true
+csharp_space_around_binary_operators = before_and_after
+csharp_space_around_declaration_statements = do_not_ignore
+csharp_space_before_colon_in_inheritance_clause = true
+csharp_space_before_comma = false
+csharp_space_before_dot = false
+csharp_space_before_open_square_brackets = false
+csharp_space_before_semicolon_in_for_statement = false
+csharp_space_between_empty_square_brackets = false
+csharp_space_between_method_call_empty_parameter_list_parentheses = false
+csharp_space_between_method_call_name_and_opening_parenthesis = false
+csharp_space_between_method_call_parameter_list_parentheses = false
+csharp_space_between_method_declaration_empty_parameter_list_parentheses = false
+csharp_space_between_method_declaration_name_and_open_parenthesis = false
+csharp_space_between_method_declaration_parameter_list_parentheses = false
+csharp_space_between_parentheses = false
+csharp_space_between_square_brackets = false
+
+# Blocks are allowed
+csharp_prefer_braces = true:silent
+csharp_preserve_single_line_blocks = true
+csharp_preserve_single_line_statements = true
+
+# warning RS0037: PublicAPI.txt is missing '#nullable enable'
+dotnet_diagnostic.RS0037.severity = none
+
+# ReSharper properties
+resharper_trailing_comma_in_multiline_lists = true

src/.gitignore

@@ -26,21 +26,6 @@ bld/
 
 # Visual Studio 2015 cache/options directory
 .vs/
-# Uncomment if you have tasks that create the project's static files in wwwroot
-#wwwroot/
-
-# MSTest test Results
-[Tt]est[Rr]esult*/
-[Bb]uild[Ll]og.*
-
-# NUNIT
-*.VisualState.xml
-TestResult.xml
-
-# Build Results of an ATL Project
-[Dd]ebugPS/
-[Rr]eleasePS/
-dlldata.c
 
 # DNX
 project.lock.json
@@ -72,32 +57,12 @@ artifacts/
 *.svclog
 *.scc
 
-# Chutzpah Test files
-_Chutzpah*
-
-# Visual C++ cache files
-ipch/
-*.aps
-*.ncb
-*.opendb
-*.opensdf
-*.sdf
-*.cachefile
-*.VC.db
-*.VC.VC.opendb
-
 # Visual Studio profiler
 *.psess
 *.vsp
 *.vspx
 *.sap
 
-# TFS 2012 Local Workspace
-$tf/
-
-# Guidance Automation Toolkit
-*.gpState
-
 # ReSharper is a .NET coding add-in
 _ReSharper*/
 *.[Rr]e[Ss]harper
@@ -112,72 +77,11 @@ _TeamCity*
 # DotCover is a Code Coverage Tool
 *.dotCover
 
-# NCrunch
-_NCrunch_*
-.*crunch*.local.xml
-nCrunchTemp_*
-
-# MightyMoose
-*.mm.*
-AutoTest.Net/
-
-# Web workbench (sass)
-.sass-cache/
-
-# Installshield output folder
-[Ee]xpress/
-
-# DocProject is a documentation generator add-in
-DocProject/buildhelp/
-DocProject/Help/*.HxT
-DocProject/Help/*.HxC
-DocProject/Help/*.hhc
-DocProject/Help/*.hhk
-DocProject/Help/*.hhp
-DocProject/Help/Html2
-DocProject/Help/html
-
 # Click-Once directory
 publish/
 
-# Publish Web Output
-*.[Pp]ublish.xml
-*.azurePubxml
-# TODO: Comment the next line if you want to checkin your web deploy settings
-# but database connection strings (with potential passwords) will be unencrypted
-#*.pubxml
-*.publishproj
-
-# Microsoft Azure Web App publish settings. Comment the next line if you want to
-# checkin your Azure Web App publish settings, but sensitive information contained
-# in these scripts will be unencrypted
-PublishScripts/
-
 # NuGet Packages
 *.nupkg
-# The packages folder can be ignored because of Package Restore
-**/packages/*
-# except build/, which is used as an MSBuild target.
-!**/packages/build/
-# Uncomment if necessary however generally it will be regenerated when needed
-#!**/packages/repositories.config
-# NuGet v3's project.json files produces more ignoreable files
-*.nuget.props
-*.nuget.targets
-
-# Microsoft Azure Build Output
-csx/
-*.build.csdef
-
-# Microsoft Azure Emulator
-ecf/
-rcf/
-
-# Windows Store app package directories and files
-AppPackages/
-BundleArtifacts/
-Package.StoreAssociation.xml
-_pkginfo.txt
 
 # Visual Studio cache files
 # files ending in .cache can be ignored
@@ -197,13 +101,6 @@ ClientBin/
 node_modules/
 orleans.codegen.cs
 
-# Since there are multiple workflows, uncomment next line to ignore bower_components
-# (https://github.com/github/gitignore/pull/1529#issuecomment-104372622)
-#bower_components/
-
-# RIA/Silverlight projects
-Generated_Code/
-
 # Backup & report files from converting an old project file
 # to a newer Visual Studio version. Backup files are not needed,
 # because we have git ;-)
@@ -212,52 +109,6 @@ Backup*/
 UpgradeLog*.XML
 UpgradeLog*.htm
 
-# SQL Server files
-*.mdf
-*.ldf
-
-# Business Intelligence projects
-*.rdl.data
-*.bim.layout
-*.bim_*.settings
-
-# Microsoft Fakes
-FakesAssemblies/
-
-# GhostDoc plugin setting file
-*.GhostDoc.xml
-
-# Node.js Tools for Visual Studio
-.ntvs_analysis.dat
-
-# Visual Studio 6 build log
-*.plg
-
-# Visual Studio 6 workspace options file
-*.opt
-
-# Visual Studio LightSwitch build output
-**/*.HTMLClient/GeneratedArtifacts
-**/*.DesktopClient/GeneratedArtifacts
-**/*.DesktopClient/ModelManifest.xml
-**/*.Server/GeneratedArtifacts
-**/*.Server/ModelManifest.xml
-_Pvt_Extensions
-
-# Paket dependency manager
-.paket/paket.exe
-paket-files/
-
-# FAKE - F# Make
-.fake/
-
 # JetBrains Rider
 .idea/
 *.sln.iml
-
-# CodeRush
-.cr/
-
-# Python Tools for Visual Studio (PTVS)
-__pycache__/
-*.pyc

src/Directory.Build.props

@@ -0,0 +1,15 @@
+<Project>
+  <PropertyGroup>
+    <TargetFramework>net8.0</TargetFramework>
+    <LangVersion>11</LangVersion>
+    <VersionPrefix>1.10.9</VersionPrefix>
+    <VersionSuffix>dev</VersionSuffix>
+    <EnforceCodeStyleInBuild Condition="$(MSBuildProjectName)!='Hazel'">true</EnforceCodeStyleInBuild>
+    <RestorePackagesWithLockFile>true</RestorePackagesWithLockFile>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <AdditionalFiles Include="$(MSBuildThisFileDirectory)stylecop.json" />
+  </ItemGroup>
+</Project>
+  

src/Impostor.Api.Innersloth.Generator/Extensions.cs

@@ -0,0 +1,30 @@
+using System.Diagnostics.CodeAnalysis;
+using System.Globalization;
+using System.Numerics;
+
+namespace Impostor.Api.Innersloth.Generator;
+
+internal static class Extensions
+{
+    public static string NormalizePath(this string path)
+    {
+        return path.Replace("\\", "/");
+    }
+
+    public static bool TryTrimStart(this string text, string value, [NotNullWhen(true)] out string? result)
+    {
+        if (text.StartsWith(value))
+        {
+            result = text[value.Length..];
+            return true;
+        }
+
+        result = null;
+        return false;
+    }
+
+    public static string ToCSharpString(this Vector2 value)
+    {
+        return $"new Vector2({value.X.ToString(CultureInfo.InvariantCulture)}f, {value.Y.ToString(CultureInfo.InvariantCulture)}f)";
+    }
+}

src/Impostor.Api.Innersloth.Generator/Generators/BaseGenerator.cs

@@ -0,0 +1,22 @@
+using System.Collections.Immutable;
+using System.Linq;
+using Microsoft.CodeAnalysis;
+
+namespace Impostor.Api.Innersloth.Generator.Generators;
+
+public abstract class BaseGenerator
+{
+    protected SourceProductionContext _sourceProductionContext;
+    protected ImmutableArray<(string RelativePath, string Content)> _files;
+
+    protected BaseGenerator(SourceProductionContext sourceProductionContext, ImmutableArray<(string RelativePath, string Content)> files)
+    {
+        _sourceProductionContext = sourceProductionContext;
+        _files = files;
+    }
+
+    protected string GetFileContent(string path)
+    {
+        return _files.Single(x => x.RelativePath == path).Content;
+    }
+}

src/Impostor.Api.Innersloth.Generator/Generators/EnumGenerator.cs

@@ -0,0 +1,39 @@
+using System;
+using System.Collections.Generic;
+using System.Collections.Immutable;
+using System.Text.Json;
+using CSharpPoet;
+using Microsoft.CodeAnalysis;
+
+namespace Impostor.Api.Innersloth.Generator.Generators;
+
+public sealed class EnumGenerator : BaseGenerator
+{
+    public EnumGenerator(SourceProductionContext sourceProductionContext, ImmutableArray<(string RelativePath, string Content)> files) : base(sourceProductionContext, files)
+    {
+    }
+
+    public void Generate(string name, string? @namespace = null, string? sourceName = null, bool flags = false, CSharpEnumUnderlyingType underlyingType = CSharpEnumUnderlyingType.Int)
+    {
+        var dictionary = JsonSerializer.Deserialize<Dictionary<string, long>>(GetFileContent($"enums/{sourceName ?? name}.json"))!;
+
+        var @enum = new CSharpEnum(name, underlyingType);
+
+        foreach (var pair in dictionary)
+        {
+            var value = flags && pair.Value > 0
+                ? $"1 << {Math.Log(pair.Value, 2)}"
+                : pair.Value.ToString();
+
+            @enum.Members.Add(new CSharpEnum.Member(pair.Key, value));
+        }
+
+        if (flags)
+        {
+            @enum.Attributes.Add(new CSharpAttribute("System.FlagsAttribute"));
+        }
+
+        var source = new CSharpFile(@namespace ?? "Impostor.Api.Innersloth") { @enum }.ToString();
+        _sourceProductionContext.AddSource(name, source);
+    }
+}

src/Impostor.Api.Innersloth.Generator/Generators/MapDataGenerator.cs

@@ -0,0 +1,210 @@
+using System;
+using System.Collections.Generic;
+using System.Collections.Immutable;
+using System.Globalization;
+using System.Numerics;
+using System.Text.Json;
+using CSharpPoet;
+using Microsoft.CodeAnalysis;
+
+namespace Impostor.Api.Innersloth.Generator.Generators;
+
+public sealed class MapDataGenerator : BaseGenerator
+{
+    public MapDataGenerator(SourceProductionContext sourceProductionContext, ImmutableArray<(string RelativePath, string Content)> files) : base(sourceProductionContext, files)
+    {
+    }
+
+    private T? Deserialize<T>(string name, string fileName)
+    {
+        return JsonSerializer.Deserialize<T>(
+            GetFileContent($"maps/{name}/{fileName}.json"),
+            new JsonSerializerOptions
+            {
+                PropertyNamingPolicy = JsonNamingPolicy.CamelCase,
+                Converters =
+                {
+                    new Vector2Converter(),
+                },
+            }
+        );
+    }
+
+    public void Generate(string name)
+    {
+        var className = name + "Data";
+
+        var spawnInfo = Deserialize<SpawnInfo>(name, "spawn")!;
+        var tasks = Deserialize<Dictionary<int, TaskInfo>>(name, "tasks")!;
+        var vents = Deserialize<Dictionary<int, VentInfo>>(name, "vents")!;
+        var doors = Deserialize<Dictionary<int, DoorInfo>>(name, "doors")!;
+
+        var ventsData = new DictionaryData("VentData", "Vents", writer =>
+        {
+            foreach (var pair in vents)
+            {
+                var id = pair.Key;
+                var vent = pair.Value;
+
+                var connections = "";
+                if (vent.Left != null) connections += ", left: " + vent.Left.Value;
+                if (vent.Center != null) connections += ", center: " + vent.Center.Value;
+                if (vent.Right != null) connections += ", right: " + vent.Right.Value;
+
+                writer.WriteLine($"[{id}] = new(this, {id}, \"{vent.Name}\", {vent.Position.ToCSharpString()}{connections}),");
+            }
+        });
+
+        var tasksData = new DictionaryData("TaskData", "Tasks", writer =>
+        {
+            foreach (var pair in tasks)
+            {
+                var id = pair.Key;
+                var task = pair.Value;
+
+                writer.WriteLine($"[{id}] = new({id}, TaskTypes.{task.TaskType}, TaskCategories.{task.Length}Task),");
+            }
+        });
+
+        var doorsData = new DictionaryData("DoorData", "Doors", writer =>
+        {
+            foreach (var pair in doors)
+            {
+                var id = pair.Key;
+                var door = pair.Value;
+
+                writer.WriteLine($"[{id}] = new({id}, SystemTypes.{door.Room}, {door.Position.ToCSharpString()}),");
+            }
+        });
+
+        var constructor = new CSharpMethod(Visibility.Internal, className, ".ctor")
+        {
+            Body = writer =>
+            {
+                ventsData.WriteInitializer(writer);
+                writer.WriteLine();
+                tasksData.WriteInitializer(writer);
+                writer.WriteLine();
+                doorsData.WriteInitializer(writer);
+            },
+        };
+
+        var @class = new CSharpClass(className)
+        {
+            IsSealed = true,
+            Extends = { "MapData" },
+            Members =
+            {
+                constructor,
+
+                ventsData.CreateProperty(),
+                tasksData.CreateProperty(),
+                doorsData.CreateProperty(),
+
+                new CSharpBlankLine(),
+
+                CreateSimpleProperty("float", "SpawnRadius", spawnInfo.SpawnRadius.ToString(CultureInfo.InvariantCulture) + "f"),
+                CreateSimpleProperty("Vector2", "InitialSpawnCenter", spawnInfo.InitialSpawnCenter.ToCSharpString()),
+                CreateSimpleProperty("Vector2", "MeetingSpawnCenter", spawnInfo.MeetingSpawnCenter.ToCSharpString()),
+                CreateSimpleProperty("Vector2", "MeetingSpawnCenter2", spawnInfo.MeetingSpawnCenter2.ToCSharpString()),
+            },
+        };
+
+        var source = new CSharpFile("Impostor.Api.Innersloth.Maps")
+        {
+            Usings = { "System.Collections.Generic", "System.Numerics" },
+            Members = { @class },
+        }.ToString();
+        _sourceProductionContext.AddSource(className, source);
+    }
+
+    private static CSharpProperty CreateSimpleProperty(string type, string name, string value)
+    {
+        return new CSharpProperty(type, name)
+        {
+            Getter = new CSharpProperty.Accessor { Body = writer => writer.Write(value + ";") },
+            IsOverride = true,
+        };
+    }
+
+    private sealed class DictionaryData
+    {
+        private readonly string _keyType;
+        private readonly string _valueType;
+        private readonly string _name;
+        private readonly Action<CodeWriter> _body;
+
+        public DictionaryData(string keyType, string valueType, string name, Action<CodeWriter> body)
+        {
+            _keyType = keyType;
+            _valueType = valueType;
+            _name = name;
+            _body = body;
+        }
+
+        public DictionaryData(string valueType, string name, Action<CodeWriter> body) : this("int", valueType, name, body)
+        {
+        }
+
+        public void WriteInitializer(CodeWriter writer)
+        {
+            writer.WriteLine($"{_name} = new Dictionary<{_keyType}, {_valueType}>");
+            writer.WriteLine("{");
+
+            using (writer.Indent())
+            {
+                _body(writer);
+            }
+
+            writer.WriteLine("}.AsReadOnly();");
+        }
+
+        public CSharpProperty CreateProperty()
+        {
+            return new CSharpProperty($"IReadOnlyDictionary<{_keyType}, {_valueType}>", _name)
+            {
+                Getter = new CSharpProperty.Accessor(),
+                IsOverride = true,
+            };
+        }
+    }
+
+    public sealed class SpawnInfo
+    {
+        public required Vector2 InitialSpawnCenter { get; init; }
+        public required Vector2 MeetingSpawnCenter { get; init; }
+        public required Vector2 MeetingSpawnCenter2 { get; init; }
+        public required float SpawnRadius { get; init; }
+    }
+
+    public sealed class TaskInfo
+    {
+        public required string Type { get; init; }
+        public required string TaskType { get; init; }
+        public required string Length { get; init; }
+        public required TaskConsole[] Consoles { get; init; }
+    }
+
+    public sealed class TaskConsole
+    {
+        public required int Id { get; init; }
+        public required string Room { get; init; }
+        public required Vector2 Position { get; init; }
+        public required float UsableDistance { get; init; }
+    }
+
+    public sealed class VentInfo
+    {
+        public required string Name { get; init; }
+        public required Vector2 Position { get; init; }
+        public required int? Left { get; init; }
+        public required int? Center { get; init; }
+        public required int? Right { get; init; }
+    }
+
+    public sealed class DoorInfo
+    {
+        public required string Room { get; init; }
+        public required Vector2 Position { get; init; }
+    }
+}

src/Impostor.Api.Innersloth.Generator/Impostor.Api.Innersloth.Generator.csproj

@@ -0,0 +1,38 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <TargetFramework>netstandard2.0</TargetFramework>
+    <LangVersion>latest</LangVersion>
+    <DebugType>embedded</DebugType>
+    <Nullable>enable</Nullable>
+    <EnforceExtendedAnalyzerRules>true</EnforceExtendedAnalyzerRules>
+    <IsRoslynComponent>true</IsRoslynComponent>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Microsoft.CodeAnalysis.CSharp" Version="4.7.0" PrivateAssets="all" />
+    <PackageReference Include="Microsoft.CodeAnalysis.Analyzers" Version="3.3.4" PrivateAssets="all" />
+    <PackageReference Include="PolySharp" Version="1.14.1" PrivateAssets="all" />
+
+    <PackageReference Include="System.Text.Json" Version="8.0.5" PrivateAssets="all" GeneratePathProperty="true" />
+    <PackageReference Include="System.Text.Encodings.Web" Version="8.0.0" PrivateAssets="all" GeneratePathProperty="true" />
+    <PackageReference Include="Microsoft.Bcl.AsyncInterfaces" Version="8.0.0" PrivateAssets="all" GeneratePathProperty="true" />
+
+    <PackageReference Include="CSharpPoet" Version="0.3.0" PrivateAssets="all" GeneratePathProperty="true" />
+  </ItemGroup>
+
+  <PropertyGroup>
+    <GetTargetPathDependsOn>$(GetTargetPathDependsOn);GetDependencyTargetPaths</GetTargetPathDependsOn>
+  </PropertyGroup>
+
+  <Target Name="GetDependencyTargetPaths">
+    <ItemGroup>
+      <TargetPathWithTargetPlatformMoniker Include="$(PkgSystem_Text_Json)\lib\netstandard2.0\*.dll" IncludeRuntimeDependency="false" />
+      <TargetPathWithTargetPlatformMoniker Include="$(PkgSystem_Text_Encodings_Web)\lib\netstandard2.0\*.dll" IncludeRuntimeDependency="false" />
+      <TargetPathWithTargetPlatformMoniker Include="$(PKGMicrosoft_Bcl_AsyncInterfaces)\lib\netstandard2.0\*.dll" IncludeRuntimeDependency="false" />
+
+      <TargetPathWithTargetPlatformMoniker Include="$(PkgCSharpPoet)\lib\netstandard2.0\*.dll" IncludeRuntimeDependency="false" />
+    </ItemGroup>
+  </Target>
+
+</Project>

src/Impostor.Api.Innersloth.Generator/Properties/launchSettings.json

@@ -0,0 +1,9 @@
+{
+  "$schema": "https://json.schemastore.org/launchsettings.json",
+  "profiles": {
+    "Generator": {
+      "commandName": "DebugRoslynComponent",
+      "targetProject": "../Impostor.Api/Impostor.Api.csproj"
+    }
+  }
+}

src/Impostor.Api.Innersloth.Generator/SourceGenerator.cs

@@ -0,0 +1,108 @@
+using System;
+using System.Diagnostics.CodeAnalysis;
+using CSharpPoet;
+using Impostor.Api.Innersloth.Generator.Generators;
+using Microsoft.CodeAnalysis;
+
+namespace Impostor.Api.Innersloth.Generator;
+
+[Generator(LanguageNames.CSharp)]
+public sealed class SourceGenerator : IIncrementalGenerator
+{
+    private const string DataPath = "Innersloth/Data/";
+
+    private readonly record struct Options(string ProjectDirectory)
+    {
+        public bool TryGetRelativePath(string path, [NotNullWhen(true)] out string? relativePath)
+        {
+            if (
+                path.NormalizePath().TryTrimStart(ProjectDirectory, out relativePath) &&
+                relativePath.TryTrimStart(DataPath, out relativePath)
+            )
+            {
+                return true;
+            }
+
+            relativePath = null;
+            return false;
+        }
+    }
+
+    public void Initialize(IncrementalGeneratorInitializationContext context)
+    {
+        var optionsProvider = context.AnalyzerConfigOptionsProvider
+            .Select((analyzerConfigOptions, _) =>
+            {
+                if (!analyzerConfigOptions.GlobalOptions.TryGetValue("build_property.projectdir", out var projectDirectory))
+                {
+                    throw new Exception("Couldn't get project directory");
+                }
+
+                return new Options(projectDirectory.NormalizePath());
+            });
+
+        var filesProvider = context.AdditionalTextsProvider.Combine(optionsProvider)
+            .Where(static pair =>
+            {
+                var (file, options) = pair;
+                return options.TryGetRelativePath(file.Path, out var relativePath) && relativePath.EndsWith(".json");
+            })
+            .Select(static (pair, cancellationToken) =>
+            {
+                var (file, options) = pair;
+
+                if (!options.TryGetRelativePath(file.Path, out var relativePath))
+                {
+                    throw new InvalidOperationException();
+                }
+
+                return (
+                    RelativePath: relativePath,
+                    Content: file.GetText(cancellationToken)!.ToString()
+                );
+            })
+            .Collect();
+
+        context.RegisterSourceOutput(filesProvider, (spc, files) =>
+        {
+            if (files.IsEmpty)
+            {
+                throw new InvalidOperationException($"No json files found in Impostor.Api/{DataPath}");
+            }
+
+            var enumGenerator = new EnumGenerator(spc, files);
+
+            enumGenerator.Generate("ColorType", "Impostor.Api.Innersloth.Customization");
+
+            enumGenerator.Generate("DisconnectReason", sourceName: "DisconnectReasons");
+            enumGenerator.Generate("GameKeywords", flags: true, underlyingType: CSharpEnumUnderlyingType.UnsignedInt);
+            enumGenerator.Generate("GameOverReason", underlyingType: CSharpEnumUnderlyingType.Byte);
+            enumGenerator.Generate("Platforms");
+            enumGenerator.Generate("RoleTypes", underlyingType: CSharpEnumUnderlyingType.UnsignedShort);
+            enumGenerator.Generate("RulesPresets", underlyingType: CSharpEnumUnderlyingType.Byte);
+            enumGenerator.Generate("SpecialGameModes", underlyingType: CSharpEnumUnderlyingType.Byte);
+            enumGenerator.Generate("StringNames");
+            enumGenerator.Generate("SystemTypes", underlyingType: CSharpEnumUnderlyingType.Byte);
+            enumGenerator.Generate("Language", sourceName: "SupportedLangs");
+            enumGenerator.Generate("TaskTypes");
+            enumGenerator.Generate("BoolOptionNames", "Impostor.Api.Innersloth.GameFilters");
+            enumGenerator.Generate("ByteOptionNames", "Impostor.Api.Innersloth.GameFilters");
+            enumGenerator.Generate("CategorizedOptionNames", "Impostor.Api.Innersloth.GameFilters");
+            enumGenerator.Generate("FloatArrayOptionNames", "Impostor.Api.Innersloth.GameFilters");
+            enumGenerator.Generate("FloatOptionNames", "Impostor.Api.Innersloth.GameFilters");
+            enumGenerator.Generate("Int32ArrayOptionNames", "Impostor.Api.Innersloth.GameFilters");
+            enumGenerator.Generate("Int32OptionNames", "Impostor.Api.Innersloth.GameFilters");
+            enumGenerator.Generate("UInt32OptionNames", "Impostor.Api.Innersloth.GameFilters");
+
+            enumGenerator.Generate("RpcCalls", "Impostor.Api.Net.Inner", underlyingType: CSharpEnumUnderlyingType.Byte);
+
+            var mapDataGenerator = new MapDataGenerator(spc, files);
+
+            var mapNames = new[] { "Skeld", "Mira", "April", "Polus", "Airship", "Fungle" };
+            foreach (var mapName in mapNames)
+            {
+                mapDataGenerator.Generate(mapName);
+            }
+        });
+    }
+}

src/Impostor.Api.Innersloth.Generator/Vector2Converter.cs

@@ -0,0 +1,42 @@
+using System;
+using System.Numerics;
+using System.Text.Json;
+using System.Text.Json.Serialization;
+
+namespace Impostor.Api.Innersloth.Generator;
+
+public class Vector2Converter : JsonConverter<Vector2>
+{
+    public override Vector2 Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options)
+    {
+        if (reader.TokenType != JsonTokenType.StartObject) throw new JsonException();
+
+        float x = 0;
+        float y = 0;
+
+        while (reader.Read())
+        {
+            if (reader.TokenType == JsonTokenType.EndObject) break;
+
+            switch (reader.GetString())
+            {
+                case "x":
+                    reader.Read();
+                    x = reader.GetSingle();
+                    break;
+
+                case "y":
+                    reader.Read();
+                    y = reader.GetSingle();
+                    break;
+            }
+        }
+
+        return new Vector2(x, y);
+    }
+
+    public override void Write(Utf8JsonWriter writer, Vector2 value, JsonSerializerOptions options)
+    {
+        throw new NotSupportedException();
+    }
+}

src/Impostor.Api.Innersloth.Generator/packages.lock.json

@@ -0,0 +1,157 @@
+{
+  "version": 1,
+  "dependencies": {
+    ".NETStandard,Version=v2.0": {
+      "CSharpPoet": {
+        "type": "Direct",
+        "requested": "[0.3.0, )",
+        "resolved": "0.3.0",
+        "contentHash": "3QDh9rMuiNhMtNWOLj0FItiZruON7lj3zD0CXC9IHq4JWpF5OjbaZ2s1X0u6gftE73KCoTezXIgKvxacps78Fw=="
+      },
+      "Microsoft.Bcl.AsyncInterfaces": {
+        "type": "Direct",
+        "requested": "[8.0.0, )",
+        "resolved": "8.0.0",
+        "contentHash": "3WA9q9yVqJp222P3x1wYIGDAkpjAku0TMUaaQV22g6L67AI0LdOIrVS7Ht2vJfLHGSPVuqN94vIr15qn+HEkHw==",
+        "dependencies": {
+          "System.Threading.Tasks.Extensions": "4.5.4"
+        }
+      },
+      "Microsoft.CodeAnalysis.Analyzers": {
+        "type": "Direct",
+        "requested": "[3.3.4, )",
+        "resolved": "3.3.4",
+        "contentHash": "AxkxcPR+rheX0SmvpLVIGLhOUXAKG56a64kV9VQZ4y9gR9ZmPXnqZvHJnmwLSwzrEP6junUF11vuc+aqo5r68g=="
+      },
+      "Microsoft.CodeAnalysis.CSharp": {
+        "type": "Direct",
+        "requested": "[4.7.0, )",
+        "resolved": "4.7.0",
+        "contentHash": "JHCP2L6lB0oJ3tQoHkC67SFZxW+KbJVOnAo+6L01K5r/NlBlSUhTk5nUAldWhTVwGdzqNeHqGtnEqpsCmGSwQA==",
+        "dependencies": {
+          "Microsoft.CodeAnalysis.Common": "[4.7.0]"
+        }
+      },
+      "NETStandard.Library": {
+        "type": "Direct",
+        "requested": "[2.0.3, )",
+        "resolved": "2.0.3",
+        "contentHash": "st47PosZSHrjECdjeIzZQbzivYBJFv6P2nv4cj2ypdI204DO+vZ7l5raGMiX4eXMJ53RfOIg+/s4DHVZ54Nu2A==",
+        "dependencies": {
+          "Microsoft.NETCore.Platforms": "1.1.0"
+        }
+      },
+      "PolySharp": {
+        "type": "Direct",
+        "requested": "[1.14.1, )",
+        "resolved": "1.14.1",
+        "contentHash": "mOOmFYwad3MIOL14VCjj02LljyF1GNw1wP0YVlxtcPvqdxjGGMNdNJJxHptlry3MOd8b40Flm8RPOM8JOlN2sQ=="
+      },
+      "System.Text.Encodings.Web": {
+        "type": "Direct",
+        "requested": "[8.0.0, )",
+        "resolved": "8.0.0",
+        "contentHash": "yev/k9GHAEGx2Rg3/tU6MQh4HGBXJs70y7j1LaM1i/ER9po+6nnQ6RRqTJn1E7Xu0fbIFK80Nh5EoODxrbxwBQ==",
+        "dependencies": {
+          "System.Buffers": "4.5.1",
+          "System.Memory": "4.5.5",
+          "System.Runtime.CompilerServices.Unsafe": "6.0.0"
+        }
+      },
+      "System.Text.Json": {
+        "type": "Direct",
+        "requested": "[8.0.5, )",
+        "resolved": "8.0.5",
+        "contentHash": "0f1B50Ss7rqxXiaBJyzUu9bWFOO2/zSlifZ/UNMdiIpDYe4cY4LQQicP4nirK1OS31I43rn062UIJ1Q9bpmHpg==",
+        "dependencies": {
+          "Microsoft.Bcl.AsyncInterfaces": "8.0.0",
+          "System.Buffers": "4.5.1",
+          "System.Memory": "4.5.5",
+          "System.Runtime.CompilerServices.Unsafe": "6.0.0",
+          "System.Text.Encodings.Web": "8.0.0",
+          "System.Threading.Tasks.Extensions": "4.5.4"
+        }
+      },
+      "Microsoft.CodeAnalysis.Common": {
+        "type": "Transitive",
+        "resolved": "4.7.0",
+        "contentHash": "pD5S14xMUebSGYe75kt0q/aaS/ftvktSo/pEv7aX7hNPHfdZS+SZeXvkvcffGxWkunYOyRF9m1oN7zzSdYj9dQ==",
+        "dependencies": {
+          "Microsoft.CodeAnalysis.Analyzers": "3.3.4",
+          "System.Collections.Immutable": "7.0.0",
+          "System.Memory": "4.5.5",
+          "System.Reflection.Metadata": "7.0.0",
+          "System.Runtime.CompilerServices.Unsafe": "6.0.0",
+          "System.Text.Encoding.CodePages": "7.0.0",
+          "System.Threading.Tasks.Extensions": "4.5.4"
+        }
+      },
+      "Microsoft.NETCore.Platforms": {
+        "type": "Transitive",
+        "resolved": "1.1.0",
+        "contentHash": "kz0PEW2lhqygehI/d6XsPCQzD7ff7gUJaVGPVETX611eadGsA3A877GdSlU0LRVMCTH/+P3o2iDTak+S08V2+A=="
+      },
+      "System.Buffers": {
+        "type": "Transitive",
+        "resolved": "4.5.1",
+        "contentHash": "Rw7ijyl1qqRS0YQD/WycNst8hUUMgrMH4FCn1nNm27M4VxchZ1js3fVjQaANHO5f3sN4isvP4a+Met9Y4YomAg=="
+      },
+      "System.Collections.Immutable": {
+        "type": "Transitive",
+        "resolved": "7.0.0",
+        "contentHash": "dQPcs0U1IKnBdRDBkrCTi1FoajSTBzLcVTpjO4MBCMC7f4pDOIPzgBoX8JjG7X6uZRJ8EBxsi8+DR1JuwjnzOQ==",
+        "dependencies": {
+          "System.Memory": "4.5.5",
+          "System.Runtime.CompilerServices.Unsafe": "6.0.0"
+        }
+      },
+      "System.Memory": {
+        "type": "Transitive",
+        "resolved": "4.5.5",
+        "contentHash": "XIWiDvKPXaTveaB7HVganDlOCRoj03l+jrwNvcge/t8vhGYKvqV+dMv6G4SAX2NoNmN0wZfVPTAlFwZcZvVOUw==",
+        "dependencies": {
+          "System.Buffers": "4.5.1",
+          "System.Numerics.Vectors": "4.4.0",
+          "System.Runtime.CompilerServices.Unsafe": "4.5.3"
+        }
+      },
+      "System.Numerics.Vectors": {
+        "type": "Transitive",
+        "resolved": "4.4.0",
+        "contentHash": "UiLzLW+Lw6HLed1Hcg+8jSRttrbuXv7DANVj0DkL9g6EnnzbL75EB7EWsw5uRbhxd/4YdG8li5XizGWepmG3PQ=="
+      },
+      "System.Reflection.Metadata": {
+        "type": "Transitive",
+        "resolved": "7.0.0",
+        "contentHash": "MclTG61lsD9sYdpNz9xsKBzjsmsfCtcMZYXz/IUr2zlhaTaABonlr1ESeompTgM+Xk+IwtGYU7/voh3YWB/fWw==",
+        "dependencies": {
+          "System.Collections.Immutable": "7.0.0",
+          "System.Memory": "4.5.5"
+        }
+      },
+      "System.Runtime.CompilerServices.Unsafe": {
+        "type": "Transitive",
+        "resolved": "6.0.0",
+        "contentHash": "/iUeP3tq1S0XdNNoMz5C9twLSrM/TH+qElHkXWaPvuNOt+99G75NrV0OS2EqHx5wMN7popYjpc8oTjC1y16DLg=="
+      },
+      "System.Text.Encoding.CodePages": {
+        "type": "Transitive",
+        "resolved": "7.0.0",
+        "contentHash": "LSyCblMpvOe0N3E+8e0skHcrIhgV2huaNcjUUEa8hRtgEAm36aGkRoC8Jxlb6Ra6GSfF29ftduPNywin8XolzQ==",
+        "dependencies": {
+          "System.Memory": "4.5.5",
+          "System.Runtime.CompilerServices.Unsafe": "6.0.0"
+        }
+      },
+      "System.Threading.Tasks.Extensions": {
+        "type": "Transitive",
+        "resolved": "4.5.4",
+        "contentHash": "zteT+G8xuGu6mS+mzDzYXbzS7rd3K6Fjb9RiZlYlJPam2/hU7JCBZBVEcywNuR+oZ1ncTvc/cq0faRr3P01OVg==",
+        "dependencies": {
+          "System.Runtime.CompilerServices.Unsafe": "4.5.3"
+        }
+      }
+    },
+    ".NETStandard,Version=v2.0/win-x64": {}
+  }
+}

src/Impostor.Api/CheatCategory.cs

@@ -0,0 +1,47 @@
+namespace Impostor.Api;
+
+// NOTE: when adding items to this enum, add them to the bottom for API stability
+public enum CheatCategory
+{
+    /// <summary>A packet used a part of the network protocol that is unknown to Impostor, like a custom RPC.</summary>
+    ProtocolExtension,
+
+    /// <summary>A host-only mod extension is used outside of host-authoritive mode.</summary>
+    HostOnlyExtension,
+
+    /// <summary>A packet was sent at an inappropriate moment.</summary>
+    GameFlow,
+
+    /// <summary>A packet was sent by a non-host player that should normally only be sent by the host.</summary>
+    MustBeHost,
+
+    /// <summary>A packet was sent that violated limits on the selection of player colors.</summary>
+    ColorLimits,
+
+    /// <summary>A packet was sent that exceeded the limits of possible nicknames to enter ingame.</summary>
+    NameLimits,
+
+    /// <summary>A packet was sent on behalf of another player.</summary>
+    Ownership,
+
+    /// <summary>An ability was used that the current role cannot access.</summary>
+    Role,
+
+    /// <summary>A packet was sent to a player that should be broadcasted, or vice versa.</summary>
+    Target,
+
+    /// <summary>A packet was sent on an invalid network object, like a PlayerControl without PlayerInfo.</summary>
+    InvalidObject,
+
+    /// <summary>A packet was sent that exceeded the maximum allowed RPC size.</summary>
+    PacketSize,
+
+    /// <summary>Legacy category for unsorted anticheat checks.</summary>
+    Other,
+
+    /// <summary>A packet was sent with more items than possible in the game.</summary>
+    ItemLimits,
+
+    /// <summary>A packet contained an identifier (friendcode or puid) that does not match the one known for that player.</summary>
+    Identifiers,
+}

src/Impostor.Api/CheatContext.cs

@@ -0,0 +1,20 @@
+using Impostor.Api.Net.Inner;
+
+namespace Impostor.Api
+{
+    public class CheatContext
+    {
+        public CheatContext(string name)
+        {
+            Name = name;
+        }
+
+        public static CheatContext Deserialize { get; } = new CheatContext(nameof(Deserialize));
+
+        public static CheatContext Serialize { get; } = new CheatContext(nameof(Serialize));
+
+        public string Name { get; }
+
+        public static implicit operator CheatContext(RpcCalls rpcCalls) => new CheatContext(rpcCalls.ToString());
+    }
+}

src/Impostor.Api/Config/AntiCheatConfig.cs

@@ -0,0 +1,41 @@
+namespace Impostor.Api.Config
+{
+    public class AntiCheatConfig
+    {
+        public const string Section = "AntiCheat";
+
+        public bool Enabled { get; set; } = true;
+
+        public bool BanIpFromGame { get; set; } = true;
+
+        public CheatingHostMode AllowCheatingHosts { get; set; } = CheatingHostMode.Never;
+
+        public CheatingHostMode AllowHostOnlyExtensions { get; set; } = CheatingHostMode.IfRequested;
+
+        public bool EnableGameFlowChecks { get; set; } = true;
+
+        public bool EnableMustBeHostChecks { get; set; } = true;
+
+        public bool EnableInvalidObjectChecks { get; set; } = true;
+
+        public bool EnableColorLimitChecks { get; set; } = true;
+
+        public bool EnableNameLimitChecks { get; set; } = true;
+
+        public bool EnableItemLimitChecks { get; set; } = true;
+
+        public bool EnableOwnershipChecks { get; set; } = true;
+
+        public bool EnableRoleChecks { get; set; } = true;
+
+        public bool EnableTargetChecks { get; set; } = true;
+
+        public bool EnableIdentifierChecks { get; set; } = true;
+
+        public bool ForbidProtocolExtensions { get; set; } = true;
+
+        public bool EnablePacketSizeChecks { get; set; } = true;
+
+        public int PacketSizeLimit { get; set; } = 1203;
+    }
+}

src/Impostor.Api/Config/CheatingHostMode.cs

@@ -0,0 +1,29 @@
+namespace Impostor.Api.Config
+{
+    /// <summary>
+    /// Details if exceptions are made for hosts that are cheating.
+    /// </summary>
+    public enum CheatingHostMode
+    {
+        /// <summary>
+        /// Hosts follow the same policies as other players.
+        /// </summary>
+        Never,
+
+        /// <summary>
+        /// Hosts are allowed to cheat if they request HostAuthority. If they
+        /// do not request this, the same policies as for other players applies.
+        /// </summary>
+        /// <para>
+        /// HostAuthority can be requested by hosts by adding 25 to their patch
+        /// version when connecting. This flag is used by a lot of (host-only)
+        /// mods and also disable server authority over MurderPlayer packets.
+        /// </para>
+        IfRequested,
+
+        /// <summary>
+        /// Hosts are always allowed to cheat.
+        /// </summary>
+        Always,
+    }
+}

src/Impostor.Api/Config/CompatibilityConfig.cs

@@ -0,0 +1,13 @@
+namespace Impostor.Api.Config
+{
+    public class CompatibilityConfig
+    {
+        public const string Section = "Compatibility";
+
+        public bool AllowFutureGameVersions { get; set; } = false;
+
+        public bool AllowHostAuthority { get; set; } = false;
+
+        public bool AllowVersionMixing { get; set; } = false;
+    }
+}

src/Impostor.Api/Config/DebugConfig.cs

@@ -0,0 +1,11 @@
+namespace Impostor.Api.Config
+{
+    public class DebugConfig
+    {
+        public const string Section = "Debug";
+
+        public bool GameRecorderEnabled { get; set; }
+
+        public string GameRecorderPath { get; set; } = string.Empty;
+    }
+}

src/Impostor.Api/Config/DisconnectMessages.cs

@@ -0,0 +1,36 @@
+namespace Impostor.Api.Config
+{
+    public static class DisconnectMessages
+    {
+        public const string Error = "There was an internal server error. " +
+                                    "Check the server console for more information. " +
+                                    "Please report the issue on the Impostor GitHub if it keeps happening.";
+
+        public const string ClientOutdated = "Please update your game to play in this lobby.";
+
+        public const string ClientTooNew = "Your game version is too new for this lobby. " +
+                                           "If you want to join this lobby you need to downgrade your client.";
+
+        public const string Destroyed = "The game you tried to join is being destroyed. " +
+                                        "Please create a new game.";
+
+        public const string UsernameLength = "Your username is too long, please make it shorter.";
+
+        public const string UsernameIllegalCharacters = "Your username contains illegal characters, please remove them.";
+
+        public const string VersionClientTooOld = "Please update your game to play on this server.";
+
+        public const string VersionServerTooOld = "Your client is too new, please update your Impostor server to play.";
+
+        public const string VersionUnsupported = "Your client version is unsupported, please update your Game and/or Impostor server.";
+
+        private const string UpgradingDocsLink = "https://github.com/Impostor/Impostor/blob/master/docs/Upgrading.md";
+
+        public const string UdpMatchmakingUnsupported = $"""
+                                                        Sorry, UDP Matchmaking is no longer supported.
+                                                        See <link={UpgradingDocsLink}#impostor-190>Impostor documentation</link> on how to migrate to HTTP Matchmaking
+                                                        """;
+
+        public const string HostAuthorityUnsupported = "Your client is requesting host authority, which is not enabled on this Impostor server.";
+    }
+}

src/Impostor.Api/Config/HttpServerConfig.cs

@@ -0,0 +1,27 @@
+namespace Impostor.Api.Config;
+
+/// <summary>
+/// Configuration for HttpServer.
+/// </summary>
+public class HttpServerConfig
+{
+    /// <summary>
+    /// Gets the name of this config section.
+    /// </summary>
+    public const string Section = "HttpServer";
+
+    public bool Enabled { get; set; } = true;
+
+    /// <summary>
+    /// Gets or sets the IP address the HTTP Matchmaking server will listen on.
+    /// </summary>
+    /// Use "127.0.0.1" if you are running behind a reverse proxy or just testing locally.
+    /// Use "0.0.0.0" if you are directly exposing this server to the internet.
+    public string ListenIp { get; set; } = "0.0.0.0";
+
+    /// <summary>
+    /// Gets or sets the port the HTTP Matchmaking server will listen on.
+    /// </summary>
+    /// For port forwarding purposes, this is a TCP port.
+    public ushort ListenPort { get; set; } = 22023;
+}

src/Impostor.Api/Config/ServerConfig.cs

@@ -0,0 +1,30 @@
+using Impostor.Api.Utils;
+
+namespace Impostor.Api.Config
+{
+    public class ServerConfig
+    {
+        public const string Section = "Server";
+
+        private string? _resolvedPublicIp;
+        private string? _resolvedListenIp;
+
+        public string PublicIp { get; set; } = "127.0.0.1";
+
+        public ushort PublicPort { get; set; } = 22023;
+
+        public string ListenIp { get; set; } = "0.0.0.0";
+
+        public ushort ListenPort { get; set; } = 22023;
+
+        public string ResolvePublicIp()
+        {
+            return _resolvedPublicIp ??= IpUtils.ResolveIp(PublicIp);
+        }
+
+        public string ResolveListenIp()
+        {
+            return _resolvedListenIp ??= IpUtils.ResolveIp(ListenIp);
+        }
+    }
+}

src/Impostor.Api/Config/TimeoutConfig.cs

@@ -0,0 +1,11 @@
+namespace Impostor.Api.Config
+{
+    public class TimeoutConfig
+    {
+        public const string Section = "Timeout";
+
+        public int SpawnTimeout { get; set; } = 2500;
+
+        public int ConnectionTimeout { get; set; } = 2500;
+    }
+}

src/Impostor.Api/Events/Attributes/EventListenerAttribute.cs

@@ -0,0 +1,34 @@
+using System;
+
+namespace Impostor.Api.Events
+{
+    [AttributeUsage(AttributeTargets.Method, AllowMultiple = true)]
+    public class EventListenerAttribute : Attribute
+    {
+        public EventListenerAttribute(EventPriority priority = EventPriority.Normal)
+        {
+            Priority = priority;
+        }
+
+        public EventListenerAttribute(Type @event, EventPriority priority = EventPriority.Normal)
+        {
+            Priority = priority;
+            Event = @event;
+        }
+
+        /// <summary>
+        ///     Gets or sets the priority of the event listener.
+        /// </summary>
+        public EventPriority Priority { get; set; }
+
+        /// <summary>
+        ///     Gets or sets the event that the listener is listening to.
+        /// </summary>
+        public Type? Event { get; set; }
+
+        /// <summary>
+        ///     Gets or sets a value indicating whether the listener will be called regardless of the <see cref="IEventCancelable.IsCancelled" />.
+        /// </summary>
+        public bool IgnoreCancelled { get; set; }
+    }
+}

src/Impostor.Api/Events/Client/IClientConnectedEvent.cs

@@ -0,0 +1,12 @@
+using Impostor.Api.Net;
+
+namespace Impostor.Api.Events.Client
+{
+    /// <summary>
+    ///     Called just after a <see cref="IClient"/> is created and connected.
+    /// </summary>
+    public interface IClientConnectedEvent : IClientEvent
+    {
+        IClient Client { get; }
+    }
+}

src/Impostor.Api/Events/Client/IClientConnectionEvent.cs

@@ -0,0 +1,12 @@
+using Impostor.Api.Net;
+
+namespace Impostor.Api.Events.Client
+{
+    /// <summary>
+    ///     Called just before a <see cref="IHazelConnection"/> is registered.
+    /// </summary>
+    public interface IClientConnectionEvent : IClientEvent
+    {
+        IMessageReader HandshakeData { get; }
+    }
+}

src/Impostor.Api/Events/Client/IClientEvent.cs

@@ -0,0 +1,9 @@
+using Impostor.Api.Net;
+
+namespace Impostor.Api.Events.Client
+{
+    public interface IClientEvent : IEvent
+    {
+        IHazelConnection Connection { get; }
+    }
+}

src/Impostor.Api/Events/EventPriority.cs

@@ -0,0 +1,12 @@
+namespace Impostor.Api.Events
+{
+    public enum EventPriority
+    {
+        Lowest = 0,
+        Low = 1,
+        Normal = 2,
+        High = 3,
+        Highest = 4,
+        Monitor = 5,
+    }
+}

src/Impostor.Api/Events/Game/IGameAlterEvent.cs

@@ -0,0 +1,7 @@
+namespace Impostor.Api.Events
+{
+    public interface IGameAlterEvent : IGameEvent
+    {
+        bool IsPublic { get; }
+    }
+}

src/Impostor.Api/Events/Game/IGameCreatedEvent.cs

@@ -0,0 +1,24 @@
+using Impostor.Api.Games;
+using Impostor.Api.Net;
+
+namespace Impostor.Api.Events
+{
+    /// <summary>
+    ///     Called whenever a new <see cref="IGame" /> is created.
+    /// </summary>
+    /// <remarks>
+    ///     Note that the game just has been created, so no players have joined
+    ///     it yet. If you want to know the future host of this game, use the
+    ///     <see cref="Host"/> property.
+    /// </remarks>
+    public interface IGameCreatedEvent : IGameEvent
+    {
+        /// <summary>
+        ///     Gets the client that requested creation of the game.
+        /// </summary>
+        /// <remarks>
+        ///     Will be null if game creation was requested by a plugin.
+        /// </remarks>
+        IClient? Host { get; }
+    }
+}

src/Impostor.Api/Events/Game/IGameCreationEvent.cs

@@ -0,0 +1,25 @@
+using Impostor.Api.Games;
+using Impostor.Api.Net;
+
+namespace Impostor.Api.Events
+{
+    /// <summary>
+    ///     Called just before a new <see cref="IGame"/> is created.
+    /// </summary>
+    public interface IGameCreationEvent : IEventCancelable
+    {
+        /// <summary>
+        ///     Gets the client that requested creation of the game.
+        /// </summary>
+        /// <remarks>
+        ///     Will be null if game creation was requested by a plugin.
+        /// </remarks>
+        IClient? Client { get; }
+
+        /// <summary>
+        ///     Gets or sets the desired <see cref="Games.GameCode"/>.
+        /// </summary>
+        /// <exception cref="ImpostorException">If the GameCode is invalid or already used in another game.</exception>
+        GameCode? GameCode { get; set; }
+    }
+}

src/Impostor.Api/Events/Game/IGameDestroyedEvent.cs

@@ -0,0 +1,11 @@
+using Impostor.Api.Games;
+
+namespace Impostor.Api.Events
+{
+    /// <summary>
+    ///     Called whenever a new <see cref="IGame" /> is destroyed.
+    /// </summary>
+    public interface IGameDestroyedEvent : IGameEvent
+    {
+    }
+}

src/Impostor.Api/Events/Game/IGameEndedEvent.cs

@@ -0,0 +1,9 @@
+using Impostor.Api.Innersloth;
+
+namespace Impostor.Api.Events
+{
+    public interface IGameEndedEvent : IGameEvent
+    {
+        public GameOverReason GameOverReason { get; }
+    }
+}

src/Impostor.Api/Events/Game/IGameEvent.cs

@@ -0,0 +1,12 @@
+using Impostor.Api.Games;
+
+namespace Impostor.Api.Events
+{
+    public interface IGameEvent : IEvent
+    {
+        /// <summary>
+        ///     Gets the <see cref="IGame" /> this event belongs to.
+        /// </summary>
+        IGame Game { get; }
+    }
+}

src/Impostor.Api/Events/Game/IGameHostChangedEvent.cs

@@ -0,0 +1,11 @@
+using Impostor.Api.Net;
+
+namespace Impostor.Api.Events
+{
+    public interface IGameHostChangedEvent : IGameEvent
+    {
+        IClientPlayer PreviousHost { get; }
+
+        IClientPlayer? NewHost { get; }
+    }
+}

src/Impostor.Api/Events/Game/IGameOptionsChangedEvent.cs

@@ -0,0 +1,49 @@
+using Impostor.Api.Games;
+
+namespace Impostor.Api.Events
+{
+    /// <summary>
+    /// This event is triggered when game options are going to be changed.
+    /// </summary>
+    /// <remarks>
+    /// Be careful when calling SyncSettingsAsync while handling this event,
+    /// as it may call this event again in some cases.
+    /// </remarks>
+    public interface IGameOptionsChangedEvent : IGameEvent
+    {
+        /// <summary>
+        /// Lists the possible reasons that the game options may have changed.
+        /// </summary>
+        public enum ChangeReason
+        {
+            /// <summary>
+            /// The options were changed by the host using LogicOptions deserialization.
+            /// </summary>
+            /// <remarks>
+            /// This event does not change the message sent to other players,
+            /// so changes made to Game.Options are not synced until
+            /// SyncSettingsAsync is called afterwards.
+            /// </remarks>
+            Host,
+
+            /// <summary>
+            /// The options were changed by a plugin using the
+            /// SyncSettingsAsync method in <see cref="IGame"/>.
+            /// </summary>
+            /// <remarks>
+            /// This event is called after serializing the settings, which
+            /// means that changes made by event handlers will not be synced
+            /// over.
+            ///
+            /// We strongly recommend against calling SyncSettingsAsync while
+            /// handling this event.
+            /// </remarks>
+            Api,
+        }
+
+        /// <summary>
+        /// Gets the reason that the game options have changed.
+        /// </summary>
+        public ChangeReason ChangedBy { get; }
+    }
+}

src/Impostor.Api/Events/Game/IGamePlayerJoinedEvent.cs

@@ -0,0 +1,9 @@
+using Impostor.Api.Net;
+
+namespace Impostor.Api.Events
+{
+    public interface IGamePlayerJoinedEvent : IGameEvent
+    {
+        IClientPlayer Player { get; }
+    }
+}

src/Impostor.Api/Events/Game/IGamePlayerJoiningEvent.cs

@@ -0,0 +1,15 @@
+using Impostor.Api.Games;
+using Impostor.Api.Net;
+
+namespace Impostor.Api.Events
+{
+    /// <summary>
+    ///     Called just before a <see cref="IClientPlayer"/> joins a game.
+    /// </summary>
+    public interface IGamePlayerJoiningEvent : IGameEvent
+    {
+        IClientPlayer Player { get; }
+
+        GameJoinResult? JoinResult { get; set; }
+    }
+}

src/Impostor.Api/Events/Game/IGamePlayerLeftEvent.cs

@@ -0,0 +1,11 @@
+using Impostor.Api.Net;
+
+namespace Impostor.Api.Events
+{
+    public interface IGamePlayerLeftEvent : IGameEvent
+    {
+        IClientPlayer Player { get; }
+
+        bool IsBan { get; }
+    }
+}

src/Impostor.Api/Events/Game/IGameStartedEvent.cs

@@ -0,0 +1,9 @@
+namespace Impostor.Api.Events
+{
+    /// <summary>
+    ///     The game is started here and players have been initialized.
+    /// </summary>
+    public interface IGameStartedEvent : IGameEvent
+    {
+    }
+}

src/Impostor.Api/Events/Game/IGameStartingEvent.cs

@@ -0,0 +1,11 @@
+namespace Impostor.Api.Events
+{
+    /// <summary>
+    ///     Called when the game is going to start.
+    ///     When this is called, not all players are initialized properly yet.
+    ///     If you want to get correct player states, use <see cref="IGameStartedEvent" />.
+    /// </summary>
+    public interface IGameStartingEvent : IGameEvent
+    {
+    }
+}

src/Impostor.Api/Events/Game/Meeting/IMeetingEndedEvent.cs

@@ -0,0 +1,27 @@
+using Impostor.Api.Net.Inner.Objects;
+
+namespace Impostor.Api.Events.Meeting
+{
+    public interface IMeetingEndedEvent : IMeetingEvent
+    {
+        /// <summary>
+        ///     Gets the exiled player.
+        /// </summary>
+        IInnerPlayerControl? Exiled { get; }
+
+        /// <summary>
+        ///     Gets a value indicating whether meeting result is a tie.
+        /// </summary>
+        bool IsTie { get; }
+
+        /// <summary>
+        ///     Gets a value indicating whether a Judge overruled the vote result.
+        /// </summary>
+        bool WasOverruled { get; }
+
+        /// <summary>
+        ///     Gets the nonce of the winning Judge overrule, or 0 if the meeting wasn't overruled.
+        /// </summary>
+        ushort OverrideId { get; }
+    }
+}

src/Impostor.Api/Events/Game/Meeting/IMeetingEvent.cs

@@ -0,0 +1,9 @@
+using Impostor.Api.Net.Inner.Objects;
+
+namespace Impostor.Api.Events.Meeting
+{
+    public interface IMeetingEvent : IGameEvent
+    {
+        IInnerMeetingHud MeetingHud { get; }
+    }
+}

src/Impostor.Api/Events/Game/Meeting/IMeetingStartedEvent.cs

@@ -0,0 +1,6 @@
+namespace Impostor.Api.Events.Meeting
+{
+    public interface IMeetingStartedEvent : IMeetingEvent
+    {
+    }
+}

src/Impostor.Api/Events/Game/Player/IPlayerChatEvent.cs

@@ -0,0 +1,17 @@
+namespace Impostor.Api.Events.Player
+{
+    public interface IPlayerChatEvent : IPlayerEvent, IEventCancelable
+    {
+        /// <summary>
+        ///     Gets the message sent by the player.
+        /// </summary>
+        string Message { get; }
+
+        /// <summary>
+        ///     Gets or sets a value indicating whether the message is sent to
+        ///     all players (true) or only to the host (false).
+        ///     To not send this message at all, cancel this event instead.
+        /// </summary>
+        bool SendToAllPlayers { get; set; }
+    }
+}

src/Impostor.Api/Events/Game/Player/IPlayerCheckMurderEvent.cs

@@ -0,0 +1,31 @@
+using Impostor.Api.Innersloth;
+using Impostor.Api.Net.Inner.Objects;
+
+namespace Impostor.Api.Events.Player
+{
+    /// <summary>
+    /// Event that allows changing or canceling an upcoming player murder.
+    /// </summary>
+    /// <remarks>
+    /// Note that this event only triggers if the Host of the Game did not disable server authority.
+    ///
+    /// If you want to get an event after the murder took place, listen to <see cref="IPlayerMurderEvent"/>.
+    /// </remarks>
+    public interface IPlayerCheckMurderEvent : IPlayerEvent, IEventCancelable
+    {
+        /// <summary>
+        /// Gets the player who will be murdered.
+        /// </summary>
+        IInnerPlayerControl Victim { get; }
+
+        /// <summary>
+        /// Gets or sets the result of this event.
+        /// </summary>
+        /// <remarks>
+        /// Its initial value is what would have happened in the normal game flow.
+        /// - If set to Succeeded, the Victim will die.
+        /// - If set to FailedProtected, the Victim will be protected with a shield animation and the attacker will have a cooldown set.
+        /// </remarks>
+        MurderResultFlags Result { get; set; }
+    }
+}

src/Impostor.Api/Events/Game/Player/IPlayerCompletedTaskEvent.cs

@@ -0,0 +1,9 @@
+using Impostor.Api.Net.Inner.Objects;
+
+namespace Impostor.Api.Events.Player
+{
+    public interface IPlayerCompletedTaskEvent : IPlayerEvent
+    {
+        ITaskInfo Task { get; }
+    }
+}

src/Impostor.Api/Events/Game/Player/IPlayerDestroyedEvent.cs

@@ -0,0 +1,6 @@
+namespace Impostor.Api.Events.Player
+{
+    public interface IPlayerDestroyedEvent : IPlayerEvent
+    {
+    }
+}

src/Impostor.Api/Events/Game/Player/IPlayerEnterVentEvent.cs

@@ -0,0 +1,15 @@
+using Impostor.Api.Innersloth.Maps;
+
+namespace Impostor.Api.Events.Player
+{
+    /// <summary>
+    ///     Called whenever a player enters a vent.
+    /// </summary>
+    public interface IPlayerEnterVentEvent : IPlayerEvent
+    {
+        /// <summary>
+        ///     Gets the entered vent.
+        /// </summary>
+        public VentData Vent { get; }
+    }
+}

src/Impostor.Api/Events/Game/Player/IPlayerEvent.cs

@@ -0,0 +1,19 @@
+using Impostor.Api.Net;
+using Impostor.Api.Net.Inner.Objects;
+
+namespace Impostor.Api.Events.Player
+{
+    public interface IPlayerEvent : IGameEvent
+    {
+        /// <summary>
+        ///     Gets the <see cref="IClientPlayer" /> that triggered this <see cref="IPlayerEvent" />.
+        /// </summary>
+        IClientPlayer ClientPlayer { get; }
+
+        /// <summary>
+        ///     Gets the networked <see cref="IInnerPlayerControl" /> that triggered this <see cref="IPlayerEvent" />.
+        ///     This <see cref="IInnerPlayerControl" /> belongs to the <see cref="IClientPlayer" />.
+        /// </summary>
+        IInnerPlayerControl PlayerControl { get; }
+    }
+}

src/Impostor.Api/Events/Game/Player/IPlayerExileEvent.cs

@@ -0,0 +1,9 @@
+namespace Impostor.Api.Events.Player
+{
+    /// <summary>
+    ///     Called whenever a player gets exiled (voted out).
+    /// </summary>
+    public interface IPlayerExileEvent : IPlayerEvent
+    {
+    }
+}

src/Impostor.Api/Events/Game/Player/IPlayerExitVentEvent.cs

@@ -0,0 +1,15 @@
+using Impostor.Api.Innersloth.Maps;
+
+namespace Impostor.Api.Events.Player
+{
+    /// <summary>
+    ///     Called whenever a player exits a vent.
+    /// </summary>
+    public interface IPlayerExitVentEvent : IPlayerEvent
+    {
+        /// <summary>
+        ///     Gets the exited vent.
+        /// </summary>
+        public VentData Vent { get; }
+    }
+}

src/Impostor.Api/Events/Game/Player/IPlayerMovementEvent.cs

@@ -0,0 +1,6 @@
+namespace Impostor.Api.Events.Player
+{
+    public interface IPlayerMovementEvent : IPlayerEvent
+    {
+    }
+}

src/Impostor.Api/Events/Game/Player/IPlayerMurderEvent.cs

@@ -0,0 +1,30 @@
+using Impostor.Api.Innersloth;
+using Impostor.Api.Net.Inner.Objects;
+
+namespace Impostor.Api.Events.Player
+{
+    /// <summary>
+    /// Event that is called when a player is killed by another player.
+    /// </summary>
+    /// <remarks>
+    /// This event works regardless of server authority is enabled or not.
+    ///
+    /// If you want to cancel this kill, listen to <see cref="IPlayerCheckMurderEvent"/>.
+    /// If you want to know about players that were voted out, listed to <see cref="IPlayerExileEvent"/>.
+    /// </remarks>
+    public interface IPlayerMurderEvent : IPlayerEvent
+    {
+        /// <summary>
+        ///     Gets the player who got murdered.
+        /// </summary>
+        IInnerPlayerControl Victim { get; }
+
+        /// <summary>
+        /// Gets the result of the event.
+        /// </summary>
+        /// <remarks>
+        /// Note that if FailedError or FailedProtected is set, the kill did not take place.
+        /// </remarks>
+        MurderResultFlags Result { get; }
+    }
+}

src/Impostor.Api/Events/Game/Player/IPlayerSetStartCounterEvent.cs

@@ -0,0 +1,10 @@
+namespace Impostor.Api.Events.Player
+{
+    public interface IPlayerSetStartCounterEvent : IPlayerEvent
+    {
+        /// <summary>
+        ///     Gets the current time of the start counter.
+        /// </summary>
+        byte SecondsLeft { get; }
+    }
+}

src/Impostor.Api/Events/Game/Player/IPlayerSpawnedEvent.cs

@@ -0,0 +1,6 @@
+namespace Impostor.Api.Events.Player
+{
+    public interface IPlayerSpawnedEvent : IPlayerEvent
+    {
+    }
+}

src/Impostor.Api/Events/Game/Player/IPlayerStartMeetingEvent.cs

@@ -0,0 +1,12 @@
+using Impostor.Api.Net.Inner.Objects;
+
+namespace Impostor.Api.Events.Player
+{
+    public interface IPlayerStartMeetingEvent : IPlayerEvent
+    {
+        /// <summary>
+        ///     Gets the player who's body got reported. Is null when the meeting started by Emergency call button.
+        /// </summary>
+        IInnerPlayerControl? Body { get; }
+    }
+}

src/Impostor.Api/Events/Game/Player/IPlayerVentEvent.cs

@@ -0,0 +1,15 @@
+using Impostor.Api.Innersloth.Maps;
+
+namespace Impostor.Api.Events.Player
+{
+    /// <summary>
+    ///     Called whenever a player moves to another vent.
+    /// </summary>
+    public interface IPlayerVentEvent : IPlayerEvent
+    {
+        /// <summary>
+        ///     Gets the vent player moved to.
+        /// </summary>
+        public VentData NewVent { get; }
+    }
+}

src/Impostor.Api/Events/Game/Player/IPlayerVotedEvent.cs

@@ -0,0 +1,26 @@
+using Impostor.Api.Net.Inner.Objects;
+
+namespace Impostor.Api.Events.Player
+{
+    public enum VoteType : byte
+    {
+        HasNotVoted = 255,
+        Missed = 254,
+        Skipped = 253,
+        Dead = 252,
+        Player = 0,
+    }
+
+    public interface IPlayerVotedEvent : IPlayerEvent
+    {
+        /// <summary>
+        ///     Gets the player he voted for.
+        /// </summary>
+        IInnerPlayerControl? VotedFor { get; }
+
+        /// <summary>
+        ///     Gets the Vote type.
+        /// </summary>
+        VoteType VoteType { get; }
+    }
+}

src/Impostor.Api/Events/IEvent.cs

@@ -0,0 +1,6 @@
+namespace Impostor.Api.Events
+{
+    public interface IEvent
+    {
+    }
+}

src/Impostor.Api/Events/IEventCancelable.cs

@@ -0,0 +1,10 @@
+namespace Impostor.Api.Events
+{
+    public interface IEventCancelable : IEvent
+    {
+        /// <summary>
+        ///     Gets or sets a value indicating whether the event was cancelled.
+        /// </summary>
+        bool IsCancelled { get; set; }
+    }
+}

src/Impostor.Api/Events/IEventListener.cs

@@ -0,0 +1,6 @@
+namespace Impostor.Api.Events
+{
+    public interface IEventListener
+    {
+    }
+}

src/Impostor.Api/Events/IManualEventListener.cs

@@ -0,0 +1,13 @@
+using System.Threading.Tasks;
+
+namespace Impostor.Api.Events
+{
+    public interface IManualEventListener : IEventListener
+    {
+        EventPriority Priority { get; set; }
+
+        public bool CanExecute<T>();
+
+        public ValueTask Execute(IEvent @event);
+    }
+}

src/Impostor.Api/Events/Managers/IEventManager.cs

@@ -0,0 +1,35 @@
+using System;
+using System.Threading.Tasks;
+
+namespace Impostor.Api.Events.Managers
+{
+    public interface IEventManager
+    {
+        /// <summary>
+        ///     Register a temporary event listener.
+        /// </summary>
+        /// <param name="listener">Event listener.</param>
+        /// <param name="invoker">Middleware between the events, which can be used to swap to the correct thread dispatcher.</param>
+        /// <returns>Disposable that unregisters the callback from the event manager.</returns>
+        /// <typeparam name="TListener">Type of the event listener.</typeparam>
+        IDisposable RegisterListener<TListener>(TListener listener, Func<Func<Task>, Task>? invoker = null)
+            where TListener : IEventListener;
+
+        /// <summary>
+        ///     Returns true if an event with the type <typeparamref name="TEvent" /> is registered.
+        /// </summary>
+        /// <returns>True if the <typeparamref name="TEvent" /> is registered.</returns>
+        /// <typeparam name="TEvent">Type of the event.</typeparam>
+        bool IsRegistered<TEvent>()
+            where TEvent : IEvent;
+
+        /// <summary>
+        ///     Call all the event listeners for the type <typeparamref name="TEvent" />.
+        /// </summary>
+        /// <param name="event">The event argument.</param>
+        /// <typeparam name="TEvent">Type of the event.</typeparam>
+        /// <returns>A <see cref="ValueTask" /> representing the asynchronous operation.</returns>
+        ValueTask CallAsync<TEvent>(TEvent @event)
+            where TEvent : IEvent;
+    }
+}

src/Impostor.Api/Events/MultiDisposable.cs

@@ -0,0 +1,31 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+
+namespace Impostor.Api.Events
+{
+    /// <summary>
+    ///     Disposes multiple <see cref="IDisposable" />.
+    /// </summary>
+    public class MultiDisposable : IDisposable
+    {
+        private readonly IEnumerable<IDisposable> _disposables;
+
+        public MultiDisposable(IEnumerable<IDisposable> disposables)
+        {
+            _disposables = disposables;
+        }
+
+        public MultiDisposable(params IDisposable[] disposables) : this(disposables.AsEnumerable())
+        {
+        }
+
+        public void Dispose()
+        {
+            foreach (var disposable in _disposables)
+            {
+                disposable?.Dispose();
+            }
+        }
+    }
+}

src/Impostor.Api/Exceptions/ImpostorConfigException.cs

@@ -0,0 +1,19 @@
+using System;
+
+namespace Impostor.Api
+{
+    public class ImpostorConfigException : ImpostorException
+    {
+        public ImpostorConfigException()
+        {
+        }
+
+        public ImpostorConfigException(string? message) : base(message)
+        {
+        }
+
+        public ImpostorConfigException(string? message, Exception? innerException) : base(message, innerException)
+        {
+        }
+    }
+}

src/Impostor.Api/Exceptions/ImpostorException.cs

@@ -0,0 +1,19 @@
+using System;
+
+namespace Impostor.Api
+{
+    public class ImpostorException : Exception
+    {
+        public ImpostorException()
+        {
+        }
+
+        public ImpostorException(string? message) : base(message)
+        {
+        }
+
+        public ImpostorException(string? message, Exception? innerException) : base(message, innerException)
+        {
+        }
+    }
+}

src/Impostor.Api/Exceptions/ImpostorProtocolException.cs

@@ -0,0 +1,19 @@
+using System;
+
+namespace Impostor.Api
+{
+    public class ImpostorProtocolException : ImpostorException
+    {
+        public ImpostorProtocolException()
+        {
+        }
+
+        public ImpostorProtocolException(string? message) : base(message)
+        {
+        }
+
+        public ImpostorProtocolException(string? message, Exception? innerException) : base(message, innerException)
+        {
+        }
+    }
+}

src/Impostor.Api/Extensions/DictionaryExtensions.cs

@@ -0,0 +1,19 @@
+using System.Collections.Generic;
+using System.Collections.ObjectModel;
+
+namespace Impostor.Api
+{
+    public static class DictionaryExtensions
+    {
+        /// <summary>Returns a read-only <see cref="ReadOnlyDictionary{TKey,TValue}" /> wrapper for the dictionary.</summary>
+        /// <param name="dictionary">An <see cref="IDictionary{TKey,TValue}" /> to create a <see cref="ReadOnlyDictionary{TKey,TValue}" /> from.</param>
+        /// <typeparam name="TKey">The type of the keys of <paramref name="dictionary" />.</typeparam>
+        /// <typeparam name="TValue">The type of the values of <paramref name="dictionary" />.</typeparam>
+        /// <returns>An object that acts as a read-only wrapper around the <see cref="IDictionary{TKey,TValue}" />.</returns>
+        public static ReadOnlyDictionary<TKey, TValue> AsReadOnly<TKey, TValue>(this IDictionary<TKey, TValue> dictionary)
+            where TKey : notnull
+        {
+            return new ReadOnlyDictionary<TKey, TValue>(dictionary);
+        }
+    }
+}

src/Impostor.Api/Extensions/MurderResultFlagsExtensions.cs

@@ -0,0 +1,11 @@
+using Impostor.Api.Innersloth;
+
+namespace Impostor.Api;
+
+public static class MurderResultFlagsExtensions
+{
+    public static bool IsFailed(this MurderResultFlags value)
+    {
+        return (value & (MurderResultFlags.FailedError | MurderResultFlags.FailedProtected)) != 0;
+    }
+}

src/Impostor.Api/Extensions/SpanReaderExtensions.cs

@@ -0,0 +1,69 @@
+using System;
+using System.Buffers.Binary;
+using System.Runtime.CompilerServices;
+
+namespace Impostor.Api
+{
+    /// <summary>
+    ///     Priovides a StreamReader-like api throught extensions.
+    /// </summary>
+    public static class SpanReaderExtensions
+    {
+        [MethodImpl(MethodImplOptions.AggressiveInlining)]
+        public static byte ReadByte(this ref ReadOnlySpan<byte> input)
+        {
+            var original = Advance<byte>(ref input);
+            return original[0];
+        }
+
+        [MethodImpl(MethodImplOptions.AggressiveInlining)]
+        public static short ReadInt16(this ref ReadOnlySpan<byte> input)
+        {
+            var original = Advance<short>(ref input);
+            return BinaryPrimitives.ReadInt16LittleEndian(original);
+        }
+
+        [MethodImpl(MethodImplOptions.AggressiveInlining)]
+        public static int ReadInt32(this ref ReadOnlySpan<byte> input)
+        {
+            var original = Advance<int>(ref input);
+            return BinaryPrimitives.ReadInt32LittleEndian(original);
+        }
+
+        [MethodImpl(MethodImplOptions.AggressiveInlining)]
+        public static uint ReadUInt32(this ref ReadOnlySpan<byte> input)
+        {
+            var original = Advance<uint>(ref input);
+            return BinaryPrimitives.ReadUInt32LittleEndian(original);
+        }
+
+        [MethodImpl(MethodImplOptions.AggressiveInlining)]
+        public static float ReadSingle(this ref ReadOnlySpan<byte> input)
+        {
+            var original = Advance<float>(ref input);
+
+            return BitConverter.Int32BitsToSingle(BinaryPrimitives.ReadInt32LittleEndian(original));
+        }
+
+        [MethodImpl(MethodImplOptions.AggressiveInlining)]
+        public static bool ReadBoolean(this ref ReadOnlySpan<byte> input)
+        {
+            return input.ReadByte() != 0;
+        }
+
+        /// <summary>
+        ///     Advances the position of <paramref name="input" /> by the size of <typeparamref name="T" />.
+        /// </summary>
+        /// <typeparam name="T">Type that will be read.</typeparam>
+        /// <param name="input">input "stream"/span.</param>
+        /// <returns>The original input.</returns>
+        [MethodImpl(MethodImplOptions.AggressiveInlining)]
+        private static unsafe ReadOnlySpan<byte> Advance<T>(ref ReadOnlySpan<byte> input)
+            where T : unmanaged
+        {
+            var original = input;
+            input = input.Slice(sizeof(T));
+            return original;
+        }
+    }
+}

src/Impostor.Api/Extensions/SystemTypesExtensions.cs

@@ -0,0 +1,12 @@
+using Impostor.Api.Innersloth;
+
+namespace Impostor.Api
+{
+    public static class SystemTypesExtensions
+    {
+        public static string GetFriendlyName(this SystemTypes type)
+        {
+            return SystemTypeHelpers.Names[(int)type];
+        }
+    }
+}