OBSIDREL / DOCS

Documentation

Guides, tutorials and technical references for the Obsidrel ecosystem.

DocumentationConditions Reference

Conditions Reference

Conditions are read-only queries through Obsidrel's public API. An unknown definition ID normally evaluates to false. Condition names do not create the referenced content.

All 8 conditions

ConditionExact syntaxBehavior
Item existsobsidrel has item %string%Checks for a defined item ID.
Block existsobsidrel has block %string%Checks for a defined block ID.
Furniture existsobsidrel has furniture %string%Checks for a defined furniture ID.
Entity existsobsidrel has entity %string%Checks for a defined custom entity ID.
Action existsobsidrel has action %string%Checks for a configured action ID.
Condition passesobsidrel condition %string% passes for %player%Evaluates a configured Core condition for a player.
Cooldown readyobsidrel cooldown %string% of %player% is readyTrue if a defined cooldown has no remaining time; unknown cooldown IDs are false.
Menu existsobsidrel has menu %string%Checks for a configured UI menu ID.

Example: only give an existing item

skript
command /checkruby:
    trigger:
        if obsidrel has item "obsidrel:ruby":
            send "Ruby is available." to player
        else:
            send "Ruby is not registered." to player

Use obsidrel has item "..." to check if the definition exists. The expression obsidrel item "..." creates an ItemStack instead; do not use obsidrel item "..." exists as a substitute for the dedicated condition.

Cooldown readiness

skript
command /checkobscooldown:
    trigger:
        if obsidrel cooldown "ruby_use" of player is ready:
            send "Ready." to player
        else:
            send "Not ready or missing cooldown." to player

A known cooldown with zero remaining time returns ready. An unknown cooldown ID is not treated as ready. This condition does not start the cooldown; an Obsidrel action or mechanic must do that.

Condition evaluation

skript
command /checkcondition:
    trigger:
        if obsidrel condition "obsidrel:my_condition" passes for player:
            send "The condition passed." to player

obsidrel:my_condition is a placeholder; replace it with a real configured condition ID. A false result may reflect Core rules rather than a syntax problem.

Was this article helpful?Loading ratings…

Help us improve Obsidrel documentation. One vote per account and article. Discord AI feedback can also contribute when the answer cites this article.