Add EFFECT_USERx functionality to Sabersense prop... (#837)

* Add EFFECT_USERx functionality...

...for specific blade style requirements.

* Typo fix.

* Edit to user guide notes.

* #endif comment added

Author: Sabersense-CC

props/saber_sabersense_buttons.h

@@ -323,6 +323,12 @@ COLOUR CHANGE FUNCTIONS WITH BLADE ON
   Applicable to two-button mode only, reverts to lockup
   being triggered by clash while holding aux.
 
+#define SABERSENSE_F263_CUSTOM_USER_EFFECT
+  Based on Fett263 'Special Abilities', this define
+  enables interaction with EFFECT_USERx in standard
+  (non-Fett) blade styles for custom effects like
+  swing colour changing.
+
 GESTURE CONTROLS
   There are four gesture types: Twist, Stab, Swing and Thrust.
   Gesture controls bypass all preon effects.
@@ -858,6 +864,41 @@ bool Event2(enum BUTTON button, EVENT event, uint32_t modifiers) override {
       return true;
 #endif
 
+    // Based on Fett263 'Special Abilities'.
+#ifdef SABERSENSE_F263_CUSTOM_USER_EFFECT
+#if NUM_BUTTONS >= 1
+    case EVENTID(BUTTON_NONE, EVENT_TWIST_RIGHT, MODE_ON | BUTTON_POWER):
+      SaberBase::DoEffect(EFFECT_USER5, 0);
+      return true;
+
+    case EVENTID(BUTTON_NONE, EVENT_TWIST_LEFT, MODE_ON | BUTTON_POWER):
+      SaberBase::DoEffect(EFFECT_USER6, 0);
+      return true;      
+
+    case EVENTID(BUTTON_NONE, EVENT_SWING, MODE_OFF | BUTTON_POWER):
+      SaberBase::DoEffect(EFFECT_USER7, 0);
+      return true;  
+#endif
+
+#if NUM_BUTTONS == 2
+    case EVENTID(BUTTON_NONE, EVENT_TWIST_RIGHT, MODE_ON | BUTTON_AUX):
+      SaberBase::DoEffect(EFFECT_USER3, 0);
+      return true;
+
+    case EVENTID(BUTTON_NONE, EVENT_TWIST_LEFT, MODE_ON | BUTTON_AUX):
+      SaberBase::DoEffect(EFFECT_USER4, 0);
+      return true;
+
+    case EVENTID(BUTTON_NONE, EVENT_SWING, MODE_ON | BUTTON_AUX):
+      SaberBase::DoEffect(EFFECT_USER1, 0);
+      return true;
+
+    case EVENTID(BUTTON_NONE, EVENT_SWING, MODE_OFF | BUTTON_AUX):
+      SaberBase::DoEffect(EFFECT_USER2, 0);
+      return true;
+#endif
+#endif  // SABERSENSE_F263_CUSTOM_USER_EFFECT
+
     // MAIN ACTIVATION
     // Saber ON AND Volume Adjust, 1 and 2 Button.
     case EVENTID(BUTTON_POWER, EVENT_FIRST_SAVED_CLICK_SHORT, MODE_OFF):