''An astronomical and surveying instrument, mounted on a tripod.''
The [[dioptra]] is a tool that, along with a [[range pole]], is used primarily in [[bridgeCartography]] planning, along with a and [[range polebridge]]planning. It may also be used to get a general idea of your locationby targeting celestial objects like [[Haven_(moon)|Haven]].
=== Usage ===
==== Surveying ====
:A dioptra is utilized by activating it and right-clicking another player holding a range pole. There will be a '''Survey''' option with automatic event log messages as follows:
==== Navigation ====
:Activate the dioptra and right-click any of Wurm's [[moons]] or [[Sol]] and select '''Use'''. Your general geographical location will be displayed in the event window.
:{{event|inline|You carefully place the dioptra on its tripod in front of you.<br>You make sure the dioptra is level.<br>You line up the dioptra with <moon>.<br>You work out you are in the <location> regions.<br>You pack up the dioptra.}}
==== Bridge planning ====
:A dioptra is utilized by activating it and right-clicking another player holding a [[range pole]]. There will be a '''Plan Bridge''' option which will proceed to plan the bridge with automatic event log messages as follows:
:Should there be any reason why the bridge can not be planned, it will interrupt the sequence with the appropriate message.
=== Creation ===A dioptra is a somewhat difficult item to make. Assuming you use a [[protractorsight]] of about equal quality to your blacksmithing skill it can be created with as low as 30 skill in blacksmithing. It is recommended to improve the protractor sight first before you try to create it in order to increase the success rate. The quality of protractor sight affects creation chance.
* The dioptra uses 0.025 kgs of [[bronze lump]] to improve.
* A starter [[compass]] may be be used in the creation.
*90 blacksmithing skill, 14ql protractor sight gives 29% chance*66 blacksmithing skill, 14ql protractor sight gives 16% chance; 43ql protractor sight 50% chance*55 blacksmithing skill, 28ql sight gives 28% chance*42 blacksmithing skill, 42ql protractor sight gives 25% chance*31.9 blacksmithing skill, 18ql protractor sight gives 6% chance ==Distance==* Maximum measurable distance is based on item quality. The dioptra’s effective range is calculated as: maxTiles = QL * 0.4 + rarity * This value is compared against the '''actual 3D distance''' between the dioptra user and the helper, converted to tiles (meters / 4). * Height difference affects the distance. The game uses full 3D distance (via Creature.rangeTo), so vertical differences (terrain height or floor levels) increase the effective distance. This means a large height gap can cause the measurement to fail even with good tools. (effectively this is a Pythagorean distance: √(dx² + dy² + dz²).) * If '''maxTiles < distanceInTiles''', the measurement fails. Its almost impossible to stand on the tile borders its best to add 1-2 quality. * The [[range pole]] uses the same formula. The pole has its own independent range check using the same calculation. Both tools must succeed, so the effective maximum distance is the smaller of (including rarity factor): min((dioptra max range) , (range pole max range)) * Fine positioning inside a tile affects measurement. '''Creature.rangeTo''' uses the creature’s precise world position, not just tile coordinates. Standing slightly closer to the border reduces the distance and can make the measurement succeed at the threshold. To maximize measurement range, stand as close as possible to the tile edge facing the other endpoint. * These limitations affect only measurement, not bridge length. Dioptra and pole range determine whether the survey can be performed. They do not limit actual bridge construction length — the real bridge length is restricted only by bridge-building rules (span limits, slope limits, section types, etc.). == Additional Notes ===
*Although brass is used to create the [[protractor]], and bronze is used to create the [[sight]], the finished dioptra tool is bronze and is therefore improved with [[bronze lump]].
*Quality of dioptra affects how long the planned bridge may be.
*The maximum distance in metres between planner and helper is quality x 1.6, as an approximation for the number of tiles it is quality x 0.4, but as its almost impossible to stand on the tile borders its best to add 1-2 quality
*The dioptra has a relatively high value and is worth the same as, for example, mooring ropes and door locks of equal quality. [[Get price]] = QL^2 * 0.50.
===See also===
* [[Range pole]]
* [[Sight]]
* [[Protractor]]
{{rare}}==Rare Functionality==Rarity on dioptra affects contributes directly to the distance of the bridge that is being plannedformula:* rare = +1 tile* supreme = +2 tiles* fantastic = +3 tilesThis applies equally to both dioptra and [[range pole]].