PROJECTGPB2  v1.0
===========

Graphics, a rider's-eye camera and new effects for GP Bikes, in one red
menu you can use with the mouse. Built for the current Steam GP Bikes
(plugin data version 12).

INSTALL
1. Close GP Bikes.
2. Copy the "plugins" folder inside "gpbikes" from this zip into your GP Bikes
   folder (the one with gpbikes.exe, e.g. SteamLibrary\steamapps\common\GP Bikes).
   Say yes to merge.
   You should end up with:
     plugins\ProjectGPB2_core64.dlo   graphics + the menu
     plugins\ProjectGPB2_cam64.dlo    rider POV camera
     plugins\ProjectGPB2_fx64.dlo     backfires, smoke, heat haze, dust, weather
     plugins\ProjGPB2\                shaders, sounds, settings, log
     plugins\presets\                 graphics presets
3. Start the game and go on track.

ReShade: if you use ReShade (an opengl32.dll next to core.exe), turn it off
or remove it while you try ProjectGPB2. The two do the same job and can fight.

KEYS
F6          the ProjectGPB2 menu (open / close + save)
F9          graphics on / off (compare with the normal game)
Ctrl+F9     reload settings

THE MENU
Three pages: GRAPHICS, RIDER POV, EFFECTS. Every change applies live.
  Mouse     click a page tab, click a row to select it, drag a slider,
            click a switch or a < choice >, wheel to scroll,
            Ctrl+wheel to adjust the row under the mouse, X to close.
  Keys      Up/Down select, Left/Right change (Shift = fine steps),
            Tab = next page, PgUp/PgDn = previous / next section,
            Enter = toggle / load preset, Ctrl+C / Ctrl+V = export / import.
Settings are saved to plugins\ProjGPB2\ProjGPB2.ini.

EFFECTS
EFFECTS
- Backfires: when you snap the throttle shut at high revs, on downshifts and
  on the limiter - a blue-white flame cone, orange licks, sparks, a flash that
  blooms, a puff of soot and a pop.
- Exhaust smoke: two-strokes smoke the way GP Bikes itself does it: read from
  the bike's gfx.cfg (its pipes and smoke top_rpm / max_rpm) and from
  effects\particles\exhaustsmoke.cfg. Strongest around top_rpm, gone by max_rpm,
  scaled by the throttle; it leaves the pipe with half the bike's speed plus
  the gas speed (revs x exit_speed_scale). Thickness, puff size, how long it
  hangs and smoothing are in the menu. Four-strokes give a faint haze.
- Heat haze shimmers out of the pipe, strongest when it's revving.
- Sparks: Spark hue / colour strength / brightness in the menu (default: red).
- Off-track dust: only when a wheel is on grass, sand, soil or gravel (never
  on tarmac or kerbs), with grass bits or stones. Other riders get dust where
  your own bike has found grass / gravel.
- Pipe position: by default the pipes come from the bike's own gfx.cfg. For
  bikes packed in a .pkz (no gfx.cfg to read) use the Height / Forward / Side
  sliders and "Twin pipes".

WEATHER AND SEASONS (GRAPHICS page, under SNOW)
- Thunderstorm: the day darkens, lightning strikes in front of you (a branching
  channel that flickers and re-strikes, sheet lightning in the clouds), the
  flash lights the sky and the scenery, and the thunder arrives later - about
  3 seconds per kilometre. Strikes per minute and thunder volume are settable.
- Hail: small white stones streaking down and bouncing.
- Snow on grass and trees (use with the overhaul's Snowfall, which covers the
  track).
- Autumn tree colours: trees turn orange, red, yellow and brown, tree by tree;
  grass dries.
- Falling leaves, and leaves lying on the track in drifting patches.
- Rainbow: 42 degrees round the point opposite the sun, with the fainter
  second bow outside it. Look away from the sun to see it; none when the sun is
  high or down.


PHOTO AND RIDING EXTRAS
- Photo pan blur (EFFECTS page): the background streaks while the bike stays
  sharp, like a panning shot. Best in replays, and it works while paused.
- Headlight and brake light: a headlight cone that follows the steering, and a
  brake light when you brake. Both settable.
- Helmet FOV and view distance (RIDER POV page): add to the game's own FOV and
  see further, without the game resetting it.
- Rider POV head motion: smooth head movement in helmet view, Overall shake to
  set how much.
- Stronger ambient occlusion (up to 4x) for deeper contact shadows.



VERSION HISTORY
v1.0 - first release.

ALSO FIXED
- The sun no longer jumps and snaps back while you ride.
- Helmet / onboard view: the white wedge over the track through the windscreen
  at lean is gone.
- Flames and smoke stay on the pipe at full lean.
- Lightning, flames and sparks against the sky are no longer wiped out by the
  sky.

PRESETS (GRAPHICS page, bottom)
  GPB 1 Performance - most FPS
  GPB 2 Balanced    - the normal settings
  GPB 3 Quality     - best image for strong graphics cards
They only change performance settings: your colours and look are kept.

IF SOMETHING LOOKS WRONG
- F9 compares with the normal game.
- plugins\ProjGPB2\ProjGPB2.log and gamefx.log say what happened.

UNINSTALL
Delete the three ProjectGPB2_*.dlo files (and the ProjGPB2 folder).

CREDITS
ProjectGPB2 is free. Please link to the download page instead of re-uploading it.
Heavy rain sound: "Calm rain.wav" by Zuvji, Wikimedia Commons (CC BY-SA 4.0)
Light rain sound: "Falling Rain SFX 1" by valvalion, Wikimedia Commons (CC BY 3.0)
