Glymera Cats v4.0

GlymeraCats - Cats and Kittens as Loyal Companions

Finally, cats in Hytale. Craft a Cat Spawner Block, place it, and get a random cat or kitten as your loyal companion. Watch them defend you in battle. 20 color varieties with natural fur tones preserving the cats' natural white belly, paws, and facial features.

Most actual version only working for Hytale stable 5 !

What is GlymeraCats?

Hytale has complete cat and kitten models sitting unused in its base assets. GlymeraCats activates them as real pets: they follow you, defend you, meow at strangers, and fight for you with real damage. Every cat has a unique name and one of 10 coat colors.

How to Get a Cat

1. Kill mobs to collect Life Essence and craft Concentrated Life Essence at the Farmingbench (100:1 ratio).
2. Craft a Cat Spawner at the Alchemybench under "Alchemy_Potions_Misc": 1x Raw Fish + 1x Ingredient Life Essence Concentrated
3. Place the block wherever you want your cat to appear.
4. A random Cat or Kitten spawns on the block with a random coat and a random name. You are the owner.
5. Manage them with /gcat (opens the UI page).

OP players can also spawn cats directly with /gcat spawn cat, /gcat spawn kitten, or /gcat spawnpick <type> <variant> to target a specific coat.

Color Variants

Cats (10 coats)
Brown, Chestnut, Tawny, Golden, LightBrown, Amber, Reddish, DarkBrown, Mahogany, Rusty

Kittens (10 coats)
Golden, Wheaten, Red, Tan, Sable, Fawn, Mahogany, Caramel, Tricolor, Chocolate

All coats are natural feline fur tones. The cats' natural white belly, paws, and inner-ear regions are preserved, and facial features like eyes, nose, and snout keep their original colors — only the fur gets recolored. Use /gcat preview (OP) to spawn all 20 variants in a circle for comparison.

Combat System

Your cats defend you and themselves:

• You get hit — All active cats hiss and attack your attacker
• Cat gets hit by a mob — That cat fights back
• Cat is in range of target — Real melee damage per claw swipe (Cat 20, Kitten 15)
• Cat HP drops below 20% — Hurt sound (once per minute per cat)

Cats meow during combat (every 3s) and meow once when a stranger enters their 8-block awareness radius.

Commands

For Everyone
/gcat — Open the cat management UI
/gcat list — List your cats with status
/gcat come — Teleport all active cats to you
/gcat call <id or name> — Re-summon a dismissed cat
/gcat dismiss <id or name> — Despawn a cat (stays in your roster)
/gcat name <id or name> <new name> — Rename a cat
/gcat remove <id or name> — Permanently release a cat
/gcat variants — List all coat variant names
/gcat status — Plugin statistics

OP Only
/gcat spawn <cat or kitten> — Direct random spawn (no block cost)
/gcat spawnpick <type> <variant> — Direct targeted spawn
/gcat preview — Spawn all 20 variants around you for comparison (auto-cleanup after 5 min)

Management UI

Type /gcat to open a visual page showing all your cats as cards. Each card shows name, type, coat, and status:

• Green "ACTIVE" — spawned and following
• Yellow "DISMISSED" — offline, ready to call
• Red "RESPAWN in Xs" — on death cooldown

Each card has buttons: Come, Call / Dismiss, Release. OPs see additional top bar buttons to spawn new cats directly.

Features

• 10 Cat coats x 10 Kitten coats — 20 distinct looks via multi-appearance model assets
• Natural fur coloring — luminance-based tinting preserves the cats' native white markings and facial features
• 100 names each for cats and kittens, collision-free per player
• Cat Spawner — craftable block from raw fish, places to spawn a random cat at the block location
• Real combat damage — cats actually claw attackers (Cat 20, Kitten 15 damage)
• Defend + Self-defense — trigger on your hit OR cat hit
• Stranger alert — meows at non-owner players within 8 blocks
• Feline sounds — hiss on combat start, meow in fight, hurt sound at low HP
• Persistent — roster survives disconnect and server restarts
• Auto-respawn — active cats come back when you log in
• Visual UI — manageable through /gcat page with live updates
• OP-only spawn commands — direct spawning requires admin; normal players craft the block
• Call / Dismiss — temporarily park cats you don't need without losing them
• Configurable — HP, damage, range, intervals, limits, recipe toggle

Configuration

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

• maxCatsOwned (default: 5) — Maximum cats in a player's roster
• maxCatsActive (default: 3) — Maximum cats spawned at the same time
• catMaxHealth (default: 1000) — Cat max HP
• kittenMaxHealth (default: 1000) — Kitten max HP
• catAttackDamage (default: 20) — Damage per cat claw
• kittenAttackDamage (default: 15) — Damage per kitten claw
• attackRange (default: 2.5) — Claw range in blocks
• attackIntervalMs (default: 1200) — Time between attacks
• deathCooldownSeconds (default: 300) — Respawn delay after death (5 min)
• followTeleportDistance (default: 50) — Distance before a cat teleports to owner
• followCheckIntervalMs (default: 2000) — Follow tick interval
• meowRange (default: 8) — Stranger alert radius in blocks
• meowIntervalMs (default: 20000) — Stranger alert scan interval
• combatTimeoutSeconds (default: 10) — How long combat mode lasts after last hit
• previewDurationSeconds (default: 300) — Auto-cleanup time for /gcat preview
• recipeEnabled (default: true) — Whether the Cat Spawner recipe is available

Good to Know

• Cats are despawned when you disconnect and respawned when you rejoin (with a 2s delay, up to maxCatsActive)
• Cats do not attack other players — they only target hostile NPCs/mobs
• Block placement is the normal way for players to get cats. Direct spawn commands are OP-only
• Dismissed cats stay in your roster — use Call to bring them back any time (subject to maxCatsActive)
• Uses Hytale's native Cat and Kitten base models with custom textures generated per variant. The texture generator preserves the original cats' natural white regions (belly, paws, inner ears) and facial features while recoloring only the fur
• All cat data is stored as JSON files per player in the plugin data directory

Installation

1. Place GlymeraCats.jar in your server's mods/ folder
2. Start (or restart) the server
3. Done! No external folders needed — everything is embedded in the JAR.

Made with care by Glymera for the Hytale community