Grup d'edició: Estructura, eines, recursos i normes.

[Magnetar]

Fil desactualitzat. Llegir-lo simplement a nivell informatiu, però preguntar abans al staff.

Estructura

El grup d'editors del 1er Reconeixement Amfibi de la Comunitat Catalana de Simulació, Cavallers del Cel, està format per els següents membres:

• Cap: Cap d'editors del grup 1RA, responsable del github, editor de missions i de la plantilla (veure més avall), perfils del virtual arsenal.
• Kronus: Editor de missions.
• Paperboy: Editor de missions.
• SilverArrow: Editor de missions.
• Viper: Editor junior.
• Atunero: Editor de missions.
• Copess: Editor de missions.

Unir-se al grup d'editors

Si vols formar part del grup d'editors i generar les teves pròpies missions no dubtis a demanar-ho. L'únic requisit necessàri, a part de les ganes d'aprendre, és formar part del grup d'Arma 3. No cal ser un mestre de scripts bohemians ni un expert en edició de missions per entrar a formar part del grup.

Eines

Al grup 1RA s'utilitza principalment el repositori de github https://github.com/CavallersDelCel. Git [1-3] és una eina de control de versió i per tant permet veure els canvis que ha sofert un particular fitxer al llarg del temps. Aixó és molt útil per identificar errors entre versions, comentar linies de codi entre companys i millorar seccions de codi font de forma centralitzada.

Actualment hi ha diversos repositoris als que es pot contribuir [6]:

• 1RA_Plantilla_Missió a responsabilitat de Magnetar [7,8]. Plantilla per les missions del grup 1RA. A la branca master hi ha la plantilla en si mentre que qualsevol missió que estigui basada en aquesta plantilla ha d'estar publicada al github com a branca de forma obligatòria un cop acabada. No s'admeten excepcions. Qualsevol canvi haurà de ser proposat a través d'un pull request que haurà de ser validat per Magnetar en cas de que afecti a la plantilla o, en el cas de que afecti a una missió en particular, per l'autor d'aquella missió.
• 1RA_Perfils a responsabilitat de Viper i Magnetar [9]. Aquest repositori està dedicat als perfils del Virtual Arsenal del grup, que proveeixen d'equipament general pels diferents rols. Qualsevol canvi haurà de ser proposat a través d'un pull request, que haurà de ser revisat per un dels responsables.
• 1RA_Combat_Dinamic a responsabilitat de Viper i Magnetar [10]. Aquest repositori serveix per adaptar la missió All out Warfare (Cruoriss, http://www.armaholic.com/page.php?id=26304) a les necessitats del grup 1RA. Qualsevol canvi haurà de ser proposat a través d'un pull request, que haurà de ser revisat per un dels responsables. La missió original de l'autor es manté a la branca master mentre que els canvis específics pel grup 1RA es posaran a la branca pertinent.

Una altra eina, especialment útil per preguntar dubtes és el fòrum privat d'editors, al que podràs accedir un cop formis part d'aquest grup selecte que es dedica a fer passar una bona estona (o no :twisted: ) a la resta de la comunitat.

Recursos d'edició pel grup 1RA

Plantilla Bàsica per Missions (PBM): la plantilla de missions pel grup 1RA

La Plantilla Bàsica per Missions (PBM), pensada per les necessitats del grup 1RA, ofereix una base sobre la que treballar [7]. No és obligatori utilitzar-la per les missios del grup d'Arma dels Cavallers del Cel però si que és altament recomenable de fer-la servir en cas de que s'estiguin donant els primers passos en el món de l'edició de missions. La plantilla, al no dependre de cap mod, és completament genèrica i configurarà automàticament els següents mods si es detecten:

• Task Force Arrowhead Radio (TFAR)
• Advanced Combat Radio Environment 2 (ACRE 2)
• Authentic Gameplay Modification (AGM). Obsolet.
• Advanced Combat Environment 3 (ACE 3)
• ASR AI 3.
• Dynamic-AI-Creator (DAC) v3.1b en versió script.

La plantilla també suporta, entre altres coses, la configuració del sistema mèdic de ACE 3 (bàsic o avancat), balística de ACE 3 (bàsica o avancada), configuració específica del mod ASR AI 3, configuració automàtica de freqüencies i canals depenent de l'esquadra i l'equip de foc, l'utilizació d'equipació customitzada (específica per cada una de les faccions) per la missió en detreniment dels perfils del virtual arsenal del grup a través de paràmetres de la missió.

Documentació més detallada es pot trobar al codi font de la plantilla i a la wiki [8].

Perfils pel grup 1RA

Equipació general per qualsevol tipus de missió [9]. Especialment útil si no es vol malgastar el temps customitzant l'equipació per una missió específica. Ideal si vols despreocupar-te de l'equipació i vols que en Viper i en Magnetar facin la feina d'equipar-te!

Normes

L'única norma a seguir és: passar-s'ho bé editant. Ningú et pot dir què fer i quin tipus de missió has de fer. És el teu temps i per tant dedica'l exclusivament a fer allò que et sentis a gust fent. Aixó si, les missions, especialment les dels dilluns, hauran d'estar pensades per que tinguin una durada de 2'5-3 hores com a màxim.

Tot i que és important dissenyar la missió per l'estàndard del grup 1RA, es permeten certes llibertats per missions específiques. Que vols fer una missió on es jugui amb el bàndol alemany i es requereix un mod de contingut addicional? Cap problema. Vols utilitzar un terreny diferent? Cap problema. Això si, cal avisar als jugadors, especialment si es requereixen addons que ocupin molt d'espai, com a mínim 1 setmana i mitja abans de la partida que mods adicionals són necessàris per tal de que tothom els tingui quan arribi l'hora.

Bibliografia

[1] Manual de git (html): https://git-scm.com/book/en/v2/Getting-Started-About-Version-Control (Anglès)
[2] Llibre en PDF: https://progit2.s3.amazonaws.com/en/2015-06-28-a1792/progit-en.562.pdf (Anglès)
[3] Breu introducció a git (html): http://blog.santiagobasulto.com.ar/programacion/2011/11/27/tutorial-de-git-en-espanol.html (Castellà)
[4] Bohemia Community Wiki (Informació de comandes, classes, etc..): https://community.bistudio.com/ (Anglès)
[5] Tutorials d'edició de KillzoneKid (Recomenat): http://killzonekid.com/category/games/arma-3/
[6] Repositori Github dels Cavallers del Cel: https://github.com/CavallersDelCel
[7] Plantilla Bàsica per Missions (PBM) (Repositori 1RA_Plantilla_Missio): https://github.com/CavallersDelCel/1RA_Plantilla_Missio
[7] Wiki de la Plantilla Bàsica per Missions (PBM): https://github.com/CavallersDelCel/1RA_Plantilla_Missio/wiki
[9] Perfils de Virtual Arsenal (Perfils1RA): https://github.com/CavallersDelCel/Perfils1RA
[10] Combat Dinàmic (adaptació de All out Warfare): https://github.com/CavallersDelCel/1RA_Combat_Dinamic

 

[Magnetar]

Normes d'edició al Github

Normes d'edició al Github

General

Qualsevol membre no autoritzat a fer canvis haurà de proposar els seus canvis mitjançant un pull request, que haurà de ser acceptat pel creador de la missió o responsable(s) del document.

• 1RA_Perfils: CC_Viper i CC_Magnetar.
• 1RA_Combat_Dinamic: CC_Viper i CC_Magnetar.
• 1RA_Plantilla_Missio: CC_Magnetar.
• 1RA_Missions_Internes: Missions creades pels components del grup 1RA.
  • Operació Jagdtag: Dia de caça: CC_Magnetar. Utilitza la Plantilla Bàsica per Missions (PBM).
  • Operació Escurçó: Primer contacte: CC_Arnau002 (creador) CC_Magnetar (només canvis que afectin a la plantilla).
  • Operació Fantasma: CC_Magnetar. Utilitza la Plantilla Bàsica per Missions (PBM).
  • Acadèmia General: CC_Viper.
• 1RA_Missions_Externes: Missions adaptades pels components del grup 1RA.
  • Wolfpack: Paquet de missions Wolfpack per Whiztler

Qualsevol fitxer de text nou ha de tenir el següent capçal:

//=======================================================================================================//
// Arxiu: *** Nom_del_fitxer_sense_espais.sqf                                                             //
// Autor: *** Nom de l'autor ***                                                                         //
// Col·laboradors: *** Nom d'aquells que hagin col·laborat al fitxer ***                                 //
// Versió: *** versió del document ***                                                                   //
// Creació del Document: *** Any/mes/dia***                                                              //
// Descripció: Breu descripció del que fa el script o la funció                                          //
// Canvis: x.x  (any/mes/dia) Versió inicial.                                                            //
//=======================================================================================================//

1RA Combat Dinàmic

Qualsevol canvi a la missió de Combat Dinàmic ha d'estar comentat (amb // o /* */) de la següent forma, que ens permetrà identificar els canvis que s'han fet a la missió All Out Warfare i identificar als responsables:

1RA: **Autor**. ** Breu comentari **

per exemple:

// 1RA: CC_Magnetar. Configuració del Task Force Arrowhead Radio.

Tots els canvis es faran a la branca de desenvolupamentt per mantenir la branca master igual a l'original.

1RA_Perfils

Qualsevol canvi ha d'estar documentat a la capçalera del fitxer 1RAPerfils.sqf i al final del fitxer Readme.md. Tots els canvis es faran a la branca de desenvolupament i quan es cregui convenient es passaran els canvis a la versió master, que es quan la resta dels membres de la comunitat tindran accés als canvis que s'hagin produït. El format dels comentaris ha de ser semblant a:

3.8   (04/07/2015) Modificada l'equipació dels metges per CC_Viper. El perfil d'observadors
                   inclou una ràdio de llarg abast "tf_rt1523g_big_rhs" i una ràdio curta
                   "tf_anprc152" per CC_Magnetar.

1RA_Missions_Internes

Aquest repositori serveix per emmagatzemar aquelles missions que hagin preparat el grup d'editors del 1er Reconeixement Amfibi (1RA) de la Comunitat Catalana de Simulació - Cavallers del Cel. Cada missió ha d'estar emmagatzemada en una carpeta diferent i és recomanable, però no obligatori, que s'utilitzi la Plantilla Bàsica per Missions (PBM) .

El conveni de noms que es fa servir per designar la missió és el següent:

1RA_aa@bb-cc_NomDeLaMissio.Illa o bé 1RA_aa@x_NomDeLaMissio.Illa en cas de nombre de jugadors variable.

on:

• "aa" és el tipus de missió abreujat: "co" (Cooperativa), "ctf" (Capturar la bandera), "tvt" (Equip contra equip), "pvp" (Jugador contra jugador), etc. tal i com s'especifica a la biki.
• "bb" és el nombre mínim de jugadors.
• "cc" és el nombre màxim de jugadors.
• "NomDeLaMissio" és el nom abreujat de la missió sense espais.
• "Illa" és l'identificador del mapa on transcorre la missió: Altis, Stratis.

Per exemple:

1RA_co@08-12_Jagdtag.Stratis

1RA_Missions_Externes

Aquest repositori serveix per emmagatzemar aquelles missions externes que s'hagin adaptat a les necessitats del 1er Reconeixement Amfibi (1RA) de la Comunitat Catalana de Simulació - Cavallers del Cel. Cada missió ha d'estar emmagatzemada en una carpeta diferent seguint el següent conveni de noms:

1RA_Extern_xx@yy-zz_NomDeLaMissio.Illa

on:

• "xx" és el tipus de missió: "co" (Cooperativa)
• "yy" és el nombre mínim de jugadors.
• "zz" és el nombre màxim de jugadors.
• "NomDeLaMissio" és el nom abreujat de la missió sense espais.
• "Illa" és l'identificador del mapa on transcorre la missió: Altis, Stratis.

Per exemple:

1RA_Extern_co@01-15_WolfpackDay01.Altis

1RA_Plantilla_Missio

La descripció detallada sobre com utilitzar la Plantilla bàsica per missions (PBM) es pot trobar al Readme.md general del repositori, que serveix tan de plantilla per generar la informació necessària per penjar la missió resultant com a subcarpeta del repositori 1RA_Missions_Internes. Les missions Jagdtag: Dia de caça o Operació fantasma es poden prendre com a model.

Una documentació més detallada sobre cada un dels fitxers i les seves funcions es pot trobar a cada una de les subcarpetes. Si teniu algun dubte no dubteu en preguntar per els fòrums o directament al Team Speak tan a CC_Magnetar com a CC_Arnau002.

En el cas de que es vulgui modificar aquest repositori, cal demanar un Pull request, que haurà de ser acceptat per CC_Magnetar.

Si descobriu algun problema o bug durant l'edició de la missió a l'utilitzar la Plantilla no dubteu en penjar-ho com a "Issue" al Github o notifique-ho el més aviat possible. Com totes les eines, la PBM es pot millorar i per tant no dubteu en fer saber les vostres suggeriments.