com.fathzer.games.ai.AI Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of games-core Show documentation

A core library to help implement two players games.

The newest version!

package com.fathzer.games.ai;

import java.util.List;

/** An AI able to find the best move(s) during a game.
 * @param  Implementation of the Move interface to use
 * @param  Implementation of the SearchParameters interface to use
 */
public interface AI {
    
    /**
     * Gets best moves evaluations with the given search parameters
     * 
This method works on all possible moves for the position. If you want to work on reduced move set, you can use {@link #getBestMoves(List, SearchParameters)} methods
     * @param parameters The search parameters
     * @return The search result
     */
    SearchResult getBestMoves(P parameters);

    /**
     * Gets best moves evaluations at the given search parameters
     * 
This methods evaluates provided moves in the list order. In order to maximize cutoff in some algorithm (like {@link Negamax}),
     * you should order the list in from what is estimated to be the best move to the worst one.
     * @param possibleMoves A list of moves to evaluate. If one of these moves is impossible, result is not specified (It may crash or return a wrong result, etc...).
     * @param parameters The search parameters
     * @return The search result. 
     */
    SearchResult getBestMoves(List possibleMoves, P parameters);
}