Attention Artists

If you are an artist and would be interested in contributing to Alec's Cats, please contact me on discord! I am not a very skilled artist, and with all the complex systems I've been working on I haven't been able to spend as much time on making things like new cat textures for Alec's Cats. I would love to partner with a capable artist to get more cat variants into people's hands!

Summary

This mod started as a simple cat conversion from unused base-game assets and has grown into a full pet system with:

• Taming + ownership
• Capture/spawn with persistent appearance variants
• Follow / Defend / Stay behaviors
• Command-item controls (Follow, Hold, Recall, Move To Ping, Set Home, Return Home, Attack Target)
• Tamework happiness/needs simulation with resource seeking
• Passive companion breeding
• Trait generation and inheritance for bred companion cats
• Multi-language localization

Requirements

• Alec's Tamework! dependency is required (Alechilles:Alec's Tamework!).

Craftable Items

Cat Collar (Capture/Spawn Item)

• 3x Light Leather
• 1x Gold Bar
• Bench: Workbench Tier 2 (Tinkering)

Cat Treat Bag (Command Item)

• 2x Light Leather
• 5x Raw Fish
• 5x Raw Meat
• Bench: Workbench Tier 2 (Tinkering)

Quick Start

1. Find a wild cat.
2. Feed raw fish to make it friendly.
3. Use a Cat Collar to capture/tame it.
4. Place your cat from the Soul Lantern item.
5. Use one of these control methods:
   • Interact directly to cycle basic modes (Follow / Defend / Stay).
   • Use the Cat Treat Bag for advanced commands.

Cat Treat Bag (Command Item)

• Left click on a cat: link/unlink that cat to the bag.
• Right click: open command selection wheel.
• Left click (while not targeting link action): execute selected command on linked cats.

Default commands:

• Follow
• Hold
• Recall
• Move To Ping
• Set Home
• Return Home
• Attack Target

Notes:

• Commands require ownership + tamed cats by default.

Taming and Ownership

• Taming assigns ownership.
• Only the owner can interact with/store the cat by default.
• When stored in an item, ownership can be cleared until re-spawn (trading-friendly flow).
• Owner damage/invulnerability behavior is controlled by Tamework companion config:
  • Alec's Cats!\Server\Tamework\Companion\TwCompanionConfig_AlecsCats.json

Happiness and Needs

• Happiness fluctuates based on if the Cat's needs are being met
• Cats will automatically eat raw fish from storage containers nearby
• Cats will automatically drink water from water sources nearby
• Cats prefer to have at least one cat friend nearby, but don't like to be overcrowded
• Cats like when their owner is nearby

Breeding and Traits

• Cats can automatically breed if they are happy and have a suitable partner
• Cats can spawn with 0-4 traits
• Traits can alter anything from size, to strength, to fertility and more
• Traits can be inherited from parents, and breeding cats with the same traits together can result in higher trait values (or lower!)
• Fur color is also inherited from parents

Spawns

Cats are uncommon but not extremely rare.

• Zone 1: Plains, Forests
• Zone 3: Forests

They usually spawn solo, but can spawn in small groups.

Color Variants

• Default black/white
• Missy (dark gray)
• Nyxie (light gray with white markings)

Config Files

• Companion Config:
  • Server/Tamework/Companion/TwCompanionConfig_AlecsCats.json
• Interaction Config:
  • Server/Tamework/Interactions/AlecsCats_Cat_InteractionConfig.json
• Spawner Config:
  • Server/Tamework/Items/Spawners/AlecsCats_Spawner_Cat.json
• Command-item Config:
  • Server/Tamework/Items/Commands/AlecsCats_Command_Item_Config.json
• Happiness Config:
  • Server/Tamework/Happiness/TwHappinessConfig_AlecsCats_Cat_Pet.json
• Needs Config:
  • Server/Tamework/Needs/TwNeedsConfig_AlecsCats_Cat_Pet.json
• Breeding Config:
  • Server/Tamework/Breeding/TwBreedingConfig_AlecsCats_Cat_Pet.json
• Trait Config:
  • Server/Tamework/Traits/TwTraitConfig_AlecsCats_Cat_Pet.json

Want More?

If you're interested in bringing the same mechanics to vanilla mobs in Hytale, check out my new mod:

If you're a modder interested in adding these mechanics to your NPCs, check out my comprehensive taming framework built specifically for modders to integrate my systems with their mods. By referencing Tamework, you can add complex systems to your NPCs without writing any Java code at all:

Known Issues

• Some wake/laydown animation transitions are still placeholder quality and will be improved.

Issue Reporting

If you run into issues, please report them here:

• https://github.com/Alechilles/AlecsCats/issues/new