Spear Config

[1.0.0]

Breaking changes

• Replaced scalar limits.<tier> values with independent enabled and amount fields. An enabled amount of 0 now blocks every craft; disabling the tier's master switch makes it unlimited.
• Replaced scalar cooldown.jab and cooldown.lunge values with independent enabled and seconds fields. Zero is now a valid zero-second value instead of changing whether the cooldown is enabled.
• Replaced the global announcements boolean with independent announcements.chat and announcements.title switches, both enabled by default.
• Added automatic migration from the 0.1 schema: positive legacy limits and cooldowns become enabled, zero values become disabled, and the legacy announcement value is copied to both channels.

Added

• Added /spearconfig toggle limit <tier>, /spearconfig toggle cooldown <jab|lunge>, and /spearconfig toggle announcements <chat|title> with full tab completion.
• Added exact integer entry through chat for every numeric GUI control, including cancel, validation, timeout handling, and return to the originating page.
• Added title announcements for successful crafts and newly reached tier limits.
• Added automated tests for 0.1-to-1.0 configuration migration.

Changed

• Redesigned every category page around both horizontal and vertical symmetry, with values above the true center and matching switches below.
• Rebuilt the enchantment browser as paginated three-row book controls with readable names, five visual level indicators, per-enchantment allow switches, and the global enchanting switch on the final page.
• Removed click-spam numeric adjustments in favor of direct integer entry.
• Made every custom crafting-barrier name and lore line explicitly non-italic.

Compatibility notes

• CraftLimitListener still changes PrepareItemCraftEvent results and cancels CraftItemEvent when an enabled limit would be exceeded; recipe or crafting plugins acting at the same priority may compete with it.
• AttackCooldownListener still cancels Paper's PrePlayerAttackEntityEvent and EntityLungeEvent; combat plugins or ProtocolLib listeners can be sensitive to event/listener ordering.
• ChatInputManager consumes an administrator's next AsyncChatEvent while exact numeric input is pending; chat-formatting or moderation plugins at other priorities may observe or compete with that cancelled message.

[0.1.0]

Added

• Seven tier-aware spear crafting limits with tracked counts, explanatory blocked-recipe barriers, successful-craft tracking, announcements, and online inventory/ender-chest/nested-shulker refreshes.
• Natural spear-drop suppression for zombies, husks, zombie villagers, zombie horse and camel husk encounters, piglins, and zombified piglins.
• Independent Paper-native jab and lunge cooldowns using PrePlayerAttackEntityEvent and EntityLungeEvent.
• Runtime discovery of spear-compatible enchantments through Enchantment#canEnchantItem, with allow-list and maximum-level enforcement at enchanting tables and anvils.
• Inventory-owner glow, tab-list color, dropped-item names, and interval-based position broadcasts using one shared color.
• Complete /spearconfig command tree, /spearcfg and /scconfig aliases, spearconfig.admin, and full argument tab completion.
• Symmetric 45-slot GUI with eight categories, consistent borders, centered controls, and uniform left/right/shift numeric adjustments.
• Java 25 Gradle build, Paper 26.1–26.2 metadata, default configuration, automated logic tests, and GPL-3.0-only project files.

Compatibility notes

• CraftLimitListener changes PrepareItemCraftEvent results and cancels CraftItemEvent when limits would be exceeded; recipe or crafting plugins acting at the same priority may compete with it.
• MobDropListener filters EntityDeathEvent#getDrops; mob-loot plugins that rewrite drops later can reintroduce or override spear drops.
• AttackCooldownListener cancels Paper's PrePlayerAttackEntityEvent and EntityLungeEvent; combat plugins or ProtocolLib listeners can be sensitive to event/listener ordering.
• Colored glow uses the main scoreboard team sc_wielders; scoreboard, nameplate, or permissions plugins that manage player teams can override it or be temporarily displaced while a player owns a spear.