From 5c650e8970c3bd4391ffece7c2a35eadc50a0d73 Mon Sep 17 00:00:00 2001
From: Liam <internet_zzb10x@ik.me>
Date: Thu, 20 Aug 2026 14:09:51 +0200
Subject: [PATCH] Added a README.md

Added README.md with project details and setup instructions.
---
 README.md | 56 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 56 insertions(+)

diff --git a/README.md b/README.md
index e69de29..dc5eb57 100644
--- a/README.md
+++ b/README.md
@@ -0,0 +1,56 @@
+# Empostor
+Empostor is an open-source private server implementation for Among Us.
+
+[![Discord](https://img.shields.io/badge/Discord-%235865F2.svg?style=flat&logo=discord&logoColor=white)](https://discord.gg/5fPmpxxnrc)
+[![GitHub license](https://badgen.net/github/license/Empostor/Empostor)](https://github.com/Empostor/Empostor/blob/main/LICENSE)
+[![GitHub latest commit](https://badgen.net/github/last-commit/Empostor/Empostor)](https://github.com/Empostor/Empostor/commit/)
+[![GitHub all releases](https://img.shields.io/github/downloads/Empostor/Empostor/total.svg)](https://github.com/Empostor/Empostor/releases/)
+[![GitHub contributors](https://badgen.net/github/contributors/Empostor/Empostor)](https://github.com/Empostor/Empostor/graphs/contributors/)
+[![GitHub total-pull-requests](https://badgen.net/github/prs/Empostor/Empostor)](https://github.com/Empostor/Empostor/pull/)
+
+## Features
+- FriendCode support (authentication)
+- Dynamic ports
+- Plugin support
+- Server-side anticheat
+
+## Getting Started 
+
+To run the server, you need:
+
+- [.NET 8.0 Runtime](https://dotnet.microsoft.com/en-us/download/dotnet/8.0)
+
+Download the build you'd like from the [releases](https://github.com/Empostor/Empostor/releases). You most likely want the x64 build. Use the arm64 build if you are running Empostor on a Raspberry Pi, another ARM-based SBC, or an ARM VPS.
+
+Unzip the file and go to config.json. To make your server playable for other devices, replace the "PublicIp" field with your actual public IP address.
+
+It is also recommended to [set up a Reverse Proxy](https://empostor.github.io/Http-server#use-a-reverse-proxy) (for HTTPS connections).
+
+## Client Setup
+
+### Windows
+1. Go [here](https://impostor.github.io/Impostor) and enter your server's IP/domain, port and name. Press "Download server file"
+2. Press Win + R and enter this (leave the quotation marks):
+```cmd
+"%userprofile%\AppData\LocalLow\Innersloth\Among Us"
+```
+3. Put the new regionInfo.json file you downloaded in the folder. Overwrite the existing file in the folder.
+4. Launch Among Us. If everything worked, your server should appear in the regions list!
+
+### Android/iOS
+1. Launch Among Us. When you reach the main menu, close the app.
+2. Go [here](https://impostor.github.io/Impostor) and enter your server's IP/domain, port and name.
+3. Scroll until you see Instructions and press the Android or Apple logo.
+4. Press "Open in Among Us". Among Us should open.
+5. Your server should appear in the regions list!
+
+## Contributing
+Please read the [contributing guidelines](https://github.com/Empostor/Empostor/blob/main/CONTRIBUTING.md).
+
+You're welcome to open a pull request/issue!
+
+## Documentation
+The documentation is available [here](https://empostor.github.io)!
+
+## License
+This project is licensed under the [GPL-v3.0 License](https://github.com/Empostor/Empostor/blob/main/LICENSE).