{"id":15007058,"url":"https://github.com/detectivekaktus/bridgewatcher","last_synced_at":"2025-04-09T16:02:41.904Z","repository":{"id":239821299,"uuid":"800683719","full_name":"detectivekaktus/bridgewatcher","owner":"detectivekaktus","description":"Make your crafting, refining, and trading in Albion Online easier","archived":false,"fork":false,"pushed_at":"2025-02-11T15:33:53.000Z","size":670,"stargazers_count":4,"open_issues_count":1,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-09T16:01:18.362Z","etag":null,"topics":["albion-online","bot","container","data-visualization","discord","discordpy","docker","helper","linux-app","python","self-hosted"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/detectivekaktus.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-05-14T19:51:17.000Z","updated_at":"2025-02-11T15:33:58.000Z","dependencies_parsed_at":"2024-05-21T18:38:30.341Z","dependency_job_id":null,"html_url":"https://github.com/detectivekaktus/bridgewatcher","commit_stats":null,"previous_names":["detectivekaktus/bridgewatcher"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/detectivekaktus%2Fbridgewatcher","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/detectivekaktus%2Fbridgewatcher/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/detectivekaktus%2Fbridgewatcher/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/detectivekaktus%2Fbridgewatcher/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/detectivekaktus","download_url":"https://codeload.github.com/detectivekaktus/bridgewatcher/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248065291,"owners_count":21041871,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["albion-online","bot","container","data-visualization","discord","discordpy","docker","helper","linux-app","python","self-hosted"],"created_at":"2024-09-24T19:02:33.667Z","updated_at":"2025-04-09T16:02:41.869Z","avatar_url":"https://github.com/detectivekaktus.png","language":"Python","funding_links":["https://www.patreon.com/detectivekaktus"],"categories":[],"sub_categories":[],"readme":"# bridgewatcher\n\nBridgewatcher is intended to be a useful and functional discord bot that crushes the latest data that can be found by using the [Albion Online Data Project API](https://www.albion-online-data.com/) and the [SandboxInteractive API](https://www.tools4albion.com/api_info.php). With this data the bot should be able to examine the data and make calculations and predictions for different groups of players all around Albion.\n\nAdd the bot by following [this link](https://discord.com/oauth2/authorize?client_id=1241428288195526796\u0026permissions=8\u0026scope=bot) or if you want to host your own instance of the bot, go ahead to the **[How do I get this to work?](https://github.com/detectivekaktus/bridgewatcher?tab=readme-ov-file#how-do-i-get-this-to-work)** section!\n\n## What are the commands that I can use?\n- `/help`: get general help over the bot.\n- `/info`: get the bot configuration information.\n- `/server`: set the Albion Online server to pull information from.\n- `/gold`: get past gold prices up to 24 hours.\n- `/premium`: get premium price with the current gold price.\n- `/price`: get the price of an item on the markets of Brecilien, Caerleon, Martlock, Thetford, Fort Sterling, Lymhurst, Bridgewatch, and Black Market.\n- `/craft`: get crafting profit from the craft of an item.\n- `/flip`: get profit from transporting an item from a royal city market to the black market.\n- `/utc`: get UTC time.\n- `/player`: get general information about a player.\n- `/deaths`: get general information about the player's deaths.\n- `/kills`: get general information about the player's kills.\n- `/guild`: get general information about a guild.\n- `/members`: get members of the guild.\n\n## I want to contribute!\nAny help that improves the project aesthetically or internally are always welcomed no matter how complex your change is. Read the [CONTRIBUTING.md](https://github.com/detectivekaktus/bridgewatcher/blob/master/CONTRIBUTING.md) file and open a pull request!\n\nFor new contributors there's a scheme that explains how the project is currently organized:\n```\nres:             -\u003e 3rd party information that the bot relies on when first starting.\nsrc:\n  - commands:    -\u003e `Cog` classes.\n  - components:  -\u003e reusable UI components.\n  - config:      -\u003e configuration logic.\n  - db:          -\u003e database logic.\n  - utils:       -\u003e helper functions and classes.\n  - api.py       -\u003e utilities to interact with 3rd party APIs.\n  - client.py    -\u003e bot definition.\n  - constants.py -\u003e constant values.\n  - market.py    -\u003e market calculations.\n```\n\n## How do I get this to work?\nBe sure to have installed python 3.12.4\n\nIf you have chosen the path of self-hosting the bot, follow the instructions in this section.\n\n### Create a new Discord application\nFollow [this link](https://discord.com/developers/applications) to the Discord Developers portal and log in using your credentials. Visit the \"Applications\" tab and click \"Create\", give your bot a name and proceed.\n\nGrant the bot all Gateway previleged intents in the \"Bot\" section, since Discord has become more stringent and specific with the permission you grant to the bot.\n\nTo invite the bot to a server, go to the \"0auth2\" section and select \"bot\" from the list you can see. Give the bot administrator permissions and copy the invite link down below.\n\n### Launch the application\nOn the Discord Developers page within your application, go to the \"Bot\" tab and click on \"Reset token\". A new authorization token will appear for a short period of time, which you need to copy. We will use this to establish a connection with Discord using the `Discord py` library.\n\nAfter cloning the repository, create a `.env` file in the root directory and inside the file, paste: `DISCORD_TOKEN=\"your token\"`. Your token is the token you copied from the Discord Developers. The quotes are obbligatory. If you also want to add a separate application as a debug version of the current application, specify `DEBUG_TOKEN=\"token\"` following the steps you've done before.\n\nThe application is launched with Docker, so we need to create a container from the image that we have in the root directory of the project, you can do this by typing `docker build -t bridgewatcher .`. Now run the container with `docker run bridgewatcher`.\n\n## Buy me a host!\nYou can support me and the project with only $3.00/month on [Patreon](https://www.patreon.com/detectivekaktus) to help me pay for the bot hosting!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdetectivekaktus%2Fbridgewatcher","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdetectivekaktus%2Fbridgewatcher","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdetectivekaktus%2Fbridgewatcher/lists"}