TownyUtils RENEWED

🌐 Client-side Diplomacy Management Mod For Towny

TownyUtils is a hitbox coloring mod designed to maximize players' situational awareness in chaotic SiegeWar environments.

This mod is designed especially for players who struggle to tell who they are hitting in extremely crowded SiegeWar environments and who cannot get maximum efficiency or enjoyment out of SiegeWars. TownyUtils is not a cheat mod; it is a QoL mod that reduces visual clutter.

⚙️ Core Architecture

TownyUtils is built on two main background data-processing engines:

1. Command Parsing

• The client listens in real time to the outputs of /n online, /n allylist, /n enemylist sent by the server, as well as to scoreboard data.

2. Nametag Reader

• By reading TextDisplayEntity and Nametag data, it detects players’ nations before they are rendered and classifies them as friendly or enemy.

🛠️ Usage & Configuration

After downloading and installing TownyUtils, you additionally need to install Mod Menu to manage TownyUtils. You can open the TownyUtils menu on any server either by searching for TownyUtils in Mod Menu or by pressing the Insert key.

• Mod Status – Allows you to enable or disable the mod’s two data-processing engines.
• Hitboxes – Lets you toggle TownyUtils’ colored hitboxes based on ally–enemy diplomacy.
• Name Tags – Disables nametags, which are the main FPS killer on bad GPUs in Towny sieges, and helps you see more clearly in chaotic environments.
• Auto Setup Wizard – Automatically classifies your current nation’s enemies and allies as hostile or friendly.
• Start Manual Detection – Automatically activates the primary data-processing engine (Command Parsing).
• Detection – Lets you choose which data-processing engine to use for detection.
• Auto Setup Target – If you go to help an allied nation instead of your own, this sets the target nation for the Auto Setup Wizard so you can define its enemies and allies.

🕵️ Data Privacy

Why is data collected?

In TownyUtils, the data-processing engine with the highest accuracy and compatibility across servers is the command-parsing engine that parses Towny commands. This engine may work incorrectly or not work at all due to the different formats and languages used by each Towny server. For this reason, only the outputs of the commands /n online, /n allylist, and /n enemylist from the command-parsing engine that you start automatically or manually are sent to us. This helps us improve the mod’s cross-server compatibility.

⚠️ PRIVACY GUARANTEE

❌ No Personal Data: Your chat logs, passwords, or private messages are NEVER accessed or collected.

✅ Command Output Only: Only the structure of towny commands is analyzed for compatibility.

Your data sharing preference can be toggled ON/OFF at any time in the settings. Your data is never shared with third parties. Data is transmitted to a private endpoint controlled by the developer. The endpoint URL is not public. During command parsing, messages within a short capture window may be transmitted to ensure compatibility across servers with different formats.

📜 Disclaimer & FAQ

All Rights Reserved. Unauthorized use of the source code, reverse engineering, or redistribution is prohibited.

❓ Does this mod provide an unfair advantage?

No. This mod is a client-side visual enhancement tool (QoL). It does not send packets or transmit any unauthorized data to the server.

This mod is not designed to provide an unfair advantage; on the contrary, it is designed to maximize competitiveness and enjoyment in SiegeWars.

❓ Why doesn’t the Nametag Reader work?

The secondary data-processing engine, the Nametag Reader, has a very low success rate and is not guaranteed to work on every server. This is because nametags are restructured differently on each server, and in some cases they may not even include nation names. However, on servers where it does work, both data-processing engines run successfully, so there are no delays in diplomacy detection and updates.

❓ Why doesn’t the mod work on the server I play on?

Since the mod has so far been tested only on Turkish servers, it is not guaranteed to work on servers with different language formats. In general, the primary data engine has worked successfully on all Turkish servers I tested. Likewise, it has also worked on foreign geopolitical servers such as EarthMC. However, it is not guaranteed to work on every foreign server.

TÜRKÇE

TownyUtils RENEWED

🌐 Towny İçin İstemci Taraflı Diplomasi Yönetim Modu

TownyUtils, kaotik SiegeWar ortamlarında oyuncuların durumsal farkındalığını en üst düzeye çıkarmak için tasarlanmış bir vuruş kutusu (hitbox) renklendirme modudur.

Bu mod, özellikle aşırı kalabalık SiegeWar ortamlarında kime vurduğunu ayırt etmekte zorlanan, SiegeWar savaşlarından maksimum verim veya keyif alamayan oyuncular için tasarlanmıştır. TownyUtils bir hile modu değildir; görsel karmaşayı azaltan bir Yaşam Kalitesi (QoL) modudur.

⚙️ Çekirdek Mimarisi

TownyUtils, arka planda çalışan iki ana veri işleme motoru üzerine kurulmuştur:

1. Komut Ayrıştırma (Command Parsing)

• İstemci; sunucu tarafından gönderilen /n online, /n allylist, /n enemylist çıktılarının yanı sıra skor tablosu (scoreboard) verilerini de gerçek zamanlı olarak dinler.

2. İsim Etiketi Okuyucu (Nametag Reader)

• TextDisplayEntity ve Nametag verilerini okuyarak, oyuncuların uluslarını onlar henüz renderlanmadan algılar ve onları dost veya düşman olarak sınıflandırır.

🛠️ Kullanım & Yapılandırma

TownyUtils'i indirip kurduktan sonra, TownyUtils'i yönetebilmek için ek olarak Mod Menu modunu kurmanız gerekir. TownyUtils menüsünü herhangi bir sunucudayken Mod Menu içinde TownyUtils'i aratarak veya Insert tuşuna basarak açabilirsiniz.

• Mod Status (Mod Durumu) – Modun iki veri işleme motorunu etkinleştirmenizi veya devre dışı bırakmanızı sağlar.
• Hitboxes (Vuruş Kutuları) – Müttefik-düşman diplomasisine dayalı olarak TownyUtils'in renkli vuruş kutularını açıp kapatmanızı sağlar.
• Name Tags (İsim Etiketleri) – Towny kuşatmalarında kötü ekran kartlarında ana FPS düşürücü olan isim etiketlerini devre dışı bırakır ve kaotik ortamlarda daha net görmenize yardımcı olur.
• Auto Setup Wizard (Otomatik Kurulum Sihirbazı) – Mevcut ulusunuzun düşmanlarını ve müttefiklerini otomatik olarak düşman veya dost olarak sınıflandırır.
• Start Manual Detection (Manuel Tespiti Başlat) – Birincil veri işleme motorunu (Komut Ayrıştırma) otomatik olarak etkinleştirir.
• Detection (Tespit) – Algılama için hangi veri işleme motorunun kullanılacağını seçmenizi sağlar.
• Auto Setup Target (Otomatik Kurulum Hedefi) – Kendi ulusunuz yerine müttefik bir ulusa yardıma giderseniz, bu seçenek Otomatik Kurulum Sihirbazı için hedef ulusu ayarlamanızı sağlar, böylece o ulusun düşmanlarını ve müttefiklerini tanımlayabilirsiniz.

🕵️ Veri Gizliliği

Veriler neden toplanıyor?

TownyUtils içinde, sunucular arasında en yüksek doğruluğa ve uyumluluğa sahip veri işleme motoru, Towny komutlarını ayrıştıran komut ayrıştırma motorudur. Bu motor, her Towny sunucusunun kullandığı farklı formatlar ve diller nedeniyle hatalı çalışabilir veya hiç çalışmayabilir. Bu nedenle, otomatik veya manuel olarak başlattığınız komut ayrıştırma motorundan gelen yalnızca /n online, /n allylist ve /n enemylist komutlarının çıktıları bize gönderilir. Bu, modun sunucular arası uyumluluğunu geliştirmemize yardımcı olur.

⚠️ GİZLİLİK GARANTİSİ

❌ Kişisel Veri Yok: Sohbet kayıtlarınıza, şifrelerinize veya özel mesajlarınıza ASLA erişilmez veya bunlar toplanmaz.

✅ Sadece Komut Çıktısı: Uyumluluk sağlamak amacıyla yalnızca towny komutlarının yapısı analiz edilir.

Veri paylaşımı tercihiniz ayarlardan istediğiniz zaman AÇIK/KAPALI (ON/OFF) olarak değiştirilebilir. Verileriniz 3. taraflarla paylaşılmaz. Veriler, geliştiriciye ait özel bir uç noktaya gönderilir. Uç nokta adresi herkese açık değildir. Farklı sunucu formatları nedeniyle, kısa bir yakalama penceresi içindeki mesajlar uyumluluk için iletilebilir.

📜 Yasal Uyarı & SSS

Tüm Hakları Saklıdır. Kaynak kodunun izinsiz kullanımı, tersine mühendislik işlemi veya yeniden dağıtımı yasaktır.

❓ Bu mod haksız avantaj sağlıyor mu?

Hayır. Bu mod, istemci taraflı bir görsel iyileştirme aracıdır (QoL). Sunucuya paket göndermez veya herhangi bir yetkisiz veri iletmez.

Bu mod haksız avantaj sağlamak için değil; aksine SiegeWar savaşlarında rekabeti ve keyfi en üst düzeye çıkarmak için tasarlanmıştır.

❓ İsim Etiketi Okuyucu (Nametag Reader) neden çalışmıyor?

İkincil veri işleme motoru olan İsim Etiketi Okuyucu, çok düşük bir başarı oranına sahiptir ve her sunucuda çalışması garanti edilmez. Bunun nedeni, isim etiketlerinin her sunucuda farklı şekilde yapılandırılması ve bazı durumlarda ulus isimlerini bile içermemesidir. Ancak çalıştığı sunucularda, her iki veri işleme motoru da başarılı bir şekilde çalışır, böylece diplomasi algılamasında ve güncellemelerinde gecikme yaşanmaz.

❓ Mod neden oynadığım sunucuda çalışmıyor?

Mod şimdiye kadar sadece Türk sunucularında test edildiğinden, farklı dil formatlarına sahip sunucularda çalışacağı garanti edilmez. Genel olarak birincil veri motoru, test ettiğim tüm Türk sunucularında başarılı bir şekilde çalışmıştır. Aynı şekilde, EarthMC gibi yabancı jeopolitik sunucularda da çalışmıştır. Ancak, her yabancı sunucuda çalışacağının garantisi yoktur.