Starfall Flute

STARFALL FLUTE / 星陨魔笛
<br />
<br />====================
<br />ENGLISH
<br />====================
<br />
<br />LANGUAGE NOTICE
<br />
<br />The current in-game text is available in Simplified Chinese only.
<br />
<br />OVERVIEW
<br />
<br />Starfall Flute adds a magical instrument that can actually be performed in Stardew Valley 1.6. Find the flute after a strange spring thunderstorm, learn six melodies through exploration, shops, letters, NPC stories and a final secret ritual, then use them for farming, monster control, teleportation and mining.
<br />
<br />This is not a tool that instantly activates when a button is pressed. The farmer plays the flute with an animation, each melody has its own short musical phrase and themed visual presentation, and the ability is triggered at the climax of the performance.
<br />
<br />FEATURES
<br />
<br />- A story-driven flute acquisition beginning with distant thunder, an anonymous letter and a one-day search across the valley.
<br />- Six melodies covering watering, crop growth, monster control, returning home and mine clearing.
<br />- Flute-playing animations, individual note sequences and themed visual effects.
<br />- Five visually distinct sheet-music items with vanilla-style animated book-reading scenes.
<br />- Multiple acquisition methods, including a shop, timed NPC letters, friendship rewards and a Secret Woods offering ritual.
<br />- Vanilla-compatible crop growth, normal monster death and drops, and normal stone destruction.
<br />
<br />THE SIX MELODIES
<br />
<br />Morning Dew Melody
<br />Play outdoors before 9:00 AM to water dry tilled soil within a five-tile radius. Costs 8 stamina and has no daily use limit.
<br />
<br />Sprout Melody
<br />Advances up to 12 crops within a four-tile radius by one day. It can succeed four times per day, and each crop can respond only once per day. Costs 25 stamina.
<br />
<br />Lamb Sleep Melody
<br />Stops monsters within a six-tile radius for 30 seconds. Costs 15 stamina and has no cooldown or daily use limit.
<br />
<br />Dance Melody
<br />Makes monsters within a five-tile radius stop chasing the player and dance for 30 seconds. Costs 22 stamina and has no cooldown or daily use limit.
<br />
<br />Homeward Melody
<br />Returns the player to the farmhouse. It has no daily use limit and costs 40 stamina per performance.
<br />
<br />Thunderfall Melody
<br />Works in mine-like locations. Lightning attacks all attackable monsters on the current floor and independently targets about 40% of breakable stones. Costs 80 stamina. It has no weekly limit and does not silence the flute for the rest of the day.
<br />
<br />CONTROLS
<br />
<br />- Hold the Starfall Flute and press the action button or use-tool button to play the selected melody.
<br />- If an NPC, chest or interactable tile is in front of the player, the action button keeps its normal vanilla interaction priority. The use-tool button can still play the flute.
<br />- Press G by default to cycle through learned melodies.
<br />- Hold and use a sheet-music item to play the reading animation and learn its melody.
<br />- Failed or invalid performances do not consume stamina or use counts.
<br />
<br />ACQUISITION GUIDE - SPOILERS
<br />
<br />Starfall Flute and Morning Dew Melody
<br />
<br />Every year on Spring 7 after 8:00 PM, unusual thunder sounds across the valley and a vague message mentions a falling light. On the morning of Spring 8, the player receives an anonymous letter. The flute appears at a safe location on the Farm, Mountain, Forest, Town, Beach or Bus Stop. It must be found that day; otherwise the opportunity returns next year. Picking up the flute uses an important-item animation and automatically teaches the Morning Dew Melody.
<br />
<br />Sprout Melody
<br />
<br />After obtaining the flute, buy the sheet music from Pierre's General Store for 2,500g.
<br />
<br />Lamb Sleep Melody
<br />
<br />Reach four hearts with Marnie. On the next non-festival and non-wedding morning, a timed letter arrives. Speak to Marnie that day to receive the sheet music.
<br />
<br />Dance Melody
<br />
<br />Reach four hearts with Emily. On the next non-festival and non-wedding morning, a timed letter arrives. Speak to Emily that day to receive the sheet music.
<br />
<br />Homeward Melody
<br />
<br />Reach four hearts with the Wizard. On the next non-festival and non-wedding morning, a timed letter arrives. Visit the Wizard's Tower that day to receive the sheet music.
<br />
<br />The three NPC routes are independent and do not require one another, but only one invitation can be sent per day. If an invitation is missed, that sheet is unavailable for the rest of the current year and can be offered again next year if the conditions are still met.
<br />
<br />Thunderfall Melody
<br />
<br />Learn the other five melodies and wait for a lightning day. A letter from the Wizard will arrive. On that same day after 8:00 PM, enter the Secret Woods, hold one Prismatic Shard and interact with the Old Master Cannoli statue. The statue consumes the offering, calls down repeated thunder and white flashes, and gives the Thunderfall sheet music. Incorrect time, location, weather, held item or inventory space prevents the ritual from starting and does not consume the shard.
<br />
<br />INSTALLATION
<br />
<br />1. Install SMAPI 4.0.0 or later.
<br />2. Download and extract the archive.
<br />3. Place the StarfallFluteMod folder directly inside Stardew Valley/Mods.
<br />4. Launch the game through SMAPI.
<br />
<br />There are no required dependencies other than SMAPI.
<br />
<br />COMPATIBILITY AND LIMITATIONS
<br />
<br />- Designed for Stardew Valley 1.6.15.
<br />- Developed and tested with SMAPI 4.5.2 on Windows 11.
<br />- Current in-game text is Simplified Chinese only.
<br />- Single-player and the host player are supported.
<br />- Remote farmhands and split-screen secondary players are intentionally disabled in public V1 to prevent multiplayer save-state conflicts.
<br />- The mod does not replace maps or bundle original game image or audio files.
<br />
<br />CONFIGURATION
<br />
<br />The following options are generated in config.json after the first launch:
<br />
<br />- CycleMelodyKey: key used to cycle melodies. Default: G.
<br />- AutoLearnMorningDewWhenGettingFlute: automatically learn Morning Dew when the flute is found. Default: true.
<br />- EnableNaturalFluteDrop: enable the natural Spring 8 flute event. Default: true.
<br />- EnableDebugCommands: developer testing commands. Default: false.
<br />
<br />CREDITS
<br />
<br />Created, designed, developed, maintained and published by WENJI.
<br />
<br />====================
<br />简体中文
<br />====================
<br />
<br />语言说明
<br />
<br />当前游戏内文本仅提供简体中文。
<br />
<br />模组介绍
<br />
<br />星陨魔笛为 Stardew Valley 1.6 增加了一件可以实际演奏的魔法乐器。玩家将在一次异常的春季雷声后寻找魔笛，再通过探索、商店、限时信件、NPC 故事和最终的秘密仪式学习六首旋律，用于种田、作物成长、怪物控制、快速回家和矿洞探索。
<br />
<br />它不是一个按下按钮后立刻结算的普通工具。角色会做出吹奏动作，每首旋律都有独立短乐句和主题视觉演出，并在乐曲高潮触发对应能力。
<br />
<br />主要内容
<br />
<br />- 一条从春季雷声、匿名信和山谷探索开始的魔笛获取剧情。
<br />- 六首用途不同的旋律，覆盖浇水、作物成长、怪物控制、快速回家和矿洞清场。
<br />- 魔笛吹奏动作、每首曲子的独立音符与主题视觉效果。
<br />- 五张具有不同封面颜色和符号的曲谱，以及原版风格的动态翻书学习演出。
<br />- 商店购买、限时 NPC 信件、好感交付和秘密森林献祭等多种获取方式。
<br />- 保留原版作物生长逻辑、怪物正常死亡与掉落，以及石头正常破坏流程。
<br />
<br />六首旋律
<br />
<br />晨露曲
<br />09:00 前在室外演奏，浇灌玩家半径 5 格内的干燥耕地。每次消耗 8 点体力，没有每日次数限制。
<br />
<br />助苗曲
<br />推动半径 4 格内最多 12 株作物向前生长一天。每天最多成功演奏 4 次，同一株作物每天只会响应一次，每次消耗 25 点体力。
<br />
<br />眠羊曲
<br />让半径 6 格内的怪物停止行动 30 秒。每次消耗 15 点体力，没有冷却和每日次数限制。
<br />
<br />跳舞曲
<br />让半径 5 格内的怪物停止追击并随节拍跳舞 30 秒。每次消耗 22 点体力，没有冷却和每日次数限制。
<br />
<br />归巢曲
<br />将玩家送回农舍。不限每日次数，每次消耗 40 点体力。
<br />
<br />惊雷曲
<br />只能在矿洞类地图发挥作用。雷电会攻击当前层所有可攻击怪物，并分别判定约 40% 的可破坏石头。每次消耗 80 点体力，没有周限，也不会让魔笛当天沉默。
<br />
<br />操作方式
<br />
<br />- 手持星陨魔笛，按动作键或使用工具键演奏当前旋律。
<br />- 面前存在 NPC、箱子或可交互地块时，动作键优先执行原版交互；使用工具键仍可演奏。
<br />- 默认按 G，在已经学会的旋律之间循环切换。
<br />- 手持曲谱并使用，即可播放翻书演出并学习对应旋律。
<br />- 条件不满足或效果失败时，不会扣除体力或使用次数。
<br />
<br />获取方式 - 包含剧透
<br />
<br />星陨魔笛与晨露曲
<br />
<br />每年春季 7 日 20:00 后，山谷会响起一声异常雷声，并出现关于坠落微光的模糊提示。春季 8 日早晨会收到匿名信，魔笛将在农场、山区、森林、城镇、海滩或巴士站中的一个安全位置出现。必须当天找到；错过后只能等下一年。拾取魔笛时会播放重要物品动作，并自动领悟晨露曲。
<br />
<br />助苗曲
<br />
<br />获得魔笛后，在皮埃尔杂货店花费 2,500g 购买。
<br />
<br />眠羊曲
<br />
<br />与玛妮达到 4 心。下一个非节日、非婚礼早晨会收到限时信件，并需要在当天找玛妮领取曲谱。
<br />
<br />跳舞曲
<br />
<br />与艾米丽达到 4 心。下一个非节日、非婚礼早晨会收到限时信件，并需要在当天找艾米丽领取曲谱。
<br />
<br />归巢曲
<br />
<br />与法师达到 4 心。下一个非节日、非婚礼早晨会收到限时信件，并需要在当天前往法师塔领取曲谱。
<br />
<br />三条 NPC 路线彼此独立，不互相作为前置，但同一天最多发送一封邀请。如果当天错过，曲谱会在该年失效，下一年仍满足条件时可以重新收到邀请。
<br />
<br />惊雷曲
<br />
<br />先学会前五首旋律，并等待雷雨天收到法师信件。当天 20:00 后前往秘密森林，手持一块五彩碎片与老者雕像交互。雕像会吞下祭品，引发连续惊雷与白光，并给予惊雷曲乐谱。时间、地点、天气、祭品或背包空间不正确时，仪式不会开始，也不会消耗五彩碎片。
<br />
<br />安装方法
<br />
<br />1. 安装 SMAPI 4.0.0 或更高版本。
<br />2. 下载并解压文件。
<br />3. 将 StarfallFluteMod 文件夹直接放入 Stardew Valley/Mods。
<br />4. 通过 SMAPI 启动游戏。
<br />
<br />本 Mod 除 SMAPI 外没有其他前置。
<br />
<br />兼容性与限制
<br />
<br />- 适用于 Stardew Valley 1.6.15。
<br />- 开发与完整回归环境：SMAPI 4.5.2、Windows 11。
<br />- 当前游戏内文本仅提供简体中文。
<br />- 支持单人游戏和联机主机。
<br />- 远程农场助手与分屏副玩家在公开 V1 中会安全禁用玩法，以避免多人存档状态不一致。
<br />- 不替换地图，也不打包原版游戏图片或音频文件。
<br />
<br />配置选项
<br />
<br />首次启动后会生成 config.json，其中可以调整：
<br />
<br />- CycleMelodyKey：切换旋律按键，默认 G。
<br />- AutoLearnMorningDewWhenGettingFlute：拾取魔笛时自动领悟晨露曲，默认 true。
<br />- EnableNaturalFluteDrop：启用春季 8 日自然坠落流程，默认 true。
<br />- EnableDebugCommands：开发测试命令，默认 false。
<br />
<br />署名
<br />
<br />创意、设计、开发、维护与发布：WENJI。
<br />
<br />