1.4 Dosya Yapısı

Dizin ağacı

plugins/AeroMine/
├── config/
│   └── config.yml
├── arenas/
│   ├── prison/
│   │   ├── arena.yml
│   │   └── mines/
│   │       ├── coal.yml
│   │       ├── iron.yml
│   │       └── diamond.yml
│   └── event/
│       ├── arena.yml
│       └── mines/
│           └── event.yml
├── data/
│   ├── players.yml
│   └── legacy/
└── langs/
    └── *.yml

config/config.yml

Eklentinin genel ayarlarını içerir. Belirli bir arenanın koordinatları veya mine'ın blok paleti burada tutulmaz. Böylece genel davranış değişirken arena verileri bağımsız kalır.

arenas/<arena>/arena.yml

Tek bir arenanın fiziksel ve davranışsal tanımıdır. Dünya, bölge köşeleri, spawn, arena modu ve blok üretim modu gibi arena kapsamındaki bilgiler burada bulunur.

Arena kimliği klasör adıyla ilişkilidir. Sunucu kapalı değilken klasörü elle yeniden adlandırmayın; mine bağlantıları ve oyuncu verileri eski kimliği kullanmaya devam edebilir.

arenas/<arena>/mines/<mine>.yml

Bir arenadaki her mine ayrı dosyadır. Bu tasarım büyük mine zincirlerini yönetmeyi ve yalnız değiştirilen mine dosyasını sürüm kontrolünde izlemeyi kolaylaştırır.

Mine silerken dosyayı doğrudan kaldırmak yerine yönetim komutunu kullanın. Ardından diğer mine dosyalarındaki sonraki mine bağlantılarını kontrol edin.

data/players.yml

Oyuncuların aktif mine ve ilerleme verilerini içerir. Bu dosya çalışma zamanında eklenti tarafından yönetilir.

• Sunucu açıkken elle düzenlemeyin.
• Düzenlemeden önce tam yedek alın.
• Oyuncu UUID değerlerini değiştirmeyin.
• Geri yükleme sırasında arena ve mine dosyalarının aynı sürümünü kullanın.

data/legacy/

Eski veri yapısından dönüştürülen veya geçiş sırasında korunan dosyalar için ayrılmıştır. Geçişin başarılı olduğundan emin olmadan bu klasörü silmeyin. Birkaç başlatma ve oyuncu ilerleme testi sonrasında bile sunucu yedeğinde saklamak sorun çözmeyi kolaylaştırır.

langs/*.yml

Oyuncuya gösterilen mesajların dil dosyalarıdır. Renk kodu, MiniMessage biçimi veya placeholder kullanımı için kurulu dosyadaki örnekleri izleyin. Eksik mesaj anahtarları sürüm güncellemelerinde varsayılan metin kullanımına veya boş mesaja neden olabilir.

Sürüm kontrolü ve yedek

Arena ve genel yapılandırmalarını özel bir Git deposunda izleyebilirsiniz; ancak oyuncu verileri sık değiştiği için data/players.yml genellikle düzenli yedek sistemine daha uygundur. Her durumda özel sunucu verilerini herkese açık depoya göndermeyin.