gift

Gives a follower a gift from the pack, like the inventory’s Give button. It raises the game’s own gift event, so the game’s scripts change the approval and move the item, and a special gift may start a conversation.

Pass to, a follower in the party, and item, an item of base type Gift from inventory. The call returns once the game has taken the gift (the item left the pack or the approval changed), or after budgetMs. The answer includes the approval before and after (approvalBefore, approvalAfter), whether the item left the pack (given), the game’s mode afterwards (dialog means a conversation began: answer it with dialogue), and a cursor for the events that followed.

A call may take up to budgetMs milliseconds, 3000 by default.

Arguments

Name	Type	Required	What
to	string	yes	The follower, by creature id.
item	string	yes	The gift, by item id.
budgetMs	integer (≥ 100, ≤ 30000)		The longest to wait for the game to take the gift, in milliseconds. Default 3000.

Call it as gift over MCP, or POST /api/tool/gift with the arguments as JSON.