initial work on TriggerEffectMessage packet and tests

common/src/main/scala/net/psforever/packet/GamePacketOpcode.scala

@@ -415,7 +415,7 @@ object GamePacketOpcode extends Enumeration {
 
     // OPCODES 0x50-5f
     case 0x50 => game.TargetingInfoMessage.decode
-    case 0x51 => noDecoder(TriggerEffectMessage)
+    case 0x51 => game.TriggerEffectMessage.decode
     case 0x52 => game.WeaponDryFireMessage.decode
     case 0x53 => noDecoder(DroppodLaunchRequestMessage)
     case 0x54 => noDecoder(HackMessage)

common/src/main/scala/net/psforever/packet/game/TriggerEffectMessage.scala

@@ -0,0 +1,83 @@
+// Copyright (c) 2017 PSForever
+package net.psforever.packet.game
+
+import net.psforever.packet.{GamePacketOpcode, Marshallable, PacketHelpers, PlanetSideGamePacket}
+import net.psforever.types.Vector3
+import scodec.Codec
+import scodec.codecs._
+
+/**
+  * na
+  * @param unk1 na;
+  *             `true` to apply the effect usually
+  * @param unk2 na
+  */
+final case class TriggeredEffect(unk1 : Boolean,
+                                 unk2 : Long)
+
+/**
+  * Activate an effect that is not directly associated with an existing game object.
+  * Without a game object from which to inherit position and orientation, those explicit parameters must be provided.
+  * @param pos the position in the game world
+  * @param roll the amount of roll that affects orientation
+  * @param pitch the amount of pitch that affects orientation
+  * @param yaw the amount of yaw that affects orientation
+  */
+final case class TriggeredEffectLocation(pos : Vector3,
+                                         roll : Int,
+                                         pitch : Int,
+                                         yaw : Int)
+
+/**
+  * Dispatched by the server to cause a client to display a special graphical effect.<br>
+  * <br>
+  * The effect being triggered can be based around a specific game object or replayed freely, absent of an anchoring object.
+  * If object-based then the kinds of effects that can be activated are specific to the object.
+  * If unbound, then a wider range of effects can be displayed.
+  * Regardless, one category will rarely ever be activated under the same valid conditions of the other category.
+  * For example, the effect "on" will only work on objects that accept "on" normally, like a deployed `motionalarmsensor`.
+  * The effect "spawn_object_effect" can be applied anywhere in the environment;
+  * but, it can not be activated in conjunction with an existing object.
+  * @param obj an object that accepts the effect
+  * @param effect the name of the effect
+  * @param unk na;
+  *            when activating an effect on an existing object
+  * @param location an optional position where the effect will be displayed;
+  *                 when activating an effect independently
+  */
+final case class TriggerEffectMessage(obj : PlanetSideGUID,
+                                      effect : String,
+                                      unk : Option[TriggeredEffect] = None,
+                                      location : Option[TriggeredEffectLocation] = None
+                                     ) extends PlanetSideGamePacket {
+  type Packet = TriggerEffectMessage
+  def opcode = GamePacketOpcode.TriggerEffectMessage
+  def encode = TriggerEffectMessage.encode(this)
+}
+
+object TriggerEffectMessage extends Marshallable[TriggerEffectMessage] {
+  /**
+    * A `Codec` for `TriggeredEffect` data.
+    */
+  private val effect_codec : Codec[TriggeredEffect] = (
+    ("unk1" | bool) ::
+      ("unk2" | uint32L)
+  ).as[TriggeredEffect]
+
+  /**
+    * A `Codec` for `TriggeredEffectLocation` data.
+    */
+  private val effect_location_codec : Codec[TriggeredEffectLocation] = (
+    ("pos" | Vector3.codec_pos) ::
+      ("roll" | uint8L) ::
+      ("pitch" | uint8L) ::
+      ("yaw" | uint8L)
+  ).as[TriggeredEffectLocation]
+
+  implicit val codec : Codec[TriggerEffectMessage] = (
+    ("obj" | PlanetSideGUID.codec) >>:~ { obj =>
+      ("effect" | PacketHelpers.encodedString) ::
+      optional(bool, "unk" | effect_codec) ::
+      conditional(obj.guid == 0, "location" | effect_location_codec)
+    }).as[TriggerEffectMessage]
+}