Dismiss Notice
Hey Guest,
If you are interested in ghosting, the Ghosting Awards for January 2025 has just been announced:

Click here to check it out!

Free Rider Mod Manager

Discussion in 'Third Party Scripting & Development' started by Calculus, Jul 5, 2024.

  1. Calculus

    Calculus Community Developer Staff Member Administrator Ghost Moderator

    Awarded Medals
    As you all know, there are several third party developers who have indulged in creating mods for this community. The majority of these mods have been small scripts hosted on tampermonkey. Although there is no real reason for it, and although tampermonkey is a good viable solution, I wanted to make a mod manager similar to Minecraft's resource pack manager where you can enable/disable packs, as well as change their priority. What separates this from tampermonkey is that instead of running the script on document start or end, devevelopers will have the option to run the script as soon as the game loads or when the game is fully loaded. Furthermore, developers will not have to account for navigation/location changes. This will automatically re-run all userscripts whenever the location changes. Developer's Guide

    Chrome Extension


    upload_2024-7-5_10-46-46.png
     
    Last edited: May 19, 2025
  2. Calculus

    Calculus Community Developer Staff Member Administrator Ghost Moderator

    Awarded Medals
    Developer's Guide

    A global property, ModManager, is defined on globalThis, accessible to all scripts.
    Several helpful events are dispatched from ModManager. A list of events is accessible on the global constructor: ThirdPartyScriptManager#Events.
    A few events are dispatched when: the game loads, before and after the scene is drawn, tick/update, etc.

    Here's a quick example on how you could use these events to create an input display:
    Code:
    ModManager.addEventListener(ThirdPartyScriptManager.Events.Draw, drawDisplay);
    
    // Detail contains the 2D canvas rendering context
    function drawDisplay({ detail: ctx }) {
        // Your code here...
    }
    GitHub Wiki
     
    Last edited: May 19, 2025
    Blank_Guy, RowanPaul, mbcool and 2 others like this.
  3. Calculus

    Calculus Community Developer Staff Member Administrator Ghost Moderator

    Awarded Medals
    Dev update
    Syntax highlighting has been implemented as well as basic functionality including priority management. I believe the only thing that's missing at the moment is the ability to modify the "run-at" option on scripts, as well as a few bugs that need to be squashed. The first beta version has been released on GitHub. I encourage devs to test it out and search for some bugs. It would help a lot.
    upload_2024-7-14_14-1-13.png
     
    Cerasium and Ness like this.
  4. Calculus

    Calculus Community Developer Staff Member Administrator Ghost Moderator

    Awarded Medals
    Version 0.0.1-beta
    The first beta version of the Free Rider Mod Manager has been published to the Chrome Web Store after a lot of tedious changes and bug fixes.

    Known bugs
    • There is a bug causing the first input on the editor to create a new line at the top
    • There may be issues with the actual userscript injection, but it should work for the most part
    • Script editor settings are not currently available
    This was mainly an initial release beta to get something out there. The next version should fix all of these issues and provide a lot more features in a bug free environment.
     
  5. m0unta1nclimber013

    m0unta1nclimber013 Active Member Official Author

    I'm having a problem where when I try to create a new script, it loads forever.
     
    Cerasium likes this.
  6. m0unta1nclimber013

    m0unta1nclimber013 Active Member Official Author

  7. Calculus

    Calculus Community Developer Staff Member Administrator Ghost Moderator

    Awarded Medals
    There may be a November update coming to address some of these issues as well as improve the overall functionality of the mod manager. It is not currently in any state that should be used by average users. I suggest that tampermonkey still be used until the first stable version of this project is finalized and published.
     
  8. Calculus

    Calculus Community Developer Staff Member Administrator Ghost Moderator

    Awarded Medals
    Version 0.0.1
    I'm pleased to announce that version 0.0.1 has been drafted and is currently under review pending publish. Here are a few changes and features:
    • Active scripts on a tab will appear at the top of the extension popup
    • Developers no longer have to worry about proper script injection
    • The extension automatically injects a ModManager object which can be used by developers to create mini-tampermonkey mods which, in the future, they will be able to add their settings/config in the extension popup for user convenience -- This object also emits events that may be useful in their script development such as game load and other useful events
    • Users can give certain scripts priority so that they execute before other scripts
      • This is good if you have scripts that depend on other scripts, order of execution matters!
    • Updated user inteface/experience
      • Signficantly improved the user interface
      • Added several helpful features that were previously missing
      • You can import several scripts simultaneously by selecting compressed zip files or individual files, or both!

    I've attached some preview images. Also be sure to check out the new Style Manager I recently released which allows you to choose the theme and style of the web user interface!

    Install on the Chrome Web Store
     

    Attached Files:

    Last edited: May 15, 2025
    Cerasium, SirHuman01, isekeb and 3 others like this.
  9. Blank_Guy

    Blank_Guy Forum Legend Team Balloon Official Author

    good shi,

    i'd recommend adding a feature to just auto-toggle a script aswell if it's not already there
     
    Cerasium and TPlacella like this.
  10. Calculus

    Calculus Community Developer Staff Member Administrator Ghost Moderator

    Awarded Medals
    Could you be more specific?
     
    Cerasium and SirHuman01 like this.
  11. Blank_Guy

    Blank_Guy Forum Legend Team Balloon Official Author

    if it's an outdated script maybe? i'm not sure what i was meaning i tend to forget what i talk about
     
    Cerasium likes this.
  12. Calculus

    Calculus Community Developer Staff Member Administrator Ghost Moderator

    Awarded Medals
    Given that an update hasn't been released for the game in over 7 years, I don't think any script can be outdated. Unless you meant scripts that become incompatible with the extension, in which case, that likely won't happen. However, if I do make a change that might break existing scripts, I will first release a deprecation notice and add a waring to the affected scripts. Developers will have some time to update the script to follow the new practice.
     
  13. Calculus

    Calculus Community Developer Staff Member Administrator Ghost Moderator

    Awarded Medals
    Version 0.0.2
    This version has been scheduled for release. I've polished up some backend stuff as well as improved the overall user experience. With this version, I've written up some developer documentation for a swift and easy development process and experience. I've also created a Wiki page to further document proper use of this extension for developers.
     

    Attached Files:

    Cerasium and TPlacella like this.

Share This Page