secret.properties

Security

This file contains private credentials and secret keys. Never share, upload, commit, or send this file to anyone. Exposure of this file may compromise your server security or external service accounts.

The secret.properties file is located at:

plugins/AmongUs/secret.properties

This file stores credentials used by optional plugin integrations such as:

• MineSkin skin generation
• AI providers

---

Default File Content

# CONFIDENTIAL FILE - CONTAINS SENSITIVE INFORMATION
# This file stores private credentials and secret keys.
# DO NOT share, upload, commit, or send this file to anyone.
# Exposure of this information may compromise security.

# API Key for https://mineskin.org/
# Used by the Morphling role to generate skins during transformation.
mineskin=

# API Key for an AI provider
ai=

---

MineSkin API Key

The mineskin property stores your API key for https://mineskin.org/.

It is required for:

• MorphBlender skin transitions
• Dynamic Morphling transformations
• Skin generation during morph animations

If no key is provided, MorphBlender features will not work and transformations will fall back to instant skin switching.

Example

mineskin=YOUR_MINESKIN_API_KEY

---

How to Obtain a MineSkin API Key

1. Create an account at https://account.mineskin.org
2. Open your dashboard
3. Create a new API key
4. Configure the key:

• Choose a descriptive name
• Select “A plugin or mod asked me to create an API key”
• Optional project URL:

https://github.com/Fantamomo/among-us-in-minecraft/

5. Copy the key into secret.properties
6. Restart your server

Note

MineSkin free plans work perfectly for the plugin.

Paid plans mainly improve skin generation speed. On free plans, generating morph transitions may take around 30–40 seconds, depending on API load.

---

AI API Key

The ai property stores the API key used by the AI integration configured inside config.yml.

This key is required when:

• ai.enabled: true
• A supported AI provider is configured

Currently supported providers depend on the plugin version and configuration.

Example

ai=YOUR_AI_API_KEY

---

How It Works

The AI key is used together with the configuration under:

ai:
  enabled: true
  provider:
    type: openrouter

The plugin reads the API key from secret.properties and injects it into outgoing API requests.

---

Security Best Practices

Recommended practices:

• Never upload this file to GitHub or public repositories
• Never share screenshots containing API keys
• Never include this file in bug reports or support requests
• Add plugins/AmongUs/secret.properties to .gitignore

---

What Happens If Keys Are Missing?

Missing mineskin

• MorphBlender becomes unavailable
• Morph transitions become instant
• Skin generation is disabled

Missing ai

• AI functionality becomes unavailable
• AI summaries will not generate
• Other plugin systems continue working normally

---

Example Configuration

mineskin=msk_xxxxxxxx_<64 chars>
ai=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx