Rehber

Minecraft ekonomi plugin'i nasıl yapılır

18 Ekim 2026 güncellendi

Bir ekonomi plugin'i her oyuncunun bakiyesini tutar ve oyuncuların birbirine ödeme yapmasını, para kazanmasını ve bunu mağazalarda harcamasını sağlar. Önemli olan komutlar değil, Vault bağlantısıdır: mağaza, meslek ve açık artırma plugin'lerinin senin paranı kullanmasını sağlayan odur. Bu rehber tasarımı, depolamayı ve nasıl derleyip test edeceğini anlatır.

Bu örnekten başla ve kuralları kendine göre değiştir.

Bunu Codexe ile oluştur

Adım adım

  1. 1.Plugin'in ne olacağına karar ver

    Ya ekonominin kendisidir (bakiyeleri saklar ve kendini Vault ekonomisi olarak kaydeder) ya da var olan bir ekonomiyi Vault üzerinden kullanır (bir mağaza, ödül avı, bir meslek plugin'i). Çoğu sunucunun iki ekonomiye değil, her birinden birine ihtiyacı vardır.

  2. 2.Sunucuyu ve sürümü seç

    Sunucu yazılımını ve sürümünü yaz, örneğin Paper 1.21.4. Plugin o sürümün API'si ve Java düzeyi için derlenir.

  3. 3.Komutları ve kuralları listele

    /balance, /pay <player> <amount>, /baltop ve /eco give|take|set gibi yönetici komutları. Başlangıç bakiyesini, para biriminin adını, ondalık basamakları ve en düşük ödeme tutarını ekle.

  4. 4.Bakiyelerin nereye kaydedileceğini seç

    Tek sunucu için SQLite, birden fazla sunucu aynı bakiyeleri paylaşacaksa MySQL. Para yeniden başlatmalardan ve çökmelerden sağ çıkmalıdır, bu yüzden asla yalnızca bellekte tutulmaz.

  5. 5.Codexe yazsın ve derlesin

    Plugin'i anlat ve bağımlılık olarak eklenmesi için Vault'u açıkça belirt. Codexe Java kodunu, plugin.yml ve config.yml dosyalarını yazar, derler ve proje Hazır olmadan önce derleme hatalarını düzeltir.

  6. 6.Ödemeleri oyunda test et

    Hemen dene'ye bas ve test sunucusuna katıl. İki hesap arasında ödeme yap, çok büyük, negatif veya sayı olmayan tutarları dene, sonra yeniden başlat ve bakiyelerin hâlâ yerinde olduğunu kontrol et.

  7. 7.Kur

    Vault'u ve .jar dosyanı sunucunun plugins/ klasörüne koy ve yeniden başlat. Diğer ekonomi plugin'lerini kaldır ya da Vault'un hangisini kullanacağına karar ver.

Vault'un yeri

Vault bir ekonomi değil, bir köprüdür. Bir ekonomi plugin'i Vault'un Economy arayüzünü uygular ve onu sunucunun servis yöneticisine kaydeder; diğer plugin'ler onu getServer().getServicesManager().getRegistration(Economy.class) ile ister ve getBalance, withdrawPlayer ve depositPlayer gibi metotları çağırır.

Böylece bir mağaza plugin'inin hangi ekonomiyi çalıştırdığını bilmesi hiç gerekmez. Plugin onsuz çalışamıyorsa plugin.yml içinde depend: [Vault], Vault isteğe bağlıysa softdepend kullan. Vault API'si yalnızca derlemek için gerekir; Vault'un kendisi sunucuya kurulur.

İstekte yazılacak kararlar

  • Para biçimi: para biriminin tekil ve çoğul adı, simgesi, kaç ondalık basamak.
  • Sınırlar: başlangıç bakiyesi, en yüksek bakiye, bakiyelerin eksiye düşüp düşemeyeceği.
  • Çevrimdışı oyuncular: /pay ve /eco komutlarının çevrimiçi olmayan oyuncular üzerinde çalışıp çalışmayacağı.
  • Kayıt tutma: yetkililerin anlaşmazlıkları kontrol edebilmesi için veritabanında veya bir dosyada işlem kaydı.
  • Para kazanma: mob öldürme, oyun süresi ödülleri, eşya satma veya yalnızca yönetici komutları.

Bakiyeler nereye kaydedilir

DepolamaUygun olduğu durumDikkat edilecekler
YAML dosyasıÇok küçük sunucular, okuması kolayÇok oyuncuyla yavaş, çökmede kolayca bozulur
SQLiteTek sunucu, kurulum gerekmezSunucular arasında paylaşılamaz
MySQL / MariaDBTek bakiyeyi paylaşan ağlarconfig.yml içinde bir veritabanı sunucusu ve giriş bilgileri gerekir

Örnek açıklama

"Kendini Vault ekonomisi olarak kaydeden, Coins adlı bir Paper 1.21.4 ekonomi plugin'i. /balance [player], en az 1 olan /pay <player> <amount>, ilk 10'u gösteren /baltop ve coins.admin yetkisi olan oyuncular için /eco give|take|set. Yeni oyuncular 100 coin ile başlar. İki ondalık basamak. Her ödeme tarih, gönderen, alıcı ve tutarla kaydedilir. Bakiyeler SQLite'ta saklanır. Para birimi adları ve tüm mesajlar config.yml içinde."

Başka bir şey istemediğinde Codexe varsayılan olarak SQLite kullanır. MySQL istersen plugin bir storage-type ayarıyla yazılır ve sen denerken test sunucusu ona kendine ait bir MySQL veritabanı verir.

Sorular

Vault'a ihtiyacım var mı?

Başka hiçbir şeyin kullanmadığı bağımsız bir ekonomi için hayır. Diğer plugin'ler (mağazalar, meslekler, açık artırmalar) bakiyeleri okumak veya değiştirmek zorunda kaldığı anda gerekir, çünkü aradıkları API odur.

EssentialsX ile birlikte çalıştırabilir miyim?

EssentialsX'in kendi ekonomisi vardır ve onu da Vault'a kaydeder. Aynı anda tek bir ekonomi çalıştır ya da istemediğini kapat; yoksa diğer plugin'ler komutlarının gösterdiğinden farklı bir bakiye kullanabilir.

Birden fazla sunucu aynı bakiyeleri paylaşabilir mi?

Evet, depolama olarak MySQL veya MariaDB ve her sunucunun config.yml dosyasında aynı veritabanı ile. Plugin'in bakiyeleri çok uzun süre önbellekte tutmak yerine veritabanından okuması için bunu istekte belirt.

Gerçek bir sunucu olmadan nasıl test ederim?

Hemen dene ile: senin sürümündeki özel bir Paper sunucusu derlenmiş plugin ile başlar ve depend ile softdepend içinde listelenen Vault gibi plugin'ler onun için kurulur. Free planda günde 10'ar dakikalık 3 test sunucusu var.

Sunucunun ekonomisini yap

Bu prompt göndermeye hazır açılır:

“Vault ekonomisi olarak kaydolan, Coins adlı bir Paper 1.21.4 ekonomi plugin'i: /balance, en az 1 olan /pay, ilk 10 için /baltop, coins.admin için /eco give|take|set, başlangıç bakiyesi 100, iki ondalık basamak, her ödeme kaydedilir, bakiyeler SQLite'ta, para birimi adları ve mesajlar config.yml içinde.”

Bunu Codexe ile oluştur
Minecraft ekonomi plugin'i nasıl yapılır (Vault, Paper) | Codexe