Package dev.twilite.game.simulation

Class Simulation<I>

java.lang.Object

dev.twilite.game.simulation.Simulation<I>

Type Parameters:

I - plugin-defined input for the current run

public class Simulation<I>
extends Object

Generic bounded-node simulator for tick-based movement planning.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final record	Simulation.Builder<I>	Builder for attaching ordered task rules to a simulation.

Constructor Summary

Constructors

Constructor	Description
Simulation(SimulationOptions options, List<SimulationTask<? super I>> tasks)	Creates a simulation with fixed options and ordered tasks that will shape each run.

Method Summary

Modifier and Type	Method	Description
static <I> Simulation.Builder<I>	create(SimulationOptions options)	Starts a simulation builder with fixed bounds and movement options.
Optional<SimulationResult>	run(I input, Coord start)	Runs the simulation from start and returns the best reachable movement candidate.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

Simulation

public Simulation(SimulationOptions options,
 List<SimulationTask<? super I>> tasks)

Creates a simulation with fixed options and ordered tasks that will shape each run.

Parameters:

options - bounds and movement settings

tasks - domain-specific rules applied in list order

Method Details

create

public static <I> Simulation.Builder<I> create(SimulationOptions options)

Starts a simulation builder with fixed bounds and movement options.

Parameters:

options - bounds and movement settings

run

public Optional<SimulationResult> run(I input,
 Coord start)

Runs the simulation from start and returns the best reachable movement candidate.

The planner expands reachable nodes, lets tasks reject movement through SimulationTask.step(Object, SimulationGrid, Coord, Coord, int), applies task scoring through SimulationTask.visit(I, dev.twilite.game.simulation.model.SimulationGrid, dev.twilite.game.simulation.model.SimulationNode), then picks the non-blocked, non-avoided node with the lowest penalty and highest score.

Parameters:

input - plugin-defined state for this run

start - start coordinate inside the simulation bounds

Returns:

the chosen destination and first step, or empty when the start is outside bounds or no candidate is usable