Package com.kraken.api.simulation

Class SimulationDecisionAdapter

java.lang.Object

com.kraken.api.simulation.SimulationDecisionAdapter

public final class SimulationDecisionAdapter
extends java.lang.Object

Converts decision-tree simulation results into executable game actions.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	SimulationDecisionAdapter.AdaptOptions	Action adaptation options for optional runtime interaction steps.
static class	SimulationDecisionAdapter.ExecutableAction	Runtime action payload translated from a simulation decision.
static class	SimulationDecisionAdapter.ExecutableStep	Runtime step payload translated from simulation decisions.
static class	SimulationDecisionAdapter.ExecutableStepType	Supported executable step types.

Constructor Summary

Constructors

Constructor	Description
SimulationDecisionAdapter(Context ctx, MovementService movementService, PrayerService prayerService, MagicService magicService)	Constructs a decision adapter for converting and executing simulation outcomes.

Method Summary

Modifier and Type	Method	Description
SimulationDecisionAdapter.ExecutableAction	adapt(DecisionTreeSearch.Result result, SimulationState rootState)	Converts a decision result into an executable action with no optional interaction step.
SimulationDecisionAdapter.ExecutableAction	adapt(DecisionTreeSearch.Result result, SimulationState rootState, SimulationDecisionAdapter.AdaptOptions options)	Converts a decision result into an executable action with configurable adaptation options.
SimulationDecisionAdapter.ExecutableAction	adapt(DecisionTreeSearch.Result result, SimulationState rootState, java.lang.String interactionAction, int interactionDistance)	Converts a decision result into an executable action with optional npc interaction.
boolean	execute(SimulationDecisionAdapter.ExecutableAction action)	Executes all action steps in order.
boolean	execute(SimulationDecisionAdapter.ExecutableAction action, java.util.Set<SimulationDecisionAdapter.ExecutableStepType> allowedStepTypes)	Executes all action steps in order, filtered by allowed step types.

Methods inherited from class java.lang.Object

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

Constructor Detail

SimulationDecisionAdapter

@Inject
public SimulationDecisionAdapter(Context ctx,
                                 MovementService movementService,
                                 PrayerService prayerService,
                                 MagicService magicService)

Constructs a decision adapter for converting and executing simulation outcomes.

Parameters:

ctx - shared API context.

movementService - movement executor service.

prayerService - prayer service.

magicService - magic service.

Method Detail

adapt

public SimulationDecisionAdapter.ExecutableAction adapt(DecisionTreeSearch.Result result,
                                                        SimulationState rootState)

Converts a decision result into an executable action with no optional interaction step.

Parameters:

result - decision tree search result.

rootState - root simulation state.

Returns:

executable action.

adapt

public SimulationDecisionAdapter.ExecutableAction adapt(DecisionTreeSearch.Result result,
                                                        SimulationState rootState,
                                                        java.lang.String interactionAction,
                                                        int interactionDistance)

Converts a decision result into an executable action with optional npc interaction.

Parameters:

result - decision tree result.

rootState - root simulation state.

interactionAction - npc action to execute (for example "Attack"), null/empty disables interactions.

interactionDistance - Chebyshev distance for selecting an interaction target.

Returns:

executable action.

adapt

public SimulationDecisionAdapter.ExecutableAction adapt(DecisionTreeSearch.Result result,
                                                        SimulationState rootState,
                                                        SimulationDecisionAdapter.AdaptOptions options)

Converts a decision result into an executable action with configurable adaptation options.

Parameters:

result - decision tree result.

rootState - root simulation state.

options - action adaptation options.

Returns:

executable action.

execute

public boolean execute(SimulationDecisionAdapter.ExecutableAction action)

Executes all action steps in order.

Parameters:

action - executable action to perform.

Returns:

true when at least one step was executed successfully.

execute

public boolean execute(SimulationDecisionAdapter.ExecutableAction action,
                       java.util.Set<SimulationDecisionAdapter.ExecutableStepType> allowedStepTypes)

Executes all action steps in order, filtered by allowed step types.

Parameters:

action - executable action to perform.

allowedStepTypes - set of step types permitted for execution.

Returns:

true when at least one permitted step was executed successfully.