메일 프레임워크 모드

목적:
플레이어에게 보내는 메일을 간소화하여 언제, 무엇을 받아야 하는지에 대한 통제력을 강화합니다.
또한 데이터 파일을 편집하는 것만으로는 불가능한 더 많은 옵션, 즉 글자의 텍스트 색상과 배경을 원하는 대로 바꾸는 기능도 제공합니다.

설치:

• SMAPI 최신 버전을 설치하세요.
• MailFrameworkMod 압축 해제/Stardew Valley/Mods로 들어갑니다.
  

변경 로그:

1.20.0

• 게임에 새로운 사용자 지정 에셋(DIGUS.MailFrameworkMod/MailData)이 추가되었습니다. 즉, 이제 MFM 문자를 Content Patcher에 로드하여 토큰과 같은 모든 기능을 사용할 수 있습니다. 동일한 속성을 지원합니다.
• 콘텐츠 팩 문자도 새로운 사용자 정의 자산에 로드되므로 콘텐츠 패처로 편집할 수 있습니다.
• 콘텐츠 팩은 이제 저장 파일을 불러올 때마다 다시 로드되는 대신, 게임 시작 시 캐시에 자동으로 로드됩니다. 콘솔 명령어를 사용하여 콘텐츠 팩을 강제로 다시 로드할 수 있습니다.
• 이제 텍스트 및 제목 속성에서 토큰화 가능한 문자열이 지원됩니다.
• 텍스처 자산은 이제 모드 폴더의 자산이 아니라 게임 자산이 될 수 있습니다.
• 새로운 GameStateQuery 속성은 편지를 전달하기 위한 조건입니다.
  

1.19.0

• 모든 조건이 하루 동안 충족되었지만 그날 우편물이 읽히지 않은 경우에도 우편물을 유효하게 유지하기 위한 새로운 속성입니다.
• 무작위로 선택된 첨부 파일을 처리하는 새로운 기능
• 첨부 파일 목록에서 얼마나 많은 항목을 선택하여 배달할지 설정하는 새로운 속성입니다.
• 첨부 파일에 "RandomGroup"을 설정하는 새로운 속성이 추가되어 전체 목록 대신 해당 그룹에서 선택할 수 있습니다.
• 첨부 파일을 무작위로 선택할 때 해당 첨부 파일의 "가중치"를 설정하는 새로운 속성입니다.
• 기본값을 사용하는 대신, 주어진 그룹에서 얼마나 많은 항목을 선택해야 하는지 설정하는 새로운 속성이 추가되었습니다.
• 주어진 그룹의 항목을 두 번 이상 선택할 수 있는지 여부를 알려주는 새로운 속성입니다.
• 첨부 파일 및 회신에 대한 MailReceived 요구 사항을 설정하는 새로운 속성 세트
• 편지가 읽히거나 답장 옵션이 선택되면 MailReceived를 제거할 수 있는 새 속성을 추가합니다.
• 주어진 답변 옵션에 대한 비용을 설정하는 새로운 속성입니다.
• 새 ItemType "None". 기본적으로 로그에 오류/경고를 발생시키지 않고 아이템을 배송하지 않을 확률을 임의로 지정하고자 할 때 사용됩니다.
  

1.18.0

• CollectionConditions의 Index와 Name을 대체하는 새로운 Ids 속성입니다. 여러 항목의 개수를 집계하여 값을 더한 후 수량과 비교할 수 있습니다.
• 새로운 ReplyConfig 속성을 통해 답장 동작을 추가할 수 있습니다. 메일을 읽은 후 플레이어에게 특정 옵션을 표시할 수 있으며, 선택한 옵션에 따라 하나 이상의 MailReceived 텍스트가 추가됩니다. 해당 선택에 따라 추가적인 모드 로직을 구현할 수 있습니다.
• CustomTextColorName 속성을 지원하지 않는 레시피가 포함된 문자를 수정했습니다.
• 게임에서 이름이 null인 아이템을 로드할 때 발생하는 null 참조 예외를 수정했습니다.
  

1.17.1

• 레시피 속성이 있는 콘텐츠 팩 메일은 레시피가 학습되지 않은 경우 재전송되기 위해 첨부 파일이 없어야 합니다. (첨부 파일이 있는 경우 레시피 속성은 무시됩니다.)
• 이전에 제작 레시피에 적용되었던 것과 동일한 논리를 요리 레시피에도 적용합니다.
  

1.17.0

• 첨부 파일의 품질을 설정하는 새로운 속성
• 레시피가 학습되지 않은 경우, 레시피가 포함된 콘텐츠 팩 메일을 다시 전달해야 합니다.
• 적격 아이템 ID를 사용하는 경우 Slingshot에 대한 경고를 수정합니다.
• 이미 제작법을 배웠더라도 제작법이 전달되는 문제를 수정했습니다.
• 레거시 이유로 인해 학습된 레시피에서 레시피 ID를 찾을 수 없는 경우 레시피 ID의 이름으로 항목을 생성하는 레시피를 찾습니다.
  

1.16.1

• 번역된 요리법 이름을 수정했습니다.
  

1.16.0

• Stardew Valley 1.6과 호환되도록 모드를 업데이트하세요
• 콘텐츠 팩을 다시 로드하는 새로운 명령
• MailDao 이름을 MailRepository로 변경했습니다. (이 기능을 사용하는 SMAPI 모드에만 적용됩니다.)
• 첨부 파일에 대한 새로운 아이템 유형 'QualifiedItemId'는 적절한 자격을 사용하면 게임 내 모든 유형의 아이템에 적용 가능합니다.
• 특별한 날짜에 맞춰 예약 가능한 새 숙소입니다. (결혼 및 출산)
• CustomTextColor에 대한 새로운 속성이 추가되었고, 기존 속성은 더 이상 사용되지 않습니다.
• 새로운 HasMods 속성
• 새로운 RequireAllMods 속성
• 이벤트 ID가 이제 문자열입니다. (숫자도 여전히 작동해야 합니다.)
• MFM에 통합된 오래된 로직 SV 1.6을 제거했습니다.
• 알파 버전에서 편지 수집 페이지에서 편지가 열리지 않는 문제가 해결되었습니다.
  

모더가 콘텐츠 팩을 사용하려면:

• 모드 폴더 안에는 각 속성의 기능에 대한 설명이 주석으로 달린 템플릿이 있습니다.
• 모든 문자 기능을 제외하고 조건과 콜백은 프레임워크로 코딩하는 것과 동일합니다.
• 조건은 구현된 조건으로 제한되며, 콜백은 항상 문자 ID를 수신됨으로 설정합니다. 고급 조건이 필요한 경우에도 코드를 작성해야 합니다. 또는 콘텐츠 팩에 조건을 추가하도록 정중하게 제안해 주셔도 됩니다. 타당한 내용이라면 추가해 드릴 수 있습니다.
• 모드 파일에 추가된 템플릿은 다음과 같습니다.
  

Modder가 API를 사용하려면:

• 복사IMailFrameworkModApiMFM 인터페이스에서 사용하고자 하는 메서드와 인터페이스를 연결합니다.
• 복사ILetter만약 그 방법 중 하나에 필요하다면.
• 행동 양식:
  
  • 등록 콘텐츠 팩- 사용도우미.콘텐츠팩.임시생성mod에서 mail.json 파일과 번역을 위한 i18n 폴더가 포함된 폴더를 로드합니다. 해당 메서드 매개변수를 사용할 수 있으므로 매니페스트는 필요하지 않습니다.
  • 등록편지- 필요한 속성으로 ILetter를 채우세요. 편지를 등록하려면 조건도 필요합니다. 최소한 수신된 편지 ID를 추가하는 콜백을 사용하는 것이 좋습니다. 아래 "Modder가 MFM 종속성을 사용하여 코드를 작성하려면" 세션.
  • 겟레터- 문자 ID에 대한 ILetter 객체를 얻게 됩니다.
  • GetMailDataString- 문자 ID에 대한 메일 데이터 문자열을 받게 됩니다. 메일 데이터 문자열은 기본적으로 번역된 텍스트와 번역된 제목을 [#]으로 구분한 것입니다.
    

Modder가 MFM 종속성을 사용하여 코드를 작성하려면 다음을 수행합니다.

• SMAPI 프로젝트에서 MailFrameworkMod.dll을 참조하세요.
  
  • MailRepository.SaveLetter(Letter)를 사용하여 편지를 등록합니다.
  • 매일 시작 시 관리자는 배달 가능 상태에 도달한 편지를 확인하고 이를 우편함에 추가합니다.
  • 이 편지는 플레이어가 우편함을 확인할 때 가장 먼저 열립니다.
  • 편지를 열면 편지함에서 편지가 제거됩니다.
  • 해당 문자의 콜백 조건은 호출되는 것입니다.
  • 하루가 끝나면 우편함에 남아 있는 편지는 제거되므로 게임에서 저장되지 않습니다.
    
• 이 모드는 편지를 보관하는 저장소라고 생각하면 됩니다. 게임이 로딩될 때 모든 편지를 불러오는 것이 가장 효과적입니다.
  

예:

스포일러:

보여주다

플레이어가 이전에 읽지 않은 경우 표시되고, 플레이어가 열면 다시 전달되지 않는 간단한 편지를 로드합니다.
메일 저장소.SaveLetter(
새로운 편지(
"LetterUniqueId"
,"편지 사용자 정의 텍스트."
,(l)=>!Game1.player.mailReceived.Contains(l.Id)
,(l)=>Game1.player.mailReceived.Add(l.Id)
)
);


이전과 마찬가지로 간단한 편지를 로드하지만 에메랄드 5개를 첨부합니다.
메일 저장소.SaveLetter(
새로운 편지(
"LetterUniqueId"
,"편지 사용자 정의 텍스트."
,새로운 목록<아이템> { 새로운 StardewValley.Object(60,5) }
,(l)=>!Game1.player.mailReceived.Contains(l.Id)
,(l)=>Game1.player.mailReceived.Add(l.Id)
  )
);

플레이어는 동일한 아이템을 받지 않고, getOne() 메서드에서 반환된 복사본을 받습니다.

요리 레시피를 알려주는 간단한 편지를 로딩합니다. 플레이어가 레시피를 모르면 편지가 전달됩니다. 모드는 플레이어가 로딩될 때 자동으로 레시피를 알려주므로, 콜백은 필요하지 않습니다.
메일 저장소.SaveLetter(
새로운 편지(
"LetterUniqueId"
, "문자 사용자 정의 텍스트."
, "레시피 고유 이름"
, (l) => !Game1.player.cookingRecipes.ContainsKey(l.레시피)
  )
);

"RecipeUniqueName"은 "Data//CookingRecipes" 또는 "Data//CraftingRecipes"에 저장된 것과 동일해야 합니다.

다양한 텍스트와 배경을 가진 간단한 편지 로딩:
메일 저장소.SaveLetter(
새로운 편지(
"LetterUniqueId"
,"편지 사용자 정의 텍스트."
,(l)=>!Game1.player.mailReceived.Contains(l.Id)
,(l)=>Game1.player.mailReceived.Add(l.Id)
1
){텍스트색상=8}
);


사용자 정의 배경을 사용하여 간단한 편지 로드:
메일 저장소.SaveLetter(
새로운 편지(
"LetterUniqueId"
,"편지 사용자 정의 텍스트."
,(l)=>!Game1.player.mailReceived.Contains(l.Id)
,Game1.player.mailReceived.Add(l.Id)
1
){
LetterTexture=helper.Content.Load("CustomLetterBG.png")
,텍스트색상=4
  }
);
여기서 CustomLetterBG.png는 "LooseSprites//letterBG"와 동일한 구조를 따르는 이미지 파일입니다.

텍스트와 제목을 번역한 간단한 편지를 로드합니다.
메일 저장소.SaveLetter(
새로운 편지(
"LetterUniqueId"
,"myletter.translation.key.text"
,(l)=>!Game1.player.mailReceived.Contains(l.Id)
,(l)=>Game1.player.mailReceived.Add(l.Id)
){
제목 = "myletter.translation.key.title",
I18N = 도우미.번역
    }
);



내 다른 모드:

• 동물 사육 모드
• 물 유지 필드 모드
• 커스텀 크리스탈리움 모드
• 작물 이식 모드
• 커스텀 캐스크 모드
  

• 커스텀 키싱 모드
  

• 테두리 없는 나무 바닥 모드
  

• 커스텀 프로듀서 모드
• 메일 서비스 모드
• 아케인 테이블 모드
• 보석 램프 포스트 모드
• 고급 캐스크 모드