From aa42b74119c8a9fa8f5bbde02aac84126cf02c5f Mon Sep 17 00:00:00 2001
From: walterhiggins <walter.higgins@gmail.com>
Date: Wed, 30 Dec 2015 13:01:11 +0000
Subject: [PATCH] Added lightning module

---
 build.xml                          |   8 ++
 docs/API-Reference.md              | 122 ++++++++++++++++++++++++++---
 src/docs/js/generateEntitiesDoc.js |  40 ++++++++++
 src/main/js/modules/entities.js    |  26 +++++-
 src/main/js/modules/lightning.js   |  30 +++++++
 src/main/js/modules/spawn.js       |   4 +-
 src/main/js/plugins/entities.js    |   8 ++
 7 files changed, 224 insertions(+), 14 deletions(-)
 create mode 100644 src/docs/js/generateEntitiesDoc.js
 create mode 100644 src/main/js/modules/lightning.js
 create mode 100644 src/main/js/plugins/entities.js

diff --git a/build.xml b/build.xml
index 2b70ee8..8b1d185 100644
--- a/build.xml
+++ b/build.xml
@@ -89,16 +89,24 @@
 	     err="${dist}/gen-api-error.log">
       <arg value="${dist}/js"/>      
     </jscript>
+
     <jscript src="src/docs/js/generateItemsDoc.js" 
 	     out="${dist}/items.md" 
 	     err="${dist}/gen-items-error.log" />
+
+    <jscript src="src/docs/js/generateEntitiesDoc.js" 
+	     out="${dist}/entities.md" 
+	     err="${dist}/gen-entities-error.log" />
+
     <concat destfile="${dist}/apiref-con.md">
       <fileset file="${dist}/apiref.md" />
       <fileset file="${dist}/items.md" />
+      <fileset file="${dist}/entities.md" />
     </concat>
 
   </target>
 
+
   <target name="gen-events-helper-canary" depends="compile-docs,init">
     <mkdir dir="${dist}/js/lib"/>
     <jscript src="src/docs/js/generateEventsHelper.js" 
diff --git a/docs/API-Reference.md b/docs/API-Reference.md
index b42ec17..f8b014f 100644
--- a/docs/API-Reference.md
+++ b/docs/API-Reference.md
@@ -407,12 +407,14 @@ Walter Higgins
    * [jsp classroom command](#jsp-classroom-command)
    * [classroom.allowScripting() function](#classroomallowscripting-function)
  * [Asynchronous Input Module](#asynchronous-input-module)
+ * [Lightning module](#lightning-module)
+   * [Usage](#usage-3)
  * [The recipes module](#the-recipes-module)
    * [Example](#example-1)
  * [Http Module](#http-module)
    * [http.request() function](#httprequest-function)
  * [sc-mqtt module](#sc-mqtt-module)
-   * [Usage](#usage-3)
+   * [Usage](#usage-4)
  * [Signs Module](#signs-module)
    * [signs.menu() function](#signsmenu-function)
    * [signs.getTargetedBy() function](#signsgettargetedby-function)
@@ -448,22 +450,22 @@ Walter Higgins
    * [watcher.unwatchFile() function](#watcherunwatchfile-function)
    * [watcher.unwatchDir() function](#watcherunwatchdir-function)
  * [Example Plugin #1 - A simple extension to Minecraft.](#example-plugin-1---a-simple-extension-to-minecraft)
-   * [Usage:](#usage-4)
- * [Example Plugin #2 - Making extensions available for all players.](#example-plugin-2---making-extensions-available-for-all-players)
    * [Usage:](#usage-5)
- * [Example Plugin #3 - Limiting use of commands to operators only.](#example-plugin-3---limiting-use-of-commands-to-operators-only)
+ * [Example Plugin #2 - Making extensions available for all players.](#example-plugin-2---making-extensions-available-for-all-players)
    * [Usage:](#usage-6)
- * [Example Plugin #4 - Using parameters in commands.](#example-plugin-4---using-parameters-in-commands)
+ * [Example Plugin #3 - Limiting use of commands to operators only.](#example-plugin-3---limiting-use-of-commands-to-operators-only)
    * [Usage:](#usage-7)
- * [Example Plugin #5 - Re-use - Using your own and others modules.](#example-plugin-5---re-use---using-your-own-and-others-modules)
+ * [Example Plugin #4 - Using parameters in commands.](#example-plugin-4---using-parameters-in-commands)
    * [Usage:](#usage-8)
- * [Example Plugin #6 - Re-use - Using 'utils' to get Player objects.](#example-plugin-6---re-use---using-utils-to-get-player-objects)
+ * [Example Plugin #5 - Re-use - Using your own and others modules.](#example-plugin-5---re-use---using-your-own-and-others-modules)
    * [Usage:](#usage-9)
+ * [Example Plugin #6 - Re-use - Using 'utils' to get Player objects.](#example-plugin-6---re-use---using-utils-to-get-player-objects)
+   * [Usage:](#usage-10)
  * [Example Plugin #7 - Listening for events, Greet players when they join the game.](#example-plugin-7---listening-for-events-greet-players-when-they-join-the-game)
  * [Arrows Plugin](#arrows-plugin)
-   * [Usage:](#usage-10)
+   * [Usage:](#usage-11)
  * [Spawn Plugin](#spawn-plugin)
-   * [Usage](#usage-11)
+   * [Usage](#usage-12)
  * [alias Plugin](#alias-plugin)
    * [Examples](#examples-2)
  * [Commando Plugin](#commando-plugin)
@@ -483,7 +485,9 @@ Walter Higgins
    * [Rules](#rules)
    * [Gameplay Mechanics](#gameplay-mechanics)
  * [Items module](#items-module)
-   * [Usage](#usage-12)
+   * [Usage](#usage-13)
+ * [Entities module](#entities-module)
+   * [Usage](#usage-14)
 
 ## Modules in Scriptcraft
 
@@ -4854,6 +4858,23 @@ The callback function as well as being bound to an object with the above propert
 
 The `value` parameter will be the same as `this.value`, the `repeat` parameter will be the same as `this.repeat` and so on.
 
+## Lightning module
+
+Causes a bolt of lightning to strike.
+
+### Usage
+```javascript
+// strike lightning wherever a player's arrow lands
+var lightning = require('lightning');
+events.projectileHit( function( event ){
+  if ( entities.arrow( event.projectile ) // it's an arrow
+       && entities.player( event.projectile.owner ) // it was shot by a player
+     ) {
+    lightning( event.projectile ); // strike lightning at the arrow location
+  }
+});
+```
+
 ## The recipes module
 
 The Recipes module provides convenience functions for adding and removing recipes
@@ -6695,3 +6716,84 @@ The following functions are provided:
  * zombieHead()
 
 ***/
+/*********************
+## Entities module
+The Entities module provides a suite of functions - one for each possible entity type.
+
+### Usage
+
+    entities.zombie(); // returns a canaryMod/Bukkit EntityType.ZOMBIE enum value
+    entities.zombie( mob ); // compares the entity's type to a zombie, returns true if mob type is zombie, false otherwise
+    entities.player( self ); // at the in-game prompt this should return true (compares self to a player entity type)
+    entities.rabbit( self ); // at the in-game prompt this should return false (compares self to a rabbit entity type)
+
+The following functions are provided:
+
+ * aRMOR_STAND()
+ * aRROW()
+ * bAT()
+ * bLAZE()
+ * bOAT()
+ * cAVE_SPIDER()
+ * cHICKEN()
+ * cOMPLEX_PART()
+ * cOW()
+ * cREEPER()
+ * dROPPED_ITEM()
+ * eGG()
+ * eNDERMAN()
+ * eNDERMITE()
+ * eNDER_CRYSTAL()
+ * eNDER_DRAGON()
+ * eNDER_PEARL()
+ * eNDER_SIGNAL()
+ * eXPERIENCE_ORB()
+ * fALLING_BLOCK()
+ * fIREBALL()
+ * fIREWORK()
+ * fISHING_HOOK()
+ * gHAST()
+ * gIANT()
+ * gUARDIAN()
+ * hORSE()
+ * iRON_GOLEM()
+ * iTEM_FRAME()
+ * lEASH_HITCH()
+ * lIGHTNING()
+ * mAGMA_CUBE()
+ * mINECART()
+ * mINECART_CHEST()
+ * mINECART_COMMAND()
+ * mINECART_FURNACE()
+ * mINECART_HOPPER()
+ * mINECART_MOB_SPAWNER()
+ * mINECART_TNT()
+ * mUSHROOM_COW()
+ * oCELOT()
+ * pAINTING()
+ * pIG()
+ * pIG_ZOMBIE()
+ * pLAYER()
+ * pRIMED_TNT()
+ * rABBIT()
+ * sHEEP()
+ * sILVERFISH()
+ * sKELETON()
+ * sLIME()
+ * sMALL_FIREBALL()
+ * sNOWBALL()
+ * sNOWMAN()
+ * sPIDER()
+ * sPLASH_POTION()
+ * sQUID()
+ * tHROWN_EXP_BOTTLE()
+ * uNKNOWN()
+ * vILLAGER()
+ * wEATHER()
+ * wITCH()
+ * wITHER()
+ * wITHER_SKULL()
+ * wOLF()
+ * zOMBIE()
+
+***/
diff --git a/src/docs/js/generateEntitiesDoc.js b/src/docs/js/generateEntitiesDoc.js
new file mode 100644
index 0000000..3f9142b
--- /dev/null
+++ b/src/docs/js/generateEntitiesDoc.js
@@ -0,0 +1,40 @@
+args = Array.prototype.slice.call(args,1);
+// [0] = type, [1] = lib.jar [2] = blockX, [3] = classX
+var out = java.lang.System.out,
+  err = java.lang.System.err,
+  entry = null;
+var content = [
+  '/*********************',
+  '## Entities module',
+  'The Entities module provides a suite of functions - one for each possible entity type.',
+  '',
+  '### Usage',
+  '',
+  '    entities.zombie(); // returns a canaryMod/Bukkit EntityType.ZOMBIE enum value',
+  '    entities.zombie( mob ); // compares the entity\'s type to a zombie, returns true if mob type is zombie, false otherwise',
+  '    entities.player( self ); // at the in-game prompt this should return true (compares self to a player entity type)',
+  '    entities.rabbit( self ); // at the in-game prompt this should return false (compares self to a rabbit entity type)',
+  '',
+  'The following functions are provided:',
+  ''
+];
+
+var enumVals = [], t, i, name;
+var entitytypes = org.bukkit.entity.EntityType.values();
+for (t in entitytypes) {
+  if (entitytypes[t] && entitytypes[t].ordinal) {
+    name = entitytypes[t].name();
+    name = ('' + name).replace(/^(.)/,function(a){ return a.toLowerCase(); });
+    enumVals.push(' * ' + name + '()');
+  }
+}
+enumVals.sort();
+content = content.concat(enumVals);
+content.push('');
+content.push('***/');
+for (i = 0; i< content.length; i++){
+  out.println(content[i]);
+}
+
+
+  
diff --git a/src/main/js/modules/entities.js b/src/main/js/modules/entities.js
index 5bd3d8d..0b74a64 100644
--- a/src/main/js/modules/entities.js
+++ b/src/main/js/modules/entities.js
@@ -1,5 +1,5 @@
-/*global __plugin, org, Packages, module, exports*/
 'use strict';
+/*global __plugin, org, Packages, module, exports*/
 var entities = {},
   entitytypes,
   t, i, name;
@@ -9,10 +9,30 @@ if (__plugin.bukkit) {
 if (__plugin.canary) {
   entitytypes = Packages.net.canarymod.api.entity.EntityType.values();
 }
+function getEntityHandler( entityType ) {
+  return function( entity ){
+    if (arguments.length == 0){
+      return entityType;
+    }
+    if (arguments.length == 1){
+      if (entity){
+	if (__plugin.bukkit){
+	  return entity.type == entityType;
+	}
+	if (__plugin.canary){
+	  return entity.entityType == entityType;
+	}
+      }
+    }
+    return null;
+  };
+}
 for (t in entitytypes) {
   if (entitytypes[t] && entitytypes[t].ordinal) {
-    name = entitytypes[t].name();
-    entities[name] = entitytypes[t];
+    name = ('' + entitytypes[t].name()).replace(/^(.*)/,function(a){
+      return a.toLowerCase();
+    });
+    entities[name] = getEntityHandler(entitytypes[t]);
   }
 }
 module.exports = entities;
diff --git a/src/main/js/modules/lightning.js b/src/main/js/modules/lightning.js
new file mode 100644
index 0000000..b1e8a41
--- /dev/null
+++ b/src/main/js/modules/lightning.js
@@ -0,0 +1,30 @@
+'use strict';
+/************************************************************************
+## Lightning module
+
+Causes a bolt of lightning to strike.
+
+### Usage
+```javascript
+// strike lightning wherever a player's arrow lands
+var lightning = require('lightning');
+events.projectileHit( function( event ){
+  if ( entities.arrow( event.projectile ) // it's an arrow
+       && entities.player( event.projectile.owner ) // it was shot by a player
+     ) {
+    lightning( event.projectile ); // strike lightning at the arrow location
+  }
+});
+```
+
+***/
+module.exports = function lightning( something ) {
+  if (__plugin.canary && something.location){
+    return something.location.world.makeLightningBolt(something.location);
+  }
+  if (__plugin.bukkit && something.location){
+    return something.location.world.strikeLightning(something.location);
+  }
+  console.log('Need an object with a location property for lightning strike');
+  return null;
+};
diff --git a/src/main/js/modules/spawn.js b/src/main/js/modules/spawn.js
index f8dbb4d..7d33b04 100644
--- a/src/main/js/modules/spawn.js
+++ b/src/main/js/modules/spawn.js
@@ -3,8 +3,10 @@
 var entities = require('entities');
 
 module.exports = function(entityType, location){
+  var entityTypeFn;
   if (typeof entityType === 'string'){
-    entityType = entities[entityType];
+    entityTypeFn = entities[entityType.toLowerCase()];
+    entityType = entityTypeFn();
   }
   var world = location.world;
   if (__plugin.bukkit){
diff --git a/src/main/js/plugins/entities.js b/src/main/js/plugins/entities.js
new file mode 100644
index 0000000..3923067
--- /dev/null
+++ b/src/main/js/plugins/entities.js
@@ -0,0 +1,8 @@
+'use strict';
+/*global reuire, exports*/
+/* 
+ make entities a global variable for use at in-game prompt 
+ Tab completion is a useful way to discover what entity types are available.
+*/
+var entities = require('entities');
+exports.entities = entities;