friendship_forecast
Calculate how many loved gifts and weeks you need to reach a target heart level with any villager from your current save.
Instructions
Loved gifts + weeks to reach a target heart level from current save points.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"villager": "<villager>"
},
"name": "friendship_forecast"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| player | No | Player/farmhand name; empty = host player. | |
| villager | Yes | Villager name, e.g. 'Robin'. | |
| save_path | No | Path to a save file OR a save folder (e.g. .../Saves/Farm_123 or .../Saves/Farm_123/Farm_123). Leave empty to use the save configured at server startup (--save/--save-dir or SDV_SAVE_PATH/SDV_SAVE_DIR). The server never auto-discovers saves; one must be configured or passed explicitly. | |
| target_hearts | No | Goal heart level. | |
| loved_gifts_per_week | No | Loved gifts given per week (max 2). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| note | No | ||
| error | No | ||
| known | No | ||
| player | No | ||
| villager | No | ||
| target_hearts | No | ||
| current_hearts | No | ||
| current_points | No | ||
| points_remaining | No | ||
| loved_gifts_needed | No | ||
| weeks_at_2_loved_per_week | No |