BWMod Basic Pack v 1.5 BETA
===========================

	!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
	! The BW-Mod is not responsible for any damage !
	!    this addon may cause to your computer.    !
	!                                              !
	!         Copyright 2005 by BWMod              !
	!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

CONTENT
-------
1. Addon Description
2. Addon Content
3. Version History
4. Installation
4. Compatibily Reference
5. Mission Editing
   - Gamelogic
   - Commands
   - Scripts
     - Officer Customize Script
     - Tactical Sign Script
     - Wing Badge Script
   - Callsigns
   - Classnames
   - Reserved Variables
6. Responsible Persons
7. Credits
8. Contact

1. ADDON DESCRIPTION
--------------------
The Basic Pack contains a set of German infantry weapons and soldiers.
Additionally it contains configurations and scripts for vehicles
and their weapons, and thus is required by all BWMod addons.

Consider this release as beta!
Future versions will include updated soldier models and textures
as well as revised and new weapons.

2. ADDON CONTENT
----------------
The addon contains a very early version of our new soldier models
and some new weapon models, like the G22 sniper rifle, the P8 pistol, the
Panzerfaust 3 anti-tank weapon and the MG3.

Additionaly some markers have been implented provisionally.

See detailed information on the content in the Mission Editing
reference given in this file.

3. VERSION HISTORY
------------------
v 1.2
  - initial BWMod release

v 1.21
  - added: compability reference in this readme file
  - added: reserved variables information
  - fixed: wrong classnames in readme
  - fixed: GMG reload time (was too long)
  - fixed: "HOT AT" changed to "HOT 2"
  - fixed: BMK 20mm AP damage was too low, HE damage was too high
  - fixed: medic armlet on sniper
  - fixed: script issue that prohibitted camouflage script
	   multiplayer compability

v 1.3
  - added: additional LODs for:
	- P8
	- G22
	- Panzerfaust 3
	- Fliegerfaust 2
	- Milan Rocket
	- HOT Rocket
  - added: new MG3 model
  - added: new mission editor commands
  - added: new callsigns for groups and HQ
  - added: user definable callsigns for groups and HQ
  - added: soldier with backpack
  - added: vehicle smoke launcher script
  - changed: BMK 20mm damage
  - fixed: correct models for dropped magazines (MG3, G22, P8)
  - fixed: helmets appearing above vehicles when inside
  - fixed: KSK Operators can heal now

v 1.35
  - added: Feldjäger
  - added: more emblems and beret colors
  - added: TOW model
  - added: TOW-2 and model
  - added: new MG3 sound (thx to treffer)
  - fixed: removed p8 magazines from medic
  - fixed: Milan & HOT locking issue when playing with FDFMod
  - fixed: HOT Name
  - fixed: Hunting Rifle not working with Basic Pack
  - fixed: Mirrored emblem on beret
  - fixed: no shadow on P8
  - fixed: PzFst3 position wrong (thx Marco-Polo)
  - fixed: G22 sound
  - changed: new textures for infantry by Snorri

v 1.5
  - added: infantry in desert camo
  - changed: gamelogic scripts

4. INSTALLATION
---------------
Extract the .pbo files from the Archive into your
Operation Flashpoint: Resistance (TM) Addons folder or a mod folder
of your choice.

Make sure to have the latest version of Operation Flashpoint: Resistance
installed (currently 1.96)!

5. COMPATIBILTY REFERENCE
-------------------------
If you are using the Basic Pack v 1.5 with the BWMod V1.3 Demo, please
delete the following PBOs:

BWMOD_Soldaten.pbo
BWMOD_MG3.pbo
BWMOD_P8.pbo
BWMOD_PzFst3.pbo

If you are using the Basic Pack v 1.5 with the Basic Pack v1.0, please
delete the following PBOs:

BWMOD_Soldaten.pbo
BWMOD_G36.pbo
BWMOD_P8.pbo

If you are using the Basic Pack v1.5 with the Basic Pack v 1.21 or older,
simply overwrite the older version.

Other weapon PBOs from older releases (eg. BWMOD_G3A3.pbo) can stay
in your addon folder and can be used with the Basic Pack v 1.5.

6. MISSION EDITING
------------------

 GAMELOGIC
 ---------
 The Basic Pack contains a Gamelogic (Gamelogic/BWMod/BWMod Server).
 This Gamelogic is required both in single and multi player and an
 error message will be given (a hint window will pop up) when the
 Gamelogic has not been placed on the map.

 The Gamelogic initializes multi player scripts if required,
 defines variables, etc.

 It will name itself "BWMod_Server", so you can use it for your own
 scripts.

 COMMANDS
 --------
 There are a few commands provided with this Basic Pack:

 BWMod_NoDust
  -> if set to true, chopper dust effects will be disabled.

 BWMod_NoEffects
  -> if set to true, both fire and chopper dust effects will be disabled.

 BWMod_NoFire
  -> if set to true, fire effects will be disabled.

 BWMod_NoScripts
  -> if set to true, all scripts will be disabled.

 BWMOD_NoSmoke
  -> if set to true, smoke launcher on vehicles will be disabled.

 BWMOD_NoSuspension
  -> if set to true, suspension scripts will be disabled.

 BWMOD_NoGunRec
  -> if set to true, gun recoil will be disabled.

 Best place this commands in the init.sqs file of the mission (must be
 created in the mission directory) or in a trigger to prohibit multiplayer
 compability issues.

 SCRIPTS
 -------

  OFFICER CUSTOMIZATION SCRIPT
  With this script one can customize the colour of and the 
  emblem on the officer's beret.
  Put the following line in a script or the init-line of
  the officer:

  	[UnitName,x,y] exec "\BWMOD_Scripts\inf\customize.sqs"

 	 x: Color of beret
		0 = Green
		1 = Black
		2 = Blue
		3 = Red
		4 = Dark Blue
		5 = Light Red

 	 y: Type of emblem
		0 = Panzergrenadiertruppe (Mechanized/Armoured Infantry) 
		1 = Fallschirmjägertruppe (Airborne/Paratrooper) 
		2 = Sanitätsdienst (Medical) 
		3 = Artillerietruppe (Artillery) 
		4 = Pioniertruppe (Combat Engineers) 
		5 = Jägertruppe (Light Infantry) 
		6 = Feldjägertruppe (Military Police) 
		7 = Fernmeldetruppe (Signals/Communications) 
		8 = Fernspähtruppe (Special Operations Reconnaissance) 
		9 = Kommando Spezialkräfte (Special Operations) 
		10 = Heeresfliegertruppe (Army Aviation) 
		11 = Flugabwehrtruppe (Air Defence) 
		12 = Instandsetzungstruppe (Repairs) 
		13 = Panzeraufklärungstruppe (Reconnaissance) 
		14 = Panzertruppe (Armored) 
		15 = Nachschubtruppe (Logistics) 
		16 = Truppe für Operative Information (Psychological Operations) 
		17 = Marinesicherungsdienst (Übersetzung noch unklar) 
		18 = DF-Brigade (Franco-German Brigade) 
		19 = ABC-Abwehrtruppe (NBC Reconnaissance) 

  Standard: Panzergrenadier-Officer (Green beret, PzGren emblem)
  Updated version may include customization of rank.

  TACTICAL SIGNS SCRIPT
  By using this script you can customize the type of
  tactical signs on our vehicles.

  Put the following line in a script or the init-line of
  the vehicle:

	[UnitName,x,y,z] exec "\BWMOD_Scripts\veh\tact.sqs"

 	 x : Number of own unit
 	 y : Type of troop (refer to Troop Type List)
 	 z : Number of next higher unit

   TROOP TYPE LIST
	 0: No Symbol
	 1: Panzertruppe
	 2: Panzerartillerie
	 3: Panzeraufklaerer
	 4: Panzergrenadiere
	 5: Panzerpioniere
	 6: Panzerjaeger
	 7: Panzerjaeger (Rakete)
	 8: Jaeger
	 9: Gebirgsjaeger
	10: Fallschirmjaeger
	11: Aufklaerer
	12: Fernspaeher
	13: Fernmeldetruppe
	14: EloKa
	15: ABC Abwehr
	16: Artillerie
	17: Feldjaeger
	18: Heeresflugabwehr
	19: Heeresflieger
	20: Instandsetzung
	21: Pioniere
	22: Sanitaeter
	23: KSK
	
  VEHICLE SMOKE LAUNCHER SCRIPT
  The Basic Pack includes a smoke launcher script for vehicles
  which launches the smoke grenades according to the direction
  of the vehicles turret.
  
  Due to mulitplayer compatiblity issues, we had to disable
  the use of the smoke launcher by the vehicles commander.

 CALLSIGNS
 ---------
  In this version of the Basic Pack, additional callsigns
  for groups and HQs have been implented.

  To use these, use the following command lines:

  GROUP CALLSIGN
  To set a new group callsign use the command setGroupID 
  on the group leader.

  Example (init line):
  this setGroupID ["BWMod_CS_Wolf","GroupColor0"]

   The group callsign will then be "Wolf".

  HQ CALLSIGN
  To use a HQ callsign, use the following code:

  [west,"BWMod_HQ_Kommandozentrale"] sideChat "Alpha, this is HQ. Come in. Over."

   The sender of the group will then be "Kommandozentrale", in game 
   the following line would apear on the player's screen:

   Kommandozentrale: "Alpha, this is HQ. Come in. Over."

  CUSTOM CALLSIGNS FOR GROUPS AND HQs:

  By defining the values STR_BWMod_CS_Custom01 or STR_BWMod_CS_Custom02 in
  the stringtable.csv, the mission editor is capable of defining custom
  callsigns for up to two groups. Simply create the stringtable.csv, define
  the string with your custom callsign and set the group's ID to
  BWMod_CS_Custom01 or BWMod_CS_Custom02.

  Same goes for the HQ callsigns.
  Define the strings STR_BWMod_HQ_Custom01 or STR_BWMod_HQ_Custom02 
  you can create unique HQ names for the mission(s). 
  Use

  [west,"BWMod_HQ_Custom01"] or [west,"BWMod_HQ_Custom02"] as sender.

  LIST OF CALLSIGNS
  
   GROUP CALLSIGNS
	BWMod_CS_Custom01
	BWMod_CS_Custom02

	BWMod_CS_Adler
	BWMod_CS_Baer
	BWMod_CS_Biber
	BWMod_CS_Bussard
	BWMod_CS_Dachs
	BWMod_CS_Dingo
	BWMod_CS_Drache
	BWMod_CS_Elefant
	BWMod_CS_Falke
	BWMod_CS_Fuchs
	BWMod_CS_Gepard
	BWMod_CS_Keiler
	BWMod_CS_Leopard
	BWMod_CS_Luchs
	BWMod_CS_Tiger
	BWMod_CS_Wolf

	BWMod_CS_Thor
	BWMod_CS_Odin
	BWMod_CS_Zeus

	BWMod_CS_Faust
	BWMod_CS_Hammer
	BWMod_CS_Speer
	BWMod_CS_Schild
	BWMod_CS_Schwert

   HQ CALLSIGNS
	BWMod_HQ_Custom01
	BWMod_HQ_Custom02

	BWMod_HQ_Gefechtsstand
	BWMod_HQ_Hauptquartier
	BWMod_HQ_Kommandozentrale
	BWMod_HQ_Vorposten      

 CLASSNAMES
 ----------
 
  UNITS

  BWMOD_Officer
  BWMOD_Soldier
  BWMOD_Medic
  BWMOD_Medic_female
  BWMOD_MG3Gunner
  BWMOD_ATSoldier
  BWMOD_AASoldier
  BWMOD_AAAssistant
  BWMOD_ATAssistant
  BWMOD_MG3Assistant
  BWMOD_Engineer
  BWMOD_SniperG22
  BWMOD_KSKOperator

  BWMOD_CrewT
  BWMOD_HeloPilot

  WEAPONS		MAGAZINE
  
  BWMOD_P8		BWMOD_P8Mag

  BWMOD_MG3		BWMOD_MG3Mag
  BWMOD_G22		BWMOD_G22Mag
  BWMOD_PzFst3		BWMOD_PzFst3_R
  BWMOD_FLF2		BWMOD_FLF2_R

 RESERVED VARIABLES
 ------------------

 The Basic Pack uses numerous variables which should not be
 changed by the mission designer.

  BWMOD_MPGame
   -> true, if more than one player is connected to the server.

  BWMOD_initiated
   -> true, if all necessary scripts have been executed.

 However, you can query these variables if required for scripts, etc.

7. RESPONSIBLE PERSONS
----------------------

 GalComT: MG3
 Helifreak: soldier models
 McCancey: Panzerfaust 3
 Schakal: soldier models, G22, P8
 TeRpEnTiN: configuration, LODs, readme, scripts
 Snorri: textures
 metalchris: sounds

8. CREDITS
----------
We want to thank the following people for their work:

 - DKM Mod (Tank Accel Script)
 - raedor (Fire Script)
 - BAS (Fire Script, Dust Script)

We do not provide support for these third party scripts.
If you have problems concerning them, please contact
their author(s).

9. CONTACT
----------

 URL:   http://ofp.info/_hosted/bwmod/
 Forum: http://games-force.de/phpBB2/


! Beta - no further support given !
Have fun.