GlymeraCompanion - Recruit NPCs as Your Personal Companions

Recruit wild NPCs with a Glymera Sword, build your personal squad, and fight together. Your companions follow you, defend you, and join your attacks. Manage them through a visual UI or chat commands.

Don't miss my other exciting projects — take a look at GlymeraCraft's Profile Discord: https://discord.gg/s5NRFWfxgy

What is GlymeraCompanion?

GlymeraCompanion lets you recruit almost any humanoid NPC in the game as a permanent companion. Hit a wild NPC with the craftable Glymera Sword to recruit it. Your companions follow you around, teleport to you when you get too far away, and fight alongside you in combat. Manage your squad through a visual UI page or classic chat commands.

Recruit, fight, conquer.

How It Works

Craft a Glymera Sword at an Arcanebench
Find a wild NPC you want to recruit
Hit it with the Glymera Sword - it joins your squad
Open /gc to manage your companions through the UI
Dismiss companions you don't need right now (they stay in your roster)
Call them back whenever you want

Combat System

Your companions fight for you in three ways:

Trigger	Behavior
You get hit	All active companions attack your attacker
Companion gets hit	That companion fights back
You attack a mob	All active companions join the fight

Companions deal configurable melee damage with hit effects and sound. They return to following you after combat ends (10s timeout).

Commands

Command	Who	Description
`/gc`	Everyone	Open the companion management UI
`/gc call &lt;name&gt;`	Everyone	Summon a companion to your side
`/gc dismiss &lt;name&gt;`	Everyone	Send a companion away (stays in roster)
`/gc release &lt;name&gt;`	Everyone	Release a companion permanently (frees slot)
`/gc list`	Everyone	List all your companions with status
`/gc status`	Everyone	Show slot and cooldown overview
`/gc transfer &lt;name&gt; &lt;player&gt;`	Everyone	Give a companion to another player
`/gc admin slots &lt;player&gt; &lt;amount&gt;`	OP	Set companion slots for a player

Companion Management UI

Type /gc to open a visual page showing all your companions as cards:

Green = Active (following you)
Yellow = Idle (dismissed, ready to call)
Red = Dead (on respawn cooldown with timer)

Each card has action buttons: Call, Dismiss, Release. The page updates live after every action.

Recruitable NPCs

Over 100 NPC types across 25+ groups can be recruited:

Group	Examples
Trork	Hunter, Warrior, Brawler, Chieftain, Shaman…
Outlander	Hunter, Berserker, Brute, Marauder, Stalker…
Kweebec	Razorleaf, Elder, Sapling, Seedling…
Goblin	Scrapper, Scavenger, Miner, Duke, Ogre…
Feran	Burrower, Civilian, Longtooth, Windwalker…
Skeleton	40 variants (Normal, Burnt, Frost, Sand, Pirate…)
Zombie	Normal, Burnt, Frost, Sand, Aberrant…
Dragon	Fire, Frost
Golem	Crystal (5 types), Firesteel, Guardian…
Wolf	Black, White, Outlander, Trork variants…
Bear	Grizzly, Polar
+ many more	Werewolf, Wraith, Yeti, Scorpion, Spider, Hyena…

NPCs with patrol/dungeon/temple prefixes are also matched automatically.

Death and Cooldown

When a companion dies in combat:

It is removed from the world
A configurable cooldown starts (default: 10 minutes)
After the cooldown, you can call it again at full health

Features

Glymera Sword recruitment - Immersive recruitment by hitting wild NPCs with a craftable sword
Visual UI - Manage all companions through a clickable page (/gc)
3 combat systems - Defend, self-defense, and offense (companions join your attacks)
Follow + teleport - Companions follow you and teleport when too far away (50 blocks)
Persistent roster - Companions survive server restarts and player disconnects
Transfer system - Give companions to other players
Slot system - Configurable total slots and max active companions per player
Death cooldown - Prevents instant respawn after companion death
Original appearance - Recruited NPCs keep their wild appearance
Per-type health - Each companion type has configurable max health
Configurable everything - Damage, range, intervals, slots, cooldowns, recruit item

Configuration

File: config.json (created on first start in plugin data directory)

Setting	Default	Description
`maxCompanionsPerPlayer`	10	Maximum companions in a player's roster
`maxActiveCompanions`	3	Maximum companions active at the same time
`defaultSlots`	5	Starting slots for new players
`deathCooldownSeconds`	600	Respawn cooldown after companion death (10 min)
`followTeleportDistance`	50	Distance before companion teleports to owner
`followCheckIntervalMs`	2000	How often follow/teleport is checked
`companionAttackDamage`	15.0	Melee damage per companion attack
`companionAttackRange`	3.0	Attack range in blocks
`companionAttackIntervalMs`	1500	Time between companion attacks
`recruitItem`	Weapon_Sword_Glymera	Item used to recruit NPCs
`swordCraftable`	true	Whether the Glymera Sword recipe is available
`swordConsumeOnUse`	false	Whether the sword is consumed on each recruitment
`companionTypes`	(see config)	Per-type settings: role, health, wild roles

Installation

Place GlymeraCompanion-9.0.0.jar in your server's mods/ folder
Start (or restart) the server
Done!

Good to Know

Companions are despawned when you disconnect and respawned when you rejoin (with 2s delay)
Companions cannot attack other players - they only target NPCs/mobs
Hitting your own companion does nothing (player attacks are ignored)
The Glymera Sword does not damage NPCs during recruitment (damage is cancelled)
Companions keep their original wild appearance (a Trork Warrior still looks like a Trork Warrior)
Admins can adjust slots per player with /gc admin slots <player> <amount>
All companion data is stored as JSON files per player in the plugin data directory

Made with care by Glymera for the Hytale community