premium banner
Cats and kittens as loyal companions for Hytale. Craft a Cat Spawner from raw fish to summon one of 20 coat varieties. They follow you, defend you in combat with real damage, and persist across server restarts.

Description

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.

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


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:

Trigger Behavior
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

Command Who Description
/gcat Everyone Open the cat management UI
/gcat list Everyone List your cats with status
/gcat come Everyone Teleport all active cats to you
/gcat call <id or name> Everyone Re-summon a dismissed cat
/gcat dismiss <id or name> Everyone Despawn a cat (stays in your roster)
/gcat name <id or name> <new name> Everyone Rename a cat
/gcat remove <id or name> Everyone Permanently release a cat
/gcat variants Everyone List all coat variant names
/gcat status Everyone Plugin statistics
/gcat spawn <cat or kitten> OP only Direct random spawn (no block cost)
/gcat spawnpick <type> <variant> OP only Direct targeted spawn
/gcat preview OP only 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 - teleport this cat to you (active only)
  • Call / Dismiss - toggle spawned state
  • Release - free the cat permanently

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

Stats & Configuration

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

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

Installation

  1. Place GlymeraCats-1.0.0.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.

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 (eyes, nose, snout) while recoloring only the fur.
  • All cat data is stored as JSON files per player in the plugin data directory.

Made with care by Glymera for the Hytale community