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
    - minecraft:tell
    - minecraft:msg
    - minecraft:w

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

roles:
  disabled:
  #  - phantom

modifications:
  disabled:
  #  - small

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

animate-scoreboard: true

msg-command-blocker

Private messaging can break gameplay by allowing hidden information to be shared between players. This module intercepts message commands before they execute to ensure fair play.

Commands such as /msg, /tell, and /w are blocked when the sender or at least one target is in an active game. They are allowed if neither player is in a game, or if the sender and target are the same person.

disabled

disabled: false

false → Command blocking is active.
true → No commands are blocked.

legacy

legacy: false

false → Automatically intercepts private message commands (recommended).
true → Only blocks the commands explicitly listed under commands:.

commands

Only used when legacy: true. Lists the commands to block:

commands:
  - msg
  - tell
  - w

Add any additional aliases your server uses.

morph-blender

Enables animated skin transitions when a player changes form (e.g. the Morphling role). A valid MineSkin API key must be set in secrets.properties. If disabled, skin changes happen instantly without any animation.

enabled

enabled: false

true → Animated morph transitions.
false → Instant skin switch.

blender

blender: virus

The animation style used during a morph:

virus – Viral spreading animation.
fade – Smooth fade transition.
checker – Checkerboard blending.

visibility

visibility: auto

Controls the visibility of generated skins on MineSkin:

auto – Automatically selects the best option based on your plan (recommended).
unlisted – Accessible via direct link only.
private – Only visible to your MineSkin account.
public – Visible to everyone (not recommended).

roles

Defines which roles are disabled and hidden from gameplay:

roles:
  disabled:
    - phantom

Roles listed under disabled: cannot be selected and are completely hidden in-game.

modifications

Defines which modifications are disabled and hidden from gameplay:

modifications:
  disabled:
    - small

Modifications listed under disabled: cannot be selected and are completely hidden in-game.

game-creation

Controls who can create games and how many can run simultaneously.

everyone-can-create

everyone-can-create: false

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

max-games

max-games: 10

The maximum number of games that can exist at the same time. Once the limit is reached, no additional games can be created.

ignore-admins

ignore-admins: true

true → Players with amongus.admin.game.create can bypass the max-games limit.
false → The max-games limit applies to everyone, including admins.

animate-scoreboard

animate-scoreboard: true

true → The scoreboard updates dynamically with animation.
false → Static scoreboard display.

Recommended Setup

For most servers, the following configuration is a good starting point:

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

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

roles:
  disabled: []

modifications:
  disabled: []

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

animate-scoreboard: true