TweakletMC Durability

Warns you before your tools, weapons and armor break.

What it does

• Watches the item in your main hand, the item in your off hand and the armor you wear (helmet, chestplate, leggings and boots; an Elytra too). The rest of your inventory and other players are never looked at, and nothing is sent to the server.
• Uses Minecraft's own durability values. Items that cannot take damage, are Unbreakable or have no durability are ignored.
• When the remaining durability of an item drops to the warning level (10% by default), a card appears at the bottom of the screen with the real item icon (and its durability bar), the item's name, the percentage left and the uses left, for example 10% left · 25/250, and a bar in the item's own durability color.
• Switching to or putting on an item that is already low warns you too, once it stays in your hand or slot for half a second. Scrolling quickly through the hotbar does not.

No spam

• An item that stays low does not warn again, however long you keep using it.
• After a repair the next drop warns again: on an anvil, or with Mending once the item is safely above the warning level (5 points). Small repairs that keep it near the level do not cause new warnings.
• Taking the same low item again within a minute does not warn again.
• When several items get low at the same moment, they are shown one after another (hands first, then armor from head to feet), and the card shows how many are waiting, for example +2.
• An item stays the same item while you use it: loading and firing a crossbow, or data that a server plugin writes on the item, do not cause new warnings.
• A broken item is forgotten: whatever you take in its place is warned about on its own.
• Leaving a world or a server forgets everything. Changing dimensions in the same world does not.

Sound

A short note plays with a warning: Minecraft's own note block sound (no extra sound files), at your Master Volume. It plays once even if several items get low at the same moment, and not again for the cards that are waiting. It can be turned off; the cards still appear.

Fits on the screen

The card sits at the bottom center, above the action bar text and below the crosshair, and is never drawn off screen. While the chat screen is open, the card is not drawn over the chat. It stays clear of the top-right column of vanilla notifications and TweakletMC Pickup Toast, and of TweakletMC Minimap. Checked with GUI scales 1, 2 and 3, an 854×480 window and the "Force Unicode Font" option.

Settings (Mod Menu)

• Warnings on or off
• Sound on or off
• Warn at: 5% to 50% in steps of 5% (default 10%); with the keyboard, each arrow key moves one step
• Main Hand, Off Hand and Armor can each be turned off

Settings are saved in config/tweaklet-durability.json. A damaged settings file does not crash the game: the defaults are used and the damaged file is kept as a backup. Durability adds no key binding.

Requirements

• Minecraft Java Edition 1.21.1
• Fabric Loader 0.16.0 or newer
• Fabric API
• TweakletMC Core 0.2.0 or a newer 0.2.x version
• Java 21
• Optional: Mod Menu, for the settings screen

Durability is a client-side mod: nothing needs to be installed on a server. It does not need TweakletMC Pickup Toast, Waypoints, Minimap or World Map, and works together with them.

Known limitations

• Two items that are exactly the same (same type, enchantments, name, repair cost, armor trim, dye color and banner pattern) and are swapped directly in the same slot count as one item.
• If TweakletMC Pickup Toast is moved to a left corner, on narrow screens (less than 480 GUI pixels wide, for example 1280×720 at the automatic GUI scale) the card can cover the lowest toasts there. In Pickup Toast's default top-right corner and in the bottom-right corner it never does.
• On very short screens (less than 240 GUI pixels high, for example 1280×720 with "Force Unicode Font") the card can cover the action bar text and the name of the held item.
• When recent chat messages are on screen (each stays for 10 seconds), the card can cover the fourth and higher chat lines from the bottom for its 4 seconds, as the vanilla action bar text and item name also do.
• The card shows for about 4 seconds, also while a screen such as the inventory or the chat is open.
• Languages: English and Turkish. Other languages show the English text.

Türkçe

Aletlerin, silahların ve zırhların kırılmadan önce seni uyarır.

Ne yapar

• Ana elindeki eşyayı, diğer elindeki eşyayı ve giydiğin zırhı (kask, göğüslük, pantolon ve botlar; elitra da) izler. Envanterin geri kalanına ve başka oyunculara hiç bakmaz; sunucuya hiçbir şey göndermez.
• Minecraft'ın kendi dayanıklılık değerlerini kullanır. Hasar alamayan, kırılmaz (Unbreakable) ya da dayanıklılığı olmayan eşyalar yok sayılır.
• Bir eşyanın kalan dayanıklılığı uyarı düzeyine (varsayılan %10) inince ekranın altında bir kart çıkar: eşyanın gerçek ikonu (dayanıklılık çubuğuyla), adı, kalan yüzde ve kalan kullanım, örneğin %10 kaldı · 25/250, ve eşyanın kendi dayanıklılık renginde bir çubuk.
• Zaten düşük olan bir eşyayı eline almak ya da giymek de uyarır; eşya yarım saniye elinde ya da yuvasında kalınca. Hotbar'da hızla gezinmek uyarmaz.

Uyarı yağmuru yok

• Düşük kalan bir eşya, ne kadar kullanırsan kullan yeniden uyarmaz.
• Onarımdan sonra bir sonraki iniş yeniden uyarır: örste ya da Mending'le uyarı düzeyinin güvenle (5 puan) üstüne çıkınca. Eşyayı düzeyin hemen üstünde tutan küçük onarımlar yeni uyarı getirmez.
• Aynı düşük eşyayı bir dakika içinde yeniden almak tekrar uyarmaz.
• Birkaç eşya aynı anda düşerse sırayla gösterilir (önce eller, sonra baştan ayağa zırh); kart sırada kaç uyarı beklediğini gösterir, örneğin +2.
• Eşya kullanılırken aynı eşya sayılır: arbaleti doldurup atmak ya da bir sunucu eklentisinin eşyaya yazdığı veri yeni uyarı getirmez.
• Kırılan eşya unutulur: yerine aldığın eşya kendi durumuna göre uyarır.
• Dünyadan ya da sunucudan çıkınca her şey unutulur. Aynı dünyada boyut değiştirmek unutturmaz.

Ses

Uyarıyla birlikte kısa bir nota çalar: Minecraft'ın kendi nota bloğu sesi (ek ses dosyası yok), Ana Ses düzeyinde. Birkaç eşya aynı anda düşse de bir kez çalar, sırada bekleyen kartlar için yeniden çalmaz. Kapatılabilir; kartlar yine çıkar.

Ekrana sığar

Kart alt ortada, aksiyon çubuğu yazısının üstünde ve nişangâhın altında durur; hiçbir zaman ekran dışına çizilmez. Sohbet ekranı açıkken kart sohbetin üstüne çizilmez. Sağ üstte vanilla bildirimlerinin ve TweakletMC Pickup Toast'un kullandığı sütundan ve TweakletMC Minimap'ten uzak durur. GUI ölçeği 1, 2 ve 3, 854×480 pencere ve "Unicode yazı tipini zorla" seçeneğiyle denendi.

Ayarlar (Mod Menu)

• Uyarılar açık ya da kapalı
• Ses açık ya da kapalı
• Uyarı eşiği: %5 – %50, %5'lik adımlarla (varsayılan %10); klavyede her ok tuşu bir adım
• Ana El, Diğer El ve Zırh ayrı ayrı kapatılabilir

Ayarlar config/tweaklet-durability.json dosyasına kaydedilir. Bozuk bir ayar dosyası oyunu çökertmez: varsayılanlar kullanılır ve bozuk dosya yedek olarak saklanır. Durability tuş ataması eklemez.

Gereksinimler

• Minecraft Java Edition 1.21.1
• Fabric Loader 0.16.0 veya daha yenisi
• Fabric API
• TweakletMC Core 0.2.0 veya daha yeni bir 0.2.x sürümü
• Java 21
• İsteğe bağlı: ayar ekranı için Mod Menu

Durability bir istemci modudur: sunucuya bir şey kurmak gerekmez. TweakletMC Pickup Toast, Waypoints, Minimap ya da World Map gerektirmez; onlarla birlikte çalışır.

Bilinen sınırlar

• Tamamen aynı olan (aynı tür, büyü, ad, onarım bedeli, zırh süsü, boya ve kalkan deseni) iki eşya aynı yuvada doğrudan yer değiştirirse tek eşya sayılır.
• TweakletMC Pickup Toast sol köşelerden birine alınmışsa, dar ekranlarda (480 GUI pikselinden dar; örneğin otomatik GUI ölçeğinde 1280×720) kart oradaki en alttaki toast'ların üstüne gelebilir. Pickup Toast'un varsayılan sağ üst köşesinde ve sağ alt köşede hiç gelmez.
• Çok kısa ekranlarda (240 GUI pikselinden kısa; örneğin "Unicode yazı tipini zorla" ile 1280×720) kart, aksiyon çubuğu yazısının ve elindeki eşyanın adının üstüne gelebilir.
• Ekranda son sohbet mesajları varken (her biri 10 saniye kalır), kart 4 saniyeliğine alttan dördüncü ve daha yukarıdaki sohbet satırlarının üstüne gelebilir; vanilla'nın aksiyon çubuğu yazısı ve eşya adı da öyle.
• Kart yaklaşık 4 saniye görünür; envanter ya da sohbet gibi bir ekran açıkken de.
• Diller: İngilizce ve Türkçe. Öteki dillerde İngilizce metin görünür.