Crea tus funciones

Crea tus funciones

> Tutorial

Crear una función

Ya hemos usado varias funciones estándar (setWeapon, moveToward, etc.). También puedes crear tus propias funciones personalizadas, con la siguiente sintaxis:


function sum(x, y) {
	return x + y
}

La palabra clave return, que es opcional, hace que la función devuelva un valor. En el ejemplo anterior, la función recibe los parámetros x e y y devuelve su suma: x + y.

Crear una función canFinish(enemy)

Nuestro código anterior para la condición de «remate» del enemigo es bastante largo y difícil de reutilizar, así que vamos a meterlo en una función.

Vamos a crear una función personalizada canFinish(enemy), que recibe un enemigo y devuelve un booleano que indica si podemos rematarlo o no.

Copiamos el código del remate en una función, que se escribe así:

function canFinish(enemy) {
	var effects = getWeaponEffects() // lista de efectos
	var total = 0 // Vamos a sumar todo el daño
	for (var effect in effects) { // recorre todos los efectos
    	if (effect[0] == EFFECT_DAMAGE) { // si el efecto es de daño
        	var minDamage = effect[1] // daño mínimo del arma
        	var boostedDamage = minDamage * (1 + getStrength() / 100) // aumentado por la fuerza
        	var finalDamage = boostedDamage * (1 - getRelativeShield(enemy) / 100) - getAbsoluteShield(enemy) // reducido por los escudos
        	total += finalDamage
		}
    }
	var totalDamage = total * (getTP() \ getWeaponCost()) // Multiplica por el número de usos posibles (PT / coste del arma)
	return totalDamage >= getLife(enemy)
}

Nota: acuérdate de indicar de qué arma hablas para que el cálculo funcione. Además, la función devuelve true si tienes suficientes puntos de turno para hacer los disparos necesarios para matar al enemigo, y false si, por el contrario, el enemigo sobrevivirá (en ese caso, quizá prefieras hacer otra cosa).

Ahora podemos usar nuestra función canFinish en el código principal, lo que hace que sea mucho más sencillo de escribir:

// [...]

if (not canFinish(enemy)) {
	// No podemos rematarlo :( Potenciadores, escudo y curación
	// [...]
}

¿Lo sabías? Llevar a una sola función un código que se repite en varios sitios se llama factorizar.

Crear una función getClosestCellToUseWeapon(enemy)

Quizá te hayas dado cuenta de que para usar la Ametralladora, o más adelante el Láser, tienes que estar en línea con el enemigo.

Así que tendrás que moverte a una casilla desde la que puedas usar tu arma, en lugar de simplemente avanzar hacia el enemigo como con la Pistola.

Para ello existe la función estándar getCellsToUseWeapon, que devuelve todas las casillas desde las que se puede usar un arma sobre un objetivo. Después tienes que elegir una: ¡la más cercana!

Así que vamos a crear una función getClosestCellToUseWeapon y a usar un bucle for in para encontrar la casilla que está a menor distancia de nosotros:

function getClosestCellToUseWeapon(enemy) {
    var closest = null
    var minDistance = 9999
    for (var cell in getCellsToUseWeapon(enemy)) {
        var distance = getCellDistance(getCell(), cell)
        if (distance != null and distance < minDistance) {
            closest = cell
            minDistance = distance            
        }
    }
	return closest
}

La usamos para sustituir el movimiento moveToward:

// Avanza hacia la casilla más cercana desde la que podemos usar el arma
var closest = getClosestCellToUseWeapon(enemy)
moveTowardCell(closest)

Si te sientes con soltura, puedes escribir estas funciones:

También puedes:

Para ver mejor el mapa y sus casillas, no dudes en usar el modo táctico pulsando T durante un combate.

Los siguientes capítulos tratan temas más difíciles, así que tómate tu tiempo para jugar con tus funciones y con los conceptos que hemos visto hasta ahora, ¡que ya bastan para subir en la clasificación!

❓ Quiz

¿Qué función devuelve correctamente el cuadrado de un número?

function square(x) { return x * x } function square(x) { x * x } function square() { return x * x } fonction square(x) { return x * x }

¿Qué función calcula el máximo de una lista?

function maximum(list) { var maxValue = -99999 for (var e in list) { if (e > maxValue) { maxValue = e } } return maxValue } function maximum(list) { var maxValue = 99999 for (var e in list) { if (e &lt; maxValue) { maxValue = e } } return maxValue } function maximum(list) { var maxValue = 99999 for (var e in list) { if (e > maxValue) { maxValue = e } } return maxValue } function maximum(list) { var maxValue = -99999 for (var e in list) { if (e &lt; maxValue) { maxValue = e } } return maxValue }

IA completa

// Equipa la ametralladora si aún no está equipada
if (getWeapon() == null) {
    setWeapon(WEAPON_MACHINE_GUN)
}

// Obtiene el enemigo más cercano
var enemy = getNearestEnemy()

// Saluda al oponente
if (getTurn() == 1) {
    say("¡Hola " + getName(enemy) + "!")
}

if (not canFinish(enemy)) {
	// No podemos rematarlo :( Potenciadores, escudo y curación
	useChip(CHIP_MOTIVATION)
	useChip(CHIP_PROTEIN)
	useChip(CHIP_HELMET)
	
	// Nos curamos si nuestra vida está por debajo de la vida máxima
	if (getLife() < getTotalLife()) {
		useChip(CHIP_BANDAGE)
	}
}

// Avanza hacia la casilla más cercana desde la que podemos usar el arma
var cell = getClosestCellToUseWeapon(enemy)
moveTowardCell(cell) 

// ¡Intenta dispararle 4 veces!
for (var i = 0; i < 4; i++) {
	useWeapon(enemy)
}

///////////////
// Funciones //
///////////////

function canFinish(enemy) {
	var effects = getWeaponEffects() // lista de efectos
	var total = 0 // Vamos a sumar todo el daño
	for (var effect in effects) { // recorre todos los efectos
    	if (effect[0] == EFFECT_DAMAGE) { // si el efecto es de daño
        	var minDamage = effect[1] // daño mínimo del arma
        	var boostedDamage = minDamage * (1 + getStrength() / 100) // aumentado por la fuerza
        	var finalDamage = boostedDamage * (1 - getRelativeShield(enemy) / 100) - getAbsoluteShield(enemy) // reducido por los escudos
        	total += finalDamage
		}
    }
	var totalDamage = total * (getTP() \ getWeaponCost()) // Multiplica por el número de usos posibles (PT / coste del arma)
	return totalDamage >= getLife(enemy)
}

function getClosestCellToUseWeapon(enemy) {
    var closest = null
    var minDistance = 9999
    for (var cell in getCellsToUseWeapon(enemy)) {
        var distance = getCellDistance(getCell(), cell)
        if (distance != null and distance < minDistance) {
            closest = cell
            minDistance = distance            
        }
    }
	return closest
}