A comprehensive protection and utility system for Minecraft servers. This plugin includes blockers, disablers, and general utilities to increase control, security, and performance.

✅ Fully configurable via config.yml ✅ Supports Minecraft 1.8.9 to 1.21.4 ✅ Includes permission-based overrides ✅ Modular loading system with isolated config directories ✅ Automatic registration of utility modules via package scanning

ℹ️ Recent Updates
♻️ Modular System with Auto-loading

• Introduced ModuleLoader class that loads configuration files per-module from /modules/{name}/config.yml.
  
  
• Modules now support README generation and config fallback.
  
  
• Added getConfig(String module, String configName) and hasModule(...), hasConfig(...) utilities.
  

Utility Module Auto-registration

• Added loadUtilityModules(String basePackage) method (with Kotlin + Java compatibility).
  
  
• Scans all classes (even in subpackages) inside com.br.gabrielmartins.syntri.utils
  
  
• Automatically instantiates and registers any class implementing Registrable
  
  
• Supports both no-args constructors and constructors with (Plugin plugin) parameter
  
  
• Utility modules like EnderPearlCooldown, InfiniteAnvil, and SpawnOnJoin can now self-register seamlessly
  

Improved Plugin Compatibility

• Full compatibility with Kotlin reflection and Java Class API
  
  
• Handles utility modules with Plugin constructor via:
  
  clazz.getDeclaredConstructor(Plugin::class.java).newInstance(plugin)
• Fallbacks to no-arg constructors if needed
  
  
• Supports abstract and interface filtering by default
  

Unified General Config

• Moved all blocker, disabler, and utility settings to modules/general/config.yml
  
  
• Cleaner organization, no longer split across random plugin paths
  

✅ Permissions Refactor

• All permissions standardized to syntri.* format (e.g., syntri.bypass.shiftemcontainer, syntri.spawn.vip)
  
  
• Updated documentation accordingly
  

Documentation Enhancements

• This README now includes:
  
  • Feature-by-feature explanation
    
    
  • ✅ Required permission for each module
    
    
  • Clear summary table at the end
    

⚙️ Reflections Integration

• Using Reflections to dynamically load all modules and utility logic
  
  
• No need to manually register utility listeners anymore
  

Credit

• Many of the core features and original inspiration were based on the open-source work by Rush
  

### **Fixes & Improvements**
- ** ScoreboardManager**
- Fixed issue where scoreboards wouldn't load on version 1.8.9.
- Added fallback for `<gradient>` tags in older versions (v1_8_R3 and below).
- Display name now respects the 32-character limit including color codes.
- Scoreboard now persists correctly per player.

- ** PlaceholderAPI**
- Fixed placeholder registration (`register()` is now used properly).
- Placeholders like `%syntri_online%` now work correctly.

- ** Kit System**
- Fixed `NullPointerException` when loading items with null Material.
- Updated `serializeItem` and `deserializeItem` methods to support all versions from 1.8.9 to 1.20.4.
- Gracefully handles corrupted or invalid Base64 data.

- ** General**
- Improved error handling and logging.
- More stable module structure for future updates.

---

### ⚠️ Requirements
- PlaceholderAPI installed.
- Vault + Economy plugin (EssentialsX recommended).
- Supported Versions: `1.8.9` to `1.20.4`.

This update brings major structural improvements and powerful new features to the Syntri plugin!

What’s New?
✅ Translation System Replaced with messages.yml

• All plugin messages are now centralized in /plugins/Syntri/messages.yml
  
  
• Full support for:
  
  • ✅ Color codes using &
    
    
  • ✅ Multiline messages (List<String>)
    
    
  • ✅ Dynamic placeholders like %player%, %balance%, %time%, etc.
    
• Auto-creates the file with default values if it doesn’t exist
  
  
• New MessagesManager system:
  mm.getMessage("key");
  mm.getMessageList("key");

• Cleaner and more modular codebase

Brand New Built-In Economy System!

• ✅ Fully Vault-compatible economy
  
  
• ✅ Optional and toggleable via config.yml
  
  
• ✅ Stored in your preferred database (MySQL, SQLite, etc.)
  
  
• ✅ Persistent balance per player
  
  
• ✅ Commands and APIs ready for /bal, /pay, and more
  
  
• ✅ Full support for placeholders: %balance%, %top_money%, etc.
  

Note: If the economy is disabled in config.yml, it won’t be initialized, avoiding conflicts with other plugins.


Fully Customizable Auto Messages
✅ Chat Messages with Click Support

auto-messages:
enabled: true
messages:
prefix: "&8[&b&lSyntri&8]"
interval: 300
texts:
- "<click:/kit>&aClick here to claim your kit</click>"
- "<click:https://discord.gg/ZgCF96j3>&bJoin our Discord!</click>"

title:
enabled: true
main: "&bWelcome to &lSyntri"
subtitle: "&7Enjoy your stay!"
interval: 600
fade-in: 10
stay: 60
fade-out: 10


Everything is editable in config.yml.


For Developers
If you used the old translation system:

java
// OLD
Translate.get("key");

Now use:

java
MessagesManager.getInstance().getMessage("key");
MessagesManager.getInstance().getMessageList("key");

✅ You can also inject your own custom placeholders via API.


Feedback or Suggestions?
Have questions, found a bug, or want to contribute?

• Open an issue on GitHub
  
  
• Or join our community on Discord:
  https://discord.gg/t6nNuPhSQE
  

Apresento a maior atualização até agora do Syntri — um sistema modular, moderno e altamente otimizado para servidores Minecraft, agora com suporte completo a Kotlin + Java, integração limpa com bancos de dados e gerenciamento dinâmico de eventos e comandos.

O que há de novo?
✅ Nova Estrutura Modular

• Divisão clara em submódulos: engine, syntri, version-api, version-1_8_9, version-1_20_4 e outros.
  
  
• Facilidade para manter, escalar e adaptar a diferentes versões do Minecraft.
  

✅ Suporte Oficial a Kotlin + Java

• Reescrito parcialmente em Kotlin para melhorar legibilidade e produtividade.
  
  
• Totalmente compatível com Java, mantendo integração estável com versões anteriores.
  

✅ Gerenciamento Avançado de Listeners

• Novo sistema de LoaderListener baseado em Reflections.
  
  
• Escaneia pacotes automaticamente, instanciando todos os Listeners (com ou sem construtores).
  
  
• Registra eventos dinamicamente, evitando registros manuais extensos.
  

✅ Registro Automático de Comandos

• Comandos anotados com @CommandInfo agora são carregados via reflexão.
  
  
• Redução drástica de boilerplate.
  
  
• Feedback em tempo real se nenhum comando for encontrado.
  

✅ ⏱️ Sistema de Cooldown Renovado

• ActionBars com fallback automático para versões legadas.
  
  
• Mensagens dinâmicas com contagem regressiva real para o jogador.
  
  
• Compatibilidade inteligente com diferentes versões do Minecraft.
  

✅ ️ Backend Flexível com Suporte a Múltiplos Bancos

• Suporte plugável para:
  
  • MySQL
    
    
  • PostgreSQL
    
    
  • MariaDB
    
    
  • Oracle
    
    
  • SQL Server
    
    
  • Firebird
    
    
  • SQLite
    
    
  • MongoDB
    
• Auto-configurável via backend.yml.
  

✅ Correções Críticas

• Corrigido erro NoClassDefFoundError causado por dependências não incluídas no .jar.
  
  
• Corrigido erro NullPointerException no onEnable ao inicializar listenerLoad.
  
  
• Adicionado api-version no plugin.yml para evitar warnings em servidores modernos.
  

Compatibilidade

• Testado em Paper/Purpur 1.8.8 até 1.20.4
  
  
• Base modular pronta para expansões de versão futuras
  

Feedback
Se você encontrar bugs, sugestões ou quiser contribuir, sinta-se livre para abrir uma issue ou me mandar mensagem!

Novidades:

• ✅ Suporte oficial a MongoDB (Atlas incluído)
  
  
• Novo sistema de /warp e /setwarp com persistência em banco
  
  
• Autenticação segura via URI configurável
  
  
• Estrutura modular — ative e desative recursos facilmente
  

Próximas features:

• Integração com Vault (economia)
  
  
• Painel Web de gerenciamento
  
  
• Mais suporte a PlaceholderAPI
  

Syntri é o plugin essencial para quem busca estabilidade, organização e flexibilidade em um só lugar.