⚙️ Race API Core Update (v0.7.5)

💡 Light Level Bug Fix

• Fixed Sky Light Detection: The light_level_below and light_level_above conditions previously used a method that ignored sky darkening. Because of this, surface light was always read as 15 at night, meaning "in the dark" conditions never actually triggered after sunset. We've switched to calculating the true local light level, correctly accounting for the time of day and weather.

🧩 24 New Condition Types!

Previously, conditions were limited to basic checks (water/ground/day/health/light/biome). To allow for truly unique, complex, and "wow-factor" races, we have massively expanded the condition system. Added:

• Items: held_item, offhand_item (supports specific items or #tags), wearing_item (slot + item/tag), and armor_count_above/below.

• Player State: hunger_below/above (0–20), air_below/above (breath meter percentage), xp_level_above/below, climbing, eye_in_water, riding (with an optional mob type filter), and gamemode.

• World Environment: standing_on (specific block or block tag under your feet), biome_id (exact biome), moon_phase (all 8 phases — perfect for werewolves!), thundering, and time_between (ticks between min and max).

• RPG Elements: entities_nearby_above/below (radius + threshold + mob type/tag filter — great for enemy proximity auras) and scoreboard_above/below (checks scoreboard values for progression systems).

🌍 Dynamic Condition Translations

• Readable Condition Labels: Conditional power labels used to display raw IDs (like is_night). The new system dynamically builds translated, human-readable labels for your abilities!

  • Thresholds now show real values ("Health below 30%").

  • Items, blocks, effects, and mobs use their proper vanilla translated names ("Holding Diamond Sword" instead of minecraft:diamond_sword).

  • Tags are cleanly displayed as #minecraft:swords.

  • Moon phases are fully translated ("Moon Phase: Full Moon").

  • Composite logic (all_of / any_of / not) is combined recursively into readable sentences: "AT NIGHT AND Holding #minecraft:swords AND NOT (Below Y 50)".

• Custom Overrides: Unknown custom types will safely fall back to displaying their raw ID. If a race creator manually sets a condition_label, it will still take priority over these auto-generated labels.

• Localization: Added 59 new condition.raceapi.* translation keys for English (en_us), Russian (ru_ru), and Ukrainian (uk_ua).

📚 Documentation

• Updated Guides: Added a massive new section for raceapi:conditional to docs/02-datapack-guide.md. It includes full reference tables for all 50 condition types and examples of nested composition setups (these conditions were entirely undocumented before this!).

(Versions updated: Race API 0.7.4 -> 0.7.5. OriginsX and Skill Tree remain unchanged)