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

Examples

Last updated Jul 27, 2026

Examples

Setup snippets for common SoapsAdmin 1.7.0 deployments. Edit live files under plugins/SoapsAdmin/, then reload.

1. Economy Primary + Vault

economy.yml:

vault-integration: true
primary-economy: money

economies:
  money:
    display-name: "Money"
    symbol: "$"
    symbol-before: true
    starting-balance: 100.0
  tokens:
    display-name: "Tokens"
    symbol: "T"
    symbol-before: false
    starting-balance: 0

LuckPerms (example nodes):

soapsadmin.balance
soapsadmin.economy.pay
soapsadmin.baltop
soapsadmin.shop
soapsadmin.shop.buy
soapsadmin.shop.sell

Staff economy:

soapsadmin.economy.give
soapsadmin.economy.set
soapsadmin.economy.take
soapsadmin.economy.reset
soapsadmin.economy.manage

See Economy and Shop, Commands: Economy.

2. Dependencies Checklist

Requirements

Plugin Purpose
SoapsCommon Hard dependency

Optional

Plugin Purpose
Vault Third-party economy bridge via primary currency
PlaceholderAPI %soapsadmin_*%
MythicMobs Mythic spawners, drops, spawnmob
MythicCrucible Crucible items in recipes / give
Citizens Custom-mob drop detection
WorldGuard / Lands / GriefPrevention Claim-aware teleports / RTP
WorldEdit Soft listed; not required for core
mcMMO Friend XP share when enabled

Verify: /sa info, /sa version → 1.7.0. See Integrations.

3. Custom Command: Lobby

customcommands.yml entry (server copy):

lobby:
  type: action
  aliases:
    - hub
  permission: soapsadmin.customcommand
  cooldown: 3
  commands:
    - "sa warp lobby"
  messages:
    - "<gray>Warping to lobby...</gray>"

Create warp first: /sa setwarp lobby. In-game create finishes registered immediately; YAML edits need /sa reload customcommands.

Manage GUI: /sa customcommand gui (soapsadmin.customcommand.manage).

See Custom Commands.

4. Mannequin Staff Use (Paper)

# modules.yml
modules:
  fake-players: true

Permission: soapsadmin.fakeplayer.

Step Command
Spawn /sa fakeplayer Steve (or any Mojang name/skin)
Edit nearest /sa fakeplayer edit
Pose / rotate / glow / name /sa fakeplayer pose / rotate / glow / namevisible
List / remove /sa fakeplayer list / remove / removeall -confirm

Spigot: module commands refuse (Paper Mannequin API). Presets (Guard, Shopkeeper, etc.) are in the editor GUI.

See Fake Players, Commands: Staff.

Discord