Skip to content

pacnutek/BotC_FF_tracker

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Firefox Plugin

This is a simple Firefox plugin that monitors a specific URL and interacts with the page's DOM without connecting to the internet. It utilizes local browser storage to save and retrieve data. License: MIT

Disclaimer

This is a test project by an amateur with the help of Copilot AI to test its ability and have soemthing useful. By no means it is good code as I dont know Java Script at all. You take all the responsibility on yourself by using it and causing it any harm to your PC. Dont install browser plugins from unknown sources that you cannot trust.

The plugin should help track some events in the botc.app that I always forget to do. This is by no means a cheting mechanism, be sure your Storyteller and group you playwith is ok with using such enhancements. I am in no way afiliated with the BotC crew nor wish to infringe on their copyright. BotC is a great game and if you can please support its creators and the community.

Project Structure

firefox-plugin
├── src
│   ├── background.js      # Background script for managing extension behavior
│   ├── content.js         # Content script for interacting with web pages
│   ├── manifest.json      # Configuration file for the Firefox extension
│   ├── popup.html         # Structure of plugin puttons
│   └── popup.js           # Button bindings
├── README.md              # Documentation for the project
└── package.json           # npm configuration file

Installation

Again, dont install plugins from sources you dont trust.

  1. Clone the repository:

    git clone <repository-url>
    cd firefox-plugin
    
  2. Load the extension in Firefox:

    • Open Firefox and navigate to about:debugging.
    • Click on "This Firefox" in the sidebar.
    • Click on "Load Temporary Add-on" and select the manifest.json file from the src directory.

Usage

  • The extension will monitor the active tab for https://botc.app/ URL.
  • It will read from and write to local browser storage
    • nomination data
    • death occurences
  • Interactions with the page's DOM can be customized in the content.js file.

Contributing

Feel free to submit issues or pull requests for improvements or bug fixes.

Misc

This is a proof of concept, not a real "product", an MVP if you like. There is a lot of debuging code, some usles code from alternative versions that didnt work, probably some dead code and code that works wrong. At the time of this upload "it works on my machine". It needs refactoring, cleanup but my copilot quota for the month was used up so I upload it now. Yes, this is vibe coding, deal with it :P Maybe some professional with be insired by this and write something good instead.

About

Blood on the Clocktower Tracker plugin for Firefox

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors