Official documentation

Somnera command reference

Use these notes to understand each command category, field alias, and notification option. Keep the help command open for in-discord reminders.

Getting started

Import, pins, and basics

Importing

Copy your `pk;export` JSON, drop it as an attachment to `som;import`, or pass a URL or `token:` so Somnera refreshes your roster, optional system metadata, and integration payload.

List / alter

`som;list [all|dormant|active]` shows slots with the pinned star indicator. Use `som;alter ` to open a profile with the updated embed + Integration list button.

Edits

`som;member new ` creates a slot, and `som;member ` uses plural-style aliases like `disp`, `bio`, `pron`, `bday`, `fav`, `integration_note`, and `integration_time`.

Import instructions

Supported exports

PluralKit

Run `pk;export`, attach the JSON, or paste the export URL into `som;import`. You can also pass `som;import token:` to pull it directly.

Tupperbox

Use the dashboard or `tul!export` (with your prefix) to generate a JSON dump and then feed it to `som;import`.

SimplyPlural

Go to Settings → Integrations → PluralKit, export a JSON using your PluralKit token, and open it in Somnera.

D-Proxy

Run `/export` or `d!export` (or `d!export proxy` for specific characters) to download JSON, then import it with `som;import`.

Commands

Integrations, favorites, and dormant overrides

Integration chain

Every integration command logs who integrates into whom.

  • `som;integrate with ` links both alters and stores notes/time.
  • `som;integrationmap` uses pagination, while `/integrationmap` offers the slash equivalent.
  • The embed button “Integration list” shows inbound partners without cluttering the profile.
  • `som;disengage with ` removes the cached connections cleanly.

Dormant overrides

`som;setdormant ` toggles manual overrides. Use `auto` to clear the override and return to automatic detection.

Favorites & pins

`som;favorite Song | url` attaches a clickable favorite entry. `som;pin ` sorts favorites to the top of `som;list` (star indicator).

Notifications

Integration + dormant alerts

Use `som;notify set integration #channel` or `som;notify set dormant #channel` to push embed updates to the channels your team checks. `som;notify list` reveals current targets and `som;notify clear ` removes a channel.

Each notification duplicates what goes to the integration log channel and applies the per-user setting, keeping your group aware of merges and manual dormant states.