SPAwards | phpVMS v7 awards for a variety achievements

• Upload spawards_config.php to modules/Awards/spawards_config.php
• Upload all other SPAwards files to modules/Awards/Awards
• Every Award does an entry in your laravel log for debugging
• Some awards, such as Discord or Ivao, require API credentials to be set in: modules/Awards/spawards_config.php
• If you update my awards just overwrite all files, but check the spawards_config.php for any changes

Below is a list of all available award modules included in SPAwards. Each award can be configured individually through the phpVMS admin panel with specific parameters (for example: distance, time, count, or thresholds).

1. Aircraft
   Rewards pilots who have completed a set number of flights using aircraft from the same family (for example, A320 or B737 series).

2. Airline
   Given to pilots who have flown a specific number of flights with one airline, showing loyalty to that carrier.

3. Cargo
   Awarded to pilots who have transported a significant amount of cargo over their career, showcasing their freight experience.

4. Consecutive
   Recognizes pilots who have filed flights on a series of consecutive days without interruption.

5. Discord
   Grants the award to pilots verified as active members of the VAs official Discord server.

6. Distance
   Awarded to pilots who have flown a total cumulative distance exceeding a defined number of nautical miles.

7. Explorer
   Given to pilots who have operated flights across multiple ICAO regions, proving their global flying experience.

8. Fleet
   Rewards pilots who have flown with a wide range of aircraft types in the VAs fleet.

9. Ivao
   Awarded to pilots with a minimum number of flight minutes logged on the IVAO network.

10. Vatsim
    Awarded to pilots with a minimum number of flight minutes logged on the VATSIM network.

11. Networkelite
    Given to pilots who are active on multiple online networks such as IVAO and VATSIM.

12. Landingrate
    Rewards pilots who achieve a landing rate within a defined precision range (for example, between -145 and -155 fpm).

13. Longhaul
    Awarded to pilots who have completed several long-haul flights exceeding a specific minimum distance.

14. Loyalty
    Recognizes pilots who primarily fly from or to the same base hub, demonstrating hub loyalty.

15. Membership
    Given to pilots who have reached a defined number of membership years since joining the VA.

16. Money
    Awarded to pilots who have earned a certain amount of virtual money through flight operations.

17. Nightowl
    Rewards pilots who have performed multiple night flights, landing between 22:00 and 06:00 UTC.

18. Passenger
    Awarded to pilots who have transported a high total number of passengers across all accepted flights.

19. Performer
    Recognizes pilots with a high number of accepted flights and consistent flight activity.

20. RouteCode
    Given to pilots who have completed a flight using a specific route code defined by the VA.

21. ShortHaul
    Awarded to pilots who have completed a set number of short-haul flights below a specified distance.

22. Streak
    Rewards pilots who have achieved a continuous streak of successful (accepted) flights without rejection.

23. Weekend
    Given to pilots who frequently fly during weekends, showing regular weekend activity.

24. Earlybird
    Awarded to pilots who fly multiple early morning flights between 04:00 and 08:00 UTC.

25. Fuelburner
    Rewards pilots who have performed at least one flight consuming more than a specified amount of fuel (for example, over 60,000 kg).

Debug examples:

• SPAwards(RouteCode) | Pilot (ID: 1) has flown PF, ABC needed.
• SPAwards(Distance) | Pilot (ID: 1) has 255 days, 31 days needed.
• SPAwards(VATSIM) | Pilot (ID: 1) has 17781.6 minutes on VATSIM, 120 needed.
• SPAwards(IVAO) | Pilot (ID: 1) has 875.1 minutes on IVAO, 120 needed.
• SPAwards(Money) | Pilot (ID: 1) has 189.69, 150 needed.
• SPAwards(Landingrate) | Pilot (ID: 1) has 0 fpm, between -155 to -145 fpm needed.
• SPAwards(Airline) | Pilot (ID: 1) has 4 flights with DVA, 3 needed.
• SPAwards(Distance) | Pilot (ID: 1) has flown 2583.74 nm, 2500 nm needed.
• SPAwards(Aircraft) | Pilot (ID: 1) has 2 flights with aircraft AT75, 2 needed.
• SPAwards(Streak) | Pilot (ID: 1) streak check: FAILED
• SPAwards(Shorthaul) | Pilot (ID: 1) has 1 short-haul flights < 250 nm, 10 required.
• SPAwards(Longhaul) | Pilot (ID: 1) has 0 flights > 4200 nm, 10 required.
• SPAwards(Consecutive) | Pilot (ID: 1) 2 active days, 5 required.
• SPAwards(Loyalty) | Pilot (ID: 1) has 3 flights from/to EFHK, 2 required.
• SPAwards(Explorer) | Pilot (ID: 1) has 3 flights in region EF, 2 required.
• SPAwards(Fleet) | Pilot (ID: 1) has flown 3 unique aircraft types, 2 required.
• SPAwards(Performer) | Pilot (ID: 1) average score: 89.0000, 80 required.
• SPAwards(Networkelite) | VATSIM: 17781.6 minutes for Pilot (ID: 1).
• SPAwards(Networkelite) | IVAO: 875.1 minutes for Pilot (ID: 1).
• SPAwards(Networkelite) | Pilot (ID: 1) total combined minutes: 18656.7, required: 3000.
• SPAwards(Nightler) | Pilot (ID: 1) has 0 night landings, 3 required.
• SPAwards(Cargo) | Pilot (ID: 1) carried 786 cargo units with DVA/AT75, 500000 required.
• SPAwards(Passenger) | Pilot (ID: 1) carried 110 pax with DVA/A319, 100 required.
• SPAwards(Weekend) | Pilot (ID: 1) has 0 weekend flights, 5 required.
• SPAwards(Discord) | Pilot (ID: 1) 000000000000000 verified successfully with required role 000000000000000.
• SPAwards(Earlybird) | Pilot (ID: 1) has 0 early flights, 5 required.
• SPAwards(Fuelburner) | Pilot (ID: 1) has no flights exceeding 50000 kg fuel used.

Note:

You can combine different award types to create progression levels, for example:

• ShortHaul I – 10 flights under 600 nm
• ShortHaul II – 25 flights under 600 nm
• ShortHaul III – 50 flights under 600 nm

Do you have any suggestions or need help?

Please use the GitHub issue tracker.

Release / Update Notes

01.NOVEMBER.25

• SPAwardsPerformer: Award gets now removed if the score drops.

16.OCTOBER.25

• Updated spawards_config and README
• Name for debugging in some awards fixed
• Added configuration options
• Added checks if the award is already granted

15.OCTOBER.25

• Initial Release