GlymeraCompanion - Changelog

v16.0.0 (2026-07-06)

Fixed

• The Glymera Sword is now craftable in survival (thanks GeneralWarship for the report!). The recipe required a Runic Sword — an item that exists only in the creative menu, with no recipe and no loot source, so the Glymera Sword could never be crafted on a survival server. New recipe: 1x Iron Sword + 1x Greater Essence of Life at an Arcanebench.
• Removed leftover debug chat messages. Every melee hit with any item flooded the attacker's chat with internal [DBG] lines. These were development leftovers and are gone.
• Companions no longer duplicate after a server crash. Companion NPCs are now excluded from world chunk saving entirely (the plugin manages their lifecycle itself). A background sweep also cleans up any duplicated companions created by older versions.
• Companions respawn automatically when their death cooldown expires. Previously a companion that died stayed unavailable until you re-logged; now it reappears at your side by itself.
• Companions now follow you across worlds. Changing worlds used to strand the companion in the old world; it now despawns and re-appears next to you in the new world.
• Player data is saved crash-safely (write-to-temp-then-rename), so a badly timed server crash can no longer corrupt a player's companion roster.

v9.0.0 (2026-04-15)

New Features

• Glymera Sword Recruitment: Companions are now recruited by hitting wild NPCs with a craftable Glymera Sword (Arcanebench recipe). Replaces the old /gc recruit command for a more immersive experience.
• Custom Sword Item: New "Weapon_Sword_Glymera" item with custom texture, embedded in the JAR asset pack. Recipe can be disabled in config (swordCraftable: false).
• Configurable Sword Behavior: swordConsumeOnUse option (default: false) to optionally consume the sword on each recruitment.

Changes

• Removed /gc recruit command (replaced by sword mechanic)
• Added recruitItem, swordCraftable, swordConsumeOnUse to config

v8.0.0 (2026-04-12)

New Features

• Interactive UI Page: /gc now opens a visual companion management page instead of showing text help. Players can call, dismiss, and release companions with clickable buttons.
• Companion Cards: Each companion is displayed as a card showing name, type, appearance, and status (Active/Idle/Dead with cooldown timer).
• Live UI Updates: After any action (call/dismiss/release), the page automatically reopens with updated state.

Technical Details

• Uses InteractiveCustomUIPage<CompanionEventData> with BuilderCodec for event handling
• Templates: CompanionPage.ui, CompanionCard.ui, BasicTextButton.ui (embedded in JAR)
• Status-colored labels: green (active), yellow (idle), red (dead/cooldown)
• Max active check prevents calling when at limit (button shown as disabled)

v7.0.0 (2026-04-06)

New Features

• Offense System: Companions now join attacks when the owner hits a mob. Previously, companions only reacted defensively (when owner or companion took damage). Now they proactively assist when the player initiates combat.

Technical Details

• Added CompanionOffenseSystem (ECS EntityEventSystem<EntityStore, Damage>)
• Checks if Damage source is owner player and target is a non-player entity
• Sets all active fighting companions' LockedTarget to the attacked mob
• Uses same combatUntil timeout logic as existing DefendSystem (10s default)
• Registered alongside existing DefendSystem and SelfDefenseSystem in setup()

All 3 Combat Systems

1. CompanionDefendSystem - Owner takes damage → companions attack the attacker
2. CompanionSelfDefenseSystem - Companion takes damage → fights back
3. CompanionOffenseSystem (new) - Owner attacks mob → companions join the fight

v6.0.0 (2026-03-30)

• Previous release (defensive-only combat)