MySQLPlayerBridge v3.7.6 – Veritabanı Senkronizasyon Eklentisi

MySQL kullanan Minecraft sunucuları için modern oyuncu veri senkronizasyonu. Güncel Paper/Bukkit ve Folia sunucuları için modüler senkronizasyon ve admin araçlarıyla geliştirildi. Tek bir veritabanının tek doğruluk kaynağı (source of truth) olması gereken çoklu sunucu kurulumları için tasarlanmıştır.

Öne Çıkanlar

• Folia ve Bukkit/Paper Uyumlu: Asenkron öncelikli (async-first) mimari.
• Modül Tabanlı Senkronizasyon: Sadece ihtiyacınız olan özellikleri aktif edin.
• Admin Düzenleme Araçları: Envanterler için GUI düzenleyiciler de dahil olmak üzere, oyuncu verilerini doğrudan veritabanında inceleyin ve değiştirin.
• Hata Korumalı Günlükleme (Fail-safe logging): Sorun giderme ve veri kurtarma için yerel hata anlık görüntüleri (snapshots).
• Giriş Engelleme Koruması (No-entry protection): Yanlış sunucudan veri yazarak mevcut verinin üzerine yazılmasını engeller.

Özellikler

• Ortak bir MySQL veritabanı ile sunucular arası senkronizasyon. İzolasyon ve güvenlik için her modül kendi tablosunu kullanır.
• Seçilebilir modüller (yalnızca istediklerinizi aktif edin):
  • Inventory
  • Offhand
  • Ender Chest
  • Armor
  • Location
  • Gamemode
  • Experience
  • Health
  • Saturation
  • Economy (Vault)
  • Potion Effects
  • Advancements
  • Statistics
  • Hotbar slot selection
• İşlemler ve veri kurtarma için Admin komutları:
  • /mpb sync – Manuel senkronizasyon
  • /mpb clear – Oyuncu verisini temizleme
  • /mpb edit – Oyuncu verilerini düzenleme (GUI envanter düzenleyicileri ve doğrudan sayısal düzenlemeleri içerir)
• Periyodik kaydetme için otomatik senkronizasyon görevi (auto-sync).
• Yapılandırılmış loglar ve veri yedekleri ile gelişmiş hata yönetimi (eklenti klasörü altında saklanır).

MySQL Kurulumu (Yerel Sunucu)

Minimum yetkilere sahip bir veritabanı ve kullanıcı oluşturun. Yerel bir MySQL sunucusu için örnek:

SQL

CREATE DATABASE mpb;
CREATE USER 'mpb_user'@'%' IDENTIFIED BY 'your_password';
GRANT ALL PRIVILEGES ON mpb.* TO 'mpb_user'@'%';
FLUSH PRIVILEGES;

Ardından mysql.yml dosyasını düzenleyin:

YAML

host: "127.0.0.1"
port: 3306
database: "mpb"
user: "mpb_user"
password: "your_password"
main-table-name: "player_data"

Admin Düzenleme Özelliği

Düzenleme sistemi gerçek zamanlı sunucu yönetimi için tasarlanmıştır:

• Desteklenen tüm modül değerlerini doğrudan veritabanında düzenleyin.
• Inventory, armor, ender chest ve offhand GUI üzerinden düzenlenir.
• Sayısal alanlar kaydedilmeden önce girdiyi doğrular.
• Çevrimdışı (offline) oyuncular veritabanı kayıtları kullanılarak düzenlenebilir.

Örnekler:

• /mpb edit <player> inventory
• /mpb edit <player> offhand
• /mpb edit <player> location <world> <x> <y> <z> [yaw] [pitch]
• /mpb edit <player> exp <value>
• /mpb edit <player> exp_level <value>

Gereksinimler

• MySQL veya MariaDB
• Java 21
• NBTAPI (Inventory serialization için gereklidir)
• Vault (İsteğe bağlı, economy senkronizasyonu için)

Diller

Yerleşik çeviriler:

• İngilizce
• Almanca