SoapsUniverse
SoapsTeleporter
SoapsTeleporter

Getting Started

HomeIntroductionGetting Started

Configuration

ConfigurationDefault Config Files

Guides

Portal CreationPortal TypesParticles and EffectsConditionsEconomyInteractive Management

Reference

Commands and PermissionsIntegrationsPlaceholdersExamples

Support

FAQChangelog

Conditions

Last updated Jul 6, 2026

Conditions

Conditions control when a player may use a portal. Multiple conditions on one portal typically must all pass (AND logic). Expression-based rules add OR and NOT support.

Commands

Command Purpose
/st setcondition <portal> <condition> [value] Set or replace a condition type
/st addcondition <portal> <condition> [value] Add another condition
/st removecondition <portal> <condition> Remove one condition
/st removecondition <portal> all Clear all conditions

Permissions:

  • st.command.setcondition
  • st.command.addcondition
  • st.command.removecondition (checked in code; grant explicitly if you split staff roles)

Time and Weather

Condition Description
day Daytime only
night Nighttime only
rain Raining
thunder Thunderstorm
clear Clear weather
sun Daytime with clear weather
storm Rain and thunder together 
/st setcondition arena day
/st addcondition arena thunder

Player State

Condition Description
sneak Player must be sneaking
fly Player must be flying

Level

/st setcondition dungeon level 30

Requires minimum XP level 30.

Environment

Condition Usage
world /st setcondition gate world world_nether
biome /st setcondition gate biome JUNGLE
gamemode /st setcondition gate gamemode CREATIVE

Items and Money

Items

/st setcondition treasure item DIAMOND 5
/st addcondition quest item ENDER_PEARL

Checks inventory. Does not consume items (use /st setcost to charge items).

Money (balance check only)

/st setcondition vip money 1000

Checks Vault balance. Does not charge the player. See Economy for /st setcost.

Advancement and Playtime

/st setcondition endgate advancement minecraft:story/enter_the_end
/st setcondition veterangate playtime 600

playtime is in minutes on the server.

Advanced Conditions (Management UI)

These are available through /st manage (GUI or chat) and stored on the portal:

Category Examples
Health and food Min/max health, min/max hunger
Equipment Armor type, weapon in hand, naked, full armor set
Player state Jumping, on fire, sprinting
Social Min/max nearby players, solo only
Time windows timeRange, dateRange in portal data
Usage limits maxUsesPerDay

Combining Conditions

Stack conditions with addcondition:

/st addcondition boss level 20
/st addcondition boss night
/st addcondition boss item DIAMOND_SWORD 1

All three must pass.

Expression Conditions (1.0.1+)

Portals can use a condition expression for nested logic:

(player_level>=10 AND has_permission:st.portal.use.vip) OR is_admin

Supported tokens include:

  • is_admin
  • has_permission:<node>
  • player_level>=<number> and player_level><number>
  • online_players>=<number>
  • server_tps>=<number>
  • Condition tokens such as DAY, NIGHT, RAIN, MONEY <amount>

Expressions are evaluated together with standard portal conditions.

Management Interface

/st manage <portal>

Open Conditions in the GUI (when gui.enabled is true) or follow the chat category buttons when GUI is disabled.

Type cancel in chat to abort any prompted input.

Next Steps

Discord