Como contribuir con ChromieCraft

¿Eres el tipo de persona a la cual le gusta contribuir con la comunidad a la que perteneces? Entonces estás en el lugar correcto: ChromieCraft es un proyecto sin fines de lucro, basado en AzerothCore y manejado por voluntarios que creen en la filosofía open-source.

Si quieres ayudar con el proyecto no necesitas ningún permiso o acceso especial, ya puedes empezar a contribuir. Siendo que nuestra base de código y canales de comunicación son completamente abiertos, todos pueden empezar a aprender y contribuir.

Open-source no es solo nuestra filosofía: es nuestra fuerza.

Y hay mucho para hacer si no eres programador. Como explicaremos en breve, hay diferentes roles para elegir y hacer de ChromieCraft un mejor proyecto, tanto técnicos como no técnicos.

Aquellos quienes contribuyan regularmente al proyecto, muestre profesionalismo y dedicación, podrán ser considerados para convertirse en Staff de ChromieCraft.

---

Aplicaciones para Game-Master

Gracias por tu interese en contribuir con nuestro proyecto. Si bien siempre buscamos contribuidores activos, quienes nos ayuden a subir la calidad de AzerothCore y ChromieCraft aun mas, nuestros GMs serán reclutados de nuestros contribuidores. Todos nuestros GMs ganaron su lugar realizando uno o mas de los roles siguientes.

---

Roles No técnicos

Reportar Bugs

Reportar bugs en nuestro bug tracker es por supuesto una manera de ayudar con el proyecto. Solo asegurate de:

• evitar reportar duplicados: siempre busca entre los bug existentes antes de abrir un reporte nuevo
• asegurate de que lo que reportas sea un bug – checkear reportes de bug toma tiempo, ayudanos a ahorrarlo y fijate dos veces antes de enviarlos
• asegurate de llenar la planilla del reporte e incluir suficiente información así es fácil de entender y reproducir el bug
• siempre incluye los pasos para reproducirlo: los desarrolladores no pueden arreglar un bug si no pueden reproducirlo
• incluye links a ítems/NPCs/hechizos/etc… relacionados al bug. Puedes usar wowgaming o similar
• incluye imágenes o videos al reporte de bug: puedes fácilmente arrastrar (o copiar) imágenes directamente en el reporte de GitHub
• si crees que alguna mecánica del juego debería funcionar distinto al funcionamiento actual, debes incluir fuentes relevantes para demostrarlo

Promotor

Ayuda a crecer a nuestra comunidad, y a encontrar nuevos usuarios y contribuidores, promoviendo nuestro proyecto en la web.

Editor de video

Crear videos jugando y publicarlos en YouTube ayuda a nuestro proyecto a ganar mas visibilidad y les da a nuestros promotores mas herramientas para hacer su trabajo.

Asegurate de incluir “ChromieCraft” en el titulo del video, y la URL de nuestro sitio en la descripción.

Diseñador Grafico / Creador de arte

Si tienes habilidad para editar imágenes, puedes ayudar proveyendo contenido grafico para nuestro sitio.

También puedes ayudar al proyecto con capturas del juego que incluyan el logo de ChromieCraft, así podemos incluirlas en las publicaciones en nuestro sitio. Para mas información, checkea el canal #chromie-artworks en nuestro servidor de Discord.

Seguidor

Puedes ayudar a otros usuarios que necesiten ayuda instalando o accediendo al juego, o que simplemente necesiten alguna ayuda genérica, respondiendo sus preguntas en el canal #support de nuestro Discord.

Moderación

Ayudanos a mantener ChromieCraft como una comunidad amigable. Reporta a los Moderadores o Admins sobre cosas que requieran nuestra atención.

Siempre actúa para desactivar drama en lugar de alimentarlo. Anima a la gente a usar /ignore en el juego en lugar de alimentar al troll.

Mantén la paz. Esto te hará un buen candidato para convertirte en Moderador.

---

Roles Técnicos

No dejes que la palabra “técnico” te asuste. Hay una gran cantidad de tareas que puedes hacer con solo tener un servidor local de AzerothCore en tu computadora.

Esta guiá puede darte información general de como lograr esto, con tips extra para aprender aun mas: Empezando con AzerothCore.

Los roles técnicos están listados de mas fácil a mas complejo. Por cada rol, algunos requisitos son mencionados, cada rol requiere los requisitos de los roles anteriores de manera implícita.

1) Triage de bugs

Requisitos:

• conocimiento básico del juego
• un servidor local de AzerothCore (una versión reciente) instalado en tu maquina
• una cuenta gratis de GitHub

Bueno tener :

• conocimiento de comandos de GM (pero puedes aprender sobre la marcha)

Los jugadores reportan bugs en el ChromieCraft bug tracker en GitHub. Recibimos muchos reportes, sin embargo, no todos son reportes validos. Así que los contribuidores deben revisar los reportes de bug y conectar los validos al repositorio de AzerothCore en GitHub, separados en categorías (por ejemplo: genéricos, 1-19, 20-29, etc…), donde todas las discusiones técnicas suceden, así los desarrolladores pueden concentrarse en ellas.

El triage de bugs es muy simple y extremadamente importante para nuestro proyecto. Si eres capaz de instalar un servidor local de AzerothCore en tu PC, puedes ayudar con esto.

El proceso de triage de bugs es explicado aquí: >>> HOW TO TRIAGE BUG REPORTS <<<

Siempre estamos en busca de contribuidores que nos puedan ayudar con este proceso. Inicialmente, no tienes permisos para cambiar las etiquetas de los reportes, así que solo deja un comentario en cambio. Luego de que comiences a hacer algo de triage, se te dará permiso para cambiar las etiquetas por tu cuenta.

2) Game Tester

Sin requisitos adicionales.

bueno tener:

• un buen entendimiento de los comandos básicos de git puede ayudar

En AzerothCore nadie empuja arreglos directo a la rama principal, ni siquiera admins. Nos importa la estabilidad, por eso requerimos que todos los desarrolladores abran una Pull Request (PR) conteniendo los cambios al código, cuales deberán ser propiamente revisados y testeados. Marcamos los PRs que requieren testeo con una etiqueta [Waiting to be tested] (“esperando a ser testead”).

Contribuir como Game Tester es también relativamente fácil, y es tan importante que hemos publicado una guiá dedicada a ello: Como testear PRs en AzerothCore.

Ayudar con el proyecto testeando PRs le dará un empujo al desarrollo de nuestro proyecto, permitiendo aprobar arreglos mas rápido y a que lleguen al servidor en vivo de ChromieCraft mas pronto.

3) DB Fixer

Requisitos adicionales:

• uso de aplicaciones como Keira3
• entendimiento de como están estructuradas las tablas de la base de datos AC world
• entendimiento básico de lenguaje SQL SELECT, UPDATE, DELETEe INSERT

bueno tener:

• un entendimiento mas a fondo del lenguaje SQL

Si quieres aprender como arreglar bugs en WoW, este es tu punto de partida. Aquí se explica bien así que no hay razón para repetirlo.

4) Core Developer

Requisitos:

• Conocimiento del lenguaje de programación C++
• – O – conocimiento de otros lenguajes de programacion orientado a objetos y dispuesto a aprender C++

Si quieres aprender C++ y ayudar con el desarrollo principal, recomendamos aprender sobre programacion en general primero. A diferencia de las otras tareas, esto no es algo que puedas descubrir con solo experimentar en tu servidor local. Hay muchos tutoriales online sobre C++, como este por ejemplo.

También, es bueno tener un buen IDE así puedes hacer debugging mas fácilmente, como Visual Studio (Windows) o CLion (cross-platform). Puedes probar CLion gratis por 1 mes, luego podemos darte una licencia open-source.

Ciclo de bugs y donde encontrar reportes

En resumen, el ciclo de un bug es:

• 1) el jugador encuentra un bug y lo reporta en el ChromieCraft bugtracker
• 2) un contribuidor clasifica el reporte de bug y lo conecta a AzerothCore
• 3) un contribuidor crea un arreglo y lo envia a traves de PR
• 4) el PR es analizado y testeado
• 5) el PR es unido al masterde AzerothCore y así la solución al bug llegara a ChromieCraft en la siguiente actualización del servidor (checkea #changelog-chromie en Discord para saber cuando se actualiza)

Reportes de bugs viniendo de ChromieCraft que hayan pasado la fase de triage son divididos entre “proyectos” de GitHub. Cada proyecto contiene todos los bugs de diferente contenido, por ejemplo: “bugs genéricos”, “1-19”, “20-29”, etc… Puedes elegir un bug de la lista de quehaceres y que no tiene ninguna solución abierta o un asignado, y trabajar en el. Cuando tengas una solución lista, enviá tu código por PR.

---

Recompensas

Los que reporten de Bugs serán recompensados  mensualmente con Chromie Points de acuerdo al numbero de reportes validos (reportes con el tag [AC Linked] en GitHub).

Todos los contribuidores regulares de ChromieCraft (gente que ayuda con el triage, testeo, desarrollo, GMs, etc…) son compensados mensualmente con un numero de Chromie Points de acuerdo a sus contribuciones. Ademas, puede acceder a los siguientes servicios exclusivos (que no rompen el juego) gratuitamente:

• Cambio de nombre de Hermandad
• Nombres personalizados de mascotas de Brujo
• Mover personajes a otra cuenta
• Recompensas de mascotas de RAF sin tener que reclutar

Los Contribuidores Mayores también recibirán experiencia bonus de descanso permanente para todos sus personajes, similar a nuestro programa RAF disponible para todos. Este bonus no tendrá efecto la primer semana luego de estrenar una fase.

Contáctenos

Si necesitas ayuda al contribuir, simplemente hablanos en el Discord de ChromieCraft.

Cualquier discusión relacionada al desarrollo de AzerothCore debería ser llevada a el Discord deAzerothCore. Es preferible las conversaciones publicas en lugar de privadas, a menos que sea necesario.

Para preguntas técnicas como de programación, instalación, troubleshooting, o uso de AzerothCore, es mejor usar StackOverflow en lugar de preguntar directamente en Discord (lea aquí).