Getting Started

Get the Among Us experience in your Minecraft server — follow the steps below to get up and running quickly.

Prerequisites

A running Paper (or compatible) Minecraft server
Server operator / file system access

Installation

Download the plugin.

Choose your preferred method:
- Download (Recommended)
- Build from Source
1. Open the Releases page on GitHub.
2. Expand Assets on the latest release.
3. Download the file named AmongUs-x.x-SNAPSHOT-all.jar.
Clone the repository and build the plugin using Gradle:
Terminal window
git clone https://github.com/Fantamomo/among-us-in-minecraft cd among-us-in-minecraft
This plugin depends on packages hosted on GitHub Packages, which requires authentication — even for read access.
Create or edit your ~/gradle.properties file and add your GitHub credentials:
gpr.user=YOUR_GITHUB_USERNAME gpr.key=YOUR_GITHUB_TOKEN
Creating a token
Open GitHub Tokens

Click Generate new token

Select read:packages.

Click Generate token.

Place it in ~/gradle.properties
Then build the plugin:
Terminal window
./gradlew shadowJar
The compiled .jar will be located in build/libs/.
The authentication requirement for GitHub Packages is a known inconvenience. We hope to migrate the dependencies to a public registry in the future to simplify this process.
Add the plugin to your server.

Move the downloaded .jar file into your server’s plugins/ directory:
- Directoryplugins/
  - AmongUs-x.x-SNAPSHOT-all.jar the downloaded .jar file
  - …
- …
Start your server.

If your server is already running, stop it first, then start it again.

This plugin does not support /reload. Always perform a full restart — both on first install and after every update.
Verify the installation.

Once the server is running, check your console for a line like:
```
[AmongUs] Enabling AmongUs vX.X-SNAPSHOT
```
If you see it, you’re all set! Next, adjust your config.yml to your liking or jump straight into creating your first area or download the pre-built-area.