Mod di Mail Framework

Obiettivo:
Semplifica l'invio di posta al giocatore, dandogli un maggiore controllo su quando e cosa ricevere.
Inoltre, vengono fornite più opzioni non possibili modificando semplicemente i file di dati, come cambiare a piacimento il colore del testo e lo sfondo della lettera.

Installazione:

• Installa l'ultima versione di SMAPI.
• Decomprimi MailFrameworkModin /Stardew Valley/Mods.
  

Registro delle modifiche:

1.20.0

• Aggiunge una nuova risorsa personalizzata al gioco. (DIGUS.MailFrameworkMod/MailData). Ciò significa che le lettere MFM possono ora essere caricate con Content Patcher e sfruttarne tutte le funzionalità, come i token. Supporta le stesse proprietà.
• Anche le lettere del pacchetto di contenuti vengono caricate nella nuova risorsa personalizzata e pertanto possono essere modificate con Content Patcher.
• I pacchetti di contenuti ora vengono caricati in una cache all'avvio del gioco, anziché essere ricaricati ogni volta che si carica un salvataggio. È possibile forzare il ricaricamento dei pacchetti di contenuti tramite il comando della console.
• Le proprietà Testo e Titolo ora supportano la stringa tokenizzabile.
• Ora le risorse texture possono essere una risorsa di gioco e non solo una risorsa nella cartella mod.
• Nuova proprietà GameStateQuery come condizione per recapitare una lettera.
  

1.19.0

• Nuova proprietà per mantenere valida una posta una volta che tutte le condizioni sono state soddisfatte per un giorno, ma la posta non è stata letta quel giorno.
• Nuova funzionalità per gestire gli allegati scelti casualmente
• Nuova proprietà per impostare la quantità di articoli dall'elenco degli allegati da scegliere per la consegna.
• Nuova proprietà per impostare un "RandomGroup" su un allegato, in modo che venga scelto da quel gruppo anziché dall'intero elenco.
• Nuova proprietà per impostare un "Peso" per un dato allegato, quando viene scelto casualmente.
• Nuova proprietà per impostare quanti elementi devono essere selezionati da un dato gruppo, invece di utilizzare il valore predefinito.
• Nuova proprietà per indicare se un elemento di un dato gruppo può essere scelto più di una volta.
• Nuovo set di proprietà per impostare un requisito MailReceived per allegati e risposte
• Nuova proprietà per impostare un MailReceived da rimuovere quando una lettera viene letta o quando viene selezionata un'opzione di risposta.
• Nuova proprietà per impostare un costo per una determinata opzione di risposta.
• Nuovo ItemType "Nessuno". Fondamentalmente da utilizzare quando si desidera una probabilità casuale di non consegnare un articolo, senza che vengano generati errori/avvisi nel registro.
  

1.18.0

• Nuova proprietà Ids per sostituire Indice e Nome per CollectionConditions. Può aggregare il conteggio di più elementi, sommandone il valore per confrontarlo con l'importo.
• Nuova proprietà ReplyConfig per aggiungere un comportamento di risposta. È possibile mostrare un'opzione al giocatore dopo aver letto una mail e questo aggiungerà uno o più testi MailReceived in base all'opzione scelta. È possibile implementare ulteriore logica di mod in base a tale scelta.
• Correzione della lettera con ricetta che non supporta la proprietà CustomTextColorName.
• Correzione dell'eccezione di riferimento nullo quando nel gioco veniva caricato un oggetto con nome nullo.
  

1.17.1

• Le e-mail con pacchetti di contenuto con proprietà ricetta non devono avere allegati per essere recapitate se la ricetta non è stata appresa. (la proprietà ricetta viene ignorata se sono presenti allegati)
• Correggi le ricette di cucina con la stessa logica applicata in precedenza alle ricette di creazione.
  

1.17.0

• Nuova proprietà per impostare la qualità dell'allegato
• Le e-mail contenenti i pacchetti di contenuti con la ricetta devono essere reinviate se la ricetta non è stata appresa.
• Correggi gli avvisi su Slingshot se si utilizza l'ID articolo qualificato.
• Correggi le ricette per gli oggetti realizzabili consegnate anche se la ricetta era già stata appresa.
• Per motivi di legacy, se l'ID della ricetta non viene trovato nelle ricette apprese, verrà cercata una ricetta che crei un elemento con il nome dell'ID della ricetta.
  

1.16.1

• Correzione del nome tradotto della ricetta.
  

1.16.0

• Aggiorna la mod per renderla compatibile con Stardew Valley 1.6
• Nuovo comando per ricaricare i pacchetti di contenuti
• Cambiato il nome di MailDao in MailRepository. (Riguarda solo i mod SMAPI che lo utilizzano)
• Nuovo tipo di oggetto 'QualifiedItemId' per gli allegati, dovrebbe funzionare per ogni tipo di oggetto nel gioco se si utilizza la qualificazione corretta.
• Nuova proprietà per date speciali. (Matrimonio e Parto)
• Nuova proprietà per CustomTextColor, quella vecchia è obsoleta.
• Nuova proprietà HasMods
• Nuova proprietà RequireAllMods
• Gli ID degli eventi ora sono stringhe. (I numeri dovrebbero continuare a funzionare)
• Rimossa la logica obsoleta SV 1.6 incorporata da MFM.
• Risolto il problema della versione alpha per cui la lettera non si apriva nella pagina di raccolta della posta.
  

Per i Modder che vogliono utilizzare il pacchetto di contenuti:

• All'interno della cartella mod è presente un modello con istruzioni commentate su cosa fa ogni proprietà.
• Tutte le caratteristiche delle lettere, ad eccezione delle condizioni e del callback, sono le stesse della codifica con il framework.
• Le condizioni sono limitate a quelle implementate e la callback imposta sempre l'ID della lettera come ricevuto. Se hai bisogno di condizioni avanzate, dovresti comunque codificarle. Oppure puoi cortesemente suggerirmi di aggiungere una condizione al pacchetto di contenuti: se ha senso, potrei aggiungerla.
• Ecco il modello aggiunto nel file mod:
  

Per far sì che Modder utilizzi l'API:

• CopiaIMailFrameworkModApiinterfaccia con il metodo che si desidera utilizzare dall'interfaccia MFM.
• CopiaLetterase uno dei metodi lo richiede.
• Metodi:
  
  • RegisterContentPack- UtilizzoHelper.ContentPacks.CreateTemporaryPer caricare una cartella dal tuo mod che contenga il file mail.json e una possibile cartella i18n per le traduzioni. Il manifesto non è necessario, poiché puoi usare quel parametro del metodo.
  • Lettera di registrazione- Compila una ILetter con le proprietà di cui hai bisogno. È richiesta anche una condizione per registrare una lettera. È consigliabile una callback, per aggiungere almeno l'ID della lettera ricevuta. Vedi esempi qui sotto, su "Per Modder per codificare con dipendenza MFM" sessione.
  • OttieniLettera- Otterrai l'oggetto ILetter per l'ID della lettera.
  • Ottieni stringa dati posta- Otterrai la stringa di dati di posta per l'ID della lettera. La stringa di dati di posta è fondamentalmente il testo tradotto più il titolo tradotto con un separatore [#].
    

Per Modder per codificare con dipendenza MFM:

• Fai riferimento a MailFrameworkMod.dll nel tuo progetto SMAPI.
  
  • Registri la tua lettera utilizzando MailRepository.SaveLetter(Letter)
  • All'inizio di ogni giorno, il moderatore controllerà le lettere che hanno raggiunto la condizione di consegna e le aggiungerà alla cassetta postale.
  • Queste lettere verranno aperte per prime quando il giocatore controllerà la cassetta postale.
  • Una volta aperta, la lettera viene rimossa dalla cassetta postale.
  • La condizione di callback della lettera è chiamata così.
  • Alla fine della giornata le lettere rimaste nella cassetta della posta verranno rimosse, quindi non verranno salvate dal gioco.
    
• Puoi pensare a questa mod come a un archivio per le tue lettere. Funziona meglio se carichi tutte le tue lettere quando il gioco si carica.
  

Esempi:

Anticipazione:

Spettacolo

Caricamento di una semplice lettera che verrà mostrata al giocatore se non è stata letta in precedenza e non verrà più consegnata dopo essere stata aperta dal giocatore:
MailRepository.SaveLetter(
nuova lettera(
"LetterUniqueId"
,"Testo personalizzato."
,(l)=>!Game1.player.mailReceived.Contains(l.Id)
,(l)=>Game1.player.mailReceived.Add(l.Id)
)
);


Caricamento di una semplice Lettera come prima, ma con 5 Smeraldi annessi:
MailRepository.SaveLetter(
nuova lettera(
"LetterUniqueId"
,"Testo personalizzato."
,nuovo Elenco { nuovo StardewValley.Object(60,5) }
,(l)=>!Game1.player.mailReceived.Contains(l.Id)
,(l)=>Game1.player.mailReceived.Add(l.Id)
  )
);

Il giocatore non riceverà lo stesso oggetto, ma una copia restituita dal metodo getOne().

Caricando una semplice lettera che insegnerà una ricetta di cucina, questa verrà consegnata se il giocatore non la conosce. La mod insegna automaticamente le ricette quando il giocatore carica, senza bisogno di un callback:
MailRepository.SaveLetter(
nuova lettera(
"LetterUniqueId"
, "Testo personalizzato."
, "NomeUnivocoRicetta"
, (l) => !Game1.player.cookingRecipes.ContainsKey(l.Recipe)
  )
);

Il valore "RecipeUniqueName" deve essere lo stesso memorizzato in "Data//CookingRecipes" o "Data//CraftingRecipes".

Caricamento di una lettera semplice con testo e sfondo diversi:
MailRepository.SaveLetter(
nuova lettera(
"LetterUniqueId"
,"Testo personalizzato."
,(l)=>!Game1.player.mailReceived.Contains(l.Id)
,(l)=>Game1.player.mailReceived.Add(l.Id)
1
){Colore del testo=8}
);


Caricamento di una lettera semplice con sfondo personalizzato:
MailRepository.SaveLetter(
nuova lettera(
"LetterUniqueId"
,"Testo personalizzato."
,(l)=>!Game1.player.mailReceived.Contains(l.Id)
,Game1.player.mailReceived.Add(l.Id)
1
){
LetterTexture=helper.Content.Load("CustomLetterBG.png")
,Colore del testo=4
  }
);
Dove CustomLetterBG.png è un file immagine che segue la stessa struttura di "LooseSprites//letterBG"

Caricamento di una semplice lettera con traduzione del testo e del titolo.
MailRepository.SaveLetter(
nuova lettera(
"LetterUniqueId"
,"myletter.translation.key.text"
,(l)=>!Game1.player.mailReceived.Contains(l.Id)
,(l)=>Game1.player.mailReceived.Add(l.Id)
){
Titolo = "myletter.translation.key.title",
I18N = helper.Traduzione
    }
);



Le mie altre mod:

• Mod per l'allevamento di animali
• Mod di campo di ritenzione idrica
• Mod Crystalarium personalizzato
• Mod Trapianto di Colture
• Mod botte personalizzata
  

• Mod Bacio Personalizzato
  

• Mod per pavimento in legno senza bordi
  

• Mod produttore personalizzato
• Mod Servizi di Posta
• Mod Tavolo Arcano
• Mod dei lampioni Gem
• Mod avanzato per botti