Skip to content

Add xenoarchaeology: dig, study, use and sell artifacts - #506

Draft
Jackriip wants to merge 29 commits into
masterfrom
feature/xenoarch
Draft

Jackriip wants to merge 29 commits into
masterfrom
feature/xenoarch

Conversation

@Jackriip

@Jackriip Jackriip commented Nov 8, 2026 •

Copy link
Copy Markdown
Member

Adds xenoarchaeology. Crews dig ancient artifacts out of planet cliffs, study and label them, use them aboard ship, or sell them at trader outposts.

Digging

  • Planets get dig sites in their cliff faces, marked with survey stakes, a spoil heap and veins in the rock. A planet keeps the same sites when it is rebuilt.
  • A pick or drill frees a boulder. Depth scanners, a core sampler and the spectrometer read it, and a field stabiliser keeps the find intact. Hammer heads from 1 to 10 cm cut it down, and a brush exposes the find.
  • Every strike chips, puffs dust and shakes the boulder, and it shrinks in stages as it is cut. Cutting too deep, or freeing the find without the right field, cracks it or loses it.
  • Finds:
    • artifacts;
    • curios (fossils, pottery, statuettes and similar) and strange objects;
    • charged crystals, which give 15 kW for 90 minutes when wired in;
    • bluespace formations;
    • sealed cases;
    • very rarely in red space, a wrecked Gygax or Durand.
  • Some sites set off a wildlife or bug ambush, warned by a rumble.
  • The green, yellow and red zones decide how strong and how rare finds are, and every find is stamped with the zone it came from.

Artifacts

  • 15 shapes and 46 effects (healing, shocks, gravity waves, force walls, life steal, Resurrect and more). Each artifact has a main effect and sometimes a second one.
  • Each effect wakes to its own trigger (touch, heat, water, electricity and others) and sleeps again after a while. An awake artifact glows, hums and sparks in the colour of its energy.
  • Harmful effects are logged as attacks against whoever woke the artifact.
  • An artifact does nothing while crated or inside a trader outpost. A wrench bolts it down.

Study

  • The scan pad and analyser print a stamped report: the find's catalogue number, its condition and what each emission is.
  • While a find sits on the pad, a paper tape logs every stimulus tried and whether the find reacted.
  • The labeler sticks a tag on a find naming its effect and trigger.
  • A find pays research once, on its first full scan. Dug curios pay research in the destructive analyzer.
  • Research nodes:
    • Xenoarchaeology (40);
    • Advanced Excavation (80);
    • Exotic Particles (120, needs yellow standing).

Using artifacts

  • The harvester draws one awake effect into an exotic battery. Each find gives at most 3 harvests, and each one lowers its sale price.
  • The hand-held utilizer runs a battery's effect as a field, in bursts, or on touch.

Selling

  • Barnaby, Boffin and Vex buy finds at their outpost stalls through the Trade window. Each inspects a find in character and gives a receipt in their own style.
  • Price depends on the zone the find came from, its rarity, how accurate its label is, its condition and how many times it was harvested.
  • Vex pays a voucher for the rarest finds.
  • Large finds travel in a specimen crate. The outpost checkpoint turns away loose artifacts.

Also

  • Artifacts, crystals and formations are left out of ship saves.
  • New wiki page: Xenoarchaeology.
  • Unit tests for every part. The xenoarch tests, the design and techweb tests and voidcrew_checkpoints/every_ship pass.

Credits

  • Dig chain and the first 26 effects: NovaSector (ported from TauCeti).
  • The other 20 effects: Polaris and VOREStation.
  • Label-accuracy selling: BeeStation.
  • Sprites: Nova, Polaris, Bay and Aurora. Every state was checked against Goonstation's artifact sprites, and none are used.

Images

Artifact shapes, idle and awake:
artifacts
glow by energy kind

A dig site, and a boulder cut down in stages:
dig site
boulder stages
tools and finds
curios

Analyser, scan pad and labeler:
analyser
scan pad
labeler

Harvester and utilizer:
harvester and utilizer windows
harvester drawing

Specimen crate:
specimen crate

Effect visuals:
effects

Defines for bands, effect tiers, triggers, energy kinds, pricing, research and dig sites;
the artifact and effect types with the shared vars later parts read; the sale value and
research point functions; the planet dig reserve and the specimen crate; and empty files
for the dig, study, use, trade and Polaris effect parts and their tests.
Fifteen artifact shapes with idle and active states and a label sticker, assembled from
NovaSector (artifacts.dmi states 7-13), Polaris (xenoarchaeology.dmi ano10, 70, 80, 120, 130,
140, 150) and Aurora (crystal_madness, with new active frames). All CC BY-SA 3.0. No Goon-derived
states.
Artifacts roll a main effect by the band they were dug in and sometimes a minor second effect,
each with its own trigger. A stimulus wakes a matching effect for a while; air and proximity
triggers hold it awake while they last. Auras spend charge faster than it refills, pulses fire
when the store is full, and touch effects act on whoever touches it.

Ported from NovaSector with fixes: planet air is only ever read, oxygen and nitrogen triggers are
gone, nothing generates free power, helpful effects never burst when smashed, healing shares one
cap per person, harmful effects log like weapons, and the scan lock frees itself. Artifacts do
nothing when crated or inside a trader outpost, can be bolted down, and are never saved with a
ship. Each energy kind has its own glow, particles, light, hum and wake sound.

Unit tests cover pricing, the effect catalogue, triggers, the lock, checkpoint exclusion, the
healing cap, cleanup and planet air.
A lead-grey recolour of the plain crate with padded straps and a
stencilled lid. A shut crate holding a find shows its field tag.
Each buyer gets a large-find row and (Barnaby, Boffin) a curio row on
their wanted ledger. A large find sells when the seller hauls it to the
counter, loose or in a shut crate: the trader looks it over, pays the
sale value into the usual account, hands over a receipt in their own
hand and says what they made of it. Vex adds a voucher for an extreme
find. Undug finds are refused. Traders remark on finds hauled in.

Outpost checkpoints turn back a loose find on the way in, with a line
from the guard. Sales record the artifact_sold metric and send
COMSIG_ARTIFACT_SOLD.
artifact_capped_heal() always asked for half brute and half burn, so a
one-sided wound (most wounds) healed only half the amount asked. It now
splits the heal in proportion to the brute and burn the target has. The
cap and ledger are unchanged.
Twenty effects rewritten for tg from Polaris 6cd19fe0dec6 and
VOREStation 9335d66b9fdf: extinguisher, animate, sweat, electric field,
fortify, faraday, sprint, berserk, disarm, force walls, gaia, plasma
vent, poltergeist, feysight, sleeping gas, life drain, gravity wave,
spines, life steal and resurrect. Polaris modifiers become tg status
effects. Gas vents are indoor only with a finite reserve; resurrect
gives three lives and only to a body whose player can come back.
Sarge buys none, but now says where to take a find hauled up to her
counter. Reword the loaded specimen crate's examine.
The harvester draws one awake effect off an artifact beside it into an
exotic battery. Each find gives three harvests; one is spent when the
first charge reaches the battery, and the find stays locked for the
draw and is released on finish, halt and deletion. A stream of motes in
the energy's colour runs from the find to the collector dome while it
hums, and its window is a phosphor scope over a glass charge tube.

The utilizer runs the battery's effect from the hand: a field or bursts
for about six and a half minutes, or ten contact uses. It hums, glows
and sounds in the energy's own colour and voice, logs whoever switched
it on, and goes dark inside trader outposts. Its window is a single
power button ringed by the charge.

Batteries and utilizers are items, so ship saves delete them; a saved
harvester comes back empty. Both are rated yellow in the gear catalog.
Art is Nova's harvester, battery and utilizer sprites with tint masks
drawn for the energy colours.
The analyser reads a large find standing on its scan pad and prints a
stamped report with the find's serial, condition and one line per
emission. Its tgui bench shows a phosphor scope that follows the find
live, engraved plates for the last reading, and a paper tape of every
stimulus the pad sensed while the crew tested it, which can be torn off.
A scan takes the find's lock and releases it on finish, halt, power
loss, panel open, the find leaving the pad, and Destroy.

The first full analysis of a dug find pays research once, as research
notes, and records artifact_analysed. The strange object pays once per
techweb in the destructive analyzer.

The specimen labeler prints the tag a crew presses onto a find, from
fixed word lists, and peels it off again. Tagging is logged.

Three research nodes on the tier ladder: Xenoarchaeology, Advanced
Excavation and Exotic Particles. They list the dig, use and trade
designs by id.
The exotic battery and utilizer it unlocks are rated yellow.
Planets get dig sites from a generator pass after the anomalies: a run of
veined mountain wall with survey stakes and a spoil heap in front. What each
site holds lives in the planet's dig reserve, so rebuilt surfaces only get
what is left, and a boulder already cut loose comes back as it was.

Site walls free a veined boulder (large find) or a strange rock (small find).
Boulders are sounded, sampled, stabilised, hammered down and brushed out;
they shrink as they are cut, and a find cut into or freed without the right
field is lost. Large finds: alien artifacts, bluespace formations, charged
crystals, sealed research cases, and in red sites a rare wrecked exosuit.
Strange rocks hold curios by site kind and band, stamped as dug.

Adds the rock hammer, brush, depth scanners, core sampler, field stabiliser,
find satchel and webbing kit, the radiocarbon spectrometer, autolathe and
research designs, gear ratings, the yellow and red dig ambush, and tests.
Harvested copies run from a carried battery: effects name what people
can see (the artifact or its carrier), and harmful ones never turn on
their carrier. The gravity wave never throws people into lava, chasms,
open air or space and flings at most 40 loose objects. Berserk is
logged. Slicks show their colour, alert text is plainer, and every
burst has a visible moment. Tests cover battery holders, the ledge
check and the electric field's targets.
A warm glint over a find as the last grit comes off it, for boulders and
strange rocks. The advanced depth scanner's design id matches the research
node, the find satchel has an in-hand sprite, and the idol's description
no longer hints at an effect it doesn't have.
Covers dig sites, tools, digging, finds, moving and studying artifacts, using them, selling to Barnaby, Boffin and Vex, and the effect and trigger labels.
- Dug curios and strange objects are marked for outpost buyers when they
  come out of the rock, and every curio type pays destructive-analyzer
  research once per techweb (20 to 60). Only a dug strange object pays.
- Add the specimen crate design to the Xenoarchaeology node. A large find
  now gets into a specimen crate by being dragged onto the open crate or
  pushed onto it and the lid shut; before, no crate could take one, so no
  find could pass an outpost checkpoint.
- Undug finds pay no research in the core value function.
- A spent effect (Resurrect with no lives, a gas vent run dry) sells as
  common and earns no voucher.
- The oxygen, nitrogen and carbon dioxide vent holds a finite reserve
  like the plasma and sleeping-gas vents; harvest copies share a vent's
  reserve instead of starting a fresh one.
- Exotic Particles joins the zone research gate list (46 nodes).
- Tests: spent pricing, gas reserves, one-sided heals, design routes,
  crate loading through the closing path, and the dig-to-buyer join.
…d finds

- span_notice(a ? b : c) expands to "<span>" + a ? b : c, so every heal,
  hurt and robo variant message and the labeler's tagging message threw a
  type mismatch. The heal aura stopped partway through its targets each
  time. Parenthesise the choice.
- A find created on a scan pad never "entered" it, so the analyser beside
  it did not watch it until it moved. The pad now also listens for atoms
  initialised on its tile.
@Jackriip
Jackriip marked this pull request as draft November 11, 2026 21:06
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant