docs: add first week & forest survival (#3190)

* docs: add first week & forest survival

two doc pages for new players

* rough draft

moved the docs to the recommended folder, first rough draft was created

* Update doc/src/content/docs/en/game/first_week.md

Co-authored-by: scarf <[email protected]>

* Update doc/src/content/docs/en/game/first_week.md

no heading 1 got it

Co-authored-by: scarf <[email protected]>

* Update doc/src/content/docs/en/game/first_week.md

Co-authored-by: scarf <[email protected]>

* suggestions added

suggestions from scarf added

* refactor: create `tutorial` section

* docs: use aside

* style: run formatter

* docs: add more sections

---------

Co-authored-by: scarf <[email protected]>

doc/src/content/docs/en/game/tutorial/first_week.md

@@ -0,0 +1,125 @@
+---
+title: first week
+---
+
+:::tip
+
+In order to maximize your ability to learn and chances of survival, Evac shelter is recommended and
+expected.
+
+:::
+
+While daunting, the game is a lot easier than some might think. You can do a great deal to prepare
+yourself for combat, but remember the zombies always get tougher thanks to evolution. It only gets
+more dangerous.
+
+## First steps
+
+### Makeshift crowbar
+
+If you've started in the evac shelter, grab a rock outside and smash a locker and a bench. A
+makeshift crowbar will help you open doors quietly and just takes a pipe and a tool with hammering.
+
+### Cudgel (or other weapons)
+
+You need a good weapon, this is usually the cudgel in the early game. If you didn't start with a
+knife, you can always make a stone knife with no skills. the makeshift crowbar lacks the hit bonus
+the cudgel has, which is why I recommend it. Optionally you can get a wooden spear but it takes some
+character skills and a fire. A self bow and crude arrows is weak but is not a bad opener to combat,
+any damage helps.
+
+### Clothes
+
+You likely won't start with the perfect insulation from the weather, so you need to manage your
+temperature as slowdown penalties from the heat or cold will kill you quickly via slowing you down
+in combat. If its too hot this is easy you just take off layers. If it's too cold you'll need to
+craft what clothes you can or loot what you can but don't waste too much time on this. You'll likely
+find the clothes you need.
+
+:::note
+
+You want to minimize how many enemies you take on at once until you learn the game and the limits of
+your character, usually 1 enemy at a time is ideal
+
+:::
+
+## Going into town
+
+### Tools
+
+You can't do anything without tools. Go for an anvil, metal sawing, wood sawing, welding, and
+soldering. The rest can be crafted fairly easily if you have to. The anvil is easy if you get a
+hacksaw or toolbox and a car for spare frames.
+
+### Weapons
+
+Guns will keep you safe from the zombies through the entire game, and looting a gunstore is the
+easiest way to get geared. Otherwise, better melee weapons. You want fast hitting melee weapons and
+ideally a good to hit bonus unless your combat skills high enough to not worry about hitting.
+
+### Backpack
+
+You can't carry anything without a backpack, tailoring is the easiest way to just make one, but
+otherwise keep looking for any non-encumbering container.
+
+### Books
+
+Books make the game a lot easier but are mainly needed for recipes. Find ones for medieval crafting,
+guns, electronics, chemistry, and skills that can't be trained with crafting such as speaking or
+computers.
+
+## Cars
+
+### Finding one
+
+It's safe to say, you need to find a good car sooner rather than later. It will make the game a lot
+easier and you will carry more loot with you. Rather than finding a broken down one, go for high
+condition with relatively few destroyed parts. You may get lucky and find one fully functional. You
+can find cars anywhere there is roads. You'll get most of your tools from a mechanics garage or
+hardware store. Some homes may have garage tools.
+
+### Welding
+
+You can't do much with cars without a welder. Acetylene torches work for early game but look out for
+arc welders. An electric welder is the most important longterm solution, and attaching it to your
+car with a single solar panel provides unlimited welding potential. Weld before a break happens and
+you won't take meaningful car damage.
+
+### Hacksaw
+
+Without a hacksaw you can't remove most parts. This means adding parts will be just as hard.
+
+### Fuel
+
+Without fuel you won't be going anywhere. Gas stations come to mind, but you can actually craft
+diesel with the right book and cooking level. You can also opt for a solar car but it won't go far
+and you need a lot of panels and the electric motors.
+
+:::note
+
+Your first week was a success if you lived long enough to loot a gun store, find a working car, and
+have otherwise kept up with your survival needs.
+
+:::
+
+## Bonus Tasks
+
+### Electric grid
+
+If you made it this far you may want to set up a functioning electric grid at an evac shelter, or
+just install more things onto your car. The evac shelter has a mounted battery and solar panel it
+just needs an oven, electric forge, welder, soldering iron, etc. You can add wind turbines via a
+vehicle on the roof connected with a jumper cable connector for even more power.
+
+### Helicopter
+
+Geting a helicopter isn't easy but if you stumble onto the parts you can install them on any
+vehicle. Gyrocopter is a fabrication 10 option. Finding a crash means ripping apart any still
+functional parts and repairing it so it can be attached to a better vehicle.
+
+### Being brave
+
+There is a lot of more dangerous locations, monsters, and mods that add more dangerous locations and
+monsters. Labs, military bases, shipwrecks, mines, collapsed towers. You will want to explore, learn
+to take on more challenges. Remember that .50 BMG and being hit by a truck solves most enemy
+problems.

doc/src/content/docs/en/game/tutorial/forest_survival.md

@@ -0,0 +1,137 @@
+---
+title: forest survival
+---
+
+Being the most difficult part of Cataclysm, surviving in the woods with nothing is one of the most
+rewarding experiences. This guide will cover a tasklist that should keep you alive. Should you fall
+behind, continue the previous steps before moving onto the next day's tasks. The exception is day 1.
+Day 1 tasks are in order of severity.
+
+:::caution
+
+This guide ASSUMES you are not playing with mods that changes this too much, specifically changing
+foraging drops. You'll die if they removed trash from shrubs.
+
+:::
+
+## Day 1 requirements
+
+- Fire drill (1 Survival) or any fire starting device
+- Fire ring (20 rocks)
+- A water source & cooking container
+- Improvised shelter (2 survival) or sleep will be hard
+
+### Fire
+
+The reason you need a fire is you can't see to craft at night, and the cold kills. You can't boil
+water without fire. You don't want to use fire without a fire ring, as it's incredibly annoying.
+Fires outside a container randomly stop and don't tell you how long they will last. You can break
+small boulders with long sticks. You can forage shrubs by activating them, and this will give you
+tons of litter and trash, including containers for liquids. You can find a glass/steel bottle or
+cans. Once you can boil and make fire you've survived short term.
+
+Firewood is not an issue in the short term as you can burn any plant or wood, including long sticks
+from young trees. Two or three long sticks will make a good fire.
+
+An improvised shelter makes sleeping easier and only requires a digging stick, 2 survival, and a lot
+of sticks and pine boughs. Place near a fire for temperature management.
+
+## Natural resources
+
+### Shrubs, Food trees, and Berry bushes
+
+Shrubs can be foraged once per season for trash, the most valuable resource of the woods as it is
+your only source of steel. Depending on your season, in spring and summer you will be relying on
+berries in trees for calories and possibly hydration but shrubs will give plenty of food later on.
+
+### Fish
+
+If you can get fish it will be an excellent source of calories. You'll need a river and a basic
+fishing rod.
+
+### Young trees
+
+Young trees are how you get long sticks which you butcher into heavy sticks and then into splintered
+wood. Follow my first week guide for crafting tips, but in general it goes short cordage, stone
+knife, digging stick, wooden bead, wooden needle, stone adze, wooden clogs, stone shovel, stone axe.
+That will get you to survival of 4 and fabrication of 4.
+
+### Grass tiles and Cattails
+
+Grass can be removed with a digging stick or shovel to give piles of straw, which can make cordage
+for your crafts, cattail plant fiber should be saved for making rags.
+
+### Clay
+
+Clay terrain must be extracted in the construction menu. It can rarely be found from digging a large
+pit. You will need lots of it so find a river bank.
+
+## Week 1 requirements
+
+### Food preservation
+
+To preserve food you need a charcoal kiln and smoking rack to smoke meat or dehydrate what you farm.
+You need cooking 2 so boil some water and cook the assorted food you find, this will likely come
+without training. The kiln is fabrication 3 and requires you to dig soil but you likely have some if
+you made an improvised shelter. Place wood in the kiln and light it, you'll get tons of charcoal
+once it'sd one.
+
+### Water storage
+
+Storing lots of water either requires foraging many containers or crafting a lot of clay containers.
+Your easiest option is clay pots but they can't be resealed. This means you can't carry them with
+you while full.
+
+### Weapons
+
+A wooden spear is your best early weapon, cudgels are practically free to make and better for when
+you can't use a reach attack. You can upgrade to a quarterstaff if you get leather, with a working
+forge there will be tons of better weapons to make so these are temporary.
+
+### Firewood
+
+Firewood is going to be from chopping trees into logs with a stone axe. You may want to save the
+food-bearing trees.
+
+### Clothes
+
+Clothes are going to be made from rags made of plant fibers. Get knitting needles.
+
+## Longterm goals
+
+### Shelter
+
+Building a house is time consuming, painful, and not rewarding. If you choose to stay in the woods
+forever and not live in a pre-spawned structure or a car then you'll want to do it eventually. With
+a pickaxe you can live in the ground but otherwise you'll want to check a few of the walls and
+floors in the construction menu to see which kind of house to build. Log cabins are fairly sturdy
+and cheap but always at risk of fire. Mortar is not an obtainable item for you, so go with adobe
+mortar which limits you to stone walls or adobe brick.
+
+### Working forge
+
+A forge is critical to get working. Building a rock forge and gaining charcoal from a kiln is easy.
+A clay crucible, metalworking chisel, metal tongs, and a hammer are all easy to make with the right
+requirements. An anvil is incredibly expensive. You'll be searching shrubs forever, if you're
+playing with the city still enabled you can smash a car into bits.
+
+### Vehicles
+
+Depending on your mapgen you'll either graduate to messing with real cars, or be stuck with wooden
+carts and horse carriages. Starting a vehicle is done in the construction menu. A canoe is a good
+idea, wooden frames take nails and planks, most wooden vehicle parts just need wood and nails.
+You'll be grinding mechanics with wooden vehicle parts.
+
+### Electronics
+
+Electronics is specifically listed as long as you are playing with normal mapgen. If it doesn't
+spawn in your world you're out of luck. See normal gameplay for how to get started, but the jist is
+to deconstruct electronic furniture in town and make any low level craft you can to advance, such as
+flash lights and electric firestarters. If you get a solar panel, mounted battery and oven you'll be
+in a good position.
+
+:::tip
+
+That's about all you can do without going into the city.
+
+:::