WOLF SURVIVAL v0.15.0
Created by Gnarly Bastard Mods
Red Dead Redemption 2 Story Mode only

======================================================================
OVERVIEW
======================================================================

Wolf Survival turns RDR2 free roam into a hardcore animal survival mode.
Play as a wolf, hunt animals and humans, feed from carcasses, drink from
natural water, manage health, stamina, hunger and thirst, and rest to heal.

Version 0.15 adds fully configurable controller support while remaining
backward compatible with v0.14 INI and save files.

======================================================================
REQUIREMENTS
======================================================================

- Red Dead Redemption 2 for PC
- Story Mode
- ScriptHookRDR2
- ASI loader, normally dinput8.dll

Do not use this mod in Red Dead Online.
Back up your Story Mode save before using player-model mods.

======================================================================
INSTALLATION
======================================================================

NEW INSTALLATION

Copy these files beside RDR2.exe:

WolfSurvival.asi
WolfSurvival.ini

The same folder should normally contain:

RDR2.exe
ScriptHookRDR2.dll
dinput8.dll

Remove all older or renamed WolfSurvival ASI files first.

UPDATING FROM v0.14

You may replace only WolfSurvival.asi.

Keep your existing:

WolfSurvival.ini
WolfSurvival.save

On the first v0.15 launch, the ASI appends the new controller sections to
an older v0.14 INI without overwriting keyboard, HUD, balance, or save
settings.

======================================================================
DEFAULT KEYBOARD CONTROLS
======================================================================

F8           Enable or disable Wolf Survival
F            Bite or lunge attack
Left Mouse   Additional mouse attack input
Hold E       Feed from a carcass or drink from shallow water
H            Howl
Z            Enter or leave the hunting/resting stance
Left Shift   Sprint tracking and safe prone exit
F7           Show status and survival values
F10          Reload the INI
F11          Emergency Arthur/John restoration

Keyboard controls use Windows virtual-key codes and remain configurable
through the existing key sections in WolfSurvival.ini.

======================================================================
DEFAULT CONTROLLER CONTROLS
======================================================================

LB + D-Pad Down     Enable or disable Wolf Survival
RT                   Bite or lunge attack
Hold Y               Feed from a carcass or drink from shallow water
D-Pad Up             Howl
B                    Enter or leave the hunting/resting stance
A                    Sprint tracking and safe prone exit
LB + D-Pad Left      Show status
LB + D-Pad Right     Reload the INI
LB + D-Pad Up        Emergency Arthur/John restoration

The administrative LB combinations are processed before single-button
actions. Therefore LB + D-Pad Up restores the human model instead of
triggering the normal D-Pad Up howl.

Movement and camera controls remain managed by RDR2 or Lenny's trainer.

======================================================================
CUSTOMIZING CONTROLLER CONTROLS
======================================================================

Every Wolf Survival controller action has its own INI section:

[ControllerToggle]
[ControllerAttack]
[ControllerFeedDrink]
[ControllerHowl]
[ControllerProne]
[ControllerSprint]
[ControllerStatus]
[ControllerReload]
[ControllerRestore]

Each section supports:

Hold=NONE
Press=RT
HoldGroup=0
PressGroup=0

Hold=NONE means the Press button works alone.
Set Hold to another button to create a combination.

Example: change howl to RB + Y:

[ControllerHowl]
Hold=RB
Press=Y
HoldGroup=0
PressGroup=0

Supported Xbox-style names:

A, B, X, Y
LB, RB, LT, RT
DPadUp, DPadDown, DPadLeft, DPadRight
LS, RS
Start, Menu
Select, Back, View
NONE

Supported PlayStation aliases:

Cross, Circle, Square, Triangle
L1, R1, L2, R2
L3, R3
Options

Names ignore capitalization, spaces, underscores, and hyphens.
For example, DPadUp, DPAD_UP, and dpad-up are treated the same.

Advanced users may enter a raw RDR2 input hash:

Press=0x6FED71BC

Raw hashes are input actions, not universal physical-button IDs, and can
be affected by the current RDR2 control context. HoldGroup and PressGroup
should normally remain 0.

Set controller support off with:

[Controller]
Enabled=0

Press F10 after changing the INI.

======================================================================
STARTING SURVIVAL VALUES
======================================================================

A new wolf starts with:

Health:  100%
Stamina: 100%
Hunger:   50%
Thirst:   50%

Toggling the mode off and on does not refill survival values.

======================================================================
HUNTING AND ATTACKING
======================================================================

Face a person or animal and use the configured attack control.
The target must be close and generally in front of the wolf.

Attacks use stamina and have a cooldown. Human targets are enabled by
default. The mod plays a wolf attack animation and applies damage shortly
after the animation begins.

======================================================================
FEEDING
======================================================================

Hold the configured Feed/Drink control beside a dead or dying body.

Default maximum hunger recovered from one fresh carcass:

Small animal:  approximately 5%
Medium animal: approximately 15%
Large animal:  approximately 30%
Human remains: approximately 20%

Each carcass has limited food. Feeding restores only a small capped amount
of health. Resting is intended to be the main healing method.

======================================================================
DRINKING
======================================================================

Approach a river, lake, pond, or other natural water source. Face shallow
water, stop moving, and hold the Feed/Drink control.

The wolf cannot drink while swimming or deeply submerged. Carcasses take
priority if food and water are both within interaction range.

======================================================================
HUNGER AND THIRST
======================================================================

The default INI drains a full hunger bar and full thirst bar in about
12 real minutes. A new wolf beginning at 50% has about six minutes before
reaching zero if it does not eat or drink.

Adjust these values under [Survival]:

HungerMinutesFromFullToEmpty=12
ThirstMinutesFromFullToEmpty=12

At zero hunger, the wolf takes starvation damage.
At zero thirst, the wolf takes dehydration damage.

======================================================================
RESTING AND HEALING
======================================================================

Stop moving and use the configured Prone control.

While fully settled:

- Stamina regenerates faster.
- Health slowly recovers.
- The wolf remains vulnerable.
- Healing pauses if hunger or thirst is below the configured minimum.
- Starvation and dehydration still cause damage.

The mod displays a message explaining whether hunger, thirst, or both are
preventing healing. Healing resumes automatically once both needs recover.

======================================================================
F7 / CONTROLLER STATUS
======================================================================

The status display includes:

- Health, stamina, hunger, and thirst
- Water detection
- Resting state
- Feeding and drinking systems
- Controller ON or OFF
- Controller SEEN after a configured controller action is detected
- Gnarly Bastard Mods branding

======================================================================
TROUBLESHOOTING CONTROLLER SUPPORT
======================================================================

CONTROLLER DOES NOTHING

1. Press F7 and confirm the mod says v0.15.
2. Confirm [Controller] Enabled=1.
3. Replace both the ASI and INI for a clean test.
4. Try RT attack and D-Pad Up howl while Wolf Mode is active.
5. Press F10 after editing the INI.
6. Check for another mod using or disabling the same controller actions.

A CUSTOM BIND DOES NOT WORK

- Try one of the supported readable names.
- Leave HoldGroup and PressGroup at 0.
- Avoid Start if you do not want the pause menu to open.
- Avoid binding two single actions to the same button.
- Use Hold combinations for status, reload, restore, and toggle actions.

THE OLD INI DOES NOT SHOW CONTROLLER SECTIONS

Launch v0.15 once, close the game, and reopen WolfSurvival.ini.
The ASI should append the missing sections automatically.

THE GAME PERFORMS ITS NORMAL BUTTON ACTION TOO

Wolf Survival reads existing RDR2 input actions rather than replacing the
entire controller system. Some bindings can also perform their normal game
action. Choose a different button or a Hold combination in the INI.

======================================================================
OTHER TROUBLESHOOTING
======================================================================

No attack:
- Move closer and face the target.
- Try keyboard F to compare.
- Confirm sufficient stamina.

Cannot feed:
- The body must be dead or dying.
- Move closer and hold the control.
- The carcass may already be empty.

Cannot drink:
- Face the shoreline.
- Move into shallow water, not deep water.
- Check F7 for Water YES.

Resting does not heal:
- Hunger or thirst may be below the minimum.
- Wait for the wolf to finish entering the resting stance.

Arthur or John does not restore:
- Use F11 or the configured ControllerRestore combination.
- Load a backup save if needed.

======================================================================
UNINSTALLATION
======================================================================

Close RDR2 and delete:

WolfSurvival.asi
WolfSurvival.ini
WolfSurvival.save
WolfSurvival.log

The save and log files may not exist until the mod has been used.

======================================================================
CREDITS
======================================================================

Concept, testing, development direction, and release:
Gnarly Bastard Mods
