Breaking Extensions so much

[AlterZwerg]

With Foundry, I was forced to lock the version when I got everything working for a campaign. I could absolutely guarantee and afternoon's SysAdmin work for myself if I ever wanted to update.

With FGU, I update weekly and if anything breaks, it'll be one of the small number of extensions which I just turn off for the week. And I rarely need to do that.

But at least in Foundry you have the option to keep stuff from updating by locking it or you can roll back to a previous (working) version.
This option is simply not a thing with FG but would be very helpful for issues like this.

I don´t run 5E and stopped shelling money out to WotC long ago. I want FG to improve so personally i can live very well with these growing pains.

[eporrini]

Extensions are a necessity for me and my players for 5e. I am not a developer, but it feels like we change core variables too often, which cause the syntax of extensions to require significant rework at times. My frustration lies in the FGU development team taking no accountability for the breaking of extensions that are critical to the overall use of FGU. Developers need to work in a less invasive way where possible to avoid levelling extensions during updates. The amount of impact recently has IMO far exceeded what I have seen in the past in terms of breaking/significant rework required.

I agree with some posters who said "don't update". That's sad, truly. I am going to be in a mode where I get stable and tell all of my players we will not be updating, missing out on new features and capabilities being introduced. I can only imagine that when I add new purchased content, at some point that will error out due to not updating...

My biggest issue presently is that certain key developers of extensions (BMOS, MeAndUnique to name a couple) don't have time or have stepped away from their extensions. I do not blame them, they have no obligation to provide updates to free extensions and it's a lot of work. When this happens, other developer "heroes" step in sometimes to help, but then you get into a Gitlab repo situation of hunting through threads for updates and knowing auto updates are out of the picture. There is no good way for a developer to take over abandoned extensions. I think there should be something in a EULA that says if an extension is abandoned another dev is allowed to lift it out and start updating it, even if under a new name or revision. I believe that certain abandoned (foundational) extensions could be taken by the FGU developers and incorporated. You likely have the stats on what's being pulled down from the Forge to gauge overall customer usage.

Bottom line, we need the FGU devs and leadership to get with extension devs to work through a better plan than exists today that makes sense for everyone. Extensions are too important (some are critical) to go through this suffrage each time we update.

[bwatford]

While I personally use and enjoy several extensions, none are essential for playing 5e or any other ruleset. The base functionality is sufficient for each ruleset. Extensions do make life easier by adding automation and other features, but they are not a necessity. We often become accustomed to the convenience they offer and forget that the game functions well without them, albeit with a bit more effort. It is still significantly better than pen and paper.

The developers provide a test channel for extension writers to work within before a release. The main issues are the lack of documentation from the developers and the limited time available to the authors. Every update tends to break something, and I do not foresee this changing. However, we can strive to minimize the impact.

I believe the development cycles are too rapid, almost weekly, which poses a significant challenge for developers who lack the documentation needed to comply in a timely manner. Since no one is making a living off extensions, free time is limited. These cycles should occur once a month at most, with weeks of lead time, rather than an active development cycle where changes are added to the test channel daily, impacting extensions.

Development cycles need better management, with documentation of changes provided as soon as they enter the test channel. Subsequent updates should only address fixes, not add new features. Changes should only enter the test channel once they are finalized on the development side.

While there is a rush to release new features, the current approach appears quite amateurish and ultimately drives users and extension writers away from the software. We have lost many talented contributors in the past 6-8 months due to the lack of time to continue development, leaving us with several “good” but unsupported extensions that are being patched together by volunteers.

We need to improve.

Phase 1: Developers work behind the scenes to develop the next version.

Phase 2: Documentation of upcoming changes is sent to third-party developers.

Phase 3: The version enters the testing phase. Extension authors work on updated versions during this period, which lasts for at least 30 days. No additional features are added during this time, except for bug fixes. The software developers collaborate with third-party developers to ensure everything is ready for the official release.

Phase 4: Official release.

[Zacchaeus]

There have only been three ruleset updates this year, in March, August and September.

Anything else has been bug fixes or updates to modules.

[Vass_Dts]

The amount of impact recently has IMO far exceeded what I have seen in the past in terms of breaking/significant rework required.

Fantasy Grounds is a 20-years-old program. It has been iteratively been build upon brick by brick. When the jump to Unity occurred, FG wasn't exactly re-written from the ground up. A colossal portion of its original code was just transplanted into Unity. During the first stage of this transition into Unity, the aim was to have the thing work in much the same way as it used to, but with some additional features whenever possible.

Now we are in the stage where the Dev team want to get rid of all bloated portions of the code, to streamline and optimize the software going forward. This endeavor is the primary reason you've seen more breaks than usual over the past year and a half or so. While some breaks in 5e did happen due to the 2024 implementation of the rules, many actually happened because of the streamlining of the base code. And while it is frustrating for us users (hey, I still haven't updated for instance), you can't have the software remain static. That's not good for any of us.

But yes, SW, from now on should be take steps to address possible breakages. Documentation is the key, as @bwatford said (among other things). Breaks will never stop happening as Ruin said earlier. The goal is to make them less frequent and less painful (particularly for extension devs).

EDIT/ADDENDUM: All of the above is my personal understanding of the situation, and I may have some details wrong, but the general gist applies.

[Laerun]

Fantasy Grounds Community Extensions:

Fantasy Grounds extensions are powerful tools developed by the community to enhance gameplay, customize rulesets, and automate tasks within the platform. However, these extensions come with their own set of challenges, particularly related to maintenance, compatibility, and ongoing support.

Key Insights on Fantasy Grounds Extensions:

Community-Driven Development: Extensions are typically created by individual developers who initially build them to improve their own gameplay. Over time, these tools are shared on platforms like the Fantasy Grounds Forge, where they can be distributed for free or at a low cost, giving them more visibility and allowing other players to benefit from these enhancements.

Technical Debt and Maintenance Challenges: Many extension developers face the reality of technical debt. As their portfolio of extensions grows, so does the difficulty of keeping them updated and compatible with the latest Fantasy Grounds updates. Frequent updates to Fantasy Grounds' core and specific rulesets can lead to breakages that developers must address. However, testing all possible scenarios is often beyond the capacity of individual developers, especially as they juggle multiple extensions.

Updating and Compatibility Issues: Extensions can conflict with each other or with updated rulesets, causing unexpected behavior during gameplay. Since SmiteWorks (the company behind Fantasy Grounds) provides indirect support but does not maintain these third-party extensions, the responsibility for updates and fixes lies primarily with the original developer. This can lead to delays in updates or, in some cases, developers abandoning their extensions due to the workload involved.

No Universal Testing Framework: There is no comprehensive testing system that ensures all extensions work flawlessly across various use cases and ruleset updates. Developers rely on feedback from users to identify and fix issues that arise, often only after an extension has already been impacted by an update.

Best Practices for Extension Developers: Developers are encouraged to keep an eye on beta announcements for Fantasy Grounds and to test their extensions on these versions in advance of major updates. By carefully managing changes and minimizing overrides of core elements, developers can reduce the frequency and impact of breakages. Creating backup copies of ruleset files they modify can also help streamline the update process when core changes occur.

User Awareness and Acceptance: For users, understanding the nature of extensions is crucial. While they add great value and convenience, they are not essential and come with inherent risks due to the evolving nature of Fantasy Grounds. It’s important for users to stay informed about the extensions they use and be prepared for potential disruptions during updates.

Extensions are a testament to the creativity and dedication of the Fantasy Grounds community, offering enhanced gameplay experiences. However, they also require ongoing commitment from both developers and users to manage and mitigate the challenges that come with integrating these custom tools into the evolving Fantasy Grounds ecosystem. For more information and guidance on using and developing extensions, you can visit the Fantasy Grounds Developer Guide and forums.