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.
- Version:
2026.07.27.1 - Paper API target:
1.21.8 - Java toolchain:
21, Java bytecode target:21 - 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
The active language is selected in config.yml:
language: en_USLanguage 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: 1048576Update 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: trueThis 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.
/mb reload validates every configured block before replacing the running registry. Missing worlds or malformed block entries reject the reload and preserve the previous live state. Reload teardown never replaces mine blocks with air, and active health/cooldown data is persisted before the registry is detached.
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. FancyHolograms 2.x (de.oliver) and the 2026 API (com.fancyinnovations) are detected independently. Provider registration now owns visibility, creation is performed exactly once, repeated updates are coalesced, and delete operations are idempotent. Intentional blank spacer lines and configured yaw, pitch, and billboard values are preserved across load and reload.
Provider adapters receive resolved components instead of raw placeholder templates. Hologram formatting and size limits are read from options.hologram-text, applied during validation and runtime rendering, and use a visual-only MiniMessage tag allowlist. The shaded artifact bundles current Adventure 4.x API, Bukkit audiences, MiniMessage, and both legacy/plain serializers; check fails if a required relocated entry point is absent.
Display-based holograms can be configured per block with hologram.billboard and hologram.rotation.yaw/pitch, or changed at runtime with /mb hologram billboard and /mb hologram rotation.
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.
.\gradlew.bat clean check --no-daemonOutput:
build/libs/MineBlocks-2026.07.27.1.jar
This fork preserves the original project license. See LICENSE.
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.
- Sürüm:
2026.07.27.1 - Paper API hedefi:
1.21.8 - Java toolchain:
21, Java bytecode hedefi:21 - 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
Aktif dil config.yml içinden seçilir:
language: en_USDil 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: 1048576Gü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: trueBu 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.
/mb reload, çalışan registry'yi değiştirmeden önce yapılandırılmış bütün blokları doğrular. Eksik dünya veya hatalı blok kaydı reload işlemini reddeder ve önceki canlı durumu korur. Reload kapanış akışı mine blockları havaya çevirmez; aktif sağlık ve cooldown verisi registry ayrılmadan önce kalıcı olarak yazılır.
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. FancyHolograms 2.x (de.oliver) ve 2026 API'si (com.fancyinnovations) ayrı ayrı algılanır. Görünürlük artık sağlayıcı kaydıyla yönetilir, hologram yalnızca bir kez oluşturulur, tekrarlanan güncellemeler birleştirilir ve silme işlemleri idempotenttir. Bilerek bırakılan boş ayırıcı satırlar ile yapılandırılmış yaw, pitch ve billboard değerleri load ve reload sonrasında korunur.
Sağlayıcı adaptörleri ham placeholder şablonları yerine çözümlenmiş componentleri alır. Hologram biçimlendirme ve boyut sınırları options.hologram-text içinden okunur, doğrulama ve çalışma zamanı renderında uygulanır ve yalnızca görsel MiniMessage etiketlerine izin verilir. Shaded çıktı güncel Adventure 4.x API, Bukkit audiences, MiniMessage ile legacy/plain serializer modüllerini paketler; gerekli relocated giriş noktalarından biri eksikse check görevi buildi durdurur.
Display tabanlı hologramlar blok başına hologram.billboard ve hologram.rotation.yaw/pitch ile ayarlanabilir; runtime tarafında /mb hologram billboard ve /mb hologram rotation komutları kullanılabilir.
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.
.\gradlew.bat clean check --no-daemonÇıktı:
build/libs/MineBlocks-2026.07.27.1.jar
Bu fork orijinal proje lisansını korur. Ayrıntılar için LICENSE dosyasına bakın.