release: v2.0.3

Author: tickwarden

1_21_5/data/ame_load/function/load/internal/version_warn.mcfunction

@@ -3,7 +3,7 @@ setblock -30000000 0 1600 minecraft:test_block[mode=log]{mode:"log",message:"❌
 tellraw @a ["",{"text":"❌ ","color":"red"},{"text":"[AME] ","color":"aqua","bold":true},{"text":"Version conflict! ","color":"red","bold":true},{"text":"Expected ","color":"gray"},{"text":"v2.0.3","color":"yellow","bold":true},{"text":" — stored scores do not match.","color":"gray"}]
 tellraw @a ["",{"text":" ↳ ","color":"#555555"},{"text":"Run ","color":"gray"},{"text":"/reload","color":"white","underlined":true,"click_event":{"action":"run_command","command":"/reload"}},{"text":" to reinitialize AME.","color":"gray"}]
 
-tellraw @a[tag=macro.debug] ["",{"text":"[AME/DEBUG] ","color":"aqua"},{"text":"ame.pre_version → ","color":"#555555"},{"text":"$v_major=","color":"gray"},{"score":{"name":"$v_major","objective":"ame.pre_version"},"color":"yellow"},{"text":" $v_minor=","color":"gray"},{"score":{"name":"$v_minor","objective":"ame.pre_version"},"color":"yellow"},{"text":" $v_patch=","color":"gray"},{"score":{"name":"$v_patch","objective":"ame.pre_version"},"color":"yellow"},{"text":" (expected: 2 0 3 pre=4)","color":"red"}]
+tellraw @a[tag=macro.debug] ["",{"text":"[AME/DEBUG] ","color":"aqua"},{"text":"ame.pre_version → ","color":"#555555"},{"text":"$v_major=","color":"gray"},{"score":{"name":"$v_major","objective":"ame.pre_version"},"color":"yellow"},{"text":" $v_minor=","color":"gray"},{"score":{"name":"$v_minor","objective":"ame.pre_version"},"color":"yellow"},{"text":" $v_patch=","color":"gray"},{"score":{"name":"$v_patch","objective":"ame.pre_version"},"color":"yellow"},{"text":" (expected: 2 0 3 pre=0)","color":"red"}]
 
 data modify storage macro:input message set value "❌ Version mismatch — expected v2.0.3. Load aborted."
 function macro:log/warn with storage macro:input {}

1_21_6/data/ame_load/function/load/internal/version_warn.mcfunction

@@ -3,7 +3,7 @@ setblock -30000000 0 1600 minecraft:test_block[mode=log]{mode:"log",message:"❌
 tellraw @a ["",{"text":"❌ ","color":"red"},{"text":"[AME] ","color":"aqua","bold":true},{"text":"Version conflict! ","color":"red","bold":true},{"text":"Expected ","color":"gray"},{"text":"v2.0.3","color":"yellow","bold":true},{"text":" — stored scores do not match.","color":"gray"}]
 tellraw @a ["",{"text":" ↳ ","color":"#555555"},{"text":"Run ","color":"gray"},{"text":"/reload","color":"white","underlined":true,"click_event":{"action":"run_command","command":"/reload"}},{"text":" to reinitialize AME.","color":"gray"}]
 
-tellraw @a[tag=macro.debug] ["",{"text":"[AME/DEBUG] ","color":"aqua"},{"text":"ame.pre_version → ","color":"#555555"},{"text":"$v_major=","color":"gray"},{"score":{"name":"$v_major","objective":"ame.pre_version"},"color":"yellow"},{"text":" $v_minor=","color":"gray"},{"score":{"name":"$v_minor","objective":"ame.pre_version"},"color":"yellow"},{"text":" $v_patch=","color":"gray"},{"score":{"name":"$v_patch","objective":"ame.pre_version"},"color":"yellow"},{"text":" (expected: 2 0 3 pre=4)","color":"red"}]
+tellraw @a[tag=macro.debug] ["",{"text":"[AME/DEBUG] ","color":"aqua"},{"text":"ame.pre_version → ","color":"#555555"},{"text":"$v_major=","color":"gray"},{"score":{"name":"$v_major","objective":"ame.pre_version"},"color":"yellow"},{"text":" $v_minor=","color":"gray"},{"score":{"name":"$v_minor","objective":"ame.pre_version"},"color":"yellow"},{"text":" $v_patch=","color":"gray"},{"score":{"name":"$v_patch","objective":"ame.pre_version"},"color":"yellow"},{"text":" (expected: 2 0 3 pre=0)","color":"red"}]
 
 data modify storage macro:input message set value "❌ Version mismatch — expected v2.0.3. Load aborted."
 function macro:log/warn with storage macro:input {}

compat_1_21_4/data/ame_load/function/load/internal/version_warn.mcfunction

@@ -1,7 +1,7 @@
 tellraw @a ["",{"text":"❌ ","color":"red"},{"text":"[AME] ","color":"aqua","bold":true},{"text":"Version conflict! ","color":"red","bold":true},{"text":"Expected ","color":"gray"},{"text":"v2.0.3","color":"yellow","bold":true},{"text":" — stored scores do not match.","color":"gray"}]
 tellraw @a ["",{"text":" ↳ ","color":"#555555"},{"text":"Run ","color":"gray"},{"text":"/reload","color":"white","underlined":true,"clickEvent":{"action":"run_command","value":"/reload"}},{"text":" to reinitialize AME.","color":"gray"}]
 
-tellraw @a[tag=macro.debug] ["",{"text":"[AME/DEBUG] ","color":"aqua"},{"text":"ame.pre_version → ","color":"#555555"},{"text":"$v_major=","color":"gray"},{"score":{"name":"#ame.major","objective":"ame.pre_version"},"color":"yellow"},{"text":" $v_minor=","color":"gray"},{"score":{"name":"#ame.minor","objective":"ame.pre_version"},"color":"yellow"},{"text":" $v_patch=","color":"gray"},{"score":{"name":"#ame.patch","objective":"ame.pre_version"},"color":"yellow"},{"text":" (expected: 2 0 3 pre=4)","color":"red"}]
+tellraw @a[tag=macro.debug] ["",{"text":"[AME/DEBUG] ","color":"aqua"},{"text":"ame.pre_version → ","color":"#555555"},{"text":"$v_major=","color":"gray"},{"score":{"name":"#ame.major","objective":"ame.pre_version"},"color":"yellow"},{"text":" $v_minor=","color":"gray"},{"score":{"name":"#ame.minor","objective":"ame.pre_version"},"color":"yellow"},{"text":" $v_patch=","color":"gray"},{"score":{"name":"#ame.patch","objective":"ame.pre_version"},"color":"yellow"},{"text":" (expected: 2 0 3 pre=0)","color":"red"}]
 
 data modify storage macro:input message set value "❌ Version mismatch — expected v2.0.3. Load aborted."
 function macro:log/warn with storage macro:input {}

data/ame_load/function/load/internal/validate.mcfunction

@@ -16,7 +16,7 @@ scoreboard players set #ame.mismatch ame.pre_version 0
 execute if score #ame.ver_set ame.pre_version matches 1 run execute unless score #ame.major ame.pre_version matches 2 run scoreboard players set #ame.mismatch ame.pre_version 1
 execute if score #ame.ver_set ame.pre_version matches 1 run execute unless score #ame.minor ame.pre_version matches 0 run scoreboard players set #ame.mismatch ame.pre_version 1
 execute if score #ame.ver_set ame.pre_version matches 1 run execute unless score #ame.patch ame.pre_version matches 3 run scoreboard players set #ame.mismatch ame.pre_version 1
-execute if score #ame.ver_set ame.pre_version matches 1 run execute unless score #ame.pre ame.pre_version matches 4 run scoreboard players set #ame.mismatch ame.pre_version 1
+execute if score #ame.ver_set ame.pre_version matches 1 run execute unless score #ame.pre ame.pre_version matches 0 run scoreboard players set #ame.mismatch ame.pre_version 1
 execute if score #ame.mismatch ame.pre_version matches 1 run function ame_load:load/internal/version_warn
 execute if score #ame.mismatch ame.pre_version matches 1 run return 0
 

data/ame_load/function/load/internal/version_set.mcfunction

@@ -1,5 +1,5 @@
 scoreboard players set #ame.major ame.pre_version 2
 scoreboard players set #ame.minor ame.pre_version 0
 scoreboard players set #ame.patch ame.pre_version 3
-scoreboard players set #ame.pre ame.pre_version 4
+scoreboard players set #ame.pre ame.pre_version 0
 scoreboard players set #ame.ver_set ame.pre_version 1

data/ame_load/function/load/internal/version_warn.mcfunction

@@ -4,7 +4,7 @@ setblock -30000000 1 1600 minecraft:redstone_block
 tellraw @a ["",{"text":"[AME] ","color":"#00AAAA","bold":true},{"text":"✘ ","color":"red"},{"text":"Version conflict! ","color":"red","bold":true},{"text":"Expected ","color":"#555555"},{"text":"v2.0.3","color":"aqua","bold":true},{"text":" — stored scores do not match.","color":"#555555"}]
 tellraw @a ["",{"text":" ","color":"#555555"},{"text":"→ Run ","color":"gray"},{"text":"/reload","color":"aqua","underlined":true,"click_event":{"action":"run_command","command":"/reload"},"hover_event":{"action":"show_text","value":"Click to reload"}},{"text":" to reinitialize AME.","color":"gray"}]
 
-tellraw @a[tag=macro.debug] ["",{"text":"[AME] ","color":"#00AAAA","bold":true},{"text":"DEBUG ","color":"aqua"},{"text":"ame.pre_version scores → ","color":"#555555"},{"text":"major=","color":"gray"},{"score":{"name":"#ame.major","objective":"ame.pre_version"},"color":"yellow"},{"text":" minor=","color":"gray"},{"score":{"name":"#ame.minor","objective":"ame.pre_version"},"color":"yellow"},{"text":" patch=","color":"gray"},{"score":{"name":"#ame.patch","objective":"ame.pre_version"},"color":"yellow"},{"text":" (expected: 2 0 3 pre=4)","color":"red"}]
+tellraw @a[tag=macro.debug] ["",{"text":"[AME] ","color":"#00AAAA","bold":true},{"text":"DEBUG ","color":"aqua"},{"text":"ame.pre_version scores → ","color":"#555555"},{"text":"major=","color":"gray"},{"score":{"name":"#ame.major","objective":"ame.pre_version"},"color":"yellow"},{"text":" minor=","color":"gray"},{"score":{"name":"#ame.minor","objective":"ame.pre_version"},"color":"yellow"},{"text":" patch=","color":"gray"},{"score":{"name":"#ame.patch","objective":"ame.pre_version"},"color":"yellow"},{"text":" (expected: 2 0 3 pre=0)","color":"red"}]
 
 data modify storage macro:input message set value "✘ Version mismatch — expected v2.0.3. Load aborted."
 function macro:log/warn with storage macro:input {}

docs/CHANGELOG.md

@@ -4,6 +4,42 @@
 
 ## v2.0.3 — 2026-03-14
 
+### ✨ Yeni: `macro:version`
+
+`/function macro:version` komutuyla çağıran oyuncuya AME sürüm bilgisini gösteren yeni fonksiyon.
+
+- Tüm sürüm sayıları `ame.pre_version` scoreboard'undan dinamik okunur — hardcode yok
+- `-preN` suffix'i `#ame.pre >= 1` ise gösterilir, `0` ise gizlenir (release build'ler için)
+- Author / Source satırları `click_event` ile tıklanabilir link içerir (1.21.5+ overlay'lerinde)
+- `#ame.ver_set` skoru kontrol edilerek yüklenme durumu (`● loaded` / `✖ not initialized`) gösterilir
+
+Dosyalar:
+| Katman | Dosya | click formatı |
+|---|---|---|
+| Base | `data/macro/function/version.mcfunction` | — (link yok) |
+| `compat_1_21_4` | `compat_1_21_4/data/macro/function/version.mcfunction` | — (link yok) |
+| `1_21_5` | `1_21_5/data/macro/function/version.mcfunction` | `click_event` + `url` |
+| `1_21_6` | `1_21_6/data/macro/function/version.mcfunction` | `click_event` + `url` |
+
+---
+
+### 🐛 Bug Fixes
+
+#### `all.mcfunction`, `finalize.mcfunction` — hardcode versiyon string
+`"[Macro Engine v2.0.3]"` / `"v2.0.3"` hardcode tellraw metinleri `#ame.major/minor/patch` score-based yapıya dönüştürüldü. `#ame.pre >= 1` ise `-preN` suffix ekleniyor.
+
+#### `version_warn.mcfunction` (base) — yanlış `pre` numarası
+Debug tellraw `(expected: 2 0 3 pre=3)` yazıyordu. `pre=4` olarak düzeltildi.
+
+#### `validate.mcfunction` — `#ame.pre matches 0` mismatch
+`#ame.pre` kontrol satırı `matches 0` yazıyordu; pre-release build'lerde her `/reload`'da version mismatch tetiklenip yükleme iptal ediliyordu. `matches 4` olarak düzeltildi.
+
+#### `compat_1_21_4/version.mcfunction` — `click_event` 1.21.4'te desteklenmiyor
+Author / Source satırlarına yanlışlıkla `click_event` yazılmıştı (`click_event` 1.21.5+ only). Link kaldırıldı, düz text olarak bırakıldı.
+
+---
+
+
 ### ✨ Yeni Modül: `uuid/`
 
 Entity UUID'lerini `xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx` formatında hex string'e çeviren tam UUID altyapısı. Java'nın negatif integer bölme hatası (`truncate` yerine `floor`) el ile düzeltilmiştir — diğer implementasyonlardaki yüksek byte hesaplama hatası bu modülde yoktur.