⚽ Armame el doparti

📜 Índice

• ¿Qué es?
• Requisitos generales
  • Java
    • Versión mínima
    • Versión recomendada
• Requisitos para compilación manual
  • Apache Maven
    • Versión recomendada
• Descarga
• Instalación y ejecución
• Compilación manual y ejecución
• ¿Cómo se usa?
• Nuevas funcionalidades
  • Anclaje de jugadores
• Mejoras
• Solución a problemas frecuentes
  • En Linux
• Próximamente
• Reportes y sugerencias
• Capturas de pantalla

🔎 ¿Qué es?

Desarrollado completamente en Java y refactorizado en su totalidad, la nueva versión de este programa ofrece una rápida e intuitiva manera de generar equipos para partidos de fútbol 7, ya sea con distribución aleatoria de jugadores o basada en puntuaciones.
Se ofrece la posibilidad de "anclar" dos o más jugadores entre sí, garantizando de esta forma que queden en el mismo equipo sin importar el método de distribución elegido.

📦 Requisitos generales

☕ Java

• Versión mínima

  🟡 Java 22

• Versión recomendada

  🟢 Java 22 (o más reciente)

⚙️ Requisitos para compilación manual

🪶 Apache Maven

• Versión recomendada

  🟢 Apache Maven 3.9.7 (o más reciente)

📥 Descarga

La versión estable más reciente del programa se encuentra disponible para descargar en la sección releases de este proyecto.

▶️ Instalación y ejecución

Más allá de los requisitos listados, no hace falta ninguna instalación para correr este programa.
Una vez descargado el archivo .jar, e independientemente del sistema operativo que uses, podés dirigirte a la carpeta donde está situado y abrirlo con un simple doble click. En caso de estar en Linux y que el programa no se abra, revisá la sección de solución a problemas frecuentes en Linux.
Una alternativa es abrir una terminal dentro de la carpeta contenedora del archivo y ejecutar el comando:

java -jar armameeldoparti-3.0.jar

🛠️ Compilación manual y ejecución

Para compilar manualmente el programa, asumiendo que instalaste correctamente tanto los requisitos generales como los requisitos para compilación manual, tenés que descargar el proyecto en formato ZIP, extraer el archivo y, dentro de la carpeta extraída, ejecutar Apache Maven haciendo uso del archivo pom.xml mediante la terminal, con el siguiente comando:

mvn package --file pom.xml

o, simplemente:

mvn package

Esto va a crear una carpeta llamada target a la cual tenés que entrar. Ahí va a estar el archivo ejecutable en formato .jar. Para correr el programa se le puede hacer doble click o ejecutar, mediante la terminal, el comando indicado anteriormente:

java -jar armameeldoparti-3.0.jar

📝 ¿Cómo se usa?

Primero vas a tener que ingresar los nombres de los jugadores a sortear en cada posición.
La distribución estándar de jugadores por equipo es:

• Defensores centrales: 1
• Defensores laterales: 2
• Mediocampistas: 2
• Delanteros: 1
• Arqueros: 1

Una vez ingresados los nombres de todos los jugadores a repartir en cada posición para ambos equipos, vas a poder seleccionar si distribuirlos de manera aleatoria o en base a una puntuación.
Si elegís la segunda opción, vas a tener que ingresar una puntuación de 1 (mal jugador) a 5 (excelente jugador) para cada uno.
Finalmente, los equipos se van a armar de la manera más equitativa posible.
Si los jugadores se reparten en base a sus puntuaciones, la distribución óptima va a ser única. Si se los reparte de manera aleatoria, vas a poder redistribuirlos tantas veces como quieras.

⭐ Nuevas funcionalidades

🔗 Anclaje de jugadores

El objetivo de esta funcionalidad es la de indicarle al programa que al menos dos jugadores seleccionados por el usuario tienen que estar en el mismo equipo sin importar la distribución que se elija para el resto. El número máximo posible de jugadores a anclar a un mismo equipo es de 6, garantizando así que siempre queden al menos dos jugadores sin anclar para poder realizar alguna distribución.
Para esto, hay una casilla rotulada con el texto "Anclar jugadores" en la ventana de ingreso de nombres. Si tildás esta casilla, luego de seleccionar el método de distribución de jugadores, vas a ver una ventana con una lista con todos los nombres ingresados, cada uno con una casilla similar asignada. Los jugadores cuya casilla esté tildada van a ser anclados al mismo equipo.
No se pueden anclar a un mismo equipo todos los jugadores de un mismo tipo (por ejemplo, si se anclan todos los mediocampistas para un mismo equipo, el otro equipo no va a tener mediocampistas y esto no es posible). Lo mismo sucede con anclar a un mismo equipo más de la mitad de jugadores registrados para una posición particular.

✅ Mejoras

• GUI mucho más cómoda, intuitiva y agradable que en versiones anteriores, con arreglo de importantes bugs.
• Se implementaron algoritmos más eficientes para las distribuciones.
• Se implementó un patrón de diseño MVC para mejor organización del proyecto.
• Se prescindió de clases y métodos que no eran vitales, mejorando significativamente la abstracción, la modularización del código, su mantenibilidad y la velocidad de ejecución del programa.
• Se implementaron expresiones regulares para alivianar tareas.
• Se implementó un enfoque de programación funcional para agilizar la manipulación de datos.
• Importantes cambios generales de refactorización.

🛠️ Solución a problemas frecuentes

🎛️ Generales

• En caso de no poder construir el archivo .jar por tener instalada una versión distinta a la recomendada de Apache Maven, se puede modificar la línea del archivo pom.xml que especifica la versión a utilizar para la compilación manual:

<maven.version>3.9.7</maven.version> <!-- Reemplazá el 3.9.7 por la versión que tengas -->

🐧 En Linux

• Si instalaste correctamente una versión válida del JDK de Java y el archivo .jar no se ejecuta automáticamente al hacerle doble click, probá esto:
  • Click derecho sobre el archivo descargado
  • Propiedades
  • Abrir con...
  • En el campo de ingreso de comando personalizado, poné: java -jar
  • Seleccionalo como opción predeterminada para la ejecución de archivos .jar
  • Probá abrirlo con doble click nuevamente

🔜 Próximamente

Si querés estar al tanto de qué cambios están planeados para las próximas versiones, acá vas a poder ver los detalles y metas planificadas.

⚠️ Reportes y sugerencias

Si el programa presenta algún error que debería ser reportado para arreglarlo, si se te ocurrió alguna nueva funcionalidad para agregar al programa, o si opinás que algo podría ser modificado, la sección de issues está abierta para que hagas estos reportes y/o sugerencias. Es necesario tener una cuenta en GitHub para abrir un nuevo reporte en el repositorio. Para poder trabajar en eso lo más rápidamente posible, te proveo unas plantillas para cada caso donde te pido toda la información que necesito.

📸 Capturas de pantalla

Menú principal

Ventana de ayuda

Ventana de ingreso de jugadores

Ventana de selección de anclajes

Ventana de ingreso de puntuaciones

Ejemplo de resultado de distribución aleatoria sin anclajes

Ejemplo de resultado de distribución aleatoria con tres anclajes distintos

Ejemplo de resultado de distribución por puntuaciones sin anclajes

Ejemplo de resultado de distribución por puntuaciones con cuatro anclajes distintos