Token di compatibilità cross-mod (CMCT)

I token di compatibilità tra mod aggiungono alcuni token speciali e personalizzati di Content Patcher che ti consentono (se sei un autore di mod) di accedere ai valori di configurazione, alle traduzioni e ai token dinamici di altre mod, incluse mod non specificamente create per Content Patcher. Questi possono essere utili se non hai altro modo per garantire la perfetta compatibilità tra la tua mod e la loro, nel caso in cui dovessi apportare modifiche in base a uno qualsiasi dei valori sopra menzionati.

Installazione

• Installa l'ultima versione di SMAPI.
• Estrarre la mod in Stardew Valley/Mods.
• Esegui il gioco utilizzando SMAPI.
  

Utilizzo per i giocatori
Questa mod non fa nulla da sola. Non c'è alcun vantaggio nell'installarla come utente se un'altra mod che stai utilizzando non la richiede.

Utilizzo per gli autori di Content Patcher Mod
Questa mod aggiunge quattro token:

• Spiderbuttons.CMCT/Config
• Spiderbuttons.CMCT/Traduzione
• Spiderbuttons.CMCT/Dinamico
• Spiderbuttons.CMCT/Asset
  

Ognuno di questi token ti permetterà di acquisire rispettivamente i valori di configurazione, le stringhe di traduzione, i valori dei token dinamici o le chiavi delle risorse interne. Tutti e quattro richiedere Argomenti di input. Il primo argomento di input sarà sempre l'ID univoco della mod da cui si sta cercando di ottenere il valore. Il secondo argomento di input dipenderà dal token in questione:

• Configurazione: il nome del valore di configurazione da trovare. Se il valore di configurazione è annidato, è necessario includere il percorso di configurazione completo in base alla struttura JSON.
• Traduzione: la chiave i18n della traduzione desiderata. Acquisirà sempre la traduzione per la lingua attualmente selezionata.
• Dinamico: il nome del token dinamico.
• Risorsa: il percorso della risorsa dall'altra mod relativa a loro file manifest.json.
  

Se usi uno di questi token, tu dovere imposta l'altra mod come dipendenza. Se non lo fai, Potrebbe funziona, ma potrebbe anche generare degli strani errori. Ecco quattro esempi, uno per ciascuno dei token, utilizzando Cerca qualsiasi cosa, Topolino con cappello Lacey, E I libri extra di Button per dimostrazione:

• {{Spiderbuttons.CMCT/Config: Pathoschild.LookupAnything, Controlli.ToggleSearch}}
• {{Spiderbuttons.CMCT/Traduzione: ichortower.HatMouseLacey, houseDisplayName}}
• {{Spiderbuttons.CMCT/Dynamic: ichortower.HatMouseLacey, Lacey}}
• {{Spiderbuttons.CMCT/Asset: Spiderbuttons.ButtonsExtraBooks, assets/Books/sheet.png}}
  

Limitazioni
Attualmente, ci sono due cose principali che considererei delle limitazioni:

• Le traduzioni che accettano token come input (ad esempio valori i18n che hanno i propri {{token}} all'interno dell'i18n stesso) non funzionano correttamente e acquisiranno solo la stringa letterale con il token ancora presente tra parentesi graffe.
• I token dinamici vengono inizializzati solo quando viene caricato un salvataggio, non quando si avvia il gioco. Questo potrebbe interessarti o meno.
  

Vale anche la pena menzionare che dovresti usare il token dinamico il più parsimoniosamente possibileSenza entrare troppo nei dettagli tecnici sul funzionamento di Content Patcher, a causa del modo in cui ho dovuto implementare il token, segnaleranno sempre che le modifiche devono essere propagate, anche se il token dinamico che stanno controllando da un altro moderatore non è cambiato. Questo non è un problema se il token aggiorna solo OnDayStart come fanno di default, ma può diventare potenzialmente costoso se lo si aggiorna OnTimeChange o OnLocationChange!

Codice sorgente