Rehber FancyHolograms Tam Rehberi — Hologram Oluşturma, Renklendirme ve Gelişmiş Ayarlar

✦ FancyHolograms Nedir?
FancyHolograms, Minecraft sunucularına hologram (havada asılı yazı, eşya veya blok) eklemenizi sağlayan hafif ve güçlü bir Paper & Folia eklentisidir. Minecraft'ın 1.19.4 ile gelen display entity sistemini kullandığı için sunucu üzerinde neredeyse sıfır performans yükü oluşturur. Hologramlar packet tabanlı çalışır; sunucu tarafında ekstra hesaplama gerekmez, veriler doğrudan oyuncunun istemcisine gönderilir.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━


▸ Gereksinimler

● Sunucu Yazılımı: Paper veya Folia (Purpur, Pufferfish gibi fork'lar da desteklenir)
● Minecraft Versiyonu: 1.21 veya üzeri
● Java Versiyonu: Java 21 veya üzeri
● Bağımlılık: Yok — opsiyonel olarak PlaceholderAPI kullanılabilir
⚠ Spigot ve Bukkit desteklenmez!

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━


▸ Kurulum

1. Modrinth, Hangar veya CurseForge'dan en güncel .jar dosyasını indirin.
2. İndirilen FancyHolograms-X.X.X.jar dosyasını sunucunuzun /plugins klasörüne atın.
3. Sunucuyu yeniden başlatın. Başka bir işlem gerekmez.
4. Kurulumu doğrulamak için oyun içinde şu komutu çalıştırın: /fancyholograms version

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━


▸ Temel Komutlar

Hologram Oluşturma:
/hologram create text hologramAdı

Metin Ekleme ve Düzenleme:
/hologram edit hologramAdı addLine <red>Merhaba!</red>
/hologram edit hologramAdı setLine 1 <gradient:blue:green>Sunucuya Hoş Geldin!</gradient>

Hologramı Taşıma:
/hologram edit hologramAdı moveHere
/hologram edit hologramAdı moveTo 100 64 200

Boyut ve Döndürme:
/hologram edit hologramAdı scale 1.5
/hologram edit hologramAdı rotate 45
/hologram edit hologramAdı billboard center

Kaldırma ve Kopyalama:
/hologram remove hologramAdı
/hologram copy hologramAdı yeniAd

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━


▸ Hologram Tipleri

● text — Çok satırlı metin hologramı. MiniMessage formatlama ile tam renk ve stil desteği.
● item — Herhangi bir oyun eşyasını hologram olarak gösterir. Animasyonlu döner.
● block — Bir blok modelini havada gösterir. Dekorasyon ve bilgi paneli için idealdir.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━


▸ MiniMessage Renk Kodları

Temel Renkler:
<red>Kırmızı</red> | <gold>Altın</gold> | <aqua>Açık Mavi</aqua> | <green>Yeşil</green> | <light_purple>Mor</light_purple>

Hex Renk Kodu:
<color:#FF4455>Özel Kırmızı</color>
<color:#00DDAA>Turkuaz</color>

Gradient (Renk Geçişi):
<gradient:red:gold>Ateş Yazısı</gradient>
<gradient:#5566FF:#AA44FF:#FF44AA>Galaxy Efekti</gradient>

Stil Etiketleri:
<bold>Kalın</bold> | <italic>İtalik</italic> | <underlined>Altı Çizili</underlined> | <strikethrough>Üstü Çizili</strikethrough>

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━


▸ PlaceholderAPI Entegrasyonu

PlaceholderAPI kuruluysa hologramlarda dinamik değişkenler kullanabilirsiniz. Oyuncu adı, para miktarı, sıralama bilgisi gibi her şey canlı gösterilebilir. MiniPlaceholders da desteklenir — placeholder çıktılarına MiniMessage formatlama uygulanabilir.

Örnek:
<gold><bold>En Zengin Oyuncular</bold></gold>
%vault_top_balance_1% — %vault_top_balance_player_1%

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━


▸ Görünürlük Ayarları

/hologram edit hologramAdı visibility ALL — Herkes görür
/hologram edit hologramAdı visibility MANUAL — Sadece seçilen oyuncular
/hologram edit hologramAdı visibility PERMISSION_NEEDED — Yetkisi olanlar
/hologram edit hologramAdı visibilityDistance 32 — Görüş mesafesi (-1 = varsayılan)

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━


▸ Önemli İpuçları

● Değişiklikleri kaydetmek için: /fancyholograms save
● Config'i yeniden yüklemek için: /fancyholograms reload
● DecentHolograms'tan geçiş için: /fancyholograms convert DecentHolograms *
● Tab tuşuyla komut tamamlama tam desteklenir — tüm argümanlar otomatik önerilir.
● Billboard modları: center (her yöne döner) | vertical | horizontal | fixed (sabit)

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

⬇ İNDİRME LİNKLERİ