Lifesteal Plugin
A fully customizable, production-grade Minecraft plugin that implements a complete lifesteal system with hearts, bans, revives, MySQL support, advanced crafting recipes, and full admin control — designed for scalable SMP servers.
Список изменений
🧠 Architecture & Design
-
Centralized Utility APIs – MessageUtils, ColorUtils, ItemBuilder provide DRY, reusable patterns.
-
Singleton-safe plugin access – consistent use of getInstance() for global plugin reference.
-
Separation of concerns – clearly segmented managers (HeartManager, BanManager, etc.) avoid bloated main class.
-
Graceful failover & shutdown – plugin disables on fatal error; database and recipes properly closed.
-
Dynamic command delegation – uses executor-permission binding; fallback warnings for missing entries.
⚙️ Code Quality & Safety
-
Null safety added – guards against null messages, lists, strings, ItemMeta, etc.
-
Cloning of mutable objects – avoids returning internal ItemStack references directly.
-
Input validation – amount clamped (1–64), tier limited (1–5), keys checked.
-
Regex matching via Matcher.appendReplacement() – safe and efficient HEX color parsing.
-
Safe config fallback – missing lang keys gracefully return default with warning.
📈 Performance Improvements
-
Efficient string coloring – reused helper for batch lore coloring reduces overhead.
-
Deferred meta setting – avoids redundant operations on ItemMeta.
-
Command tab completer registered conditionally – avoids NPE if command is missing.
📜 Documentation & Readability
-
Full JavaDocs added – method-level docs explain parameters, return values, and side effects.
-
Consistent naming and formatting – fluent, descriptive method and variable names.
-
Simplified logging interface – log(String) method wraps colored console output.
🚨 Error Handling & Logging
-
Fallback logs for lang keys – warns when translation keys are missing.
-
Structured exception logging – prints full stack trace on startup failure.
-
Invalid hex codes skipped silently – prevents plugin crash from user config errors.
🧩 Extensibility Support
-
Lore overloads and builder extensibility – builder pattern allows for chaining, expansion (e.g., enchantments).
-
Formatted string retrieval in LangManager – supports runtime placeholders with String.format(...).
