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
| Condition | Exact syntax | Behavior |
|---|---|---|
| Item exists | obsidrel has item %string% | Checks for a defined item ID. |
| Block exists | obsidrel has block %string% | Checks for a defined block ID. |
| Furniture exists | obsidrel has furniture %string% | Checks for a defined furniture ID. |
| Entity exists | obsidrel has entity %string% | Checks for a defined custom entity ID. |
| Action exists | obsidrel has action %string% | Checks for a configured action ID. |
| Condition passes | obsidrel condition %string% passes for %player% | Evaluates a configured Core condition for a player. |
| Cooldown ready | obsidrel cooldown %string% of %player% is ready | True if a defined cooldown has no remaining time; unknown cooldown IDs are false. |
| Menu exists | obsidrel has menu %string% | Checks for a configured UI menu ID. |
Example: only give an existing item
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
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
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.