Custom Companions
stardew-valley — Mods & Enhancements
Custom Companions is a framework for Stardew Valley that lets you create custom entities to spawn on maps or have them follow you around. With 58,537 endorsements and 3.8 million downloads, it's a highly popular modding tool for adding companions, pets, or decorative creatures to your game.
📦 Full mod page on discovermods
Downloads, ratings, compatibility info, installation guides, and user reviews.
View on discovermods →Syntax
Modding ToolsExample
Downloads: 3,823,163 | Endorsements: 58,537💡 Notes
By PeacefulEnd | v5.1.0 | 58,537 endorsements
🎯 Tips & Tricks
Install this framework first, then look for companion mods that require it — many popular ones list it as a dependency.
Check the mod's page for documentation on creating your own entities if you're interested in modding.
Since it's a framework, make sure to read mod descriptions of companion mods to see if they need this as a prerequisite.
🔧 Troubleshooting
Mod not working
Check load order and required dependencies. Read the full mod description.
⚠️ Common Mistakes
- Installing multiple mods that modify the same files without checking compatibility
👍 Pros
- Massive community trust with 58k endorsements and 3.8M downloads — this is the go-to framework for custom companions
- Flexible: spawn entities on maps or have them follow you, so it works for pets, NPCs, or even ambient critters
- Actively maintained — last updated December 2025, so it's current with the game
👎 Cons
- It's a framework, not a content pack — you'll need to find or create your own companion mods to actually use it
- No built-in companions included, so out-of-the-box you get nothing but the tools
- Requires some modding knowledge to get the most out of it; casual players might find it overwhelming