Minecraft Eklentisi

WebStore eklentisi, sitenizle Minecraft sunucunuz arasındaki köprüdür. Oyuncu mağazadan bir ürün aldığında site teslimatı bir kuyruğa yazar; eklenti bu kuyruğu düzenli aralıklarla sorar, ürüne tanımlı komutları sunucuda çalıştırır ve sonucu siteye bildirir. Ayrıca sunucunun çevrimiçi durumunu, oyuncu sayısını ve TPS değerini siteye iletir.

Eklenti siteyi kendisi arar; sunucunuzda port açmanız ya da RCON kurmanız gerekmez.

Sunucu kaydı ve anahtarlar Mağaza → Katalog → Oyun Sunucuları sayfasındadır. Teslimatları Mağaza → Satışlar → Teslimat Kuyruğu sayfasından izlersiniz.

Rastgele Üret düğmeleri anahtarları sizin için üretir. Kayıttan sonra sayfa hazır bir config.yml bloğu gösterir; Config.yml Kopyala ile alın.

1. Sunucuyu panelde kaydedin

   Oyun Sunucuları sayfasında Yeni Sunucu Kaydet’e basın, adı ve Server ID’yi girin, Sunucu Oluştur & Key Üret’e basın. Kurulum sihirbazını kullandıysanız ilk sunucu zaten oluşturulmuştur.

2. Eklentiyi yükleyin

   WebStore.jar dosyasını Minecraft sunucunuzun plugins klasörüne koyun ve sunucuyu yeniden başlatın. Eklenti ilk açılışta plugins/WebStore/config.yml dosyasını oluşturur.

3. config.yml dosyasını doldurun

   Panelden kopyaladığınız bloğu dosyaya yapıştırın:

   api:
     url: "https://sunucum.com"
     server-id: "survival-1"
     api-key: "PANELDEN_ALDIGINIZ_KEY"
     secret-key: "PANELDEN_ALDIGINIZ_SECRET"
   
   delivery:
     interval-seconds: 5
   
   heartbeat:
     interval-seconds: 30
   
   debug: false

   delivery.interval-seconds eklentinin kuyruğu kaç saniyede bir sorduğunu, heartbeat.interval-seconds durum bilgisini kaç saniyede bir gönderdiğini belirler.

4. Ayarları yeniden yükleyin

   Oyunda ya da konsolda /webstore reload komutunu çalıştırın.

5. Bağlantıyı doğrulayın

   Oyun Sunucuları sayfasında sunucunun çevrimiçi göründüğünü, oyuncu sayısı ve TPS değerinin geldiğini kontrol edin. İsterseniz Web Konsolu sayfasındaki Bağlantı Testi ile eklentiyi sınayın.

Oyuncuya ne verileceğini ürünün komutları belirler. Mağaza → Katalog → Ürünler sayfasında ürünün Minecraft Konsol Komutları bölümüne her satıra bir komut yazarsınız. {player} oyuncunun Minecraft adıyla değiştirilir. Örnek:

lp user {player} parent set vip
eco give {player} 10000

Komutlar sırayla çalıştırılır. Ayrıntı için Ürünler sayfasına bakın.

• Eklenti yeni teslimatları sorar; site her teslimatı tek eklentiye verir, böylece aynı ürün iki kez teslim edilmez.
• Eklenti yanıt vermezse teslimat 2 dakika sonra kendiliğinden yeniden sıraya girer. Başarısız teslimatlar artan aralıklarla (1 dakikadan 6 saate kadar) otomatik yeniden denenir; 5 denemeden sonra yöneticiye bildirim düşer.
• Eklenti her komutun sonucunu bildirirse, teslimat yarıda kesildiğinde yalnızca çalışmamış komutlar tekrar gönderilir.
• Teslimat Kuyruğu sayfasında durum ve sunucuya göre süzebilir, sipariş numarası, oyuncu veya komuta göre arayabilir, başarısız teslimatları elle yeniden deneyebilirsiniz.

Aynı anahtarlarla eklenti, oyuncunun AuthMe ile oyunda kayıt olmasının ardından siteye hesap açtırabilir ve sohbette tek kullanımlık giriş bağlantısı verebilir; ceza kayıtları da aynı sunucu anahtarıyla siteye aktarılabilir. Dış araçlar için ayrıca sürümlü bir API vardır (bkz. API).