BUYSHIP
Keywords: BUYSHIP, BUYSH
=== USER MANUAL ===
Usage: buyship
buyship <model>
Description:
Purchase a new ship (or land vehicle) from the shipyard or
garage you are standing in. Bare buyship lists every model
available to your race at the current location; adding a
model name commits the purchase.
Forms:
buyship ............. List every available model with
columns for Ship, Size, MP Cost,
and SP Cost.
buyship <model> .... Buy the named model. Partial / prefix
name matching is supported -- "buyship
sco" finds Scout.
Location:
The command's behavior depends on the room you're in:
Shipyard ............ (ROOM_SHIPYARD flag) Lists and sells
spacecraft (any hull up to and including
stations).
Garage .............. (ROOM_GARAGE flag) Lists and sells
land vehicles only.
Anywhere else ...... "You need to be at a shipyard or
garage to buy a ship."
Visibility / Race Gate:
The catalog is filtered by:
- Price > 0 -- models with price 0 are hidden
(staff "disabled" models use this mechanic).
- Race match -- the model's race field must include
your race (h human, z zombie, d demon). Staff
bypass this filter.
A ship with matching price but wrong race simply won't appear
in your list and cannot be purchased.
Fleet Cap:
Non-staff players are limited to 3 owned ships at once
(8 for clan-purchased ships, though clanbuy mode is
currently disabled in source):
You own too many ships, use the ones you have.
Sell or scrap an old hull first (sellship / scrapship)
to make room.
Purchase Naming:
The new ship is auto-named: "<owner>'s <model> <file-num>"
Example: "Hanz's Scout 42" for a Scout bought by Hanz.
The name can be customized later via staff tooling, but
ownership is cleanly encoded from the start.
Echo:
You pay <N> credits to purchase the ship. (you)
<n> walks over to a terminal and makes a
credit transaction. (room)
The new ship is spawned in the current room, docked at
SHIP_DOCKED state, with you registered as owner.
Requirements:
In shipyard / garage ROOM_SHIPYARD or ROOM_GARAGE flag.
Model in catalog ..... "No such ship is available to you."
means either the model doesn't exist
or fails the race / price gate.
Under fleet cap ...... 3 ships for personal purchases.
Notes:
- Currency checks are currently disabled in source
(commented out). The command does not actually spend
credits; it echoes the cost but does not deduct. This may
be re-enabled later.
- Spaceships and land vehicles live in different catalogs
-- you cannot buy a Scout at a garage or an ATV at a
shipyard.
- Newly-bought ships default hatchopen = false. Use
openhatch after boarding to let crew aboard.
- The ship is immediately saved to disk; it persists
through reboots.
Strategic Notes:
- Check scanship on a model's siblings (via other
players' ships) to gauge capabilities before buying.
- If you hit the fleet cap, consider scrapship for
partial refund rather than selling at a discount.
- Staff-only models show to staff with the full list;
ask a staffer to spawn those if you need them for roleplay.
Related Helpfiles: SELLSHIP, SCRAPSHIP, SHIPLIST, SHIPSTAT, BOARDSHIP, OPENHATCH, ADDPILOT, LAUNCH
=== END MANUAL ===