{"id":16218421,"url":"https://github.com/kevinnovak/msl-bumper","last_synced_at":"2026-01-19T09:11:31.031Z","repository":{"id":42361675,"uuid":"130949239","full_name":"KevinNovak/MSL-Bumper","owner":"KevinNovak","description":"Browser automation - Auto-bump your Minecraft server on minecraft-server-list.com.","archived":false,"fork":false,"pushed_at":"2022-09-26T18:54:07.000Z","size":307,"stargazers_count":2,"open_issues_count":8,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-07T19:51:22.057Z","etag":null,"topics":["automation","browser-automation","bump","bumper","minecraft","minecraft-server","puppeteer"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","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/KevinNovak.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}},"created_at":"2018-04-25T04:07:37.000Z","updated_at":"2024-05-28T19:03:48.000Z","dependencies_parsed_at":"2023-01-18T11:45:33.548Z","dependency_job_id":null,"html_url":"https://github.com/KevinNovak/MSL-Bumper","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/KevinNovak/MSL-Bumper","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KevinNovak%2FMSL-Bumper","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KevinNovak%2FMSL-Bumper/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KevinNovak%2FMSL-Bumper/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KevinNovak%2FMSL-Bumper/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/KevinNovak","download_url":"https://codeload.github.com/KevinNovak/MSL-Bumper/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KevinNovak%2FMSL-Bumper/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28565001,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-19T08:53:44.001Z","status":"ssl_error","status_checked_at":"2026-01-19T08:52:40.245Z","response_time":67,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["automation","browser-automation","bump","bumper","minecraft","minecraft-server","puppeteer"],"created_at":"2024-10-10T11:49:25.309Z","updated_at":"2026-01-19T09:11:31.012Z","avatar_url":"https://github.com/KevinNovak.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# MSL Bumper\n\nAuto-bump your Minecraft server on [minecraft-server-list.com](http://minecraft-server-list.com/).\n\nRunning this script will automatically put your server at the top of the [Recently Updated](https://minecraft-server-list.com/updated/) servers list, which will help your server attract more players. Includes a built-in scheduler which can be set on any schedule you'd like.\n\n## Requirements\n\n* Node.js\n  * [Install files can be found here](https://nodejs.org/en/download/).\n\n## Getting Started\n\n1. [Download the latest release here](https://github.com/KevinNovak/MSL-Bumper/releases/latest)\n    * Click one of the ```Source code``` links to download.\n2. Extract the download and navigate to the extracted files.\n3. Install the required packages.\n    * Run ```npm install```.\n4. Modify ```config.json```.\n    * See the [Configuration](https://github.com/KevinNovak/MSL-Bumper#configuration) section.\n    * ***Important***: Remember to modify at least ```username```, ```password```, and ```serverId```.\n5. Start with ```npm start```.\n\n## Running on a Schedule\n\nThere are 2 main ways you can run this script on a schedule:\n\n1. Built-in scheduler:\n    * Simply run ```npm run scheduler```.\n    * The **recommended** and probably easiest method.\n    * Commands:\n        * View logs with ```pm2 logs msl-bumper```.\n        * Restart with ```pm2 restart msl-bumper```.\n        * Stop with ```pm2 stop msl-bumper```.\n        * Remove with ```pm2 delete msl-bumper```.\n2. Custom scheduler:\n    * Setup a custom scheduler of your choice to run ```node app.js``` or ```npm start```.\n    * Run directly with Node:\n        * Windows: [Run a Node script with Windows task scheduler](https://eddyerburgh.me/run-a-node-script-with-windows-task-scheduler)\n        * Mac \u0026 Linux: [How to Run Node.js Scripts from a Cron Job](https://askmacgyver.com/blog/tutorial/how-to-run-node-scripts-from-a-cron-job)\n    * Run from a shell script:\n        * Windows: [Execute Bash Script (Using Git Bash) from Windows Task Scheduler](https://gist.github.com/damc-dev/eb5e1aef001eef78c0f4)\n        * Mac: [How to Run a Shell Script Every Day on a Mac](https://www.dssw.co.uk/blog/2011-05-22-how-to-run-a-shell-script-every-day-on-a-mac/)\n        * Mac \u0026 Linux: [Schedule Tasks on Linux Using Crontab](https://kvz.io/blog/2007/07/29/schedule-tasks-on-linux-using-crontab/)\n\n## Configuration\n\n* **account**:\n  * **username**:\n    * Your **minecraft-server-list.com** username.\n  * **password**:\n    * Your **minecraft-server-list.com** password.\n  * **serverId**:\n    * Your **minecraft-server-list.com** server ID.\n    * This can be found in the URL of your servers page on **minecraft-server-list.com**.\n      * For example, your servers page URL might be ```http://minecraft-server-list.com/server/123456/```.\n        * In this example ```\"123456\"``` is the server ID.\n* **bump**:\n  * **enabled**:\n    * Actually bump the server?\n    * If ```false```, will run all actions except the actual bump, useful for testing.\n  * **descriptions**:\n    * **enabled**:\n      * Whether or not to type in a random description for the server.\n      * ***Important***: If enabling, remember to modify the list of descriptions. Don't use the default.\n    * **list**:\n      * A list of possible descriptions to use.\n        * You can add as many as you want.\n      * If enabled, one will be chosen at random each time the script is run.\n* **browser**:\n  * **hide**:\n    * Should the browser window be hidden?\n    * ***NOTE***: Set to ```true``` if running from SSH or a non-GUI OS like Debian or Raspbian Lite.\n  * **custom**:\n    * **enabled**:\n      * Whether or not to use your own custom browser from the provided path.\n      * ***NOTE***: Supports most newer versions of Chrome or Chromium.\n      * If ```false``` will use the default version of Chromium bundled with this package.\n    * **path**:\n      * The path to the Chrome or Chromium executable to use (if enabled above).\n      * See [this page](https://github.com/GoogleChrome/puppeteer/blob/master/docs/api.md#puppeteerlaunchoptions) for more details.\n* **timings**\n  * **delays**:\n    * **enabled**:\n      * Whether or not this script should wait a random amount of time between actions.\n      * Recommended to leave enabled.\n    * **min**:\n      * Minimum time to wait between actions in seconds.\n    * **max**:\n      * Maximum time to wait between actions in seconds.\n  * **typingDelays**:\n    * **enabled**:\n      * Whether or not to type with delays (rather than instantaneously).\n    * **delay**:\n      * Time to wait between key presses in milliseconds.\n  * **scheduler**:\n    * **expression**:\n      * Defines when the bump script should be ran using a cron expression.\n      * [You can read about cron expressions here](http://www.quartz-scheduler.org/documentation/quartz-2.x/tutorials/crontrigger.html)\n      * [Here are some examples and a cron generator](https://www.freeformatter.com/cron-expression-generator-quartz.html).\n      * ***NOTE***: Does not support every format. See [this page](https://github.com/harrisiirak/cron-parser#supported-format) for details.\n      * Defaults to every day at 9am, 3pm, and 9pm.\n        * With a 0 to 2 hour offset, see ```offset``` below.\n    * **offset**:\n      * **enabled**:\n        * Whether or not to wait a random amount of time after the scheduled time comes.\n        * Recommended to leave enabled.\n      * **min**:\n        * Minimum time to wait after the scheduled time in seconds.\n      * **max**:\n        * Maximum time to wait after the scheduled time in seconds.\n        * ***NOTE***: Should be less than how often the script is running according to the ```cronExpression```.\n\n## Disclaimer\n\nRunning automated scripts like this one is often against a websites terms and conditions. Ultimately you are the one responsible for knowing the terms and conditions, and for what you do with this script. Run at your own risk.\n\n## References\n\n* [Puppeteer](https://developers.google.com/web/tools/puppeteer/) by [Google](https://developers.google.com/) - Automate browser tasks in Chrome or Chromium.\n* [Node Schedule](https://github.com/node-schedule/node-schedule) by [Tejas Manohar](https://tejas.io/) \u0026 [Santiago Gimeno](https://github.com/santigimeno) - Schedule jobs to run with Node.js.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkevinnovak%2Fmsl-bumper","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkevinnovak%2Fmsl-bumper","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkevinnovak%2Fmsl-bumper/lists"}