Mixed packet timing issue between printToPlayer and messageSpecial in a custom trade script.

[vitus0123456]

The Issue:
I am writing a custom gear augmentation NPC module. When a player overpays with Dynamis currency, I want the chat log to output chronologically like this:

1. Custom Text: "Here is your newly augmented item:"
2. System Green Item Link: Obtained: Dream hat.
3. Custom Text: "Here is your remaining currency:
4. "System Green Item Link: You obtain 20 Lungo-Nango Jadeshells.

However, right now, the server groups all printToPlayer lines at the top of the chat frame, and clumps all messageSpecial items at the very bottom, completely breaking the order.

My Questions: Is there a native function that lets me send a standard text string (like a header) into the same message queue as messageSpecial so the client renders them in order? (I tried messageBasic, but couldn't find the right message ID offsets for plain text).

Alternatively, is there a core string utility method (like xi.item.getName or a specific packet token) available in the module environment that exposes raw item names, so I can just use printToPlayer for everything with \x1e\x1f color tags without hardcoding a manual translation table?

My code Snippet:

-- How I am currently delivering the items and text inside my onTrade loop:
player:printToPlayer("Here is your newly augmented item:", 0, "Augment Service")

player:addItem({ id = data.reward, exdata = { augmentKind = xi.augment.kind.HAS_AUGMENTS, augments = augments } })
player:messageSpecial(ID.text.ITEM_OBTAINED, data.reward)

player:printToPlayer("Here is your remaining currency:", 0, "Augment Service")

player:addItem(family.hundred, num100)
player:messageSpecial(ID.text.ITEMS_OBTAINED, family.hundred, num100)

Here is the lua file:
GearAugment.zip

[LycorisXI]

I'm not confident that this is the proper approach, but if there are only two pairs of messages, sending the messages asynchronously from the NPC interaction, like below, might make them appear in the expected order.

player:addItem({ id = data.reward, exdata = { augmentKind = xi.augment.kind.HAS_AUGMENTS, augments = augments } })
player:addItem(family.hundred, num100)

player:printToPlayer("Here is your newly augmented item:", 0, "Augment Service")
player:messageSpecial(ID.text.ITEM_OBTAINED, data.reward)

player:queue(0, function(playerArg)
	playerArg:printToPlayer("Here is your remaining currency:", 0, "Augment Service")
	playerArg:messageSpecial(ID.text.ITEMS_OBTAINED, family.hundred, num100)
end)

[vitus0123456]

thank you so much! player:queue(0, function) did it. Really appreciated it.

[lefneer311]

@vitus0123456 - great! Please mark the question as answered so LycorisXI gets credit for helping.