townforge/MANUAL.html
2021-11-25 12:10:05 +00:00

840 lines
54 KiB
HTML

<html>
<head>
<title>Townforge player's manual</title>
</head>
<body>
<h1> Basic gameplay elements </h1>
<h2> Overview </h2>
<p>
Townforge is a blockchain based game where you create buildings which will provide you with income.
<br>
Buildings and land cost a one off sum as well as regular maintenance costs. Payout is earned at every
game update, which happens every 720 blocks. A portion of the block rewards go to the game, to be
redistributed to players. A research "tech tree" allows players to improve their buildings' efficiency.
Peer to peer trade allows players to exchange goods and money. A 3D world view allows players to
bring their buildings to life, and a decentralized chat is available in game.
<br>
Every game action is stored on a blockchain, ensuring that what you own cannot be taken away from
you unless the game rules allow it. No exit scam, no central database corruption, no rules change at
a whim without notice. The game state is stored on every game user's copy of the blockchain.
</p>
<h2> Player </h2>
<p>
Any wallet may create a game account. Game accounts are linked to the main wallet address.
For anti spam purposes, there is a 1 coin account creation fee.
<br>
The game account may be deposited to (from its associated wallet or any other) and withdrawn from.
Withdrawal is automated, and player controlled. Money deposited into the game is still under the
wallet owner's control, not under a third party's control, so you can use your own keys to withdraw
at any time. This protects against an exit scam by the game author.
<br>
A player may own any number of buildings in the game, in one or more cities. Note that a player can
manage only up to 12 buildings before management staff is required (for a fee). This is intended to
encourage richer players to go for large buildings rather than many smaller ones. Above 12 buildings,
one staff is required for up to four extra buildings. A management staff is also required for every
team of up to four staff.
<br>
A decentralized chat is available, using transactions in the txpool. They will not be mined, so are
transient and therefore not suitable for information you want to be preserved. Notifications about
new buildings, new discoveries, etc will also be placed in the chat.
</p>
<h2> Cities and treasury </h2>
<p>
The world of Townforge is a large grid, upon which cities may be founded. At the start of the game,
there is one single city. Every city is founded by a player, who becomes its mayor, and starts off
with a town square. New cities can be bought from the game, with their price depending on the current
number of cities and the total economic activity. The more cities currently exist, the higher the
cost of a new city. The larger the world's total economic activity, the lower the cost. The mayor
of a city may elect to allow only some players to buy land and build in their city. By default,
anyone may build in a city.
<br>
Each city has a treasury. This is the amount of money in the city coffers. This treasury is managed
by the consensus rules, and can only be used by the automated game update. Every game update
(every 720 blocks, so roughly 4 times a day), about 9% of the block rewards for the last 720 blocks
gets awarded to city treasuries in proportion to their economic strength. About 10% of each town's
treasury gets distributed to players based on their buildings' economic strength. The city mayor
receives 0.1% of the treasury. The game account receives 0.25% of the treasury. The game account
will be used for storytelling purposes (prizes for participating in role playing or similar events),
expenses like VPS hosting, and other reasons I deem appropriate. It may also be used for bounties.
<br>
The treasury also receives money from players buying new land or items directly from the game,
land tax, etc. The higher the treasury grows, the more attractive it is to build in a city, since
that treasury will flow back into player's pockets.
<br>
Cities may be bought and sold on the open market.
<br>
Cities reach new levels upon reaching a certain size (but do not downgrade if they drop below this
threshold). Reaching a new level allows players to build new building types in this city. Here are
the building types which become available at various levels:
<table>
<tr> <td> Role </td> <td> Level </td> </tr>
<tr> <td> Commercial </td> <td> 2 </td> </tr>
<tr> <td> Military </td> <td> 3 </td> </tr>
<tr> <td> Affluent Residential </td> <td> 4 </td> </tr>
<tr> <td> Cultural </td> <td> 5 </td> </tr>
<tr> <td> Research </td> <td> 6 </td> </tr>
<tr> <td> Luxury Residential </td> <td> 7 </td> </tr>
</table>
</p>
<h2> Flags and buildings </h2>
<p>
Each city is placed at a point on the world. Players may buy land from the game, from tiny 8x8 plots
to the largest allowed, 256x256. Those plots of lands are called flags for historical reasons. A flag
is empty when bought, and may be bought and sold on the open market. Flags are always rectangular.
Land price is higer near the center of town and drops quickly, then starts slowly increasing again.
<br>
Flags pay land tax every game update. Land tax is based on flag size as well as the flag's economic
power. Economic power is a measure of the quality/strength of the building one builds on that land.
An empty flag is tax as if holding a basic 100% economic power building. Land tax also increases very slightly
with distance from the town square, to avoid people building things at preposterous distances.
Moreover, if a flag stays unbuilt for 10 days or more, it starts attracting an extra 0.1 gold tax per tick
(this does not mean it has to have a 3D model on it, just be setup as a building).
<br>
Land tax also increases with distance from the city square. The cartography discoveries allow a player
to lessen that increase. The increase is also lessened with city level. If a city drops in level, the
tax decreases are maintained.
<br>
Buildings may be built on flags. There are a few types of buildings. Some buildings qualify for payouts
from the city treasury, while some others produce materials instead. Yet others don't do either, but
provide bonuses for other buildings. Every new building is assigned an economic power, which is its
relative output. It can range from the baseline 100% to a maximum of 300%. A 300% building will yield
3 times the income of a 100% building (at least for buildings getting treasury payouts, it's a little
more complex for producing buildings). However, they cost more than 3 times as much to build. At the
start of the game, the maximum economic power is only 150. Civil engineering discoveries increase that
maximum by 50 each, up to 300%.
<br>
Buildings have prerequisites to function effectively. Many buildings require being in the influence area of another
building. If they are not, they will not be active, and thus not provide income. Some other prerequisites
are softer, and only give bonuses and penalties.
<br>
Current building types are:
<table>
<tr><td> Role </td><td> Payout </td></tr>
<tr><td> Agricultural </td><td> - </td></tr>
<tr><td> Craft </td><td> 1.2% </td></tr>
<tr><td> Industrial </td><td> 1.5% </td></tr>
<tr><td> Commercial </td><td> 1.2% </td></tr>
<tr><td> Basic residential </td><td> 1.2% </td></tr>
<tr><td> Affluent residential </td><td> 1.3% </td></tr>
<tr><td> Luxury residential </td><td> 1.5% </td></tr>
<tr><td> Military </td><td> - </td></tr>
<tr><td> Cultural </td><td> 0.6% </td></tr>
<tr><td> Stonecutter </td><td> - </td></tr>
<tr><td> Sawmill </td><td> - </td></tr>
<tr><td> Kiln </td><td> - </td></tr>
<tr><td> Smelter </td><td> - </td></tr>
<tr><td> Workforce </td><td> - </td></tr>
<tr><td> Road </td><td> 0.8% </td></tr>
<tr><td> Research </td><td> 0.2% </td></tr>
</table>
Some of those (industrial, luxury residential, kiln, smelter) are not available just yet, and will be
made available following a progressing storyline.
<br>
For example, if a city consists of two craft buildings only, identical in all respects except one
has twice the other's economic power, and the city treasury contains 1000, then the buildings will receive
a payout of 1000 * 1.2% * 2 / 3 = 8 and 4 respectively at every game update.
<br>
Producing buildings (stonecutter, sawmill, kiln, smelter, workforce) do not get treasury payouts.
Instead, they consume some resources (stone, wood) and produce more resources. Those resources are
needed to build other buildings. While it is possible to buy those resources directly from the game's
supply, those prices are dear, and players with those producing buildings will offer better value.
<br>
Buildings may be demolished. Demolishing a building removes all blocks from its 3D representation,
and resets the type to none. Another building may then be constructed on the flag. The owner recovers
20% of the blocks in the original budget (whether they were used in the 3D representation or not).
<br>
If a building owner does not have enough money to pay the tax for a plot of land, this plot of land
will disappear, along with any building on it. The land is then free to be bought by another player.
Similarly, if a building falls to 0 repair condition, it will disappear (the land remains the owner's
property). It is therefore in the player's interest to ensure buildings are repaired in time, and to
keep enough balance to meet land tax requirements. Repairing a building costs labour and materials.
If a building's repair level falls below 70%, its efficiency starts decreasing. Above 70%, no ill
effects apply. To disincentivize constant repair spam, repairing a building in 99% condition or
better costs as much as repairing it from 99%.
<br>
Some building types have restrictions on size, depending on economic power. This should be kept in
mind when buying land. The following table lists the minimum size of a plot for building types. The
first value is the minimum size of a 100% building, the second value for a 300% building. For other
economic power values, the minimum size is interpolated and rounded down.
<table>
<tr><td> Role </td><td> Min size at 100% - 300% </td></tr>
<tr><td> Agricultural </td><td> 64-120 </td></tr>
<tr><td> Craft </td><td> 16-40 </td></tr>
<tr><td> Industrial </td><td> 40-180 </td></tr>
<tr><td> Commercial </td><td> - </td></tr>
<tr><td> Basic residential </td><td> 10-12 </td></tr>
<tr><td> Affluent residential </td><td> 24-80 </td></tr>
<tr><td> Luxury residential </td><td> 96-140 </td></tr>
<tr><td> Military </td><td> 24-80 </td></tr>
<tr><td> Cultural </td><td> - </td></tr>
<tr><td> Stonecutter </td><td> 20-60 </td></tr>
<tr><td> Sawmill </td><td> 20-60 </td></tr>
<tr><td> Kiln </td><td> 28-80 </td></tr>
<tr><td> Smelter </td><td> 28-80 </td></tr>
<tr><td> Workforce </td><td> 24-64 </td></tr>
<tr><td> Road </td><td> 8-36 </td></tr>
<tr><td> Research </td><td> 24-60 </td></tr>
</table>
Additionally, roads have the extra constraint that their longest dimension must be at least
2.5 times longer than the minimum size in the table above (ie, a 100% road has minimum size
8 x 20, and a 300% road has minimum size 36 x 90).
<br>
Some bonuses apply:
<ul>
<li>
Buildings of type cultural, affluent residential, luxury residential and commercial get
an extra bonus of up to 0.15% for each square touching the town square, up to 15%.
</li>
<li>
Buildings of type cultural, affluent residential and luxury residential get extra bonuses
if their owner owns gemstones (the rarer the gemstones, the better the bonuses).
</li>
<li>
Some building types benefit from elevation relative to their surroundings. The base elevation
bonus is 2% per block of the flag's average elevation compared to its surroundings (measured
as 250% of its width/height), up to 50%. Most buildings are not affected by this, but those
in the following list are, with varying weights:
<table>
<tr><td> Role </td><td> Percentage of the base bonus </td></tr>
<tr><td> Commercial </td><td> 10% </td></tr>
<tr><td> Affluent residential </td><td> 25% </td></tr>
<tr><td> Luxury residential </td><td> 100% </td></tr>
<tr><td> Military </td><td> 100% </td></tr>
<tr><td> Cultural </td><td> 20% </td></tr>
</table>
For example, an affluent residential building on a flag with an average height of 40 and
average surroundings height of 35 is an average 5 blocks higher than its surroundings,
so gets 10% base elevation bonus. From the table above, affluent residential buildings
get 25% of the base bonus, so the final elevation bonus for this building is 2.5%.
</li>
<li>
Stonecutters benefit from direct access to exposed rock, so get a production bonus based
on how much bare cliff face lies within their extent, to a maximum of about +42%.
</li>
<li>
The average slope also gives bonuses or penalties to some building types: too high a slope
will penalize agricultural buildings, luxury residential buildings and sawmills, but give
a bonus to roads, since they're there to allow easier passage over rough terrain.
</li>
</ul>
</p>
<h3> Shares </h3>
<p>
Shares are the way payouts are calculated. Every building has a number of shares based on its characteristics,
and that number acts as a weight when the treasury pays out.
<br>
The basic number of shares for a building is its area in squares multiplied by its economic power.
<br>
Other things come into play: if the repair level of a building falls below 70%, its share count will
start going down. Similarly, if a building's requirements are not met, this building will be inactive,
and its shares zeroed until requirements are met.
<br>
The number of shares is used to apportion treasury income within a city and pricing new cities.
<br>
Roads and discoveries (see below) also affect shares.
</p>
<h3> Gemstones </h3>
<p>
Gemstones are rare precious stones.
They can be unearthed randomly as quarries extract stone from the ground.
They bring prestige to their owners, who get a bonus amount of shares to some of their buildings:
<table>
<tr><td> Gemstone </td><td> Effect </td></tr>
<tr><td> Amethyst </td><td> +1% cultural </td></tr>
<tr><td> Sapphire </td><td> +2% cultural +2% affluent residential </td></tr>
<tr><td> Emerald </td><td> +5% cultural, +5% affluent residential </td></tr>
<tr><td> Ruby </td><td> +10% cultural, +5% affluent residential, +5% luxury residential </td></tr>
<tr><td> Diamond </td><td> +20% cultural, +10% affluent residential, +10% luxury residential </td></tr>
</table>
The probability of finding a gemstone depends on the area of the stonecutter, its economic power
and its age (older stonecutter have reached deeper into the ground).
</p>
<h3> Time and seasons </h3>
<p>
Townforge takes a real life week to go through a game year, so time is 52 times as fast in game
as in the real world. Game years are divided in 4 seasons, each comprising 3 months (ie, early
summer, mid summer, late summer are the summer months). Each month is made up of 30 days. The
current date is displayed in the Calendar section of the game UI.
<br>
The new year starts with the midwinter month and ends with the early winter month. The game
starts in spring of year 950, just in time for the vegetable sowing season.
</p>
<h3> Food and heating </h3>
<p>
Buildings need food in order to be productive. Different building types have different requirements for
food, as shown here:
<table>
<tr><td> Role </td><td> Relative requirements </td></tr>
<tr><td> Agricultural </td><td> - </td></tr>
<tr><td> Craft </td><td> 100 </td></tr>
<tr><td> Industrial </td><td> 50 </td></tr>
<tr><td> Commercial </td><td> 100 </td></tr>
<tr><td> Basic residential </td><td> 100 </td></tr>
<tr><td> Affluent residential </td><td> 130 </td></tr>
<tr><td> Luxury residential </td><td> 200 </td></tr>
<tr><td> Military </td><td> 100 </td></tr>
<tr><td> Cultural </td><td> 100 </td></tr>
<tr><td> Stonecutter </td><td> 100 </td></tr>
<tr><td> Sawmill </td><td> 100 </td></tr>
<tr><td> Kiln </td><td> 100 </td></tr>
<tr><td> Smelter </td><td> 100 </td></tr>
<tr><td> Workforce </td><td> 200 </td></tr>
<tr><td> Road </td><td> 0 </td></tr>
<tr><td> Research </td><td> 100 </td></tr>
</table>
If a building does not have enough food to consume, it will be disabled until enough
food is available.
<br>
Food is produced by agricultural buildings. There are three main types of food:
<ul>
<li>vegetables are very nutritious but spoil fast</li>
<li>grain is least nutritious but keeps very well</li>
<li>meat falls in the middle</li>
</ul>
Agricultural land produces vegetables from early summer, grain from midsummer, and meat in autumn.
<br>
When consuming food, the game uses the most perishable food type first: vegetables,
then meat, then grain.
<br>
Similarly, buildings need heating. Heating is obtained by consuming burnable material,
currently only wood. The amount of heating a building needs per surface depends on the
current temperature, which fluctuates along seasonal variations and with altitude.
<br>
When burning wood, the game prefers firewood, then the cheapest wood first: pine, then
oak, then teak.
<br>
Any wood type may be chopped into firewood, for a cost of 5 labour per 100 wood. This
allows a player to override the priority in which wood types are used for heating.
</p>
<h3> Farming </h3>
Agricultural buildings produce food, which other buildings need in order to stay active.
Vegetables and grain may be sown at the right time of the game year, and harvested later.
The more time a crop stays growing above a temperature threshold, the more food will be
produced when harvested. However, temperatures below the damage threshold will cut that
yield. Should the yield reach 0, growth till be prevented for the next 180 blocks.
Growing a crop on agricultural land depletes that land's nutrients base for that
particular crop, so growing the same crop over and over again will lead to diminishing
returns. Nutrients recover yearly. If the building catches fire, any crop is destroyed,
but the nutrients will not deplete. Geothermal potential gives a small temperature boost.
For every tick an agricultural building is not active while a crop is being grown, the
final yield will lose 20%. Farming yield is also affected by how much an agricultural
building is south facing.
<table>
<tr><td> </td> <td> Vegetables </td> <td> Grain </td> </tr>
<tr><td> Sowing season start </td> <td> start of march </td> <td> start of may </td> </tr>
<tr><td> Sowing season end </td> <td> mid may </td> <td> mid june </td> </tr>
<tr><td> Harvest season start </td> <td> start of may </td> <td> start of august </td> </tr>
<tr><td> Harvest season end </td> <td> end of june </td> <td> end of september </td> </tr>
<tr><td> Damage temperature </td> <td> &lt; -2&deg; </td> <td> &lt; 0&deg; </td> </tr>
<tr><td> Growth temperature </td> <td> &gt; 2&deg; </td> <td> &gt; 5&deg; </td> </tr>
</table>
<h3> Hunting </h3>
Moose and bears roam the wilderness. They can be hunted for food. The higher the population,
the more meat a hunt will yield, but the lower the population, the more time it will take for
it to grow back. Moose popoulation is larger, and thus moose hunts yied more meat, but if
the moose population goes too low to support the bear population, hungry bears will start
venturing into town in search of food, causing damage and eating what they can find.
Players with military buildings have a large bonus when hunting bears attacking a town,
and a small one for hunting bears and moose otherwise. You need to have at least one non-road
building (active or not) in a city to hunt in that city.
<h3> Influence </h3>
<p>
Some building types have an influence over the surrounding land. Influence is a prerequisite for
many other buildings. For example, most buildings need to be within the influence area of an agricultural
building, and a residential building takes a penalty from being within the influence of an industrial
building. Military buildings are even more complicated: most buildings receive a bonus from being under
the influence of one military building, but a penalty if the are under the influence of three or more.
<br>
<table>
<tr><td> Role </td><td> Agr. </td><td> Craft </td><td> Ind. </td><td> Com. </td><td> Bas. </td><td> Aff. </td><td> Lux. </td><td> Mil. </td><td> Cul. </td><td> Stone. </td><td> Sawmill </td><td> Kiln </td><td> Smelter </td><td> Work. </td><td> Road </td><td> Research </td> </tr>
<tr><td> Agricultural </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td> </tr>
<tr><td> Craft </td><td> N1 </td><td> </td><td> </td><td> </td><td> B1 </td><td> </td><td> </td><td> B1 </td><td> </td><td> B1 </td><td> B1 </td><td> </td><td> </td><td> </td><td> </td><td> B1 </td> </tr>
<tr><td> Industrial </td><td> N1 </td><td> </td><td> B2 </td><td> B1 </td><td> B1 </td><td> </td><td> </td><td> B1 </td><td> </td><td> B1 </td><td> B1 </td><td> B1 </td><td> B1 </td><td> B1 </td><td> </td><td> B2 </td> </tr>
<tr><td> Commercial </td><td> N1 </td><td> N1 </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> B1P3 </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td> </tr>
<tr><td> Basic residential </td><td> </td><td> </td><td> P1 </td><td> B1 </td><td> B4 </td><td> B2 </td><td> B1 </td><td> B1P3 </td><td> B2 </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td> </tr>
<tr><td> Affluent residential </td><td> </td><td> B1 </td><td> P3 </td><td> N1 </td><td> </td><td> B3 </td><td> B1 </td><td> B1P3 </td><td> B2 </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> B1 </td> </tr>
<tr><td> Luxury residential </td><td> </td><td> </td><td> P99 </td><td> N1 </td><td> P1 </td><td> </td><td> </td><td> B1P3 </td><td> B4 </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> B2 </td> </tr>
<tr><td> Military </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td> </tr>
<tr><td> Cultural </td><td> </td><td> </td><td> P99 </td><td> </td><td> </td><td> </td><td> </td><td> P99 </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> B1 </td> </tr>
<tr><td> Stonecutter </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td> </tr>
<tr><td> Sawmill </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td> </tr>
<tr><td> Kiln </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td> </tr>
<tr><td> Smelter </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td> </tr>
<tr><td> Workforce </td><td> </td><td> </td><td> </td><td> </td><td> B4 </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> P2 </td><td> </td><td> </td> </tr>
<tr><td> Road </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td> </tr>
<tr><td> Research </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td> </tr>
</table>
<p>
Legend: <br>
Nx: needs x buildings of that type <br>
Bx: gets a 5% bonus from every building of that type up to x of them<br>
Px: gets a 5% penalty from every building of that type up to x of them<br>
BxPy: gets a 5% bonus from every building of that type up to x of them, except if there are y or more, in which case it's a 5% penalty per such building<br>
</p>
The larger a building's plot and the higher a builing's economic power, the larger its influence will be.
<p>
For a building to be deemed to be under the influence of a given building type, at least 50% of the
building's surface area needs to be within the influence range of any building of the given type.
<br>
Similarly, to get double bonus, at least 150% of the tiles should be within the influence or any
building of the given type (any tile within the influence of N buildings will count N times),
250% for triple bonus, etc.
</p>
</p>
<h3> Production and potential </h3>
<p>
Some building types don't get treasury payouts, but consume and produce resources instead.
Production goes up faster than consumption with economic power.
<br>
Currently, only stonecutter (producing stone) and sawmill (producing wood) are available.
Kiln (producing bricks) and Smelter (producing metal) will be available later on in updates.
</p>
<p>
Potential has a substantial effect on production. Potential is an inherent property of the
land a building is built upon. Some land lends itself well to quarrying stone, some other
to wood felling, etc. Building a stonecutter on land that has good stone potential will see
better returns. For buildings which generate materials, potential is used to determine the
quality mix of the materials. Low potential will yield cheap materials (though in larger
quantities) while a high potential will yield smaller quantities of more expensive materials
Potential also applies to agricultural land, and stability (which controls how fast a building needs repairs).
</p>
<p>
Each of stone and wood has three different types. The mix of stone or wood a building produces
depends on the building's economic power. Higher economic power skews towards the more expensive
types of each. Keep this in mind since building requirements depend on role (basic residential
buildings only need the cheapest basic wood type, while affluent residential buildings will
also require some more expensive wood type) and on economic power, so it is possible that the
market gets a glut of one type of wood and scarcity of another. A canny businessman will see
the trends to know what to build.
</p>
<p>
New buildings have to be built close enough to existing resource generating buildings. For
instance, if a new building requires some type of stone, it has to be built close enough to
a stonecutter (such proximity rule is waived if building at the center of town, since there
are no such building yet). The resource availability distance is the furthest away from a
resource generating building that can be built without incurring extra labour cost for
resource transportation. Beyond 16 times that distance, you cannot build at all without
first building intermediate stonecutters or sawmills.
</p>
<h3> Roads </h3>
<p>
Roads are simple building types meant to link other flags. They provide bonuses to buildings
they touch, and get their own bonus from them. The more buildings a road connects, the higher
its return will be.
<br>
In order to connect to a building, a road must touch it flush. If the length of the connection
is smaller than 8 squares, the connection will be more fragile and the bonuses will fall.
Commercial buildings get more bonus if they have more connection length with the road, up to
20 tiles, since window browsing space attracts more customers. Residential buildings get a
slightly better bonus if they're on the north side of the road, as the world is in the northern
hemisphere, so free space on the south side to let the sun through benefits them.
If the difference between a building's economic power and the road's economic power is larger
than 50%, then a connection will not be made, even if they two flags touch each other.
<br>
Different building types contribute more less to a road's shares, from 40% for agricultural
buildings to 150% for commercial buildings. Otherwise, the shares a building contributes to
a road is proportional to its area and economic power.
<br>
Roads spanning a gully can be used as bridges and thus get an extra bonus. If two or more
roads are close to one another, only the oldest one will get a bridge bonus.
<br>
Roads connecting to other roads get a bonus based on the surrounding roads' bonuses.
<br>
Different building types get more or less affected by road bonuses. Commercial buildings get
the most effect, while agricultural ones the least:
<table>
<tr><td> Role </td><td> Bonus </td></tr>
<tr><td> Agricultural </td><td> 0% </td></tr>
<tr><td> Craft </td><td> 110% </td></tr>
<tr><td> Industrial </td><td> 50% </td></tr>
<tr><td> Commercial </td><td> 150% </td></tr>
<tr><td> Basic residential </td><td> 100% </td></tr>
<tr><td> Affluent residential </td><td> 115% </td></tr>
<tr><td> Luxury residential </td><td> 140% </td></tr>
<tr><td> Military </td><td> 80% </td></tr>
<tr><td> Cultural </td><td> 120% </td></tr>
<tr><td> Stonecutter </td><td> 80% </td></tr>
<tr><td> Sawmill </td><td> 80% </td></tr>
<tr><td> Kiln </td><td> 80% </td></tr>
<tr><td> Smelter </td><td> 80% </td></tr>
<tr><td> Workforce </td><td> 80% </td></tr>
<tr><td> Road </td><td> - </td></tr>
<tr><td> Research </td><td> 85% </td></tr>
</table>
</p>
</body>
<h2> 3D world </h2>
<p>
Townforge allows players to give a shape to their creations. A block based 3D world show the
city and the buildings it contains. Players may freely build on their flags using the budget
they already paid for when they setup their building. This is intended to provide an outlet
for creativity, and is not needed in order to participate in the economic game. It is nonetheless
encouraged, and may be involved in some kind of voting/competition mechanic later on.
<br>
To help different buildings keep a similar scale, a block is meant to be about a foot (30 cm)
in each direction. Thus, a typical residential door will be 7 blocks high.
<br>
Building is done by pressing Q to place a block where the turquoise cursor is or E to remove a
block where from red cursor is (move the mouse to move those cursors). The block type to use can
be selected by clicking on the player or flag inventories, pressing TAB (if the GUI is not focused
or by pressing X to open the material selection HUD and using the arrow keys to navigate,
releasing X when done.
<br>
Key bindings may be changed in the options menu.
<br>
While building, all blocks are kept locally, and will only be submitted to the blockchain once
"Approve build" is clicked. All new "in progress" blocks are displayed with a ghost effect to
distinguish them from already mined blocks.
<br>
You can move and look around the world using the arrows keys, WASD keys, page up/down and by
moving the mouse while the right button is pressed. Pressing control slows down movement speed,
while pressing shift speeds it up.
<br>
Placing a block incurs labour cost as well as the block placed. The higher the block, the more
labour cost is incurred. There are currently no architectural/structural rules, so building
hovering blocks is possible. It is not encouraged.
<br>
Models in the vox format may be imported and exported. This format is from Magica Voxel, which
runs on Windows. Note that if you build a model with Magica Voxel, you should match the colour
indices to the Townforge material indices (ie, pine is 1, oak is 2, teak is 3, sandstone is 4,
granite is 5, marble is 6).
<br>
To find your (or others') buildings, you can double click on a building in the player info
dialog or the game update events dialog. The camera will automatically switch to a free camera.
<br>
</p>
<h2> User interface </h2>
<p>
The UI is contained in a shadable widget that can be moved around by dragging it around and
resized by clicking on the bottom right corner when it is opened. While some of it can be
used in spectator mode, you will need to have a game account before being able to use much
of it. Among other things, the camera mode can be changed to a free camera by selecting the
desired mode in the Commands menu. The UI's contents may be panned with the mouse if they
extend past the size of the actual widget.
</p>
<p>
Control is by mouse and keyboard. Right click with the mouse to rotate the view, left click
to select tiles. Left click on the sky to deselect.
<br>
Key mappings:
<table>
<tr><td> Mouse </td><td> Look around </td></tr>
<tr><td> Page up </td><td> Move up (in free camera mode) </td></tr>
<tr><td> Page down </td><td> Move down (in free camera mode) </td></tr>
<tr><td> W </td><td> move forward </td></tr>
<tr><td> A </td><td> move left </td></tr>
<tr><td> S </td><td> move backward </td></tr>
<tr><td> D </td><td> move right </td></tr>
<tr><td> Escape </td><td> close dialog, or open options </td></tr>
<tr><td> ~ </td><td> open/close in-game chat </td></tr>
<tr><td> F </td><td> switch to free camera mode or back to walker mode </td></tr>
<tr><td> O </td><td> switch to orbit camera mode or back to walker mode </td></tr>
<tr><td> TAB </td><td> cycle through available building block types </td></tr>
<tr><td> Q </td><td> Place a block at the blue mouse cursor location </td></tr>
<tr><td> E </td><td> Remove a block at the red mouse cursor location </td></tr>
<tr><td> P </td><td> Select material from the tile under the cursor </td></tr>
<tr><td> X </td><td> Open the material selection HUD </td></tr>
<tr><td> Z </td><td> Add blocks on selected tiles</td></tr>
<tr><td> G </td><td> Add flat layer of blocks on selected tiles</td></tr>
<tr><td> C </td><td> Remove blocks on selected tiles</td></tr>
<tr><td> V </td><td> Remove top level blocks on selected tiles</td></tr>
<tr><td> B </td><td> Toggle Minecraft style build mode </td></tr>
<tr><td> J </td><td> Jump to the selected building </td></tr>
<tr><td> [ </td><td> Jump to previous building (of the same role if shift pressed) </td></tr>
<tr><td> ] </td><td> Jump to next building (of the same role if shift pressed) </td></tr>
<tr><td> L </td><td> Toggle user light source </td></tr>
<tr><td> T </td><td> Open the trade screen </td></tr>
<tr><td> N </td><td> Open the news screen </td></tr>
<tr><td> F3 </td><td> Search flags by name</td></tr>
<tr><td> F10 </td><td> Open the player info screen </td></tr>
<tr><td> Shift </td><td> Decrease motion speed while held </td></tr>
<tr><td> Control </td><td> Increase motion speed while held </td></tr>
</table>
</p>
<h2> Research </h2>
<p>
Research allows a player to make discoveries. Discoveries have a variety of effects, but
a typical effect is to provide a bonus of some sort. For example, the "improved plough"
discovery gives a 2% bonus in harvest yield for all the player's agricultural buildings.
<br>
Many discoveries yield a patent. The patent takes the form of an item that is freely tradable on the open
market, and it is this item which provides the benefit. So if the player making the
"improved plough" discovery has no agricultural buildings, they may decide to sell the
patent to their discovery to someone for whom it will be much more lucrative.
Upon a discovery, the discoverer receives 10 patent items. Anyone in possession of one
of them will benefit from the discovery. Possessing more than one item for a given
patent gives no benefit over possessing just one.
<br>
Discoveries are made by paying towards research on a particular subject. Every discovery
has a difficulty, which represents an estimation of how much research will have to be made
before the discovery is made. Paying towards research gives you a certain chance of making
that discovery. The more is paid for research, the higher the chance of discovery. The
higher the difficulty, the lower the chance. The difficulty of a discovery goes down with
time, as well as with money already spent on research. So if a discovery seems too dear
to research, waiting will bring it down to affordable levels, if someone else doesn't beat
you to the punch.
<br>
Patents last a limited time. After 15 game years (105 days in real time), though this might change in the future), everyone gets the benefit of
the discovery for which a patent was awarded. This will prevent the first discoverer from
obtaining an advantage leading to a snowball effect, leaving others unable to ever catch up.
<br>
Some discoveries can only be researched once other prerequisite discoveries are discovered.
When all prerequisites of a discovery are discovered, anyone may start researching that
newly unlocked discovery, not only the person who discovered the last prerequisite.
<br>
Research buildings provide a bonus to research, essentially making discoveries cheaper
for the owner of those buildings.
<br>
More discoveries will be added later on, possibly in conjunction with storytelling.
</p>
<h2> Special events </h2>
<p>
Special events are temporary alterations to game rules which happen randomly at a game update
boundary. Some events have good or bad effect, providing interest and potential hooks for storytelling.
Special events include fire (there will be new discoveries providing protection against
fire), time limited bonuses for some types of buildings (bumper harvest increase influence
of agricultural buildings), epidemics causing lower payouts for some building types, strikes
causing labour shortages, social unrest causing damage to buildings not near a military building,
festival increasing cultural building payouts, etc.
Special events are localized to a particular town. To see whether a special event is currently
active in town, see the "Town" section in the UI. If a special event is active, there will also
be a "?" button to get more information about it. There cannot be more than one special event
active in a given town at the same time.
</p>
<p>
Fires are a particuarly special kind of special event. When a fire breaks out, military buildings
act as firefighters, and can attempt to put a fire out. If a burning building is within 350% of
a military building's influence, anyone can pay it to fight the fire. The larger and the higher
economic power a military building, the stronger its fire fighting capability. The larger a burning
building, the harder the fire is to put out. Once a military building has tried to put a fire out,
whether succesfully or not, its firefighting efficiency drops to 20%, and will grow back to 100%
over a period of almost a game update cycle. If a fire is put out for a building, that building
will not burn again until the end of the fire event. The fire has a chance to stop at every game
tick. If the building drops to 0 repair before the fire is extinguished or fizzles out, it is
destroyed.
</p>
<h2> Items </h2>
<p>
In addition to construction materials such as stone and wood, various types of items exist in
Townforge. Most are predefined, but players may also define their particular choice of items.
Those can then be used, given, traded as other items. Possible uses for these player defined
items include in-game company shares, lottery tickets. Note that since player defined items
are custom, any promise made by players which does not rely on game mechanics relies on trust
in that player (for example, if Alice creates a new "Alice Corp" item with 100 instances,
then game mechanics ensure no more than 100 instances will ever exist, that players may trade
these items. But if Alice says she will pay monthly dividends from her in game "Alice Corp"
company, the game cannot and will not enforce payment of these dividends.
</p>
<p>
Non Fungible Tokens may be created, and linked to arbitrary data stored on IPFS.
The item creation form allows selecting a file to upload to IPFS, the hash to which will be
stored in the item data on the blockchain.
The game only supports displaying some types of image, including PNG and JPEG. Remember that
these images are user created, and their creator is potentially malicious.
<br>
Townforge will keep that data pinned for a few days after item creation. Beyond this, the item
creator (or current owner, or anyone else) has to keep running the IPFS daemon or use an
external pinning service to keep the data available.
</p>
<p>
A player may define items groups. Item groups are items themselves, but with no actual instances
created. Any player defined item may optionally be set to belong to a group created by the
same player. This may be used to group similar items, for instance to create non fungible items
(ie, create a "Animal figurines" group, then two non group items "Cow" and "Pony", each with
just one instance). Grouped items may have an amount greater than one, to enable collections.
Note that the number of items in a group can go up, even though the number of items of a non
group type cannot, since new item types may be created in a group. Item groups may be private
of public. If public, anyone can create new items in this group. If private, only the creator
of the group may do so.
</p>
<p>
Player created items may contain some amount of gold in them. This gold will be recovered if
the item is destroyed (minus a small smelting fee). Items with gold contribute to increasing
the owner's prestige score.
</p>
<p>
Collectible coins are a special type of item. New coin designs are created to mark various
game events and any player may mint one or more by supplying the gold necessary for the item.
Collectible coins are available for minting for a period of one game year (a real week) after
they are first introduced. After this period, the only way to obtain this coin is the peer to
peer markets. A collectible coin may be smelted at any time to recover the gold (but if the
minting window is over, may not be turned back into the original coin).
</p>
<h2> Badges, levels, prestige, role playing and attributes </h2>
<p>
Badges are a way to track a player's progress through the game. Badges track a particular metric
(for instance, the number of buildings a player has) and have a level from 1 to 5. The better
you score in a particular badge's metric, the high level you will obtain for this badge.
<br>
Badges are what determine a player's level, giving a numeric value to the player's progression
through the game. As a player obtains more and higher level badges, the player's level will
increase. At each level, the player may allocate a point to an attribute of their choosing.
Some building material variants and chat colours become unlocked at certain levels.
<br>
Prestige is a score calculated from players' precious items, such as collectible coins and
gemstones and badges. Coin rarity (ie, how many coins of a given design exist) is the main driver of
prestige for coins, with coin age and number of coins owned also having some impact.
0.5% of the the game subsidy goes to the players with the most prestige. Each full set of
coins in a runic cycle (a period of 19 years) gives additional bonuses, as does owning at least
one of each type of gemstone (amethyst, sapphire, emerald, ruby, diamond). Core badges (ie, not
the ones awarded for role playing) and up to 5 event badges give a small prestige bonus. The
genesis coin also gives an extra bonus.
<br>
Attributes are role playing style facets of the player, which are dynamically defined by the
game account which runs role playing events. These are intended to add some extra interest in
the game not stemming directly from the economy mechanics. Those attributes are in turn used
in role playing events to influence outcomes of storylines.
<br>
While most badges are managed by consensus, the game account can create new badge types, which
will be awarded to players who participate in optional role playing sessions.
<br>
Attributes currently have no effect on the game mechanics.
</p>
<h2> Auctions and mortgages </h2>
Flags (whether with a building on them or not) and sets of items may be auctioned. Auctions
take place over a time of 2 to 14 days, at the seller's option. Auctions are driven by the game,
so bids and the sale are automatic and atomic. If any bid happens too close to the end of the
auction, the end is pushed back by another game tick (auctions always end on game ticks). If
the seller wants to have a minimum sell price, the seller should bid that price themselves,
so they'll basically buy back their own auctioned property if noone bids higher.
<br>
Auctions may be created either for a flag or for a set of items. In the latter case, several
items of different types may be sold as a slot (for instance, a set of collectible coins).
<br>
A flag can be mortgaged. This allows a player to raise money from other players in a semi
trustless way, since mortgage repayments will be automatic. A mortgage's repayment schedule
can be configured by the mortgage issuer on its creation. Once created, the stated repayments
(which can be made in gold or other items) will happen at every game tick. Should the creditor
not have enough balance to meet a payment, the mortgaged building will be automatically taken
by the game and put on auction for a week. Proceeds from the sale will then be distributed
to creditors. Any leftover will be given back to the mortgage issuer.
<br>
To avoid order spam, there is a small fee for creating an auction as well as for bidding.
<h2> Scripts </h2>
<p>
Townforge supports in game scripting, which is used for storytelling and world building
purposes, allowing players to play through stories designed by the game designers.
Scripts can have effects on players, but cannot create gold or items at will. Anything
a player gains will be transfered from the game account. If the game account does not
have enough inventory, the script will not start.
<br>
Players can also use this scripting capability in a very limited way. Any level 5+
player may place a runestone anywhere in a building, and attach a message, a script,
or both. Other players clicking on this runestone will see the message, and have
the option to start the script. To avoid abuse, styling will be enabled only for the
current city's mayor and the game account. Additionally, the mayor of a city may enable
styling in their city for any account they choose.
<br>
To prevent abuse, players may not write their own scripts directly. Instead, they can
submit their script for approval to a game designer, who will vet those scripts first
(typically for a fee depending on the script's complexity). Once those scripts are vetted,
they can be used on a runestone. It will also be possible to a player to write a complex
script, get it vetted, then allow other players to pay the writer a fee to use it.
<br>
Since scripts are state machines with arbitrary branching, it is possible to create
scripts that never finish, or do not do what they claim to, thereby defrauding another
player. This is why scripts must be vetted before being allowed in game. Automated
countermeasures are possible, and may be employed in the future, which would allow any
player to write their own scripts directly. However, this is not a certainty.
</p>
<h2> Leaderboards </h2>
<p>
Leaderboards track various statistics. It is possible that some small amount of the
treasury will be distributed to those at the top of at least some of them.
</p>
<h2> Blockchain </h2>
<p>
Townforge is a blockchain based game. The entire game state is stored on the chain. This
brings advantages (protection against exit scam, against abuse of power by the game author)
but also drawbacks (the need to wait for a block for every action to be recorded on the
blockchain).
<br>
The blockchain is based on Monero, so a lot of things will be very similar to Monero.
In particular, non-game transactions benefit for Monero style privacy. In game transactions
are public, however. Everyone will know that game character Alice just built a new house
on that location, with those settings, etc. However, Noone knows who plays Alice, since
gameplay happens through blockchain transactions. However, Alice might have more than one
character, and nobody will know, assuming she does not do things like giving all of a
character's money to the other. It is what the Internet was meant to be:
somewhere you can live in without having to constantly show papers.
<br>
Note that the daemon the game connects to will know which player the game controls. As with
Monero, you are supposed to use your own daemon.
<br>
Technically, the block target time is thirty seconds. The emission curve is similar to Monero's
starting off at about 17 coins per block and decreasing till a floor of 0.5 gold a block, or
1 gold a minute, where tail emission starts. This makes the tail emission about 50% higher
than Monero's.
<br>
Game transactions are much smaller that normal transactions. 100 bytes is typical, compared
to 2.5 kB for out of game transactions. This is what you get for eschewing privacy (after
all, you need people to see your buildings to build a city). Note that in game transactions
do not compromise the privacy pool of normal out of game transactions since the in game
accounts are balance based, not output based.
<br>
Townforge can be merge mined with Monero, or separately.
<br>
The decentralized marketplace is implemented by transactions which get publicized on the
txpool, and mined when they're matched with another.
<br>
A huge number of consensus changes were made: all the game specific rules are consensus
changes. These changes have not received anywhere near the scrutiny a Monero consensus
change would receive. Since markets allow items, buildings etc to be turned to and from
money, this means that there is a non trivial chance that there may be a bug which affects
balances. Money supply looks unlikely to be affected, though. This is a game first, and
a currency second. Treat is as such.
<br>
Townforge will not be a static game. There will be changes to the game as it runs its
course. Some of these changes will be to consensus rules. While the emission will not
change, other things might, such as the price of last resort materials, the land tax
function, cost of new land, etc. These and others may need changing based on seeing how
the game economy behaves with many players.
</p>
</html>