Custom Companions
🟡 Updated this year⚠️ Install Order · 2 steps
Install in this order, then this mod last — most mods fail to load without their framework and dependencies in place.
Preview
🔍 Analysis
- 👍 1.5% endorsement rate — high engagement, a strong quality signal
- 🏆 #13 of 119 Modding Tools mods in this game by downloads
📋 About This Mod
See the GitHub repository for an in-depth wiki on how to create a content pack for Custom Companions.
See the example pack in the Optional Files section for example companions.
Multiplayer is supported!
Content Patcher is supported!
Save Anywhere is supported!
Source code is available here.
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.
✨ Key Features
📊 Pros & Cons
✅ 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
For Stardew Valley modders who want to add custom companions, pets, or entities to their game. Also for players who want to install companion mods that depend on this framework. Skip if you're looking for a ready-to-use companion — this is a tool, not a content pack.
💡 Beginner Tips
- 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.
📊 Mod Details
- Game
- Stardew Valley Mods
- Author
- PeacefulEnd
- Version
- 5.1.0
- Downloads
- 3,823,163
- Endorsements
- 58,537
- Category
- Modding Tools
- Created
- 5/2/2021
- Updated
- 12/19/2025
🔗 Required By 2 Mods
These mods list this mod as a dependency.
🧩 Commonly Used Together
Users add these mods to the same collections — a real compatibility signal, not an AI guess.
🔧 How to Install Stardew Valley Mods
Download from Nexus.
📖 Full step-by-step install guide for Stardew Valley →
Visit the official mod page for specific installation instructions for this mod.
🎮 Need cheat codes or console commands? Check ur gaming wiki for Stardew Valley commands, item IDs, and more.
Keep browsing — more Stardew Valley mods await