@@ -1,4 +1,7 @@ 
-AI = {};
+// AI.js & uStrat (c) Derek Stevens <drkste@zoho.com>
+// this file contains AI logic (duh!)
+
+window.AI = {};
 AI.animCounter = 0;
 AI.fCounter = 0;
 AI.Q = {}

@@ -1,3 +1,7 @@ 
+// Attack.js & uStrat (c) Derek Stevens <drkste@zoho.com>
+// this file contains Attack procedures and some AI code related to them
+
+
 window.attack = {};
 attack.pattern = {};
 attack.rotations = [ 0 ];
@@ -27,21 +31,45 @@ {
 	  AI.focus = 0;
 	  endPhase();
 	}
-	gameState.flow = "cpuAttackReady";
 	attack.src = teams.cpu.units[AI.focus];
 	attack.pattern = attack.src.equipment.pattern;
 	if (attack.src.mode != "defend")
 	{
-  	mapCursor.x = attack.src.target.x;
-	  mapCursor.y = attack.src.target.y;
+		if (dist(attack.src.target, attack.src) <= attack.src.equipment.range)
+		{
+    	mapCursor.x = attack.src.target.x;
+	    mapCursor.y = attack.src.target.y;
+	  }
+	 	else
+	 	{
+	 		AI.focus++;
+	 		return;
+	 	}
 	}
 	else
 	{
 	  // search for closest enemy unit in range, target it
 	  // if nothing in range, do nothing
-	  AI.focus++;
-	  gameState.flow = "cpuAttackReady"
+	  var i, min, working;
+	  min = 99999;
+	  working = 0;
+	  for (i = 0; i < teams.p1.units.length; i++)
+	  {
+	  	working = dist(attack.src, teams.p1.units[i]);
+	  	if (working <= min && dist(teams.p1.units[i], attack.src) <= attack.src.range)
+	  	{
+	  		min = working;
+	  		mapCursor.x = taems.p1.units[i].x;
+	  		mapCursor.y = teams.p1.units[i].y;
+	  	}
+	  }
+	  if (min == 99999)
+		{
+  	  AI.focus++;
+	    return;
+	  }
 	}
+	gameState.flow = "cpuAttackReady";
 }
 
 attack.cancel = function()

@@ -1,3 +1,9 @@ 
+// Engine.js & uStrat (c) Derek Stevens <drkste@zoho.com>
+// this file contains high level engine code and utility functions;
+// aside from utility functions and the state machine known as loop(),
+// we mostly have wrapper functions that call more complex
+// functions from other files
+
 window.gameState = {};
 window.controller = {};
 window.gameOverWindow = new Image();

@@ -1,3 +1,6 @@ 
+// Equipment.js & uStrat (c) Derek Stevens <drkste@zoho.com>
+// this file contains all functions directly related to equipment
+
 function equipment()
 {
   this.pattern = new Array(5);

@@ -1,3 +1,6 @@ 
+// Keyboard.js & uStrat (c) Derek Stevens <drkste@zoho.com>
+// this file contains keybinds!
+
 document.addEventListener("keydown", pressHandler, false);
 document.addEventListener("keyup", releaseHandler, false);
 

@@ -1,3 +1,6 @@ 
+// Map.js & uStrat (c) Derek Stevens <drkste@zoho.com>
+// this file contains map, camera, and HUD data and functions
+
 window.map = {};
 map.sz = 64;
 map.gfx = {};

@@ -1,3 +1,7 @@ 
+// Menu.js & uStrat (c) Derek Stevens <drkste@zoho.com>
+// this file contains the menu system and definitions for
+// individual menus
+
 window.menuSys = {};
 menuSys.cursor = 0;
 menuSys.menu = {};

@@ -1,3 +1,6 @@ 
+// MiniMap.js & uStrat (c) Derek Stevens <drkste@zoho.com>
+// this file contains the mini-map data, listening, and drawing procedure
+
 window.minimap = {};
 minimap.gfx = {};
 minimap.gfx.bg = new Image();

@@ -1,3 +1,8 @@ 
+// Movement.js & uStrat (c) Derek Stevens <drkste@zoho.com>
+// this file contains data and functions related to Unit
+// movement including player plotting of paths and movement
+// animation
+
 window.movement = {};
 movement.chain = new Array();
 movement.unit = {};

@@ -0,0 +1,42 @@ 
+# uStrat
+
+uStrat is a strategy game developed primarily for mobile phones. It is inspired by games like uCity, Fire Emblem, and Super Robot Wars. uStrat is written in Javascript using HTML5 Canvas and a whole lotta elbow grease.
+
+## Gameplay
+
+The map is randomly generated at the beginning of the game. P1 and CPU headquarters are spawned in opposite quadrants of the map. The goal is to build your headquarters up with power generation, factories, and armories (Structures), and build an army of mecha soldiers (Units) equipped to defend the Cities and destroy the enemy's HQ. The CPU team will be doing the same, but aiming to destroy the Cities.
+
+Resource management is centered around Energy. Each power generation Structure adds a certain amount of Energy to your team's pool, up to a maximum defined by the sum of the power generation Structures. Building Units, Structures, and Equipment costs energy.
+
+Each Unit has its own strengths and weaknesses; Same goes for the equipment. You can mix and match units and equipment to come up with an arsenal that best matches your strategy.
+
+The game ends when too many cities are destroyed or either HQ is destroyed.
+
+## Controls
+
+uStrat can be controlled by keyboard (desktop/laptop) or touch (mobile). The game will automatically detect a mobile platform and render the touch controls when necessary. The controls are as follows:
+
+### touch
+
+* `d-Pad (left cross)`: movement
+* `pause (center button)`: show/hide mini-map
+* `face buttons (right cross)`:
+  * `Y (right button)`: select tile/menu option
+  * `X (bottom button)`: cancel selection or operation
+  * `Z (top button)`: reset movement path; change cycle class; rotate attack pattern
+  * `W (left button)`: cycle through current cycle class; rotate attack pattern
+
+### keyboard
+
+* `arrow keys`: movement
+* `spacebar`: show/hide mini-map
+* `x`: select tile/menu option
+* `z`: cancel selection or operation
+* `s`: reset movement path; change cycle class; rotate attack pattern
+* `a`: cycle through current cycle class; rotate attack pattern
+
+## Development
+
+* currently finishing the AI and polishing up some UI
+* there is a lot of improvement to be made on the AI's basic pathfinding. more will be done with this later after the game is more or less playable
+* probably a million and one bugs. please do report them and/or contribute fixes!

@@ -1,3 +1,8 @@ 
+// Struct.js & uStrat (c) Derek Stevens <drkste@zoho.com>
+// this file contains everything related to structures,
+// including constructors, factories, and methods on structures
+// (ie damage and destruction)
+
 structure = function()
 {
   this.x = 0;

@@ -1,3 +1,7 @@ 
+// Team.js & uStrat (c) Derek Stevens <drkste@zoho.com>
+// this file contains data structures and basic functions
+// relating to the Teams (ie P1 and CPU)
+
 function defTeams()
 {
   this.p1 = {};

@@ -1,3 +1,6 @@ 
+// Touch.js & uStrat (c) Derek Stevens <drkste@zoho.com>
+// this file contains the touch controls!
+
 
 function doNothing(e)
 {

@@ -1,3 +1,8 @@ 
+// Unit.js & uStrat (c) Derek Stevens <drkste@zoho.com>
+// this file contains everything related to units,
+// including constructors, factories, and methods on units
+// (ie damage and destruction)
+
 function Unit()
 {
   this.sprite = {};