Stardew Valley AI 주민 모드: 자유 대화와 음성 명령
SMAPI와 Neocortex로 Stardew Valley AI 주민 모드 만들기: 나를 기억하는 주민, 축제 스토리 비트, 농사 퀴즈, 음성 명령.
Neocortex TeamThe team behind Neocortex
· 6분 분량

술집에 들어가서 애비게일에게 이번 주가 어땠는지 물어보세요. 하트가 두 개일 때 그녀는 예의 바르고 짧게 답합니다. 여덟 개일 때는 둘이 함께 탐험한 동굴 이야기를 꺼내고, 사흘 연속 준 자수정을 두고 놀립니다. Stardew Valley AI 주민 모드는 이런 대화를 가능하게 합니다.
이 게임의 손으로 쓴 대사는 사랑받고 있지만, 플레이어는 둘째 해쯤이면 그 대사를 다 듣게 됩니다. 자유 대화는 이 캐릭터들이 계속 말하게 해 주며, 하트, 선물, 생일을 잊었던 순간까지 기억합니다. Neocortex는 SMAPI 모드에 AI 캐릭터, 축제 장면을 위한 Conversation Flows, 퀴즈 엔진, 온디바이스 음성 명령을 제공합니다.
스크린샷: Stardew Valley © ConcernedApe
하트, 선물, 기억
애비게일의 대답은 모드가 메시지마다 함께 보내는 정보에 따라 달라집니다. 하트 단계, 이번 주에 받은 선물, 계절과 날짜, 날씨, "플레이어가 Egg Festival에서 우승" 같은 최근 사건이 여기에 포함됩니다.
캐릭터는 세션을 유지하므로, 대화는 멈췄던 곳에서 이어집니다. 각 응답은 텍스트, 초상화용 감정 태그와 함께 돌아오며, 때로는 { "name": "GIVE_ITEM", "targetId": "coffee" } 같은 행동을 돌려줘서 모드가 실행하게 합니다.
이것이 손으로 쓴 대사를 대신하지는 않습니다. 그 대사는 그대로 두고, 자유 대화는 그 사이의 빈틈을 채웁니다.
캐릭터는 성격, 감정, 지식, 음성 노드가 있는 시각적 노드 편집기에서 만듭니다. 리누스에게 그의 텐트와 과거에 대한 텍스트 파일을 지식으로 줄 수 있습니다. Pro와 Team 요금제에서는 캐릭터 최대 여섯 명이 하나의 대화를 함께 나눌 수 있으므로, 팸, 거스, 에밀리와 함께하는 술집의 밤에 알맞습니다.
SMAPI 모드가 웹 API를 호출할 수 있나요?
네. 거의 모든 Stardew Valley 모드는 SMAPI(GitHub), 즉 Stardew Modding API 위에서 돌아갑니다. 현재 릴리스는 4.5 계열이며, Stardew Valley 1.6.14 이상용입니다. 게임 1.7 버전은 발표되었지만 출시일은 정해지지 않았습니다.
SMAPI 모드는 manifest.json이 있는 .NET 6 기반 C# 프로젝트입니다. 진입 클래스는 게임 이벤트(날 시작, 메뉴 변경, 버튼 입력, 렌더링)를 구독하고, 게임 상태를 직접 읽습니다.
일반 .NET이므로 모드는 HttpClient로 웹 API를 호출하고, 응답을 게임의 대화 상자나 커스텀 메뉴에 보여 주며, 돌려받은 WAV 클립을 게임의 MonoGame 오디오로 재생할 수 있습니다. SMAPI는 모드마다 config.json도 읽으므로, 플레이어의 API 키는 그곳에 두면 됩니다.
Content Patcher(GitHub)는 어떨까요? 게임 파일을 바꾸지 않고 게임 데이터, 이미지, 맵을 수정하는 콘텐츠 팩을 불러옵니다. 새 초상화, 축제 부스, 손으로 쓴 대체 대사에 쓰고, AI 로직은 SMAPI 모드에 두세요. Stardew Valley 위키의 모딩 페이지에서 두 도구를 자세히 다룹니다.
모드용 TalkTo 메서드
SMAPI 모드에서 보내는 최소한의 채팅 호출 예시입니다. 계절, 날짜, 하트 단계를 이벤트로 보내고, 첫 메시지의 대사, 행동, flowState를 돌려받습니다.
private static readonly HttpClient Http = new() { BaseAddress = new Uri("https://api.neocortex.link/v3/") };
private async Task<JsonElement> TalkTo(string characterId, string npcName, string text)
{
var body = new {
characterIds = new[] { characterId },
message = text,
playerId = Game1.player.UniqueMultiplayerID.ToString(),
sessionId = this.sessionId,
events = new[] { new { priority = 1, content = $"{Game1.currentSeason} {Game1.dayOfMonth}, hearts: {Game1.player.getFriendHeartLevelForNPC(npcName)}" } }
};
using var req = new HttpRequestMessage(HttpMethod.Post, "chat") { Content = JsonContent.Create(body) };
req.Headers.Add("x-api-key", this.Config.ApiKey);
using var res = await Http.SendAsync(req);
var json = await res.Content.ReadFromJsonAsync<JsonElement>();
this.sessionId = json.GetProperty("sessionId").GetString();
return json.GetProperty("messages")[0]; // lines, actions, flowState
}이것이 /v3/chat 호출입니다. 모드는 대사를 대화로 보여 주고, /v3/audio/generate 또는 /v3/audio/stream에서 음성을 재생하며, 캐릭터가 돌려준 행동을 실행합니다.
스크린샷: Stardew Valley © ConcernedApe
축제 날
Luau, Conversation Flow로 이끌기
루아우는 자연스럽게 어울리는 장면입니다. 루이스 시장이 인사하고, 당신이 감자 수프 재료로 무엇을 넣는지 묻고, 주지사의 시식까지 안내합니다.
Conversation Flow가 체크포인트를 따라 장면을 이끌고, INGREDIENT_ADDED, GOVERNOR_TASTED, VERDICT_GOOD 같은 키워드를 돌려줍니다.
모드는 각 키워드에 반응합니다. 좋은 평가가 나오면 마을 전체의 호감도가 올라가고, 나쁜 평가가 나오면 어색한 침묵과 시무룩한 루이스가 나옵니다.
박람회의 퀴즈 부스
스타듀 밸리 페어에 퀴즈 부스를 추가하세요. 진행자가 "수확 후 다시 자라는 것은 블루베리와 멜론 중 무엇일까요?"와 "파스닙이 자라는 데 며칠이 걸릴까요?"라고 묻습니다.
퀴즈 엔진(Team 요금제)이 /v3/quiz를 통해 질문, 점수 계산, 리더보드를 맡고, 모드는 작물을 아는 플레이어에게 별 토큰을 지급합니다.
음성으로 농사짓기
행위자("farmhand", "me"), 행동("water", "harvest", "pet", "plant", "equip"), 대상("crops", "cows", "parsnip seeds", "watering can")으로 명령 세트를 설계하세요. "Water the crops and pet the cows"는 두 명령으로 들어오고, "plant twenty parsnip seeds"는 수량이 붙은 채로 들어옵니다. 모드는 이 명령을 도우미 NPC에게 시키거나 플레이어의 도구로 실행합니다. Neocortex Voice Commands 라이브러리가 플레이어의 컴퓨터에서 매칭을 처리하므로, 클라우드를 거치지 않습니다. 음성 쪽을 더 깊이 알고 싶다면 게임 모드를 위한 온디바이스 음성 명령을 읽어 보세요.
Voice Commands는 라이선스가 있는 SDK입니다. Voice Commands 라이선스 문의하기.
순서대로 보는 Stardew Valley AI 주민 모드 만들기
- SMAPI 설치하기. 위키의 모더 가이드에 따라 C# 모드 프로젝트를 설정합니다.
- 주민 설계하기. Neocortex 대시보드에서 주민을 만들고, Luau 흐름과 농사 질문 세트도 만듭니다. 브라우저에서 먼저 테스트하세요.
- 명령 세트 설계하기. 농사 작업을 위해 행동마다 예시 문구를 몇 개씩 붙입니다.
- 모드에서 연결하기. 게임 루프를 막지 않고
/v3/chat을 호출하고,sessionId를 재사용하며, 행동을 게임 코드에 연결합니다. - API 키는
config.json에 두기. 플레이어가 입력하게 하고, 공유 모드에 하드코딩하지 마세요. - 푹 누르고 말하기로 싱글플레이 세이브에서 테스트하기. 다른 무엇보다 먼저 하세요.
협동 플레이, Nexus Mods, 공정한 플레이
모드는 무료이며 비상업적으로 유지하고, Nexus Mods나 ModDrop처럼 게시하는 사이트의 규칙을 따르세요. 싱글플레이 세이브를 기준으로 만드세요. 협동 플레이에서는 모드를 가진 친구들이 동의한 경우에만 쓰세요. 각 플레이어는 자신의 Neocortex API 키를 씁니다.
어디서부터 시작할까
주민 한 명, 계절 하나부터 시작하세요. 가장 자주 대화하는 캐릭터를 골라 Neocortex에서 만들고, 브라우저에서 대화를 테스트한 뒤, 루아우와 박람회는 나중에 붙이세요. Neocortex가 다른 AI 캐릭터 플랫폼과 어떻게 다른지는 비교 페이지에서 볼 수 있습니다. 다른 식민지를 위해 만든다면, RimWorld AI 식민지 대화 모드와 Minecraft AI NPC 모드 가이드를 보거나, AI NPC와 음성 명령 모드 전체 목록을 확인하세요.
도구 버전과 링크는 2026년 10월에 확인했습니다. 모딩 도구는 자주 바뀌므로, 최신 릴리스는 각 프로젝트 페이지에서 확인하세요.
자주 묻는 질문
Stardew Valley 주민에게 AI 대화를 추가할 수 있나요?
네. SMAPI 모드는 호감도, 선물, 달력을 읽고, 웹 API를 호출하고, 게임의 대화 상자에 텍스트를 보여 줄 수 있는 C# 코드입니다. Neocortex 캐릭터는 그 관계를 고려해 주민의 역할에 맞게 답할 수 있습니다.
Stardew Valley AI 모드에 SMAPI나 Content Patcher가 필요한가요?
SMAPI가 필요합니다. 네트워크 호출을 하고 응답에 반응할 수 있는 것은 C# 코드뿐이기 때문입니다. Content Patcher는 데이터, 이미지, 맵을 수정하는 콘텐츠 팩용이므로 초상화나 손으로 쓴 대사에 잘 어울리지만, AI 쪽은 SMAPI 모드에서 실행됩니다.
AI 주민이 나와의 관계를 기억하나요?
기억할 수 있습니다. 모드가 메시지마다 하트 단계, 최근 선물, 사건을 보내고, Neocortex가 대화 세션을 유지합니다. 주민은 내 농장에서 실제로 일어난 일에 반응합니다.
Stardew Valley에서 음성 명령으로 농사를 지을 수 있나요?
모드를 쓰면 음성을 농장 행동으로 바꿀 수 있습니다. Neocortex Voice Commands는 플레이어의 PC에서 실행되며, "water the crops and pet the cows" 같은 문구를 오프라인으로 인식해 각 명령을 모드에 전달합니다. 라이선스가 있는 SDK이므로, 라이선스는 저희에게 문의하세요.






