+init

10 files changed, 612 insertions, 0 deletions

diff --git a/Impostor-dev/docs/Building-from-source.md b/Impostor-dev/docs/Building-from-source.md
new file mode 100644
index 0000000..cf3632f
--- /dev/null
+++ b/Impostor-dev/docs/Building-from-source.md
@@ -0,0 +1,45 @@
+# Building from source
+
+The solution contains two main projects, the Impostor client and server. The client is built using [.NET Framework 4.7.2](https://dotnet.microsoft.com/download/dotnet-framework/net472) and the server with [.NET 5](https://dotnet.microsoft.com/download/dotnet/5.0).
+
+Currently .NET 5 is not yet officially released, so in order to build using Visual Studio, you should have Visual Studio 2019 **Preview** installed.
+This documentation will go over building both the [Server](#building-the-server) and the [Client](#building-the-client) and their requirements.
+
+## Cloning Impostor
+
+You need to clone Impostor with all submodules.
+
+```bash
+git clone --recursive https://github.com/AeonLucid/Impostor.git
+```
+
+If you already have cloned Impostor but have errors related to Hazel, run the following.
+
+```bash
+git submodule update --init
+```
+
+## Building the server
+
+### Dependencies
+- [.NET 5 SDK](https://dotnet.microsoft.com/download/dotnet/5.0)
+- [Visual Studio Preview](https://visualstudio.microsoft.com/vs/preview/) (Optional, only if you want the full IDE experience)
+
+### Build using the CLI
+
+```bash
+cd src/Impostor.Server/
+dotnet build
+```
+To setup the server, please look at [Running the server](Running-the-server.md).
+
+## Building the client
+
+### Dependencies
+* [.NET Framework 4.7.2 Developer Pack](https://dotnet.microsoft.com/download/dotnet-framework/thank-you/net472-developer-pack-offline-installer)
+
+### Build using the CLI
+```bash
+cd src/Impostor.Client/Impostor.Client.WinForms
+dotnet build
+```
\ No newline at end of file
diff --git a/Impostor-dev/docs/FAQ.md b/Impostor-dev/docs/FAQ.md
new file mode 100644
index 0000000..14df95f
--- /dev/null
+++ b/Impostor-dev/docs/FAQ.md
@@ -0,0 +1,11 @@
+# Frequently Answered Questions
+
+## What is this?
+The Impostor project is a reverse engineered and open sourced 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. 
+###### \* In order to play on an Impostor server with iOS, you _must_ have a jailbroken device.
+
+## 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!
diff --git a/Impostor-dev/docs/README.md b/Impostor-dev/docs/README.md
new file mode 100644
index 0000000..e32ff8c
--- /dev/null
+++ b/Impostor-dev/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)
\ No newline at end of file
diff --git a/Impostor-dev/docs/Running-the-server.md b/Impostor-dev/docs/Running-the-server.md
new file mode 100644
index 0000000..db0a618
--- /dev/null
+++ b/Impostor-dev/docs/Running-the-server.md
@@ -0,0 +1,101 @@
+# Running the server
+
+There are currently two modes to run the Impostor server in. The first way is the simplest one and is the one you should probably use. The other way will distribute players across other servers and is a more advanced configuration.
+
+## Single server
+
+### Without docker
+1. Install the **.NET 5.0 runtime**.
+    - [Windows x64](https://dotnet.microsoft.com/download/dotnet/thank-you/runtime-5.0.0-windows-x64-installer)
+    - [Linux x64](https://docs.microsoft.com/en-us/dotnet/core/install/linux)
+    - [macOS x64](https://dotnet.microsoft.com/download/dotnet/thank-you/runtime-5.0.0-macos-x64-installer)
+2. Find the [latest dev release](https://ci.appveyor.com/project/Impostor/Impostor/branch/dev/artifacts).
+3. Download either the Windows or the Linux version.
+4. Extract the zip.
+5. Modify `config.json` to your liking. Documentation can be found [here](Server-configuration.md) *(this step is mandatory if you want to expose this server to other devices)*
+6. Run `Impostor.Server.exe` (Windows) / `Impostor.Server` (Linux)
+
+### Using docker
+
+[![Docker Image](https://img.shields.io/docker/v/aeonlucid/impostor?sort=semver)](https://hub.docker.com/repository/docker/aeonlucid/impostor)
+[![Docker Image](https://img.shields.io/docker/v/aeonlucid/impostor/nightly)](https://hub.docker.com/repository/docker/aeonlucid/impostor)
+
+```
+docker run -p 22023:22023/udp aeonlucid/impostor:nightly
+```
+
+### Using docker-compose
+```
+version: '3.4'
+
+services:
+  impostor:
+    image: aeonlucid/impostor:nightly
+    container_name: impostor
+    ports:
+      - 22023:22023/udp
+    volumes:
+      - /path/to/local/config.json:/app/config.json # For easy editing of the config
+      - /path/to/local/plugins:/app/plugins         # Only needed if using plugins
+      - /path/to/local/libraries:/app/libraries     # Only needed if using external libraries
+```
+
+## Multiple servers
+
+Follow the steps from the single server on two or more servers.
+
+### Master server
+
+The master server will accept client connections and redirect them to the other servers listed in the configuration. It will not host any games itself.
+
+Example configuration:
+
+```json
+{
+  "Server": {
+    "PublicIp": "127.0.0.1",
+    "PublicPort": 22023,
+    "ListenIp": "0.0.0.0",
+    "ListenPort": 22023
+  },
+  "ServerRedirector": {
+    "Enabled": true,
+    "Master": true,
+    "Locator": {
+      "Redis": "",
+      "UdpMasterEndpoint": "127.0.0.1:22024"
+    },
+    "Nodes": [
+      {
+        "Ip": "127.0.0.1",
+        "Port": 22025
+      }
+    ]
+  }
+}
+```
+
+### Node servers
+
+The node server should have `ServerRedirector` enabled too, but `Master` **must be disabled**. Nodes do not need to be aware of each other.
+
+Example configuration:
+
+```json
+{
+  "Server": {
+    "PublicIp": "127.0.0.1",
+    "PublicPort": 22025,
+    "ListenIp": "0.0.0.0",
+    "ListenPort": 22025
+  },
+  "ServerRedirector": {
+    "Enabled": true,
+    "Master": false,
+    "Locator": {
+      "Redis": "",
+      "UdpMasterEndpoint": "127.0.0.1:22024"
+    }
+  }
+}
+```
diff --git a/Impostor-dev/docs/Server-configuration.md b/Impostor-dev/docs/Server-configuration.md
new file mode 100644
index 0000000..5841ca7
--- /dev/null
+++ b/Impostor-dev/docs/Server-configuration.md
@@ -0,0 +1,77 @@
+# Server configuration
+
+Some information about all the possible configurations. Click [here](https://github.com/AeonLucid/Impostor/blob/master/src/Impostor.Server/config.full.json) to see all the possible config options.
+
+## 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`. |
+
+### AntiCheat
+
+| Key | Default | Value |
+|-|-|-|
+| **BanIpFromGame** | `true` | When 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. **(Setting this to false does not disable the anti-cheat!)** |
+
+### ServerRedirector
+In a multi-node setup these need to be specified.
+| Key | Default | Value |
+|-|-|-|
+| **Enabled** | `false` | Whether the server runs in multi-node setup. If this is `false`, all other options in this section do not have any effect. |
+| **Master** | `false` | Whether the current server is a master. A master is responsible for redirecting clients to nodes |
+| **Locator** | | Fill in either `Redis` or `UdpMasterEndpoint` to choose which method to use for locating other nodes. This must be the same across all servers. |
+| **>Redis** | | Format `127.0.0.1.6379`, you can also use a password like so: `127.0.0.1.6379,password=value`. |
+| **>UdpMasterEndpoint** | | On the master, this value acts as a listen ip and port. On a node, this should be the public ip and port of the master. Format `127.0.0.1:32320`. |
+| **Nodes** | | An array containing public ips and ports of nodes. Only needs to be set on the master. See above for an example. |
+
+## Config providers
+
+### File
+
+The simplest option to configure is by using the `config.json` file next to the server executable. For all possible options see the [config-full.json](https://github.com/Impostor/Impostor/blob/dev/src/Impostor.Server/config-full.json) file.
+
+### Command line arguments
+
+TODO
+
+```
+Server:PublicIp=127.0.0.1
+Server:PublicPort=22023
+Server:ListenIp=0.0.0.0
+Server:ListenPort=22023
+AntiCheat:BanIpFromGame=true
+ServerRedirector:Enabled=false
+ServerRedirector:Master=true
+ServerRedirector:Locator:Redis=127.0.0.1.6379
+ServerRedirector:Locator:UdpMasterEndpoint=127.0.0.1:32320
+ServerRedirector:Nodes:0:Ip=127.0.0.1
+ServerRedirector:Nodes:0:Port=22024
+ServerRedirector:Nodes:1:Ip=127.0.0.1
+ServerRedirector:Nodes:1:Port=22025
+```
+
+### Environment variables
+
+TODO
+
+```
+IMPOSTOR_Server__PublicIp=127.0.0.1
+IMPOSTOR_Server__PublicPort=22023
+IMPOSTOR_Server__ListenIp=0.0.0.0
+IMPOSTOR_Server__ListenPort=22023
+IMPOSTOR_AntiCheat__BanIpFromGame=true
+IMPOSTOR_ServerRedirector__Enabled=false
+IMPOSTOR_ServerRedirector__Master=true
+IMPOSTOR_ServerRedirector__Locator__Redis=127.0.0.1.6379
+IMPOSTOR_ServerRedirector__Locator__UdpMasterEndpoint=127.0.0.1:32320
+IMPOSTOR_ServerRedirector__Nodes__0__Ip=127.0.0.1
+IMPOSTOR_ServerRedirector__Nodes__0__Port=22024
+IMPOSTOR_ServerRedirector__Nodes__1__Ip=127.0.0.1
+IMPOSTOR_ServerRedirector__Nodes__1__Port=22025
+```
diff --git a/Impostor-dev/docs/TROUBLESHOOTING.md b/Impostor-dev/docs/TROUBLESHOOTING.md
new file mode 100644
index 0000000..8750159
--- /dev/null
+++ b/Impostor-dev/docs/TROUBLESHOOTING.md
@@ -0,0 +1,28 @@
+# 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 SBC (Single-Board 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`
+
+## `You are using an older version of the game`
+You are using an older version of Impostor. The game does not really check who is outdated and blames it on the user.  
+Make sure you got the latest working version of Impostor (probably in AppVeyor, not Github).
+
+## `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 `127` nor `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.
diff --git a/Impostor-dev/docs/Writing-a-plugin.md b/Impostor-dev/docs/Writing-a-plugin.md
new file mode 100644
index 0000000..a7ad21b
--- /dev/null
+++ b/Impostor-dev/docs/Writing-a-plugin.md
@@ -0,0 +1,343 @@
+# 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 Core SDK
+
+Download and install the latest .NET Core 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 5, which includes:
+
+- .NET Standard 2.0
+- .NET Standard 2.1
+- .NET Core 3.1
+- .NET 5
+
+For more information about compatibility, see https://docs.microsoft.com/en-us/dotnet/standard/net-standard.
+
+> At the moment of writing this document, I recommend you to use **.NET Standard 2.1** until .NET 5 is released officially. This should give you enough functionality. If not, upgrade to .NET Core 3.1.
+
+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>netstandard2.1</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. Next to the search bar, enable `Include prerelease`.
+5. Search for `Impostor.Api`.
+6. Click the `Impostor.Api` result and press install on the right side.
+
+### Dotnet CLI
+
+> Make sure to grab the latest (pre-)release version from NuGet [here](https://www.nuget.org/packages/Impostor.Api).
+
+1. Open your project folder in command prompt / bash.
+2. Run `dotnet add package Impostor.Api -v "1.2.0-ci.58"`.
+
+## 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/netstandard2.1/`.
+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>`
+  - `IOptions<ServerRedirectorConfig>`
+- 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\\netstandard2.1"
+    ],
+    "Libraries": []
+  }
+}
+```
+
+### 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.Libraries` 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)
\ No newline at end of file
diff --git a/Impostor-dev/docs/images/client.jpg b/Impostor-dev/docs/images/client.jpg
new file mode 100644
index 0000000..2d82f47
--- /dev/null
+++ b/Impostor-dev/docs/images/client.jpg
diff --git a/Impostor-dev/docs/images/logo_458.png b/Impostor-dev/docs/images/logo_458.png
new file mode 100644
index 0000000..173f648
--- /dev/null
+++ b/Impostor-dev/docs/images/logo_458.png
diff --git a/Impostor-dev/docs/images/logo_64.png b/Impostor-dev/docs/images/logo_64.png
new file mode 100644
index 0000000..74c0721
--- /dev/null
+++ b/Impostor-dev/docs/images/logo_64.png