townforge/GameData/TB/Tutorial/tutorials.json

253 lines
17 KiB
JSON

[
{
"name": "startup_tutorial",
"trigger": "startup",
"title": "Tutorial Compendium",
"pages": [
{
"name": "welcome",
"text": "Welcome to Townforge, a blockchain based Norse themed emergent city simulator, with embedded RPG elements.\n\nIf you are new to it all, click \"Or create a wallet\" on the main screen message after you close this window.\n\nBasic controls:\n Move: <color #1b6bc8>WASD</color>\n Camera: <color #1b6bc8>&#8592;&#8593;&#8595;&#8594;</color>\n\nPress >> below for an overview and quick start guide to key game mechanics, or Done to play the game right now.\n\nYou can always review any tutorial screen later from the options screen.\n",
"image": "Tutorial/tutorial_startup_welcome.png"
},
{
"name": "blockchain",
"text": "Townforge is decentralized, with the game state distributed among a network of peers. All game actions are added to the game blockchain. The Townforge network aims to find new blocks every 30 seconds on average, meaning the game state progresses - on average - every 30 seconds.",
"image": "Tutorial/tutorial_startup_blockchain.png"
},
{
"name": "crypto",
"text": "Townforge includes its own cryptocurrency, gold. Gold is used as money for in-game transactions, and it can be obtained by mining blocks, purchasing from other players or miners, or via in-game actions such as town treasury payouts.",
"image": "Tutorial/tutorial_startup_crypto.png"
},
{
"name": "wallet",
"text": "In order to play, you need to create a wallet or load an existing one. This wallet is essentially your means of access to your in-game account. Please note that due to the decentralized nature of Townforge, if you lose your wallet, nobody can recover it for you, so it is essential to keep the wallet secure and store its 25 word recovery mnemonic seed, preferably at a secure physical location.",
"image": "Tutorial/tutorial_startup_wallet.png"
},
{
"name": "concepts",
"text": "Townforge consists of: the daemon, the Townforge network, and the game itself. \n\n1) The daemon is your connection to the Townforge network - it will ensure your game state is up to date with other players'. \n2) The network is governed by consensus rules, and consists of every other Townforge player daemons. \n3) Finally, the game client is how the player interacts with the network. As an open source project, you could use any non-official client or even create your very own!",
"image": "Tutorial/tutorial_startup_concepts.png"
},
{
"name": "gameplay1",
"text": "The persistent world of Townforge is loosely based on Norse lore, but there is no single correct way to play. You can become a city building mogul, a fervent role player, an architect, an in-game market speculator, a share driven research-enterprise, and much more. The game is designed with emergence both mechanistically and aesthetically, with players driving the development of the Townforge world.",
"image": "Tutorial/tutorial_startup_gameplay1.png"
},
{
"name": "gameplay2",
"text": "In game, the main UI panel is located on the top-right corner, with ESC opening up the options. Movement happens with standard WASD-style movement. Hold the right mouse button to change camera direction. The arrow keys can be alternatively used to move the camera. Shift will increase the speed of movement, while control will decrease it. The left mouse button is used for selecting terrain and blocks and interacting with the UI. Finally, buttons Q, E, Z, and C are advanced buttons in building voxels, while X opens the material selection screen.\n\nA full list of key commands is available in the options, where they can be customized.",
"image": "Tutorial/placeholder_256x512.png"
},
{
"name": "gameplay3",
"text": "The main game panel opens from the top-right corner of the game screen and contains all the player commands. Depending on your current status (such as selected terrain), various options are greyed out or available - for example, purchasing land is available when you have selected an area.",
"image": "Tutorial/placeholder_128x128.png"
},
{
"name": "time",
"text": "All game actions are stored in blocks in the blockchain. Since blocks are added every 30 seconds on average, the game progresses in short bumps. Every 720th block (6 hours), a game update happens, where non-player initiated events happen.",
"image": "Tutorial/placeholder_128x128.png"
}
]
},
{
"name": "basic_ui_calendar",
"trigger": "ui_calendar",
"title": "Townforge Calendar",
"pages": [
{
"name": "Calendar wheel",
"text": "The Townforge year is split into four seasons, each with three months (early, mid, late). The green outer rim portions indicates vegetable sowing and harvesting, while brown indicates grain sowing and harvesting seasons. Intuitively, sowing happens in the spring, while harvesting more towards the summer and fall. The thick vertical black line indicates time progression, while the short black lines on the outer rim of the calendar wheel show game update times.\n\nA Townforge year lasts a week in real time.",
"image": "Tutorial/tutorial_basic_ui_calendar.png"
},
{
"name": "Temperature and details",
"text": "Temperature changes as a function of the seasons, affecting crops and in-game events. Furthermore, as in-game time progresses, certain game conditions, such as year-specific collectible coins or time-limited story scripts, unlock and progress.",
"image": "Tutorial/tutorial_basic_ui_calendar2.png"
}
]
},
{
"name": "basic_ui_compass",
"trigger": "ui_compass",
"title": "Compass and Coordinates",
"pages": [
{
"name": "Compass",
"text": "Townforge is played on a huge game world, allowing players to select where to build. The compass helps you find your bearings. You can face north by aligning the red pointer towards N(orth).",
"image": "Tutorial/tutorial_basic_ui_compass.png"
},
{
"name": "Coordinates",
"text": "Different locations have different properties such as soil fertility, price, and potential bonuses for various building types. All selections done with mouse highlight a shape on the {x,y}-plane, which can be used for land purchases, placing voxels for aesthetic building, etc.",
"image": "Tutorial/tutorial_basic_ui_coordinates.png"
}
]
},
{
"name": "basic_ui_player",
"trigger": "ui_player",
"title": "Player info",
"pages": [
{
"name": "Player",
"text": "The player info section in the main panel shows current in-game balance (public) as well as out-of-game balance (private).\n\nOpen the player information screen by pressing the ? button near a name, or press F10. This screen contain for example the item inventory, bio, discoveries, level, attributes, and achievements by the player. All in-game information is public and visible to other Townforge players.",
"image": "Tutorial/tutorial_basic_ui_player.png"
},
{
"name": "Wallet",
"text": "Upon starting the game, player is prompted to create a wallet file. Alternatively, an existing wallet file can be created. A wallet exists out of game, and will require 1 Townforge gold deposit to create an in-game account tied to it. The wallet files end in suffix .keys; additionally, a cache file without a suffix is created, and for troublehooting purposes deletion of this file may sometimes be necessary. \n\nTake good care of your wallet file, as it is a key component of your authentication!",
"image": "Tutorial/tutorial_basic_ui_wallet.png"
}
]
},
{
"name": "basic_ui_node",
"trigger": "ui_node",
"title": "Townforge node",
"pages": [
{
"name": "Node",
"text": "In order to play Townforge, you need to have an up-to-date blockchain, since it stores the game state. Therefore, make sure to be fully synced to the network. Due to the decentralized nature of Townforge, you may sometimes find yourself disconnected from the main blockchain, which may result in loss of game actions or even spurious game state.",
"image": "Tutorial/tutorial_basic_ui_node.png"
},
{
"name": "Mining and daemon",
"text": "Solving computational problems to append new blocks to the blockchain is called mining, and is optional, though highly encouraged. Mining will earn you gold, which you can then use in game or sell out of game.\n\nThe Townforge daemon is the component doing the mining, a computationally intensive process. Townforge supports merge-mining with the prominent privacy coin Monero. Merge-mining strengthens both networks and makes the miner eligible for rewards from both cryptocurrencies.\n\nThe game will run the dameon automatically if it is not already running, but it is possible to disable this from the options and run e.g. a custom remote node.",
"image": "Tutorial/tutorial_basic_ui_mining.png"
}
]
},
{
"name": "basic_ui_build",
"trigger": "ui_build",
"title": "Building",
"pages": [
{
"name": "Lot purchase",
"text": "In order to create functional buildings, the player must first purchase land in a city. The purchased lots may not overlap with existing lots and the player must have enough money to purchase the land. Every lot is subject to land tax, even if there is no building on it. Lots may be resized, bought, sold, auctioned and destroyed. Once a building is created on a lot, it will have to be destroyed to resize the lot.",
"image": "Tutorial/tutorial_basic_ui_landpurchase.png"
},
{
"name": "Building typing",
"text": "In order to make use of your newly purchased land, you must create a building on it. This involves choosing a building type (such as agricultural, residential, crafts, etc), and its economic power (EP). EP is a measure of economic potential, which includes size, quality, etc. Higher EP buildings give better returns, but require more and better construction materials, and pay higher land tax.\n\nBuildings are activated and inactivated at game updates, so the newly built building will have its first activation check on the next game updates. Note that several building types have preconditions in order to become active, or boost each other for being within influence range of favorable building types.",
"image": "Tutorial/tutorial_basic_ui_landpurchase.png"
},
{
"name": "Building sculpting",
"text": "If you want to, you can build voxel based 3D models of your buildings. This is a purely aesthetic function, and is not required in any way for the building to be fully functional. Since you have already paid for the construction materials when creating the building, sculpting a 3D model for it does not cost extra.\n\nAesthetic building is encouraged, and badges will be awarded for beautiful buildings.\n\nSome default key bindings essential for aesthetical building are\n-Q and E for adding or removing individual voxels\n-Z and C for adding or removing voxels at current selection\n-X for material selection, with horizontal for different materials and vertical for variations in material textures.\n-U to undo and R to redo \n\nAfter the building is ready, click Approve to send the planned building to be mined into the blockchain, after which is will slowly appear as horizontal slices.\n\nThese voxel-based buildings can be imported and exported in VOX format for user convenience; for example, trees and other replicated assets are easiest to build when imported.",
"image": "Tutorial/tutorial_basic_ui_landsculpting.png"
}
]
},
{
"title": "Aiming mode",
"trigger": "startup-1",
"pages": [
{
"text": "There are two aiming modes available: Mouse dragging style and Minecraft style.\n\nToggle between both with <color #1b6bc8>B</color>."
}
]
},
{
"title": "Player screen",
"trigger": "startup-2",
"pages": [
{
"text": "Press F10 to see your in game state, including your buildings, inventory, history and everything else."
}
]
},
{
"title": "Notifications",
"trigger": "startup-3",
"pages": [
{
"text": "If a notification disappeared before you read it, you can view history in the UI page of the options screen."
}
]
},
{
"title": "Day/night cycle",
"trigger": "startup-4",
"pages": [
{
"text": "The day/night cycle is based on your local time and is aesthetic only.\nYou can toggle it or choose a set time of day in the Graphics page of the options screen."
}
]
},
{
"title": "Merge mining",
"trigger": "startup-5",
"pages": [
{
"text": "Townforge is a proof of work cryptocurrency.\n This means you can mine with your computer to get Townforge gold which you can use in game.\nWhile you can mine directly from the game, using a pool miner on https://pool.townforge.net/ will be more efficient.\n\nIf you're familiar with cryptocurrency mining, solo mining or even merge mining with Monero is even better."
}
]
},
{
"title": "Vistas",
"trigger": "startup-6",
"pages": [
{
"text": "If you like a particular scene in Townforge, you can share vista codes with others so they can reprodduce the same view.\n\nGo the \"Bookmark vista\" in the main panel's city section, and copy the code. To view it, select \"Go to vista\" in that section."
}
]
},
{
"title": "Choosing your first plot of land",
"trigger": "startup-7",
"pages": [
{
"text": "Townforge's main gameplay is based on land and buildings. But all land is not equal. Agricultural buildings will fare better on land with high agricultural potential, sawmills on land with high wood quantity potential, etc.\n\nSee next pages for an overview of the properties of land in Townforge."
},
{
"text": "Stability\n\nStability is a measure of how well foundations will support a building. High stability mean buildings deteriorate slower, which means repairs are less frequent."
},
{
"text": "Agriculture\n\nAgriculture is a measure of the land's suitability to grow crops. Harvests will be more bountiful with higher agricultural scores."
},
{
"text": "Geothermal\n\nHigher geothermal scores mean the ground receives more heat from underground, and will offer a small boost in temperature, which has effects on how much heating is needed as well as crop growing"
},
{
"text": "Gemstone\n\nThe higher the gemstone score, the more likely a gemstone is to be found when quarrying the land. Only stonecutters may find gemstones."
},
{
"text": "Wood type\n\nTownforge has three types of wood: pine, oak and teak. Wood type score indicates the mix of those a sawmill will produce. Closer to zero and most wood will be the cheaper pine. Higher scores will shift production to oak and teak."
},
{
"text": "Wood quantity\n\nThe higher this score, the more wood a sawmill will produce. Quantity does not affect the relative makeup of wood production."
},
{
"text": "Stone type\n\nTownforge has three types of stone: sandstone, granite and marble. Stone type score indicates the mix of those a stonecutter will produce. Closer to zero and most stone will be the cheaper sandstone. Higher scores will shift production to granite and marble."
},
{
"text": "Stone quantity\n\nThe higher this score, the more stone a stonecutter will produce. Quantity does not affect the relative makeup of stone production."
},
{
"text": "Cliff\n\nCliffs are bare rock showing when terrain slope is high enough. Having exposed cliff face makes it easier to quarry, giving a bonus to stonecutter production."
}
]
},
{
"title": "Visualizing land properties",
"trigger": "startup-8",
"pages": [
{
"text": "You can view up to three land properties directly on the map to help you select where to buy land.\n\nIn the Terrain section of the main panel, select a mode, such as \"Agricultural\". Black shading means lowest score, white shading means highest score.\n\nTo view more than one property at once, select \"Multiple ground types\", then select another. Up to three maps will be displayed in the red, green and blue channels.\n\nThere are plenty of land properties to choose from<."
}
]
},
{
"title": "Terrain features",
"trigger": "startup-9",
"pages": [
{
"text": "Townforge's 3D terrain is not here only for aesthetics, but has an impact on a building's performance:\n\n - Temperature decreases with altitude\n - South facing slopes give bonuses to some building types\n - Agriculture gets a bonus from being protected from winds by surrounding ground\n - Some buildings get a bonus from being higher than their immediate surroundings\n\nMoreover, building 3D models that make clever use of terrain features is a good way to earn high level architecture badges!"
}
]
}
]