Enable your openclaw to create mods for Stardew Valley

星露谷物语 Mod 制作助手。用于创建 Content Patcher (CP) Mod 或 SMAPI Mod，包括：创建项目结构、编写 JSON、添加 NPC/事件/对话、验证格式、编译 SMAPI Mod。当用户说"做星露谷 mod"、"创建 Stardew Valley Mod"、"星露谷 Mod 制作"...

Security Scan

The skill's files, instructions, and requested resources are consistent with a local Stardew Valley mod-creation helper: it reads/writes local files, optionally references the game DLL for SMAPI mods, and does not request credentials or contact external endpoints.

Purpose & Capability

Name/description (Stardew modding helper) matches the included scripts and templates: scripts create CP or SMAPI project structures, validate JSON, and check local tools. All required behavior (reading game DLL path for SMAPI, writing mod files) is justified by the stated purpose.

Instruction Scope

SKILL.md and scripts operate on local filesystem (creating mod folders under ~/Desktop, checking for game directory and game DLL) and call local tools (python3, dotnet). This is within scope, but the repo contains hard-coded macOS paths (e.g., /Users/geyize/...) in templates and path checks which are environment-specific and should be adjusted before use.

Install Mechanism

No install spec; the skill is instruction-only with included Python scripts. No network downloads or archive extraction are present, so there is no high-risk install behavior.

Credentials

The skill requests no environment variables or credentials. It does check for and rely on local binaries (python3, dotnet) and local game files — which are proportionate to building SMAPI mods. No secrets or unrelated service credentials are requested.

Persistence & Privilege

Skill is not always-enabled and does not modify other skills or system-wide agent settings. It only writes project files into user-visible locations (~/Desktop) and reads local game paths when creating SMAPI projects.

Assessment

This skill appears coherent for creating Stardew Valley mods. Before running: (1) review the included scripts (they run locally and will create files under ~/Desktop), (2) note the templates contain hard-coded macOS paths (/Users/geyize/...) — update them to your environment if needed, (3) back up your game files before building or copying DLLs, (4) ensure dotnet is installed only if you plan to build SMAPI (CP mods don't need it), and (5) run the scripts in a controlled environment if you're unsure (they do not make network calls or request secrets).

Stardew Valley Mod 制作助手

⚠️ 工具依赖

使用本技能前，请确保有以下工具：

工具	用途	检查命令
文本编辑器	编辑文件	已有
Python	验证 JSON	python3 --version
.NET SDK	编译 SMAPI Mod	dotnet --version

检查工具可用性

import subprocess
import shutil

def check_tools():
    errors = []
    
    # 检查 Python
    if not shutil.which('python3'):
        errors.append("❌ Python 未安装")
    
    # 检查 .NET (可选，用于 SMAPI Mod)
    if not shutil.which('dotnet'):
        errors.append("⚠️ .NET SDK 未安装（SMAPI Mod 需要，CP Mod 不需要）")
    
    if errors:
        return errors
    return ["✅ 所有工具就绪"]

---

🔧 自动判断 Mod 类型

根据用户需求自动选择：

需求	类型	需要 .NET
添加 NPC/对话/立绘	CP Mod	❌ 不需要
修改游戏数据	CP Mod	❌ 不需要
添加新地图	CP Mod	❌ 不需要
修改游戏机制	SMAPI Mod	✅ 需要
添加孩子功能	SMAPI Mod	✅ 需要
代码级 Hook	SMAPI Mod	✅ 需要

自动判断逻辑

def determine_mod_type(user_request):
    request = user_request.lower()
    
    smapi_keywords = ["孩子", "孩子功能", "hook", "修改机制", "代码", "dll", "编译"]
    cp_keywords = ["对话", "立绘", "npc", "剧情", "事件", "地图", "json"]
    
    for keyword in smapi_keywords:
        if keyword in request:
            return "SMAPI"
    
    for keyword in cp_keywords:
        if keyword in request:
            return "CP"
    
    return "CP"  # 默认 CP

---

快速开始

Content Patcher Mod

1. 创建项目文件夹结构
2. 编写 manifest.json
3. 编写 content.json
4. 添加资源文件（对话、立绘、地图等）

SMAPI Mod (C#)

1. 创建 C# 项目
2. 引用 SMAPI DLL
3. 编写 Mod 代码
4. 编译 DLL

项目结构

CP Mod 标准结构

ModName/
├── manifest.json           # Mod 信息
├── content.json          # 内容定义
└── assets/              # 资源文件夹
    ├── Dialogue/        # 对话文件
    ├── Image/           # 图片资源
    ├── Maps/            # 地图文件
    ├── Schedule/        # 行程文件
    └── i18n/           # 多语言

SMAPI Mod 标准结构

ModName/
├── ModName.csproj       # 项目文件
├── ModEntry.cs          # 主代码
└── manifest.json        # Mod 信息

常用代码片段

manifest.json 模板

{
  "Name": "ModName",
  "Author": "YourName",
  "Version": "1.0.0",
  "Description": "Mod 描述",
  "UniqueID": "YourName.ModName",
  "ContentPackFor": {
    "UniqueID": "Pathoschild.ContentPatcher",
    "MinimumVersion": "2.0"
  }
}

content.json 基础结构

{
  "Format": "2.3.0",
  "Changes": [
    {
      "LogName": "说明",
      "Action": "EditData/Load/EditImage",
      "Target": "目标路径",
      "Entries": {}
    }
  ]
}

婚后对话格式

{
  "Action": "EditData",
  "Target": "Characters/Dialogue/MarriageDialogueNPC名",
  "Entries": {
    "Rainy_Day_0": "对话内容",
    "Indoor_Night_0": "对话内容"
  }
}

Event 触发条件

条件	代码
结婚	Spouse NPC名
好感度	Friendship NPC名 数字 (2500 = 10心)
时间	Time 600 1000
天气	Weather rainy
季节	Season summer
雨天	Weather rainy
晴天	Weather sunny

工具

验证 JSON

python3 -c "import json; json.load(open('file.json'))"

编译 SMAPI Mod

dotnet build

资源路径

• 游戏目录：~/Library/Application Support/Steam/steamapps/common/Stardew Valley/
• Mods：.../Stardew Valley/Contents/MacOS/Mods/
• SMAPI DLL：.../Stardew Valley/Contents/MacOS/smapi-internal/

参考

• Wiki: https://stardewvalleywiki.com/Modding:Index
• SMAPI: https://smapi.io/
• Content Patcher: https://smapi.io/mods/1915