API changes to BZFS

Make suggestions for improving one of the best games on the net!
Post Reply
User avatar
Zehra
Private First Class
Private First Class
Posts: 914
Joined: Sun Oct 18, 2015 3:36 pm
Location: Within the BZFS API and Beyond it
Contact:

API changes to BZFS

Post by Zehra »

Currently the API provides quite a bunch of notification and modification events.
While normally this is not a cause of concern, it does pose quite an issue when dealing with multiple plug-ins, especially if data is modified.

I'll provide the three most common events in this example:
The death event, the flag transferred event, and the shot fired event.

The death event provides a modification and a notification event upon a player death.
However the lack of a final state made it quite tricky to track the last death and it could easily be incorrect if another plug-in modified the event at a later time.
The introduction of the death finalized event did resolve this issue quite nicely.

For the secondary event, the flag transferred event will be used.
It is both a notification and modification event.
Simply using the thiefControl plug-in and if another plug-in uses the event as a notification upon steal, it can easily cause the plug-in to improperly function.
This causes it to be somewhat difficult to be able to properly track flags.
(Self-written solutions are generally required to work-around said issue or merging plug-ins.)

For the third event, shot fired event.
If a shot is fired, it can be modified and this can cause inaccuracies if actions or notifications based on shots fired is being done and they are modified.
This can easily cause a plug-in to malfunction or confuse a plug-in enough to function improperly.
Merging plug-ins or updating them has been one work-around for this.

Requesting that changes be made for the next major release within the API.

-Zehra
Those who are critical of me, I'll likely be the same of them. ~Zehra
The decisions we make are the ones we look forward too and the ones we regret. ~Zehra
There's a difference between knowing my name and knowing me, one shows respect to my name and the other is to who I am. ~Zehra

See where I've last been active at Strayers.
Visit BZList.net for a modern HTML5 server stats site.

Click here to view the 101 Leaderboard & Score Summaries Last updated 2021-01-12 (YYYY-MM-DD)
Latest 101 thread
Post Reply