Changelog

Changelog

The complete, always-current changelog lives in the repository: CHANGELOG.md.

2.0.0 — highlights

A large, fully backward-compatible update. Every existing interaction file keeps working; the new features are opt-in.

Added

• A new, cleaner schema_version: 2 JSON format (strictly valid JSON, unified match selectors, SNBT-string NBT, precise error messages). See Interaction Format.
• Advanced rewards — guaranteed drops, multiple rolls, and a Fortune/Looting-style bonus.
• Player effects & feedback — potion effects, plus interaction-level sound / particles.
• Conditions — gate by time, weather, y_range, light, requires_sneaking, and player_state (min food / XP), on top of biome and dimension filters.
• Typed NBT predicates — match item/block-entity data with a clean path + int_range + where filter.
• Multiplayer JEI sync — the JEI category is now correct on dedicated servers.
• Optional datapack loading — Loader.load_from_datapacks reads data/<namespace>/pta/interaction/*.json on top of the config folder.
• Expanded JEI display — guaranteed drops, NBT predicates and a summary tooltip on the arrow (rolls, Fortune, effects, conditions, sound/particles).

Fixed

• Unknown ids/tags are reported instead of silently becoming air/empty.
• NBT blacklist range checks now work (and support short values like enchantment levels).
• Cooldown uses world time, so it no longer blocks a player after respawn or dimension change.
• Right-click interactions no longer risk double-processing.
• Invalid NBT no longer discards a whole file; assorted null-safety fixes.

Changed / Deprecated

• The original format (no schema_version, or 1) is deprecated but still loads, logging a one-time warning. A migration table is in Interaction Format.
• Faster click evaluation via indexed filtering (no behaviour change).

Why the jump to 2.0.0? A new interaction format, a rebuilt parser, multiplayer sync and a big set of new capabilities — a major step up — while staying 100% backward compatible.