== DOWNLOADS: ==
----------- : ---- : -----------------------------------------------------
  game-home : 44MB : http://www.mediafire.com/download.php?lu0muy1bc229bhz
----------- : ---- : -----------------------------------------------------
      win32 :Ärkef.: http://test.bcfh.eu/shotty_win.zip
   Mac OS X :  R.R.: http://pbclan.tk/sekret_files/SST_assaultcube.dmg
linux64-bin :  flow: http://www.mediafire.com/download.php?2k0rqi6ktah3q63
----------- : ---- : -----------------------------------------------------
sourcediffs :   6KB: http://www.mediafire.com/download.php?7gda642opko5tdt
full-source : 300KB: http://www.mediafire.com/download.php?0xaa3kfh9hzxphm
----------- : ---- : -----------------------------------------------------

== HowTo: ==
If you are on mac, skip until you see "For Mac:". Everybody needs 'game-home' (media); unpack
contained ACshotgun folder to e.g. Desktop.
- Create a new link to game-launcher (assaultcube (.BAT)) and
- pass it the additional argument "--home=/PATH/TO/DESKTOP/ACshotgun",
  with PATH/TO/DESKTOP being your real path to where you unpacked the GameHome.
- use this launcher to test-play

- sgpat.cfg gives LCTRL & RCTRL (left/right control keys) new meaning
  left displays the last shot-pattern, right brings up the config-menu.

For Mac:
- Open the .dmg you downloaded, and play the game.

- sgpat.cfg (already included and executed) gives LCTRL & RCTRL (left/right control
  keys) new meaning left displays the last shot-pattern, right brings up the config-menu.
  If you are on a macbook pro and dont have RCTRL, P is bound to it by default.

== Caveats: ==

Windows: the client is still called ac_client.exe - rename to ac_shotgun.exe and
adapt a _copy_ of the BAT-file-launcher to match that new name.

Linux: you can copy the binaries to the bin_unix of your 1104 installation,
the gamehome replaces all the media so it matches the SVN-file-layout.

MAPS: you might have trouble spawning on maps, if so remove the "official" and "servermaps"
subdirectories of the packages/maps-folder in your unpacked-gamehome data!

== Technical background: ==
The shotgun uses 3 rings: center, middle and outer
Each ring gets 21 pellets distributed evenly (!) inside it's area.
The pellets (in their sum) can do a given percentage of the total-damage /if/ they actually hit.
All of these attributes can be configured.
The circles can be made to overlap each other, or leave segments free even -
whether this is a sensible setting though is highly questionable.
The default settings were picked to most closely approximate the behaviour so far.

It is recommended that you first get a feel for the changes in settings,
try to generate such free segments as mentioned above ..
just keep shooting and pressing LCTRL.
Once you've got a feel for that you can
start fiddeling together something you think would behave in some fashion,
start a BOT DEATHMATCH and set "/idlebots 1" .. have a go at shooting the bots
from different angles and distances.

HTH

These are the latest values "to try out":
--------------
shotgun_tryout = [
    SGDMGTOTAL 88
    SGCCdmg 500
    SGCMdmg 325
    SGCOdmg 175
    SGDMGDISTB 50
    SGDMGBONUS 62
    SGCCbase 0
    SGCCrange 45
    SGCMbase 25
    SGCMrange 60
    SGCObase 50
    SGCOrange 75
]
--------------