⚙️ function core_action_transferGems(...)

Last updated: 11/17/2025

URL

https://github.com/42core-team/monorepo/blob/dev/client_lib/src/public/actions.c#L108

Description

Gives gems to another object or drops it on the floor.

If the position points to an object that can hold gems (Cores / Units / Gem Piles), the gems will be transferred to that object, otherwise a new gem pile object will be created on the floor.

Only units are able to drop gems on the floor.

  • Objects can only transfer gems if their action cooldown is 0, for more see Cooldowns.
  • Objects can only transfer gems one tile up, down, left or right; for more see Action Position Limits. The only exception to this is outlined in the tip box below.

The transferring object must be a Core or Unit of your team, and the target object must be a Core or Unit of any team, a Gem Pile, or an empty grid position.

💡 Unlike other action parameters, the server won't stop executing the transfer gems action if the gems amount parameter is set higher than the possible amount. That means you can pass 99999, even if the source object is only holding 42 gems, to transfer the maximum possible amount of gems anyways.
💡 But what if my core is surrounded by units? How will I get gems to and from it? -> The transferGems action will work back and forth between a unit and its core provided the unit is at the closest possible unoccupied position to its core in Manhattan distance. If the core is surrounded, the unit must simply get as close as possible for this action to work then, as determined by a floodfill algorithm and the manhattan distance. This does not apply to dropping money on the floor.

Signature

void core_action_transferGems(const t_obj *source, t_pos target_pos, unsigned long amount);

Parameters

  • const t_obj *source: The object that the gems should be transferred from. (e.g. Core / Unit)
  • const t_obj *target_pos: The position of the object to transfer the gems to, or the non-occupied position where the gems pile should be dropped
  • unsigned long amount: The amount of gems to transfer or drop

Return

void

Examples

t_obj *nearest_deposit = ft_get_deposit_nearest(obj->pos);
if (nearest_deposit && obj->s_unit.gems <= 0)
	core_action_pathfind(obj, nearest_deposit->pos);
else
{
	core_action_pathfind(obj, ft_get_core_own()->pos);
	core_action_transferGems(obj, ft_get_core_own()->pos, 99999);
}