04 TUTORIAL: Come si assegnano le funzioni ai Parametri 1

[Lomax_Iced]

Ragazzi vedevo quel post Chilometrico (03Tutorial) che mi faceva paura. Avevo esigenza di frammentare la spiegazione.  :smile: 
Dunque: 
Se volete ripassare qualche vecchio argomento, vi invito a rivedere i tutorial precedenti:
00T:
http://www.rpg2s.net...er-mv</strong>/
01T:
http://www.rpg2s.net...ginjs</strong>/
02T:

http://www.rpg2s.net...biamo</strong>/
03T:
http://www.rpg2s.net...lugin</strong>/
 

Bene facciamo un breve riepilogo per riallacciarci al tutorial precedente:
Plugin Direttamente in Mappa:

Spoiler

//=================================================
/*:
* @plugindesc
* Permette di saltare lo Scene_Title
* @author
* Lomax_Iced
* @param
* Parametro1
* @desc
* Questo comando descrive
* la funzione del parameto
* @default
* 0
* @help
* Istruzioni per l'uso
*/
//=================================================
var parameters = PluginManager.parameters('Direttamente in Mappa');

var parameter = Number(parameters['Parametro1'] || 0);

Scene_Boot.prototype.start = function() {
Scene_Base.prototype.start.call(this);
SoundManager.preloadImportantSounds();
if (DataManager.isBattleTest()) {
DataManager.setupBattleTest();
SceneManager.goto(Scene_Battle);
} else if (DataManager.isEventTest()) {
DataManager.setupEventTest();
SceneManager.goto(Scene_Map);
} else {
this.checkPlayerLocation();
DataManager.setupNewGame();
//SceneManager.goto(Scene_Title);
//Window_TitleCommand.initCommandPosition();
DataManager.setupNewGame();
SceneManager.goto(Scene_Map);
}
this.updateDocumentTitle();
};

Bene. Compilando questo script abbiamo imparato:

1. A riconoscere la porzione di codice che ci permette di dialogare con l'Rpg Maker. 

Spoiler

Ne approfitto per ripassare i comandi che abbiamo imparato fin'ora e che appartengono a questa sezione di plugin:

 

                    //   <- questo simbolo genera una stringa commento .  (in realtà potete inserirlo in qualsiasi parte del corpo del plugin)

                  /*:    <- quest'altro apre la testa del plugin dove vi verranno inserite le informazioni .

                     *   <- questo asterisco precede sempre ogni stringa del box (testa del plugin). Serve ad inserire le informazioni.

@plugindesc   <- questo comando permette di far apparire in RpgMakerMv una descrizione del Plugin da noi creata. 

@author           <- specifica l'autore o gli autori del Plugin e lo visualizza nell'apposita sezione dedicata in RpgMakerMv.

@param            <- nomina un parametro che vorremo assegnare al nostro Plugin.

@desc              <- descrive la funzionalità che dovrebbe assumere il parametro che vorremmo inserire nel nostro Plugin.

@default          <- assegna un valore al parametro presente nel nostro plugin.

@help              <- si occupa di inserire nell'apposita finestra di dialogo 'Guida' di Rpg Maker Mv, le istruzioni per l'uso dello script.

                     */  <- questo simbolo chiude il box di testa del plugin. 

2. A dichiarare in un Plugin che verranno utilizzati i parametri appartenenti a quello script specifico:

Spoiler

var parameters = PluginManager.parameters('Direttamente in Mappa');

Dove:
var                      <- indica il comando di richiamo.

parameters        <- la fattispecie dell'oggetto che verrà richiamato.

=                         <- è un operatore logico, in questo caso indica che i parametri che verranno presi in considerazione saranno Uguali,

                               ovvero saranno quelli appartenenti al plugin Direttamente in Mappa.js .

PluginManager <- è una superclasse. dire PluginManager.parameters equivale a dire i parametri della superclasse in questo caso

                               Direttamente in Mappa.js che verrà indicata entro virgolette chiuse dentro parentesi tonde.

;                          <- Questo simbolo lo reputo importantissimo. Serve per far capire all'eseguibile e ai programmatori, la fine di una 

                                stringa. Non è obbligatorio usarlo però, non farlo, potrebbe generare delle errate interpretazioni dell'eseguibile. 

Comunque volendo tradurre questa stringa:
Adesso verranno usati i parametri appartenenti al Plugin Direttamente in Mappa.js   !!!

3. A dichiarare i singoli parametri che formano lo script:

Spoiler

var parameter = parameters['Parametro1'];

Dove: 
var                       <- funge sempre da comando di richiamo.

parameter           <- è l'oggetto che si vuole richiamare.

=                          <- è sempre l'operatore logico  che associa la fattispecie all'oggetto specifico. 

parameters['']     <- è l'array che ospiterà il o i parametri che verranno richiamati. in questo caso è solo Parametro1. 

;                           <- il solito simbolo che indica la chiusura di una dichiarazione.

Quindi traduzione:
Verrà richiamato il parametro appartenente al Plugin Direttamente in Mappa.js, nominato Parametro1. 

4. Ad dichiarare un valore numerico, assegnato all'array che ospita al suo interno uno o più parametri. 

Spoiler

var parameter = Number(parameters['Parametro1'] || 0);

Dove:
var                       <- è sempre il comando di richiamo della funzione.

parameter           <- è l'oggetto a cui si riferisce il richiamo.

=                          <- è sempre l'operatore logico  che associa la fattispecie all'oggetto specifico.

Number()             <- è la tipologia di valore che vogliamo far assumere al parametro. 

                                (ricordiamo che esso può essere Numerico, Testuale, oppure Logico)

parameters['']      <- è l'array che ospita il singolo o i più parametri che apparterranno al Plugin.
||                           <- questi simboli indicano che tutto quello associato all'array assume il valore che lo sussegue. 
0                           <- zero (in questo caso) è il valore che è stato assegnato all'array. e quindi di conseguenza al Parametro1.

;                           <- il solito simbolo che indica la chiusura di una dichiarazione.
Volendo tradurre questa dicitura:
Verrà richiamato il parametro appartenente al Plugin Direttamente in Mappa.js, nominato Parametro1 a cui verrà assegnato il valore numerico di partenza pari a zero!

Fatto il doveroso riepilogo..
Procediamo:   


Innanzitutto voglio segnalarvi un errore nel mio script Direttamente in Mappa.js (c'è qualcuno che mi segue  :unsure: link..)
Comunque|   

Spoiler

Dunque: 
L'errore sta nel fatto che se il giocatore avvia il gioco, lo script funge. Ma se il giocatore dovesse entrare nel menu principale e seleziona la voce 'Termina' e quindi entra nel sotto menu 'torna al titolo' o ' cancella' e digita 'torna al titolo'. 
Lo script non funge più e appare il menu del titolo. Che oddio in un game comunque non è male. Non lo considero un errore, anzi. 
Comunque, per chi volesse risolvere questa cosa, solo a scopo didattico. 
Vi illustro il da farsi, così imparerete a riconoscere il metodo che gestisce il Game_End del vostro gioco. 

Come per il precedente metodo: (consulta 01T: per capire a cosa mi riferisco) 

 

1. Bisogna recarsi nel nostro rpg_scenes.js

2. Cercate la stringa 1613

3. Copiate le stringhe da 1613 a 1616
4. Incollate il tutto verso la fine del vostro script (creato da voi). 
     quindi appena sotto l'ultimo vostro   }; 
5. Il tutto dovrebbe visualizzarsi così:

//^^^^qui su ci stavano altre informazioni
}
this.updateDocumentTitle();
};
Scene_GameEnd.prototype.commandToTitle = function() {
this.fadeOutAll();
SceneManager.goto(Scene_Title);
}; 

Ora la dichiarazione che ordina all'eseguibile di far apparire lo Scene_Title dopo aver digitato la suddetta voce (l'ho spiegato prima)
è proprio quella lì, ossia       SceneManager.goto(Scene_Title); 
Quindi per risolvere il sedicente Bug, sarà sufficiente gelare quella stringa lì e sostituirla con quest'altra:
                                             SceneManager.goto(Scene_Map);

 

Però, senza dimenticarci di dichiarare che si sta riavviando una Nuova Partita, quindi non sarà soltanto un teletrasporto in mappa.
Ma all'eseguibile verrà comandato di rifar ripartire tutto dall'inizio (a me onestamente questo effetto non piace ma vi mostro la funzione così voi avete piena libertà di considerarla o meno).  
                                              DataManager.setupNewGame(); (questo inseritelo sopra la prima modifica appena fatta)
A me piaceva addirittura senza la correzione a monte, comunque..
Semplice, rapido e indolore.   sto javascript mi piace per la sua immediatezza. 
A voi lo script corretto:

Spoiler

 

//=================================================
/*:
* @plugindesc
* Permette di saltare lo Scene_Title
* @author
* Lomax_Iced
* @param
* Parametro1
* @desc
* Questo comando descrive
* la funzione del parameto
* @default
* 0
* @help
* Istruzioni per l'uso
*/
//=================================================
var parameters = PluginManager.parameters('Direttamente in Mappa');

var parameter = Number(parameters['Parametro1'] || 0);

Scene_Boot.prototype.start = function() {
Scene_Base.prototype.start.call(this);
SoundManager.preloadImportantSounds();
if (DataManager.isBattleTest()) {
DataManager.setupBattleTest();
SceneManager.goto(Scene_Battle);
} else if (DataManager.isEventTest()) {
DataManager.setupEventTest();
SceneManager.goto(Scene_Map);
} else {
this.checkPlayerLocation();
DataManager.setupNewGame();
//SceneManager.goto(Scene_Title);
//Window_TitleCommand.initCommandPosition();
DataManager.setupNewGame();
SceneManager.goto(Scene_Map);
}
this.updateDocumentTitle();
};
Scene_GameEnd.prototype.commandToTitle = function() {
this.fadeOutAll();
//SceneManager.goto(Scene_Title);
DataManager.setupNewGame();
SceneManager.goto(Scene_Map);
}; 

Adesso possiamo passare all'argomento principale, ovvero non parlare più per fattispecie ma assegnare realmente una funzione al nostro Parametro1. 
Ora visto che c'è a chi piace cotta e a chi piace cruda, ho intenzione di assegnare a questo Parametro1 la facoltà di poter far scegliere al programmatore se desidera andare al Menu iniziale, oppure Andare in Mappa. che ne dite?..Ma si. 
Dunque, procediamo con il da farsi:

1. Per prima cosa dobbiamo andare in testa allo script ed inserire in box le nuove informazioni che poi verranno visualizzate in RpgMv
    tipo così:

Spoiler

 

//=================================================
/*:
* @plugindesc
* Permette di saltare lo Scene_Title
* @author
* Lomax_Iced
* @param
* Vuoi tornare al Menu Iniziale?
* @desc
* Questo comando consente di attivare la possibilità
* di accedere al menu iniziale.
* @default
* Si.
* @help
* Entra nella finestra Parametro e cambia il suo valore.
* Si. Permetti al giocatore di tornare al Menu Iniziale.
* No. Permetti al giocatore di tornare in Mappa.
* Ricominciando una nuova partita.
*/
//================================================= 

EDIT: tutti i comandi che riguardano i parametri vanno scritti UNICAMENTE sulla stessa linea! (come è scritto su è sbagliato)
Ecco la forma corretta:
 

//=================================================
/*:
* @plugindesc
* Permette di saltare lo Scene_Title
* @author
* Lomax_Iced
* //===================================
* @param Vuoi tornare al Menu Iniziale?
* @desc Questo comando consente di attivare la possibilità di accedere al menu iniziale.
* @default Si.
* //===================================
* @help
* Entra nella finestra Parametro e cambia il suo valore.
* Si. Permetti al giocatore di tornare al Menu Iniziale.
* No. Permetti al giocatore di tornare in Mappa.
* Ricominciando una nuova partita.
*/
//================================================= 

2. Il prossimo passo sarà quello di rendere effettiva questa dichiarazione: 
             var parameter = Number(parameters['Parametro1'] || 0);
Perché così non ha più alcun senso.
Quindi, svolgimento:
Prestate molta attenzione perchè si rischia di fare un errore sottile ma rompiscatole al punto di fare impazzire: 

Spoiler

facciamo si che il nostro comando di richiamo var, nomini appunto una variabile effettiva, quindi proviamo a rinominare l'asettico 'parameter' con qualcosa che si riferisca a cosa andremo a fare. E qui possiamo sbizzarrirci con la fantasia. 
ehm.....vediamo.... lo nominiamo....                         vaialmenu   che dite? :-)
Dunque ricapitombolando:
            var vaialmenu =             
Adesso il nostro valore 'Si' non è più un numero. Ma una parola, allora quel Number() dovrà essere sostituito.
Con questo:                                                                                                          String() .
Quindi vediamo un po come si scrive il tutto:
          var vaialmenu = String(parameters['Parametro1'] || 'Si.'); 
Notate la differenza?
Bene. Ma non abbiamo ancora finito. Ormai il nostro parametro non si chiama più Parametro1 ma l'abbiamo rinominato alla voce @param  'Vuoi tornare al Menu Iniziale?'.  Quindi adesso entro le quadre dovrà inserirsi questa dicitura. 
E il tutto verrà presentato in questo modo:
          var vaialmenu = String(parameters['Vuoi tornare al Menu Iniziale?'] || 'Si');
Perfetto! 

Abbiamo appena generato una domanda, nel senso che, tradotto si chiede:
        Vuoi tornare al Menu iniziale? Se dici Si. ci torni altrimenti Fili in Mappa!!
Voi ancora non ve ne rendete conto ma stiamo iniziando a creare della roba utile. 

3. Come vedete nel punto due questa che poi si andrà a generare sarà una condizione. 
Cos'è una condizione? {Filate a ripassare cosa sono le condizioni brutti bacucchi!!     }
Comunque trovate maggiori chiarimenti nello 02T:
http://www.rpg2s.net...io-che-abbiamo/
Se non sapete che cosa sono.
Ma non c'è da capire molto, dai vi accenno l'argomento:

Spoiler

Vi faccio un esempio, non scendo nei dettagli:

Se io ho la Maggior'età, posso guidare la macchina. 

Quest'affermazione significa:
Che io posso guidare la macchina, solo se ho raggiunto come minimo il diciottesimo anno di età . 

Quindi se tutto ciò risulta essere vero, ovvero soddisfa la condizione preposta, io posso guidare l'auto. 
Io ho 28 anni e si..posso guidare la macchina. 

Ma nel caso in cui io non avessi ancora compiuto 18 anni.
La condizione non verrebbe soddisfatta ed io non potrei guidare alcun'auto. 

Quindi come trasformare tutto questo concetto in javascript e soprattutto, secondo l'uso che ci siamo prefissati?
ve lo spiego uscendo fuori dallo spoiler  :smile: 

Dunque come si compila una condizione in javascript...

Spoiler

Per i nostalgici del rgss
 

if @var == true
#info
elsif @var == false
#info2
end 

Nulla di tutto questo! 
java script è più immediato e semplice! Dimenticate quanto scritto su!

Piuttosto in JS una condizione la si scrive in questo modo:

if(nomedelparametro == 'Valore')
{
//azione da eseguire, se la condizione è soddisfatta
}
else
{
//azione da eseguire, se la condizione non è soddisfatta
} 

Adesso proviamo ad entrare più nel dettaglio e iniziamo a specificare il tutto.
Quindi torniamo nel nostro plugin. Precisamente dentro la sezione in cui vogliamo far valere la condizione e quindi dare un'importanza al valore del nostro parametro vaialmenu. 
Ovvero qui:
 

//^^^^^^su c'erano altre informazioni..........
Scene_GameEnd.prototype.commandToTitle = function() {
this.fadeOutAll();
//SceneManager.goto(Scene_Title);
DataManager.setupNewGame();
SceneManager.goto(Scene_Map);
}; 

E iniziamo ad inserire la nostra condizione. 
Cancelliamo tutto! o quasi..
 

//^^^^^^su c'erano altre informazioni..........
Scene_GameEnd.prototype.commandToTitle = function() {
this.fadeOutAll();



}; 

adesso appena sotto   this.fadeOutAll();  inseriamo la nostra condizione, in questo modo:
 

//^^^^^^su c'erano altre informazioni..........
Scene_GameEnd.prototype.commandToTitle = function() {
this.fadeOutAll();
if (vaialmenu == 'Si.') 
{
   SceneManager.goto(Scene_Title);
}
else 
{
   DataManager.setupNewGame();
   SceneManager.goto(Scene_Map);
}
}; 

Salvate la modifica e rientrate su Rpg Maker Mv per testare con i vostri occhi cosa avete combinato  :smile:   
Andiamo..

 

4.
Siamo all'interno di Rpg Maker Mv e siamo in procinto di testare il nostro Plugin.
Per vedere se sono tutte cose a loro posto andiamo in: 

Gestione Plugin
tasto destro del mouse sul nostro plugin
Modifica
Clicca 2 volte su Parametri
Bene..proviamo a togliere quel Si. (che è il nostro valore di partenza e mettiamo qualcos'altro, tipo ad esempio No!)
usciamo da Gestione Plugin e facciamo avviare il Tester per vedere che succede.


....attendiamo....
O_O Non Funge!  :ohmy: 
. . . . .

No vi spiego subito (motivo per cui ho tardato a rilasciare questo Quarto tutorial) 
Dunque ho scoperto che occorre prestare Molta attenzione ad ogni singola punteggiatura e non solo. 
Faccio prima a postarvi lo script Corretto (24 ore di sbattimento ma alla fine ci sono riuscito!  :laugh: a farlo andare )
. . . . .
 

//======================================================
/*:
* @plugindesc
* Permette di saltare lo Scene_Title
* @author
* Lomax_Iced
* //Parametri-----------
* @param Vuoi andare al Menu Iniziale?
* @desc Questo comando consente di attivare
* la possibilità di accedere al menu iniziale.
* @default Si
* //---------------------------------------------------
* @help
* Entra nella finestra Parametro e cambia il suo valore.
* Si. Permetti al giocatore di tornare al Menu Iniziale.
* No. Permetti al giocatore di tornare in Mappa.
* Ricominciando una nuova partita.
*/
//=======================================================
var parameters = PluginManager.parameters('00SaltaTitle');

var vaialmenu = String(parameters['Vuoi andare al Menu Iniziale?'] || 'Si');

Scene_Boot.prototype.start = function() {
Scene_Base.prototype.start.call(this);
SoundManager.preloadImportantSounds();
if (DataManager.isBattleTest()) {
DataManager.setupBattleTest();
SceneManager.goto(Scene_Battle);
} else if (DataManager.isEventTest()) {
DataManager.setupEventTest();
SceneManager.goto(Scene_Map);
} else {
this.checkPlayerLocation();
DataManager.setupNewGame();
SceneManager.goto(Scene_Map);
}
this.updateDocumentTitle();
};
Scene_GameEnd.prototype.commandToTitle = function() {
this.fadeOutAll();
if(vaialmenu == 'Si')
{
   SceneManager.goto(Scene_Title);
}
else
{
  DataManager.setupNewGame();
  SceneManager.goto(Scene_Map);
}
};

Quest'ultima versione dello script sicuramente vi darà i risultati corretti. Un accorgimento, quando testate il vostro progetto, non abbiate fretta. Poiché dovete dare il tempo necessario a plugin.js di aggiornare i suoi parametri, lo fa in automatico, e ha bisogno di mezzo secondo in più uplodarsi.

Nel prossimo tutorial concluderò l'argomento Parametri e vi racconterò tutte le vicissitudini che mi sono successe per cercare di trovare una soluzione a questo Plugin. Condividerò con voi le mie esperienze in modo che possano arricchirvi in qualunque modo. 
Dunque Gente :D Al prossimo Tutorial

Modificato da Lomax_Iced, 23 November 2015 - 04:00 AM.

[Soul Eater]

Apprezzo molto quello che stai facendo con questi tuotrial: Bravo!

Una domandina? Io avevo capito che per dare l'equivalenza, quando si fanno dei calcoli con Js, si usasse "===". Verso la fine di questo script, c'è scritto: "if(vai al menu == si) ecc..."; rpgmaker nel legge anche 2? Non ho provato.

[Guardian of Irael]

Altro gran lavorone ben commentato ed hai pure messo l'elenco completo in alto! E:3

 

Dal 21 in poi dovrò iniziare a studiarmelo un poco! ^ ^

 

@Soul: ecco qui lo spiega in maniera semplice e diretta, in effetti Lomax con false meglio cambiarlo.

^ ^

[Soul Eater]

Oh, capisco, avrei dovuto informarmi meglio. Buono a sapersi!

[KenzaMe92]

 

00T:
http://www.rpg2s.net...er-mv</strong>/
01T:
http://www.rpg2s.net...ginjs</strong>/
02T: http://www.rpg2s.net...biamo</strong>/
03T:
http://www.rpg2s.net...lugin</strong>/

Perché nei link c'è un </strong>/ ? non fa aprire la pagina correttamente

[Guardian of Irael]

Da quel che vedo lo strong è nel testo, il link, cioè la parte che apri e quella che ottieni facendo copia indirizzo è giusta.

^ ^

[siengried]

Scusa, ma c'è un errore...

A me non funziona... va sempre al menù sia che metto si che metta no.

Modificato da siengried, 07 December 2015 - 15:01 PM.

[Lomax_Iced]

Scusa, ma c'è un errore...

A me non funziona... va sempre al menù sia che metto si che metta no.

Si lo so. Lo faceva anche a me. Ci perdevo la salute. Ma la soluzione è la seguente:

1.
Intanto quando nomini lo script non mettere spazi. Robe tipo   Salta Titolo.js non sono concesse. 
Nemmeno titoli estremamente lunghi tipo Modalitapersaltareiltitolodigioco.js anche questo non va bene.

2.
Sii coerente, ovvero fa concidere questo:
 che sarebbe il nome del tuo script.
Con quest'altro:

Devono avere i nomi uguali. 

Quella dichiarazione lì dello script indica che in game verranno presi in considerazione i parametri di quello script specifico. 
Questa stringa è fighissima! e la potrete utilizzare in un casino di vostri script creati da voi. E' come se darete l'ok, l'approvazione, 
il consenso per poter utilizzare e modificare i valori delle variabili, utilizzando la gestione plugin del tool rpg maker mv. 

 Siengried tu mi pare che volevi trovare un modo per cambiare valore ad una variabile in gioco. 
Mi sto studiando la cosa. Non ti ho ignorato. Mi sto studiando la cosa bene. Ti farò sapere. :)

Modificato da Lomax_Iced, 07 December 2015 - 17:28 PM.

[siengried]

Ho messo il parametro a no...poi ho iniziato una partita a lol...

Alla fine ho riaperto il progetto ma non funziona comunque.

In ogni caso in altri script funziona in tempo reale l'aggiornamento

Modificato da siengried, 07 December 2015 - 16:07 PM.

[Lomax_Iced]

Si si. il fattore plugin.js a me dava problemi prima di capire che fosse quello lì su il vero problema. 
Perché nella lista dei plugin, nella cartella avevo nominato il File Salta Titolo.js e nel file stesso c'era invece '00SaltaTitle' quindi 
Era come voler far accendere una Playstation 4 senza attaccare la spina. capiscimi bene :D


'Non mettere spazi' perché proprio perché devono coincidere, poi nello script occorre che entro le virgolette ci siano parole concise e senza spazi, altrimenti poi il tool rompe un po. 

'Non parole troppo lunghe' sempre per lo stesso discorso. Questa seconda cosa è un po meno importante della prima, piuttosto la dico per comodità di compilazione. 

Modificato da Lomax_Iced, 07 December 2015 - 16:23 PM.

[siengried]

Ah perfetto, ora funziona xD

[-Akm-]

A me succede l'opposto: salta il menù indifferentemente dai parametri che inserisco...Ho copincollato il tuo script, facendo attenzione a nominarlo esattamente come il tuo, ma nulla. Ci sto uscendo scemo... :/

[Guardian of Irael]

Intendi che salta il menù se ricominci la partita già avviata anche se metti sì nel parametro? ^ ^

[-Akm-]

Intendo dire che iniziando una partita in playtest, premendo f5, aprendo il menù e facendo termina, in tutti e tre i casi skippa il menù iniziale, indifferentemente da quello che seleziono come parametro dalla finestra dei plugin.

[Guardian of Irael]

Mmmh anche a me in tutti e tre i casi skippa il menù del titolo tranne nel caso in cui seleziono termina e poi torna al titolo. In quel caso mi dà proprio il titolo. Te cosa vuoi che succeda, scusami? XD

^ ^

[-Akm-]

A me non va al titolo nemmeno facendo Termina. Ricarica direttamente la prima mappa, come se l'avessi appena fatta partire. :/ Che sia io imbecille? :/ Mi sa.

[Guardian of Irael]

Ma tu nel termina hai solo termina? O scegli l'opzione torna al titolo? > <