Emotecraft Plugin – Paper/Bukkit İçin Emote Sistemi (Kurulum + Kullanım)

Emotecraft, Minecraft’a emote (oyuncu animasyonları) ekleyen popüler bir projedir. Oyunda hazır emote’ları kullanabilir, kendi emote’larını ekleyebilir ve uygun sunucu kurulumuyla emote’ları diğer oyuncularla senkron şekilde paylaşabilirsin.

Emotecraft Plugin Ne İşe Yarar? 🎭

• Emote tekeri: Oyun içinde emote seçip anında oynatmanı sağlar.
• Custom emote desteği: Kendi emote dosyalarını ekleyebilirsin.
• Sunucu senkronizasyonu: Emote’ların oyuncular arasında “paylaşım derdi olmadan” senkronlanmasını hedefler.
• Çapraz modloader uyumu: Örneğin Forge client ile Fabric server gibi farklı kurulum kombinasyonları çalışabilir.

Önemli Not: “Standalone Plugin” Değil ⚠️

Paper/Bukkit tarafındaki Emotecraft, tek başına “herkese emote gösteren” bir sistem değildir.
Emote’ları görmek/kullanmak için oyuncuların client tarafında Emotecraft kurulu olması gerekir.
Güzel tarafı: Sunucu, Emotecraft’sız oyuncuları genelde oyundan atmaz; sadece emote sistemi o oyuncularda aktif olmaz.

Özellikler (Kısa ve Net)

• Built-in emote’lar: Varsayılan emote’lar (ör. el sallama gibi) hazır gelir.
• Custom emote üretimi: Blender/Blockbench gibi araçlarla emote hazırlanabilir.
• Emote paylaşım portalı: Hazır emote’lar bulup indirebileceğin bir paylaşım alanı bulunur.

Kurulum ✅

A) Oyuncu (Client) Kurulumu

1. Emotecraft’ı oynadığın modloader’a göre indir (Fabric/Quilt/Forge/NeoForge).
2. Dosyayı .minecraft/mods klasörüne at.
3. Fabric kullanıyorsan ayrıca Fabric API ve PlayerAnimationLibrary gerektiğini unutma.
4. Oyunu yeniden başlat.

B) Sunucu (Paper/Bukkit) Kurulumu

1. Sunucuna uygun Emotecraft Bukkit/Paper sürümünü indir (dosya adında genelde “bukkit/paper” yazar).
2. Dosyayı {server}/plugins klasörüne koy.
3. Sunucuyu yeniden başlat.

Not: Paper tarafında güncel sürümlerde ekstra bir plugin gerekmeyebilir; ancak daha eski sürümlerde ProtocolLib gerekmiş olabilir.

Nasıl Kullanılır? 🎮

• B tuşu ile emote seçim tekerini aç.
• Custom emote eklemek için emote dosyalarını .minecraft/emotes klasörüne koy.
• İstersen modun ayar ekranından “Open emotes folder” ile klasörü hızlıca açabilirsin.

Komutlar ve Yetkiler (Sunucu Sahipleri İçin) 🛠️

Client Komutları

• /emotes-client play <emote> — emote oynat
• /emotes-client stop — emote durdur

Sunucu Komutları

• /emotes play <emote> <player> <forced> — seçili oyuncuya emote oynat
• /emotes stop <player> — oyuncunun emote’unu durdur
• /emotes reload — emote’ları yeniden yükle

Permission Örnekleri

• emotes.play.player
• emotes.stop.player
• emotes.stop.forced
• emotes.play.showhidden
• emotes.reload

Komut odaklı yönetim istiyorsan ayrıca “Command Extension” paketine de ihtiyaç duyabilirsin.

Geyser (Bedrock) Kullanıyorsan: Geyser Extension 🌍

Geyser Extension ile Geyser sunucularında Java ↔ Bedrock emote görünürlüğü hedeflenir:

• Bedrock → Java: stabil
• Java → Bedrock: deneysel (bazı durumlarda sorunlu olabilir)

Bedrock’a özel yardımcı komutlar:

• /emotes-geyser list — kullanılabilir emote listesini gösterir
• /emotes-geyser fix-geometry — model/bükülme (bends) görüntü sorunlarını düzeltmeye yardımcı olur

Sık Sorunlar ve Çözümler

1) Emote tekeri açılmıyor

• Tuş çakışması olabilir: Kontrollerden “Emote Wheel” tuşunu kontrol et.
• Vanilla sunucudasın: Emotecraft kurulu olsa bile bazı sunucularda sistem aktif olmayabilir.

2) Ben emote yapıyorum ama kimse görmüyor

• Sunucuda plugin/mod kurulu mu kontrol et.
• Diğer oyuncularda Emotecraft client kurulu değilse emote’ları görmeyebilirler.

3) Paper’da çalışmıyor gibi

• İndirdiğin dosya sürümü sunucunun Minecraft sürümüyle uyumlu olmalı.
• Eski sürümlerde ProtocolLib gerekebildiği için (özellikle eski kurulumlarda) bunu da test edebilirsin.

Emotecraft, roleplay ve sosyal sunucular için harika bir “ifade” sistemi ekler.

En iyi deneyim için: oyuncular client modunu kurar ve sunucu tarafında (Paper ise plugin, modlu sunucu ise mod sürümü) doğru paket kullanılır.