MineBlocks Plus

MineBlocks Plus is a maintained, security-hardened fork of MineBlocks for modern Paper/Folia servers. It lets administrators create configurable mine blocks, attach holograms, rate-limit block breaks, and reward players through controlled server commands.

Highlights

• Version: 2026.06.30.1
• Paper API target: 1.21.8
• Java toolchain: 21, Java bytecode target: 17
• Folia metadata: folia-supported: true
• Default language: en_US
• Bundled languages: en_US, tr_TR, es_ES, az_AZ
• Optional Floodgate/Geyser information forms for Bedrock players
• Hologram providers: FancyHolograms, DecentHolograms, CMI, or safe no-hologram fallback

Configuration

The active language is selected in config.yml:

language: en_US

Language files live in plugins/MineBlocks/lang/. Missing bundled entries are added automatically on load. Invalid bundled language files are backed up before being regenerated or normalized.

Runtime errors are written to plugins/MineBlocks/error.log. The file is rotated to error.log.1 when it reaches the configured limit:

options:
  error-log:
    max-size-bytes: 1048576

Update checks use the latest GitHub Release from siberanka/MineBlocks-plus. Admin notifications link to the release page, and the check can be disabled:

options:
  update-check:
    enabled: true

Safety Notes

This fork adds fail-safe GUI cancellation, stale menu closing, atomic config/storage writes, safer offline reward persistence, reward command payload filtering, block ID validation, break rate limiting, and Folia-aware scheduling for entity, region, global, and async work.

Floodgate/Geyser support is optional and reflection-based. If Floodgate is present, supported Bedrock players receive clean information forms for help, block lists, and hologram previews; otherwise the normal Java chat/GUI flow is used.

Hologram support is optional and reflection-guarded. MineBlocks prefers FancyHolograms, then DecentHolograms, then CMI. If none of them are installed or a provider API is unavailable, the plugin keeps running and simply skips live hologram spawning.

Reward commands are administrator-controlled config. Keep them simple, avoid commands that depend on unsafe third-party placeholders, and test reward flows on a staging server before production rollout.

Build

gradle test shadowJar --no-daemon

Output:

build/libs/MineBlocks-2026.06.30.1.jar

License

This fork preserves the original project license. See LICENSE.

---

MineBlocks Plus Türkçe

MineBlocks Plus, modern Paper/Folia sunucuları için güvenlik odaklı şekilde bakımı yapılan bir MineBlocks forkudur. Yöneticiler yapılandırılabilir mine block oluşturabilir, hologram bağlayabilir, blok kırma hızını sınırlayabilir ve kontrollü sunucu komutlarıyla oyunculara ödül verebilir.

Öne Çıkanlar

• Sürüm: 2026.06.30.1
• Paper API hedefi: 1.21.8
• Java toolchain: 21, Java bytecode hedefi: 17
• Folia metadata: folia-supported: true
• Varsayılan dil: en_US
• Paketle gelen diller: en_US, tr_TR, es_ES, az_AZ
• Bedrock oyuncular için opsiyonel Floodgate/Geyser bilgi formları
• Hologram sağlayıcıları: FancyHolograms, DecentHolograms, CMI veya güvenli hologramsız fallback

Yapılandırma

Aktif dil config.yml içinden seçilir:

language: en_US

Dil dosyaları plugins/MineBlocks/lang/ klasöründedir. Eksik bundled entryler yükleme sırasında otomatik eklenir. Bozuk bundled dil dosyaları önce yedeklenir, sonra yeniden oluşturulur veya normalize edilir.

Runtime hataları plugins/MineBlocks/error.log dosyasına yazılır. Dosya belirlenen limite ulaşınca error.log.1 olarak döndürülür:

options:
  error-log:
    max-size-bytes: 1048576

Güncelleme kontrolü siberanka/MineBlocks-plus reposundaki son GitHub Release üzerinden yapılır. Admin bildirimleri release sayfasına yönlendirir ve kontrol kapatılabilir:

options:
  update-check:
    enabled: true

Güvenlik Notları

Bu fork fail-safe GUI iptali, stale menü kapatma, atomic config/storage yazma, daha güvenli offline reward saklama, reward command payload filtreleme, blok ID doğrulama, kırma rate limit'i ve entity/region/global/async işler için Folia uyumlu scheduler katmanı ekler.

Floodgate/Geyser desteği opsiyoneldir ve reflection tabanlıdır. Floodgate varsa desteklenen Bedrock oyuncular yardım, blok listesi ve hologram önizleme gibi bilgi yüzeylerini temiz formlar olarak görür; yoksa normal Java chat/GUI akışı kullanılır.

Hologram desteği opsiyoneldir ve reflection guard ile korunur. MineBlocks önce FancyHolograms, sonra DecentHolograms, sonra CMI kullanır. Hiçbiri yoksa veya provider API erişilemezse eklenti çalışmaya devam eder, yalnızca canlı hologram oluşturmayı atlar.

Reward komutları yönetici kontrollü config verisidir. Komutları sade tutun, güvensiz üçüncü parti placeholder çıktısına bağımlı komutlardan kaçının ve production öncesi reward akışlarını staging sunucuda test edin.

Build

gradle test shadowJar --no-daemon

Çıktı:

build/libs/MineBlocks-2026.06.30.1.jar

Lisans

Bu fork orijinal proje lisansını korur. Ayrıntılar için LICENSE dosyasına bakın.