config.yml

The plugin’s configuration file is located at:

plugins/AmongUs/config.yml

Below is the full default configuration:

msg-command-blocker:
  disabled: false
  legacy: false
  commands:
    - msg
    - tell
    - w
    - me
    - minecraft:tell
    - minecraft:msg
    - minecraft:w
    - minecraft:me

morph-blender:
  enabled: false
  blender: virus
  visibility: auto

roles:
  disabled: []

modifications:
  disabled: []

game-creation:
  everyone-can-create: false
  max-games: 10
  ignore-admins: true

action-log-upload:
  enabled: true
  url: https://logs.among-us-in-minecraft.fantamomo.com
  send-to-players: true

ai:
  enabled: false
  provider:
    type: openrouter
    base-url:
    chat-completions-path:
    model-path:
    embeddings-path:
  model: google/gemini-2.5-flash
  generate-game-summary: true
  latency-warning: true

bots:
  enabled: true
  only-admins: false
  admin-ignore-bots-limit: true
  max-bots-per-game: 5

animate-scoreboard: true

msg-command-blocker

Prevents players from using private messaging commands during games to ensure fair play and prevent information leakage.

Blocked commands include:

/msg
/tell
/w
/me
and their Minecraft namespaced variants

Commands are blocked when a player is in an active game.

disabled

disabled: false

false → Command blocking is active.
true → All commands are allowed.

legacy

legacy: false

false → Automatically intercepts message commands (recommended).
true → Only blocks commands listed in commands:.

commands (legacy mode only)

Used only when legacy: true:

commands:
  - msg
  - tell
  - w
  - me
  - minecraft:tell
  - minecraft:msg
  - minecraft:w
  - minecraft:me

You can extend this list for custom server aliases.

morph-blender

Enables animated skin transitions when players change form (e.g. Morphling role). Requires a valid MineSkin API key in secrets.properties.

enabled

enabled: false

true → Enables animated morph transitions.
false → Instant skin changes.

blender

blender: virus

Available animation styles:

virus – Spreading “infection-style” animation
fade – Smooth fade transition
checker – Checkerboard pattern transition

visibility

visibility: auto

Controls MineSkin skin visibility:

auto – Recommended automatic selection
unlisted – Accessible via direct link only
private – Only visible to your account
public – Visible to everyone (not recommended)

roles

Defines roles disabled in the game:

roles:
  disabled: []

Any role listed here will not appear in-game.

Example:

disabled:
  - phantom

modifications

Defines gameplay modifications that are disabled:

modifications:
  disabled: []

Example:

disabled:
  - small

game-creation

Controls game creation permissions and limits.

everyone-can-create

everyone-can-create: false

true → All players can create games
false → Only players with amongus.admin.game.create

max-games

max-games: 10

Maximum number of simultaneous games allowed.

ignore-admins

ignore-admins: true

true → Admins bypass game limit
false → Admins are also restricted

action-log-upload

Handles uploading game logs for analysis or replay systems.

enabled

enabled: true

Enables or disables log uploading.

url

url: https://logs.among-us-in-minecraft.fantamomo.com

Endpoint used to upload action logs.

send-to-players

send-to-players: true

true → All players in a game receive logs
false → Only the host receives logs

ai

AI features for summaries and optional integrations via OpenRouter.

enabled

enabled: false

Enables AI features such as:

Game summaries
Bot chat and smarter votes

provider

provider:
  type: openrouter

Currently only OpenRouter is supported.

Optional fields:

base-url
chat-completions-path
model-path
embeddings-path

model

model: google/gemini-2.5-flash

AI model used for generation.

Multiple models can be specified:

model: modelA;modelB;modelC

Fallback order is used if a model fails.

generate-game-summary

generate-game-summary: true

Generates a post-game AI summary.

latency-warning

latency-warning: true

Warns about AI response delays.

bots

Controls AI/player bots in games.

enabled

enabled: true

Enables bot system.

only-admins

only-admins: false

true → Only admins can create bots

admin-ignore-bots-limit

admin-ignore-bots-limit: true

true → Admins bypass bot limits

max-bots-per-game

max-bots-per-game: 5

Maximum number of bots per game (max effective: 9).

Set to:

0 → Unlimited (clamped internally to 9)

animate-scoreboard

animate-scoreboard: true

true → Animated scoreboard updates
false → Instant updates

Recommended Setup

A balanced production setup:

msg-command-blocker:
  disabled: false
  legacy: false

morph-blender:
  enabled: true
  blender: virus
  visibility: auto

ai:
  enabled: true
  model: google/gemini-2.5-flash

bots:
  enabled: true
  max-bots-per-game: 5

game-creation:
  everyone-can-create: false
  max-games: 10
  ignore-admins: true

animate-scoreboard: true