Q: How can I call HR's original functions?
e.g.: OnGameArenaDraft

if (e.is_hero_choices)
{
//must set e.handled to true if you handle draft in this function.
e.handled = true;

//choose hero here
e.draft_pick_id = GetBestHeroCardId(e);

return;
}else
{
//other cards drafting use default A.I.
e.handled = false;
return;
}

Q: How does OnQueryBestMove interact with the event list and when is it called?

Everytime when any card status changed will call this function, not only at the start of the turn, since there is random effect card, for example, after random attack card attacked, bot must get the updated game status and re-calculate.

Silverfish only can calculate the first move of any given game status, that's why the list every time only can add one action.

Sure you can add action 1, action 2, action 3 ... to the list, bot will execute it one by one, but you must make sure the action is accurate and executable. if action 2 has random effect, then action 3 should not be added to the list.

If you return empty list, bot will ends the turn since there is no executable move, but botbase class will query multiple times to ensure it, it's a bit strange but there is latency to transfer the game state data.

Q: How is int index of BotAction counted? What is the base value?

A: All index is based on zero.


Q: Questions about Entity class:
How is int EntityId counted? Does it depend on the draworder or the playorder?

A: EntityId is given by game's server, bot only simulate to generate a entityid for spawned card, it's calculated as max entity id on the board + 1.


Q: What is List<Entity> Attachments used for? Is it for auras? How is the reference resolved? Is it bidirectional?

A: If a card has ability/buff given from other cards, then an entity called attachment will be added to its attachment list.

There is no reference, all is copied entity instance.


Q: What is bool IsElite mean and what is it used for?

A: IsElite is used for game's special visual effect, for example [firelord], usually you don't need to care about it.


Q: What happens to an Entity when it is silenced?

A: Entity.IsSilenced will be true.

Q: When is BotBase.updateGameState called?

A: Wheneven new gamestate data is received.

Q: Can I see the cards played by the enemy?
If so, can I see targets of battlecries, too?
e.g.: Enemy plays Shattered Sun Cleric and buffes minion. How is this resolved by the bot engine?
What is the Entity representation of the buffed minion?

A: Not public yet, but you can store all the info by yourself if you think it's necessary.

Q: OnQueryBestMove can "return" a list of actions. When OnQueryBestMove is recalled due to state changes before all actions are performed, does the new call contain this list or is it a new empty list?

A: new call means bot already executed all the actions and query for next move, the list is empty.

Q: What is bool Entity.IsMagnet used for?

A: It's used for special visual effect, no need to care about it.

Q: Where can I get information like "Feugen died" from?

Q: Enemy turn again: Where can I recive data of enemy cards played from?
If you had Feugen on the board and your enemy removed it somehow, it is important to know if Feugen died or was Hexed and then removed.
What is the best way to access the data?

A: Feugen is special, you have to store every played turns data, then extract information from it.

@xytrix ofc, the game-state is updated

So I decided to look into this further and found that there are 2 entries in the GameState that can be used to detect callbacks that may have incomplete board states:

bool IsBlockingServer
and
bool IsProcessingPowers

When Muster for Battle is played, both values are true until the action is completed.
When Divine Favor is played (but all drawn cards are not known yet), only IsProcessingPowers is true.

I would like to ignore incomplete board states to prevent misplays (i.e. not knowing some cards you had in hand), so returning no action when IsBlockingServer == true, seems to fix misplays with Muster for Battle being incomplete (seems you always get another callback when IsBlockingServer == false, so taking no action is fine here)

However, returning no action when IsProcessingPowers == true, sometimes makes the bot end turn without taking action. Seems we're not guaranteed another callback when "powers" are finished processing?

Can JoyAdmin (or anyone with experience with these variables) comment on how they actually work? Also, in the Divine Favor example, is there any way to make the bot simply wait and perform no action until IsProcessingPowers == false or we know all the cards that are drawn?

Q) Is the deck_name from GameStartEventArgs broken?
As I'm only getting empty string if I use it.

Use BeforePlayCardBonus instead of InHandBonus

InHand bonus = Bonus to keep it on your hand.
BeforePlay bonus = Bonus before deciding to play the card.

Idk about the InHandPlayPriority though