Skip to content

Latest commit

 

History

9 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Contributors Forks Stargazers Issues project_license


mc-auto-voter

A simple automation script in python to perform automatic server voting for cracked minecraft servers.
Explore the docs »

View Demo · Report Bug · Request Feature

Table of Contents
  1. About The Project
  2. Getting Started
  3. Usage
  4. Contributing
  5. License
  6. Acknowledgments

About The Project

The script is fully customizable and rapidly changeable. All the automation tasks for each specific site are divided into its own class, thus enabling rapid adaptability to any change in website layout. All the automation tasks are handled for worst case scenarios, all of it then saved in a log and showed to the user during runtime and automatic retrial of failed votes.

For now the scripts supports automatic voting for the servers, pika-network and jartex-network.

Getting Started

To get a local copy up and running follow these simple example steps.

Prerequisites

  • To run using the released binary, nothing is required, the script automatically downloads the required chromium web-drivers and other dependencies.
  • To run the script itself, python in a virtual environment is preferred.

Installation for the script

  1. Clone the repo
    git clone https://github.com/neelnix/autoVoter.git
  2. Install the python packages required
    pip install -r requirements.txt
  3. Either you can have the script automatically download the required chromium binaries or manually download the chromium binaries
    playwright install chromium
    patchright install chromium
    Any one these two commands will work, only chromium is needed as patchright supports only chromium. If using the automatic download, then the downloaded binaries will be places at project_dir/browsers

Usage

  1. Both the scipt and the released binary needs a .env file placed in the root of the project_dir to work. The required fields and values are attached below for the .env file, change this values accordingly.
    #username to use for voting
    MC_USERNAME = "steve"
    
    #retry count, can be set to 0
    RETRY_COUNT = 2
    
    #whether to inform the user if there is a updated version of the app
    CHECK_FOR_UPDATE = true
    
    #Whether to run the automation in headless mode or not
    RUN_HEADLESS = true
    
    #Urls to try to vote for jartex, urls can be changed here to accomodate for any change in the urls provided on the jartex network vote page
    URLS_JARTEX = "https://topminecraftservers.org/vote/18687,https://best-minecraft-servers.co/server-jartexnetwork.4402/vote,https://www.minerank.com/jartexnetwork/vote,https://minecraft.buzz/vote/jartexnetwork,https://minecraftkrant.nl/server/jartexnetwork/vote,https://minecraft-mp.com/server/52462/vote/,https://minecraft-server-list.com/server/288369/vote/"
    
    #Urls to try to vote for pika, urls can be changed here to accomodate for any change in the urls provided on the pika network vote page
    URLS_PIKA = "https://topminecraftservers.org/vote/21765,https://best-minecraft-servers.co/server-pikanetwork-bestq-pika-host.4401/vote,https://www.minerank.com/pikanetwork/vote,https://minecraft.buzz/vote/pikanetwork,https://minecraftkrant.nl/server/pikanetwork/vote,https://minecraft-mp.com/server/41366/vote/,https://minecraft-server-list.com/server/424827/vote/"
    
    #Domains to block to stop inteeference from popups, required for one site at the time
    DOMAINS_TO_BLOCK = "opulentsylvan.com,copycarpenter.com"
  1. To Vote for pika-network

    autoVoter.exe pika
    python src/main.py pika 
  2. To vote for jartex

    autoVoter.exe jartex
    python src/main.py jartex
  3. Optionally you can use, autoVoter.exe pika -u Alex -rc 5

    -u will set the username for that specific run to the given value and -rc will set the retry count to the given value. This args overwrite the .env values.

Contributing

Any contributions are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

Top contributors:

contrib.rocks image

License

Distributed under the MIT license. See LICENSE.txt for more information.

Acknowledgments

(back to top)

About

A simple web automation tool to perform automatic voting for cracked minecraft server.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Contributors

Languages