meta patches and clicks entity offhand support

plugin/src/main/java/com/denizenscript/denizen/events/player/PlayerRightClicksEntityScriptEvent.java

@@ -4,6 +4,7 @@
 import com.denizenscript.denizen.utilities.implementation.BukkitScriptEntryData;
 import com.denizenscript.denizen.events.BukkitScriptEvent;
 import com.denizenscript.denizencore.objects.ObjectTag;
+import com.denizenscript.denizencore.objects.core.ElementTag;
 import com.denizenscript.denizencore.scripts.ScriptEntryData;
 import com.denizenscript.denizencore.utilities.Deprecations;
 import org.bukkit.event.EventHandler;
@@ -35,6 +36,7 @@ public class PlayerRightClicksEntityScriptEvent extends BukkitScriptEvent implem
     // @Context
     // <context.entity> returns the EntityTag the player is clicking on.
     // <context.item> returns the ItemTag the player is clicking with.
+    // <context.hand> returns "offhand" or "mainhand" to indicate which hand was used to fire the event. Some events fire twice - once for each hand.
     // <context.click_position> returns a LocationTag of the click position (as a world-less vector, relative to the entity's center). This is only available when clicking armor stands.
     //
     // @Player Always.
@@ -94,6 +96,9 @@ public ObjectTag getContext(String name) {
         else if (name.equals("item")) {
             return item;
         }
+        else if (name.equals("hand")) {
+            return new ElementTag(event.getHand() == EquipmentSlot.OFF_HAND ? "offhand" : "mainhand");
+        }
         else if (name.equals("location")) {
             Deprecations.playerRightClicksEntityContext.warn();
             return entity.getLocation();
@@ -118,11 +123,8 @@ public void playerRightClicksEntity(PlayerInteractEntityEvent event) {
     }
 
     public void playerRightClicksEntityHandler(PlayerInteractEntityEvent event) {
-        if (event.getHand() == EquipmentSlot.OFF_HAND) {
-            return;
-        }
         entity = new EntityTag(event.getRightClicked());
-        item = new ItemTag(event.getPlayer().getEquipment().getItemInMainHand());
+        item = new ItemTag(event.getPlayer().getEquipment().getItem(event.getHand()));
         this.event = event;
         fire(event);
     }

plugin/src/main/java/com/denizenscript/denizen/scripts/containers/core/EntityScriptContainer.java

@@ -56,7 +56,7 @@ public class EntityScriptContainer extends ScriptContainer {
     //   age: baby/adult/<#>
     // </code>
     //
-    // MORE OPTIONS ARE LISTED HERE: <@link url /denizen/mecs/entitytag.>
+    // MORE OPTIONS ARE LISTED HERE: <@link url https://meta.denizenscript.com/Docs/Mechanisms/entitytag.>
     //
     // -->
 

plugin/src/main/java/com/denizenscript/denizen/utilities/implementation/DenizenCoreImplementation.java

@@ -192,7 +192,7 @@ public boolean needsHandleArgPrefix(String prefix) {
     // - assign set script:MyScript npc:<entry[save].created_npc>
     //
     // Denizen tracks a "linked player" and a "linked NPC" in queues and the commands within.
-    // Many commands automatically operate on the linked player/NPC or by default or exclusively
+    // Many commands automatically operate on the linked player/NPC default or exclusively
     // (for example, "give" defaults to giving items to the linked player but that can be changed with the "to" argument,
     // "assignment" exclusively changes the assignment of the linked NPC, and that cannot be changed except by the global NPC argument).
     //