SCRAPSHIP
Keywords: SCRAPSHIP, SCRAPS
=== USER MANUAL ===
Usage: scrapship <ship>
Description:
Permanently destroy a ship you pilot at the current shipyard.
The ship is disassembled, hauled away, and removed from the
world. Its save file is deleted and its world entry purged.
This is irreversible. There is currently no refund in
the live code -- the ship is gone with nothing to show for
it. If that matters, sellship returns a fraction of the
purchase price instead.
Requirements:
Shipyard ........... in_shipyard(ch) must be true
(ROOM_SHIPYARD flag). Garages do not
count: "You need to be at a shipyard to
scrap a ship."
Target name ........ "Scrap what ship? Usage: scrapship
<name>" if omitted.
Ship in room ....... Must be docked in the same room:
"No ship by that name is here."
Pilot access ....... Must own the ship or be on its pilot
list (addpilot): "That is not your
ship."
Docked .............. "The ship must be docked to scrap
it." In-flight ships cannot be scrapped.
What Scrap Does:
When the command commits:
- Every contained object on the ship is extracted
(destroyed).
- Every character still on the ship is returned to
their start room.
- The ship itself is extracted from the world.
- The ship's save file in SHIP_DIR is deleted.
- The global ship list is rewritten without it.
Echo:
You order <ship> to be scrapped. The ship is
disassembled and hauled away. (you)
<n> orders a ship to be scrapped. A crew arrives
and dismantles it. (room)
Scrap vs Sell:
scrapship ........... Destroys the ship, no payment, no
item recovery. Useful when you just want
an owned ship out of your fleet cap.
sellship ............ Sells to the shipyard for a partial
refund. Preferred if the hull is worth
anything.
Both require the ship to be docked at a shipyard. Neither
returns installed modules -- use removemodule first to
salvage high-value modules.
Notes:
- Anyone still on board the ship at scrap time is
politely returned to their start room, not harmed.
- Every carried object on the ship is destroyed. If you
were storing cargo, move it off first.
- Module items are not returned -- run removemodule
on each installed module first if you want to keep them.
- The command succeeds silently against ships you pilot
but do not own. Double-check you want this action.
- The ship's file on disk is unlinked immediately.
There is no recovery on a server crash.
Strategic Notes:
- Only use scrap when the hull has no resale value
(heavily damaged or retired model). For anything with a
nonzero sell price, sellship recovers value.
- To clear fleet-cap slots for a new buyship, this
is the faster option -- no transaction, just destruction.
- Always removemodule expensive gear before
scrapping. Modules are destroyed with the ship.
Related Helpfiles: SELLSHIP, BUYSHIP, REMOVEMODULE, SHIPLIST, SHIPSTAT
=== END MANUAL ===