mirror of https://github.com/dirtbags/tanks.git
More cautious attempt to update docs
This commit is contained in:
Neale Pickett
parent
8ea2ff7dda
commit
2b949a819a
|
|
@ -1,147 +0,0 @@
|
|||
<!DOCTYPE html>
|
||||
<html>
|
||||
<head>
|
||||
<title>Tanks Introduction</title>
|
||||
<meta charset="utf-8">
|
||||
<link rel="stylesheet" href="style.css" type="text/css">
|
||||
<script type="application/javascript" src="tanks.js"></script>
|
||||
<script type="application/javascript" src="figures.js"></script>
|
||||
</head>
|
||||
<body>
|
||||
<h1>Tanks Introduction</h1>
|
||||
|
||||
<table class="figure">
|
||||
<caption>"ChashTank" dominates this short round.</caption>
|
||||
<tr>
|
||||
<td>
|
||||
<canvas id="shortround"></canvas>
|
||||
<script type="text/javascript">
|
||||
start("shortround", shortround);
|
||||
</script>
|
||||
</td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
<p>
|
||||
Tanks is a game in which you pit your coding abilities against
|
||||
other hackers. You write a program for your tank, set it out on
|
||||
the battlefield, and watch how it fares against other tanks while
|
||||
running your program.
|
||||
</p>
|
||||
|
||||
<p>
|
||||
Each tank has a turret-mounted laser, two treads, up to ten
|
||||
sensors, and a diagnostic LED. Sensors are used to detect when
|
||||
other tanks are inside a given arc. In the examples on this page,
|
||||
"triggered" sensors turn black. Most tanks will take some action
|
||||
if a sensor is triggered, such as changing speed of the treads,
|
||||
turning the turret, or firing.
|
||||
</p>
|
||||
|
||||
<p>
|
||||
Tanks are programmed in Forf, a stack-based language similar to
|
||||
PostScript. Please read the <a href="forf.html">Forf manual</a>
|
||||
to learn more about forf, and the <a href="procs.html">Tanks
|
||||
procedure reference</a> for a description of Tanks extensions.
|
||||
</p>
|
||||
|
||||
<h2>Quick Start for the Impatient</h2>
|
||||
|
||||
<table class="figure left">
|
||||
<caption>"Crashmaster" pwns the lame default tank provided in this
|
||||
section.</caption>
|
||||
<tr>
|
||||
<td>
|
||||
<canvas id="default"></canvas>
|
||||
<script type="text/javascript">
|
||||
start("default", default_);
|
||||
</script>
|
||||
</td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
<p>
|
||||
To get started, head over to the <a href="debugger.html">Tank
|
||||
Debugger</a> and enter the following example tank. This tank will
|
||||
move around, turn the turret, and fire if there's something in
|
||||
front of it.
|
||||
</p>
|
||||
|
||||
<pre style="clear: both;">
|
||||
Sensor 0: 50 0 7 ☑
|
||||
Sensor 1: 30 0 90 ☐
|
||||
|
||||
get-turret 12 + set-turret! ( Rotate turret )
|
||||
37 40 set-speed! ( Go in circles )
|
||||
0 sensor? { fire! } if ( Fire if turret sensor triggered )
|
||||
1 sensor? { -50 50 set-speed! } if ( Turn if collision sensor triggered )
|
||||
</pre>
|
||||
|
||||
<p>
|
||||
Obviously, this tank could be improved. Studying the examples on
|
||||
this page should give you ideas about how to make a better tank.
|
||||
Don't forget the <a href="forf.html">Forf manual</a> and the
|
||||
<a href="procs.html">Tank procedure reference</a>.
|
||||
</p>
|
||||
|
||||
<h2>Tank Specifications</h2>
|
||||
|
||||
<table class="figure">
|
||||
<caption>"Ant Lion" nails "Rabbit With Gun".</caption>
|
||||
<tr>
|
||||
<td>
|
||||
<canvas id="antlion"></canvas>
|
||||
<script type="text/javascript">
|
||||
start("antlion", antlion);
|
||||
</script>
|
||||
</td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
<p>
|
||||
Your PF-255 autonomous tank is built to the exacting
|
||||
specifications sent to our factory in New Khavistan. All
|
||||
distances are in meters, angles in degrees.
|
||||
</p>
|
||||
|
||||
<dl style="clear: both;">
|
||||
<dt>Tank size</dt>
|
||||
<dd>
|
||||
The targettable area of the tank—the part which can be hit by a
|
||||
cannon—is a circle about 7½ meters in radius.
|
||||
</dd>
|
||||
|
||||
<dt>Speed</dt>
|
||||
<dd>
|
||||
Each tread can have a speed between -100 and 100. This is in
|
||||
percentage of total speed for that tread, where total speed is
|
||||
roughly 7 meters per turn.
|
||||
</dd>
|
||||
|
||||
<dt>Sensors</dt>
|
||||
<dd>
|
||||
Each sensor has a maximum range of 100 meters. Of course, you
|
||||
don't have to use the full range. Sensors may be attached to
|
||||
the turret (they turn along with the turret), or left fixed to
|
||||
the tank.
|
||||
</dd>
|
||||
|
||||
<dt>Turret</dt>
|
||||
<dd>
|
||||
Turret angle can be set between -359° and 359°, with 0° directly
|
||||
in front of the tank. Be aware that it takes time for the
|
||||
turret to swing around: the turret can swing about 45° per turn.
|
||||
</dd>
|
||||
|
||||
<dt>Cannon range and recharging</dt>
|
||||
<dd>
|
||||
When the cannon is fired, it obliterates everything for 50
|
||||
meters in front of it. It takes around 20 turns for your cannon
|
||||
to recharge after it's been fired, so only shoot when you feel
|
||||
like you're going to hit something.
|
||||
</dd>
|
||||
</dl>
|
||||
|
||||
Good luck blowing everybody up!
|
||||
include(nav.html.inc)
|
||||
</html>
|
||||
|
|
@ -0,0 +1,97 @@
|
|||
# Tanks Introduction
|
||||
|
||||
<figure>
|
||||
<figcaption>"ChashTank" dominates this short round.</figure>
|
||||
<canvas id="shortround"></canvas>
|
||||
<script type="text/javascript">
|
||||
start("shortround", shortround);
|
||||
</script>
|
||||
</figure>
|
||||
|
||||
Tanks is a game in which you pit your coding abilities against
|
||||
other hackers. You write a program for your tank, set it out on
|
||||
the battlefield, and watch how it fares against other tanks while
|
||||
running your program.
|
||||
|
||||
Each tank has a turret-mounted laser, two treads, up to ten
|
||||
sensors, and a diagnostic LED. Sensors are used to detect when
|
||||
other tanks are inside a given arc. In the examples on this page,
|
||||
"triggered" sensors turn black. Most tanks will take some action
|
||||
if a sensor is triggered, such as changing speed of the treads,
|
||||
turning the turret, or firing.
|
||||
|
||||
Tanks are programmed in Forf, a stack-based language similar to
|
||||
PostScript. Please read the [Forf manual](forf.md) to learn more
|
||||
about forf, and the [Tanks procedure reference](procs.html) for a
|
||||
description of Tanks extensions.
|
||||
|
||||
## Quick Start for the Impatient
|
||||
|
||||
<figure>
|
||||
<figcaption>"Crashmaster" pwns the lame default tank provided in this
|
||||
section.</figcaption>
|
||||
<canvas id="default"></canvas>
|
||||
<script type="text/javascript">
|
||||
start("default", default_);
|
||||
</script>
|
||||
</figure>
|
||||
|
||||
To get started, head over to the designer for your game,
|
||||
and use the following example tank. This tank will
|
||||
move around, turn the turret, and fire if there's something in
|
||||
front of it.
|
||||
|
||||
Sensor 0: 50 0 7 ☑
|
||||
Sensor 1: 30 0 90 ☐
|
||||
|
||||
get-turret 12 + set-turret! ( Rotate turret )
|
||||
37 40 set-speed! ( Go in circles )
|
||||
0 sensor? { fire! } if ( Fire if turret sensor triggered )
|
||||
1 sensor? { -50 50 set-speed! } if ( Turn if collision sensor triggered )
|
||||
|
||||
Obviously, this tank could be improved.
|
||||
Watch other tanks in your game to get ideas about how to improve yours.
|
||||
Don't forget the [Forf manual](forf.md) and the
|
||||
[Tank procedure reference](procs.html).
|
||||
|
||||
## Tank Specifications
|
||||
|
||||
<figure>
|
||||
<figcaption>"Ant Lion" nails "Rabbit With Gun".</figcaption>
|
||||
<canvas id="antlion"></canvas>
|
||||
<script type="text/javascript">
|
||||
start("antlion", antlion);
|
||||
</script>
|
||||
</figure>
|
||||
|
||||
Your PF-255 autonomous tank is built to the exacting
|
||||
specifications sent to our factory in New Khavistan. All
|
||||
distances are in meters, angles in degrees.
|
||||
|
||||
|
||||
Tank size
|
||||
: The targettable area of the tank—the part which can be hit by a cannon—is a circle about 7½ meters in radius.
|
||||
|
||||
Speed
|
||||
: Each tread can have a speed between -100 and 100. This is in
|
||||
percentage of total speed for that tread, where total speed is
|
||||
roughly 7 meters per turn.
|
||||
|
||||
Sensors
|
||||
: Each sensor has a maximum range of 100 meters. Of course, you
|
||||
don't have to use the full range. Sensors may be attached to
|
||||
the turret (they turn along with the turret), or left fixed to
|
||||
the tank.
|
||||
|
||||
Turret
|
||||
: Turret angle can be set between -359° and 359°, with 0° directly
|
||||
in front of the tank. Be aware that it takes time for the
|
||||
turret to swing around: the turret can swing about 45° per turn.
|
||||
|
||||
Cannon range and recharging
|
||||
: When the cannon is fired, it obliterates everything for 50
|
||||
meters in front of it. It takes around 20 turns for your cannon
|
||||
to recharge after it's been fired, so only shoot when you feel
|
||||
like you're going to hit something.
|
||||
|
||||
Good luck blowing everybody up!
|
||||
Loading…
Reference in New Issue