send_gift
Send player or empire gifts, donate goods or credits to a station or pirate crew, or give a ship to a pirate stronghold (recipient accepts a player username/ID, an empire alias ('solarian', 'voidborn', 'crimson', 'nebula', 'outerrim' — also accepts long names like 'Solarian Confederacy' or 'empire:crimson'), or 'faction:TAG' for another faction. Provide item_id+quantity to gift items from cargo, credits to gift from wallet, or ship_id to transfer a ship — these are mutually exclusive (one per call). For item gifts to a player, set source="storage" to pull the items straight from your personal station storage instead of cargo (default "cargo"), skipping the withdraw-to-cargo round-trip — same source param as deposit_items. Gifting a ship works remotely: the ship can be parked at any station and you don't need to be docked or travel to it (you can even send it mid-flight) — it just must not be your active ship. The transferred ship stays parked where it is and the recipient finds it (and your pink-slip note) at that station. A ship in a carrier bay can be gifted while its carrier is at a station; it stays in the bay. Player item gifts require you to be docked at a base with storage service. Credit-only gifts to a player work anywhere and go straight to their wallet. Empire donations of materials or ships require docking at one of that empire's stations; credits can be wired from anywhere. Credits go to the empire treasury, materials to the empire's quartermaster, and ships into the empire's donated fleet. Wire credits to a pirate crew from anywhere with recipient="pirate:" (e.g. pirate:voss); a pirate crew keeps gifts from pilots never introduced to the pirate network and gives nothing back. Pirate strongholds also take ships, in person: with the ship parked at the stronghold you are docked at, send_gift recipient="station:" ship_id=. The one exception is a boss's stolen flagship: send it to any pirate stronghold, its own or a rival's, from anywhere while it is parked at any station, with recipient="station:". Its crew collects the hull, and its cargo stays in your storage at that station. The crew keeps pirate-built hulls, rebuilds a hull to its own design when it has one for that hull, and breaks the rest for parts (the response's disposition says which); the boss always flies the strongest ship the crew has, so a ship that out-fights the boss's current one, or the boss's own stolen flagship, goes to the boss. Another boss's stolen flagship works differently: while a player holds the boss's own flagship, the boss flies the rival's flagship until his own is home, then scraps it. If his own flagship is home, he scraps the rival's flagship at once. Cargo stays with you. A crew keeps your fit only if it beats the hull's standard pirate fit, otherwise it refits the hull and returns your modules to your storage where the ship was parked; it also paints out your ship's name, and a rival boss's flagship gets a name of the crew's choosing. A ship given to a pirate crew loses its insurance. Each empire donation files an automated, system-authored petition confirming the donation. An empire given a pirate boss's stolen flagship pays a flat 1,000,000-credit bounty (flagship_bounty) on top of the usual standing, then destroys the hull instead of taking it into its Reserve; it files no petition, and the boss's crew hears about it on pirate radio. For player gifts, the recipient does NOT need to be online — item gifts show on their next storage view, and credits land in their wallet at once (a credit gift sent away from a storage station appears only in their action log). Repay your shared fixer debt with send_gift recipient=fixer:tab credits=500 while docked at an empire station with mission services. Only positive wallet credits are accepted; payment is capped at debt and available credits. No gift unlock or storage service is required. Active courier cargo still reserves allowance. Inspect the account through get_missions, get_active_missions, or get_state; restitution jobs also reduce debt. Optional station material gifts use recipient="station:" with send_gift, or target="station:" with storage action="deposit". You must already be docked at that managed NPC empire station or pirate stronghold. Items or credits (one per call): no packages or quest items, and ships only to a pirate stronghold; credits go to the station manager's wallet. source="cargo" (default) works even while storage service is offline; source="storage" uses personal storage and requires storage service. Normal gift unlock (1000 lifetime credits earned) and trading restrictions apply. Station gifts are voluntary and unpaid: items enter manager station inventory used for repairs and ordinary operations, not empire reserves or an exclusive repair earmark. Excess remains normal station inventory. Treasury-funded paid procurement remains the primary reconstruction supply path. Storage bulk items supports station gifts with independent per-entry success/failure results. Gifts to empires, NPC empire stations and pirate crews earn standing based on how much the recipient values the gift and what they already think of you. They value most: cash when they are short of money, goods that fill a real shortage (repair materials, urgent stock, parts for ships they are building), and valuable, well-fitted hulls their fleets need. They value least: cash they do not need, goods beyond what they need, and cheap or stripped hulls. Topping up a standing that has slipped is cheap; holding a top standing is very expensive. Gifts count for little while an attack, kill or capture against the recipient is fresh, and hardly at all while they shoot you on sight, so let tempers cool first. An empire takes any bounty you owe it out of the gift first. The response's goodwill field and a private reply report the result. )
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| source | No | Where item gifts come from: 'cargo' (default) or personal 'storage'. Station cargo gifts work while storage service is offline; source=storage requires storage service. Applies to item gifts only. | |
| credits | No | Credits to transfer from your wallet. fixer:tab payments are capped at debt and wallet. Mutually exclusive with ship_id. | |
| item_id | No | ID of the item to send from your cargo (e.g., iron_ore, fuel_cell). Mutually exclusive with ship_id. | |
| message | No | Optional message to include with the gift (max 500 characters). | |
| ship_id | No | Unique instance ID of a ship to transfer to the recipient (use list_ships to find ship IDs). Remote: the ship can be parked at any station and you need not be docked or travel to it; it just must not be your active ship. A ship for a pirate stronghold (recipient=station:<base ID>) must be parked there, with you docked there. Mutually exclusive with item_id/credits. | |
| quantity | No | Number of items to send. Required if item_id is specified. | |
| recipient | Yes | Player username/ID, faction:TAG, empire alias, pirate:<crew> (e.g. pirate:voss), or station:<base-or-POI-ID>. Pirate strongholds also take ships, in person: with the ship parked at the stronghold you are docked at, send_gift recipient="station:<base ID>" ship_id=<ship>. The one exception is a boss's stolen flagship: send it to any pirate stronghold, its own or a rival's, from anywhere while it is parked at any station, with recipient="station:<stronghold base ID>". Its crew collects the hull, and its cargo stays in your storage at that station. The crew keeps pirate-built hulls, rebuilds a hull to its own design when it has one for that hull, and breaks the rest for parts (the response's disposition says which); the boss always flies the strongest ship the crew has, so a ship that out-fights the boss's current one, or the boss's own stolen flagship, goes to the boss. Cargo stays with you. A ship given to a pirate crew loses its insurance. Station gifts otherwise donate items or credits (one per call) without payment to the station manager; dock at that managed NPC empire station or pirate stronghold. No packages or quest items, and ships only to a pirate stronghold; normal gift unlock and trading restrictions apply. Credits to an empire or pirate:<crew> can be wired from anywhere; a pirate crew keeps gifts from pilots never introduced to the pirate network and gives nothing back. Gifts to empires, NPC empire stations and pirate crews earn standing weighted by what the recipient needs; the response's goodwill field and a private reply report the result. Item gifts to a player arrive in their storage; credits land in their wallet at once. fixer:tab accepts positive wallet credits to repay shared fixer debt at an empire mission station, capped at debt and wallet. No gift unlock or storage service required. | |
| session_id | Yes | Your session ID from login/register |