Yapılandırma ve sorun giderme

config.yml yönetici düzenlemelerini korur. Eksik anahtarlar dosyayı yeniden yazmadan güncel varsayılanları kullanır; config.reference.yml ise tam başvuru olarak her başlangıçta yeniden oluşturulur. Migrate, eklentinin daha yeni bir sürümü tarafından oluşturulmuş yapılandırmayı reddeder.

Önemli ayarlar #

migration.confirmation-timeout-seconds: start ile confirm arasında izin verilen süre.
migration.dry-run-validity-minutes: bir deneme çalıştırması sonucunun geçerli kaldığı süre.
migration.max-records: bir planda kabul edilen en fazla kayıt sayısı.
performance.batch-size: tek bir grupta yazılan kayıt sayısı.
performance.pause-between-batches-ms: gruplar arasındaki duraklama; yoğun bir sunucuda artırın.
conflicts.defaults: her çakışma türü için varsayılan çözüm.
world-mappings ve currency-mappings: açık kaynaktan hedefe eşlemeler.
identity.create-missing-players: eksik HuskHomes kullanıcı satırlarının oluşturulmasına izin verir; varsayılan olarak kapalıdır.
connections.advancedban ve connections.litebans: açıkça yapılandırılmış MariaDB/MySQL bağlantıları.
compatibility.allow-unverified-versions: daha yeni, doğrulanmamış eklenti sürümlerinin daha sıkı deneme çalıştırmasına ulaşmasına izin verir; bunları engellemek için kapatın.

Migrate'in kendi durum veritabanı SQLite'tır. Alternatif durum veritabanı seçenekleri 1.0.0 için doğrulanmamıştır ve sunucuda ilgili JDBC sürücüsünün kurulu olmasını gerektirir.

Çakışma politikaları #

Deneme çalıştırması her çakışmayı ve uygulanacak politikayı gösterir. Güvenli varsayılanlar mevcut hedef kayıtları korur ve geçersiz veya desteklenmeyen verileri atlar. Rotaya uygun diğer politikalar arasında OVERWRITE, RENAME, KEEP_NEWEST, KEEP_OLDEST, MANUAL ve FAIL_MIGRATION bulunur.

text

/migrate conflicts MIG-20261008-0001
/migrate resolve MIG-20261008-0001 INVALID_WORLD SKIP
/migrate dryrun MIG-20261008-0001

Bir politikayı veya eşlemeyi değiştirdikten sonra deneme çalıştırmasını yeniden yapın.

Yedekler ve raporlar #

İlk yazmadan önce Migrate; normalize edilmiş verileri, hedefin önceki görüntülerini, izin verilen kaynak/hedef dosya kopyalarını, etkin yapılandırmayı ve SHA-256 sağlama toplamlarını plugins/Migrate/backups/<id>/ altına kaydeder. Yedekler asla otomatik silinmez.

Her taşıma plugins/Migrate/reports/ altına JSON, metin ve HTML raporları yazar; atlanan kayıtlar ayrıca bir CSV raporu alır. /migrate backups <id> saklanan sağlama toplamlarını doğrular.

Diller #

Migrate; İngilizce, Türkçe, Almanca, İspanyolca, Fransızca, Brezilya Portekizcesi, Lehçe, Rusça, Basitleştirilmiş Çince ve Japonca dillerini içerir. Birini /migrate language <locale> ile veya language.default ile seçin. Eksik mesaj anahtarları İngilizceye geri döner.

Sorun giderme #

Mesaj veya durum	Yapılacak
Deneme çalıştırması çok eski	`/migrate dryrun <id>` komutunu yeniden çalıştırın.
Hedef eklenti devre dışı olmalı	Hedef jar'ı kaldırın veya devre dışı bırakın, sunucuyu yeniden başlatın ve yeniden başlayın.
Sürüm doğrulanmamış	Deneme çalıştırması uyarılarını inceleyin; bu tür sürümler engellenecekse `compatibility.allow-unverified-versions` seçeneğini kapatın.
`connections.<plugin>` ayarlanmamış	O bağlantı bölümünü tamamlayın ve `/migrate reload` çalıştırın.
Başka bir taşıma hedefe yazıyor	Bitmesini bekleyin veya `/migrate history` komutunu inceleyin.
Yapılandırma yeniden yüklenmedi	Mesajda adı geçen geçersiz yolu düzeltin; önceki ayarlar etkin kalır.
Taşıma kesintiye uğradı	`/migrate inspect <id>` komutunu çalıştırın, ardından `resume` veya `rollback` seçin.

Destek için /migrate diagnostics, /migrate compatibility, /migrate adapters çıktılarını, taşımanın metin raporunu ve ilgili sunucu günlüğü satırlarını ekleyin. Paylaştığınız her şeyden parolaları ve sunucu adreslerini çıkarın.