draugnorak/files/instructions.md

# Draugnorak

A survival audio game built with NVGT
Explore gather craft defend your base through the day and night cycle

## Installation
- Unzip the file for your operating system
- On Linux and Mac mark the draugnorak executable as executable

```bash
chmod +x draugnorak
```

### Android Note
- Android builds require an external keyboard (USB or Bluetooth)
- Touch controls are not implemented because too many game controls to do this in a good way for playability

## Quick Start
- Move with Left or Right
- Jump with Up
- Hold Shift or slash or Z for 2 seconds to start a search results come after 1 second delay
- Craft basic tools in the base with C
- Set snares and build fires to survive

Some of the first things you will want are a stone knife a spear a stone axe and a firepit

## Controls
- **Left or Right** move
- **Up** jump climb trees start rope climbs when prompted
- **Down** climb down trees descend rope climbs when prompted
- **Shift or slash or Z hold** search area
- **Control hold then release** attack with equipped weapon bow and sling use a charge window
- **Space** call your pet send it out or call it back
- **A** action menu place snare feed fire burn incense also check fire fishing pole or snare if in range
- **C** crafting menu base only
- **I** inventory
- **E** equipment
- **P** character info
- **B** base info base only
- **Q** quests menu base only
- **S** altar menu base only
- **F** fylgja menu once unlocked
- **Tab** adventure menu outside base once per day
- **H** health
- **T** time
- **X** coordinates and terrain
- **1 to 0** quick slots press in Equipment to bind an item to equip or in Inventory to bind a count check
- **Backspace** pause or resume
- **Escape** exit game or close menus

### History Shortcuts
- **Backslash** repeat most recent notification
- **Left bracket** previous notification
- **Right bracket** next notification
- **Comma** previous speech history message
- **Period** next speech history message

## Menus
- **Up or Down** move selection
- **Enter** confirm
- **Escape** close
- **Tab in most menus** perform max actions craft all deposit all and similar

## Gathering and Resources
- **Grass Forest Deep Forest** sticks and vines search
- **Gravel Stone** stones search
- **Streams and water edges** reeds and clay search
- **Snow** found in high mountains currently yields no resources
- **World drops** found on the ground after hunting search picks them up such as goose turkey and recoverable arrows
- **Trees** search near trees for sticks and vines
- **Trees** use an axe to chop a tree for logs and extra sticks and vines
- **Trees** regrow over time
- **Trees** you can climb Up and climb down with Down

## Crafting Base Only
Crafting is only available in the base with C

### Categories
- **Weapons** spear sling bow
- **Tools** knife snare stone axe fishing pole rope quiver canoe reed basket clay pot
- **Materials** butcher game smoke fish bowstring arrows incense
- **Clothing** skin gear moccasins pouch backpack
- **Buildings** firepit fire herb garden storage pasture stable altar
- **Barricade** reinforcement options
- **Runes** engrave equipment after unlocking runes in adventures

## Combat and Hunting
- Equip weapons in the Equipment menu or bind them to quick slots
- **Spear** 1 tile range
- **Axe** melee also chops trees
- **Sling** ranged uses stones hold Control to charge release on the in range audio cue
- **Bow** ranged uses arrows hold Control to draw release to fire damage scales with draw time 0 to 10
- Enemies include zombies at night bandits during invasions and boars during daytime
- **25 percent chance** to recover a fired arrow as a world drop
- If your base has an altar each undead kill grants 0.2 favor

## Base and Survival
- Passive healing in the base when below max health
- Herb Garden increases healing speed base only one per base
- Fires require a nearby firepit and need fuel sticks vines logs
- Barricade starts at 40 health capped at 500 reinforces via Crafting Barricade
- Storage enables base inventory management and helps attract residents
- Residents if recruited consume meat help defend repair the barricade and collect resources

## Residents and Automation
Residents can automate survival tasks defend your base and process resources
To get the most out of them ensure you have the necessary tools and facilities in your base storage

### Recruitment and Care
- **Recruitment** residents can join after invasions end if your barricade is standing storage increases the chance 1 to 2 survivors can join at a time up to a maximum of 4 residents beware the vampyr it will eat your residents
- **Food** each resident consumes 1 unit of food every 8 hours 3 per day
- **Food priority** meat then smoked fish then basket of fruits and nuts
- **Hunger** if no food is available residents go hungry and stop working
- **Blessing** the Blessing of the Resident from the altar doubles efficiency and reduces tool breakage for a short time

### Activities and Requirements
- **Defense melee** requires spear deals damage to attackers spears can break
- **Defense ranged bow** requires bow and arrows preferred ranged defense consumes arrows bows can break
- **Defense ranged sling** requires sling and stones attacks from a distance consumes stones slings can break
- **Repairs** no tools required repairs the barricade during the day
- **Gathering** requires reed basket collects sticks vines stones and logs
- **Foraging** requires reed basket occurs during daytime and scales with resident count produces basket of fruits and nuts
- **Fishing** requires fishing pole daytime only requires a nearby stream catches raw fish
- **Smoking fish** requires raw fish and sticks requires a burning fire converts fish to smoked fish
- **Butchering** requires knife and game requires a burning fire processes small game or boar carcasses into meat skins and more
- **Snare check** requires placed snares checks active snares retrieves small game and resets the snare

Tools used by residents can break keep a stock of spares

## Pets
Pets are optional companions that can fight and retrieve drops

### Getting a pet
- Pets can appear after a quest score of 10 or more
- Pets can appear after adventure victories with a small chance
- Reaching the top of a tree can attract a hawk with a small chance
- You need food to accept a pet offer

### Calling and status
- **Space** call your pet
- If your pet is out Space recalls it and your pet runs back to you
- If your pet is with you Space sends it out and costs 1 loyalty
- If loyalty is 2 or less your pet will not go out and says it is hungry and unresponsive
- If your pet is knocked out Space reports remaining recovery time
- Press H to hear pet health and loyalty when you have a pet

### Loyalty and feeding
- Loyalty starts at 5 and max is 10
- While your pet is out loyalty drops by 1 each hour
- At loyalty 1 you get a hungry warning notification
- If loyalty reaches 0 your pet leaves
- Every 8 hours your pet can eat 1 food only while it is not out
- Eating restores loyalty to max
- Food can be meat smoked fish raw fish or basket of fruits and nuts
- Food is taken from your inventory first then storage

### Help in the field
- When out your pet attacks bandits undead and boars within range
- Each successful hit costs the pet 1 health
- Pets do not heal while out
- If health reaches 0 the pet is knocked out for 3 hours and then recovers
- When out your pet can retrieve world drops like small game boar carcasses and arrows
- Retrieval messages are spoken without the pet sound cue
- If you cannot carry the item the pet keeps it and it is lost
- Pets stay out and follow you until you recall them with Space or they leave from loyalty loss

### Random finds
- If loyalty is at least 5 your pet can bring back sticks vines stones or clay

## Time Weather and Events
- 1 real minute equals 1 in game hour
- Day night ambience crossfades around sunrise and sunset
- Weather transitions between clear windy rainy and stormy
- Invasions begin on or after day 2 and expand the map east
- Expansions can be normal biomes or mountain ranges

## Mountains and Rope Climbing
- Mountains have elevation steep slopes require a rope
- When prompted press Up to climb up or Down to climb down
- Moving left or right during a rope climb cancels and causes a fall
- Falling from height can cause damage

## Quests Adventures and Runes
- Quests become available in the base once you have an altar and enough favor
- Adventures are accessed with Tab outside the base once per day
- The mountain adventure features the Unicorn boss unlocking the Rune of Swiftness
- The forest adventure features the Bandit Hideout unlocking the Rune of Destruction
- Fylgja unlocks after 9 wins in its adventure press F to activate once per day for example Unicorn Charge
- Runes are engraved in the base Crafting Runes and require a knife clay and favor

## Inventory and Storage
- Personal inventory stacks are capped at 9
- Skin pouches add 2 stack capacity backpacks add 9
- Arrows require quivers each quiver adds capacity for 12 arrows
- Bowstrings are crafted from sinew at a fire and used to craft bows
- Storage is separate and accessed in the base Inventory menu when storage exists

## Saving and Loading
- The game auto saves daily at 6 AM in game time
- Load from the main menu starting a new game prompts if a save exists
- In the Load Game menu press Delete to remove the selected save (confirmation required)