Custom NPC Festival Extension
Enhanced customization of festivals, events, and mini-games to allow custom NPCs to participate.
Screenshots 3 screenshots
About this mod Machine translation
Enhanced customization of festivals, events, and mini-games to allow custom NPCs to participate.
Custom NPC Festival Additions
🎉 **Custom NPC Festival Extension (CNFA)** is a new upgraded version of my original Flower Dance Festival Restoration Mod (FDF)!
✨ Module Features
CNFA aims to enhance the customization functions of festivals, events and mini-games, allowing custom NPCs to participate in various game activities!
Currently, CNFA is mainly optimizing for the Flower Dance Festival on the 24th of spring:
- 🕺Customized number of dance partners
- 👫 Allow custom NPCs to participate in dance
- 🔀 Randomly match NPC dance partners
⚙️ Configuration instructions
The current module settings need to be configured by modifying the config.json file:
**EnableCNFAspring24** (default: true)
- Enable or disable modifications to the Flower Dance Festival
**CNFAspring24NumberDancerPairs** (default: 6)
-Set the number of pairs of dance partners allowed to dance, up to 17 pairs are supported
**CNFAspring24RandomizeDancersInPairs** (default: true)
- Randomly match NPCs of the opposite sex
- When disabled, the "love interest" matching system will be used
**CNFAspring24Blacklist**
- Set up a blacklist of NPCs who do not participate in the dance
- Example: "Emily, Sebastian, Leah"
🚧 Upcoming features
**Flower Dance Festival Enhanced Features:**
- 🎨 Custom sprites and animations for all dancers
- ♀️♂️ Mixed gender dance queue
- 📝 Dance partner whitelist and blacklist system
- 🖥️ Graphical configuration interface
- 🔧 Sophisticated token system for modders
- 📦 Content pack integration support
**Other holiday expansion plans:**
- 🥚Spring 13th Easter Egg Hunting Festival - Customized NPC participation, variable difficulty
- 🎪 Stardew Valley Market on Fall 16th - Customized NPCs to participate in the agricultural products exhibition
- 🎣 Winter 8-day Ice and Snow Festival - Customized NPCs to participate in the ice fishing competition
❓ FAQ
**Why is this mod still in beta? **
This is the first version of CNFA, and I hope players can help find edge cases that I haven't been able to find. Many full version features are still in development, but I want to release the basic version first.
**Why not update the FDF module directly? **
After Stardew Valley version 1.6, many Harmony modules need to be rewritten. It's more efficient to start a new project over than to fix old code, and I have other ideas for extensions for the holidays!
**Does this module still have FDF glitches? **
No! I've fixed various glitches in the original FDF, such as random empty positions in the dancer queue. Of course, if you find any problems, please give us feedback in time!
**Is the module open source? **
Not yet, but it will be open source soon! A link will be added to the GitHub repository as soon as it is ready.
---
*The custom NPCs in the screenshots are from the Ridgeside Village mod! *
Install & use Install: SMAPI mod (Stardew Valley standard)
- Install SMAPI first (Stardew Valley's mod loader): download it from smapi.io, run 'install on Windows.bat' and pick your game folder.
- Unzip the archive from playbuff and find the folder that contains manifest.json — that folder is the mod.
- Copy that whole folder into Stardew Valley/Mods/.
- Launch the game through SMAPI (run StardewModdingAPI.exe or set it as the launch option). The console before the title screen lists each mod's load result.
Cheat-style tools may not need SMAPI — unzip and run them as the readme describes. Back up your save before editing it; SMAPI lists failed mods in its console.