SoapsUniverse
SoapsAdmin
SoapsAdmin

Getting Started

Home

[Home](README.md)

IntroductionGetting StartedModulesConfigurationComparison: EssentialsX · CMI · SoapsAdminCommands IndexCommands: PlayerCommands: ModerationCommands: StaffCommands: EconomyCommands: AdminGUIs and MenusModerationEconomy and ShopSpawnersRecipes and CrucibleItem EditorFake Players / MannequinsMail and Player InfoChat and MessagingCustom CommandsPlayer VaultsTeleportationPermissionsPlaceholdersIntegrationsDefault Config FilesExamplesFAQChangelog

Mail and Player Info

Last updated Jul 27, 2026

Mail and Player Info

Two staff/player systems added and polished through the 1.6.x line: offline mail and the player info staff hub.

Mail

Module wiring lives with utility/social systems. Data: plugins/SoapsAdmin/data/social/mail/{uuid}.yml (legacy data/mail/ and data/mail.yml migrate on load).

Commands

Command Description Permission
/sa mail Open inbox GUI / summary soapsadmin.mail
/sa mail send <player> <message> Send mail (works offline) soapsadmin.mail.send
/sa mail read [id] Read a message soapsadmin.mail
/sa mail clear [id|all] Delete message(s) soapsadmin.mail

Exact permission children are in plugin.yml / Permissions.

Behavior

  • You cannot send mail to yourself.
  • Recipients get a join / receive notification with unread count.
  • Inbox GUI supports read and clear actions.
  • Message length is capped (see messages.yml / mail manager limits).
  • Saves are debounced; flush on quit / disable.

Use cases

  • Staff warnings that persist when the player is offline
  • Event rewards instructions
  • Helper → player follow-ups without relying on Discord

Player Info

Staff inspection hub for a target player (not yourself).

Opening

Method Notes
/sa playerinfo <player> Primary command
/sa whois <player> Alias via custom commands (if configured)
Shift + right-click player When soapsadmin.profile.view / playerinfo interact is enabled

Self-target is blocked for playerinfo/whois to avoid confusing staff self-inspect loops.

Hub Contents

Panels (permission-gated):

  • Vitals / gamemode / location summary
  • Armor and hotbar preview
  • Shortcuts: invsee, endersee, spectate, freeze, notes, alts, punish history
  • Links into the broader Staff Panel / Player Action GUI from /sa admin

Invsee / endersee from the hub resolve the target correctly (no unresolved placeholder).

Command Purpose
/sa invsee <player> View/edit inventory
/sa endersee <player> View/edit ender chest
/sa snapshot <player> Snapshot view
/sa alts <player> IP-linked accounts
/sa notes <player> Staff notes
/sa audit <player> Audit trail

Player Profile (Social)

Separately from staff playerinfo, sneak+right-click with profile permission can open a social profile GUI (trade / msg / pay shortcuts). See GUIs and Menus.

Permission examples

Role Nodes
Helper soapsadmin.mail / send node + soapsadmin.playerinfo (without full soapsadmin.admin)
Moderator playerinfo, invsee, notes, alts, audit

Mail is for offline messages. Permanent staff case notes use /sa note / /sa warn.

Discord