DarwinBotsManual
Open the app EspañolES

Shots

How a shot is born, how far it travels, who it hits, and what each type does on arrival: steal energy or body, give, poison, dirty, fertilize or write to the other bot's memory.

A shot is a particle that a bot throws forward and that travels on its own through the world until it hits another bot or runs out of range. It is how almost every bot that isn't a vegetable eats, and also how they attack, give away energy, paralyze or write to another bot's memory. This page explains the mechanism from end to end; the sysvars that handle it are in Shots.

From .shoot to the shot

The DNA requests a shot by writing a number other than 0 to .shoot. The engine launches it later, in the actions phase of that same cycle, and sets .shoot and .shootval back to 0. The shot is born at the edge of the bot, on the side it faces (.aim), and goes out:

A newly created shot doesn't move in the cycle in which it is born: it starts in the shots phase of the next cycle. If your energy is 0 or less, nothing goes out.

Each type has a different cost. All of them use the scenario's cost of shooting, multiplied, like all costs, by the Cost multiplier:

ShotWhat the shooter pays
−1 and −6 (steal)the cost of shooting, divided by the number of ties plus one
−1 and −6 with .shootval greater than 4 or less than −4that value multiplied by the cost of shooting
−2 (gift)what it gives away, plus the cost of shooting divided by ties plus one
−3 and −4 (venom and waste)the cost of shooting divided by ties plus one; the venom or waste comes out of its reserve
positive (memory) and −8 (sperm)the whole cost of shooting

How far it travels

Range is measured in cycles of flight and depends on the shooter's body (in a tied organism, on the body of the whole organism; see Ties and multicellular bots). It grows slowly, like a logarithm:

Shooter's bodyCycles of flightApproximate distance from its edge
10 or less140
1007280
100011440
500013520
3200016640

A negative .shootval on a −1 or −6 shot stretches the range: −8 doubles it and −16 triples it, and it is charged as shown in the table above.

The shot doesn't hit equally hard along the whole path. While it flies it loses force, very little at the start and suddenly at the end:

Part of the path already coveredForce it has left
half98%
80%94%
90%86%
the last cyclenone

So at exactly the edge of the range the shot arrives with no force: it pays to shoot at what is close. The energy gift (−2) can be exempted with Energy shots do not decay and the waste shot (−4) with Waste shots do not decay.

At the edges, a shot passes to the other side if the world is toroidal and bounces if there is a wall. It bounces off a shape too, unless the scenario has Absorb shots. Shots don't collide with each other.

How it hits

In the shots phase of each cycle, the engine looks at the stretch each shot is about to cover in that cycle and finds the first bot it crosses along it. If there is one, the shot hits it right there, takes effect and disappears. If not, it moves on and ages one cycle; when it exceeds its range, it vanishes.

Some rules about who it hits:

What each type does

Each shot goes out with a value (the force it was thrown with) and arrives with that value reduced by what it lost on the way. We call that the force of the hit.

−1: steal energy

The value is 20 plus a fifth of the shooter's body: with 1000 body, 220. A .shootval of 8 doubles it, of 16 triples it (between −4 and 4 it changes nothing). When it hits a living bot:

That gift coming back is the food. If another bot crosses its path, that bot eats it instead. When it arrives it is shared out like any −2 (see below). In the test, with 1000 body, the target lost 198 energy and 2.2 body, and the shooter gained 209 energy and 0.88 body.

If the victim doesn't have enough energy, it loses all it has and the gift goes out with that. If it is left with 0.5 of energy or body, it dies, and the shooter adds a death to .kills. A −1 takes nothing from a corpse, which no longer has energy.

If the victim has a lot of poison, poison goes out toward the shooter instead of a gift: see Defenses.

−6: steal body

The value is 10 plus half the shooter's body (510 with 1000 body), with the same .shootval as the −1. The victim's shell stops it first (see Defenses). What happens:

It is the most profitable shot and the one for eating corpses. In the test, against a target with 1000 body and no shell, the target lost 102 energy and 40.8 body and the shooter gained 484.5 energy.

−2: give energy

The shooter sends whatever .shootval says (unsigned and never more than it has; with 0, 1% of its energy). The receiver keeps 95% as energy, a little more as body (the equivalent of 4%) and 1% turns into waste. If it goes over 32000 energy, 10% of the excess goes to the body. Corpses can't make use of it.

−3: venom

It sends venom from the shooter's reserve (.venom): whatever .shootval says, or a twentieth if it is 0. It paralyzes the victim and makes it write to its memory what you chose. The whole mechanism is in Defenses.

−4: waste

It sends waste: whatever .shootval says (unsigned, up to what you have) or a twentieth of your .waste if it is 0. The shooter gets rid of 99% of what it sends: 1% stays in its .waste and, besides, another 1% goes to its .pwaste, which can't be thrown away. The victim adds the force of the hit to its waste, up to 32000. More waste than it can handle writes garbage into its memory (see Energy, body and waste). The engine also expels waste this way on its own when a bot has too much.

−8: sperm

It carries a copy of the shooter's DNA. On hitting, it leaves the victim fertilized for about 10 cycles (.fertilized) with that DNA, ready for sexual reproduction; if it was already fertilized, the new DNA replaces the old one. See Reproduction.

Positive: write to memory

A positive number in .shoot is an address: the shot writes your .shootval to that address in the victim's memory. It is taken modulo 1000 (1050 writes to 50), 340 (.delgene) is protected and an exact multiple of 1000 gives a sperm shot. What is written stays in the other bot's memory, and its DNA reads it in the next cycle.

Poison stops it: if the victim has at least half the shot's energy in .poison (220 for a shooter with 1000 body), nothing is written and poison goes out toward the shooter.

Viruses and poison

Viruses (−7) don't come out of .shoot: they are built with .mkvirus and launched with .vshoot (see Viruses). Poison (−5) doesn't either: it is only born as a response from a toxic bot (see Defenses). The other negatives don't shoot anything.

With fixed exchange

Everything above holds with the proportional Energy exchange, the default. With the fixed one, every −1 or −6 always hits with the Fixed amount (200 by default), regardless of the shooter's body, its .shootval or the distance. With the proportional one, the Proportion multiplies the force of those two types.

What the receiver feels

Each hit leaves a flavor in the victim, whether it did damage or not (a shot that the shell stops is felt too):

The engine writes them in the shots phase, so your DNA reads them in the next cycle, and clears them after it has run. If several hit you, the last one remains. Watch out: a bot that hunts with −1 also feels its food, because the gift coming back marks −2 on it.

This bot, if its energy is stolen, turns toward the shooter and returns fire:

' If my energy is stolen, I turn toward the shooter and return fire
cond
 *.shflav -1 =
start
 *.shang .aimdx store
stop

cond
 *.eye5 0 >
start
 -1 .shoot store
stop

In the test, against a hunter that hit it in cycle 8, the bot turned in 9, already had it in .eye5, and from 11 on the two were stealing energy from each other.

A minimal hunter

Animal Minimalis, from the Bestiary, sums up everything above in one gene: it shoots −1 only when what it sees is close (*.eye5 50 >) and isn't its own species (*.refeye *.myeye !=, see What it sees (ref*)), and meanwhile it accompanies the target by copying its velocity (.refveldx, .refvelup).

' From Animal Minimalis's attack gene
cond
 *.eye5 50 >
 *.refeye *.myeye !=
start
 -1 .shoot store
 *.refveldx .dx store
 *.refvelup .up store
stop

The step-by-step guide to writing a hunter of your own is in A bot that shoots.