ZBSchools - Macro

Auto grinder for ZBSchools built with Python Selenium
Report Bug · Request Feature

Table of Contents

1. About The Project
2. Installation
3. Configuration
4. Contributing
5. License
6. Contact

About The Project

This is a rather simple Python script which makes use of Selenium's ability to interact with the web browser to create a sophisticated bot capable of solving most questions with absolute precision.

Some awesome features:

• Lightweight
• Runs in the background
• Solves nearly all questions
• Multi threaded
• Gain 25 million points per day (On 8 Threads)
• Instant setup and configurable

Disclaimer

Use this program at your own risk. According to SPH Terms and Conditions Section 6 Part D, users must not "use any automated process, use any kind of scripting software or bots or service to access and/or use the Site and/or Services". This program is merely demonstrating the capabilities of the Selenium webdriver, and you are liable for all consequences of your actions.

(back to top)

Installation

Prerequisites: Cookie Editor browser extension, Chrome version 110 (Latest as of 19 Feb 2023)

1. Head to Release and download the release zip file
2. Once complete, extract the zip file
3. In the extracted folder, you should see 3 files, namely main.exe, config.json and cookies.json
4. Go to ZBSchools and sign in
5. Using the Cookie Editor extension, export your cookies which should copy them to your clipboard
6. Open cookies.json and clear all the text in the file and paste your cookies in
7. Note that you need to do this every time your cookies change (Which depends on your activity)
8. Modify config.json to your liking. Refer to the section below.
9. Finally, run main.exe which will open a terminal

(back to top)

Configuration

This is a list of configurable options in the config.json file and what they mean.

Configurable	Description	Default	Datatype
lastProcessedArticleID	Saves the last processed article ID to prevent repeated processing. Do not modify this unless you know what you are doing.	14	int
articlesPerSession	Number of articles the script will process every time you run it. Once it processes that many articles, it will stop and exit.	100	int
threads	Number of threads to run. More threads means that the script will be able to solve more articles concurrently, but will also use more system resources.	4	int
headless	If set to true, the browser will be invisible which increases performance. It is recommended to turn this on for quicker solving, especially when multiple threads are used.	false	bool

(back to top)

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make 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!

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

(back to top)

License

Distributed under the GNU GPLv3 License. See LICENSE.txt for more information.

(back to top)

Contact

TheTrustyPwo - Pwo#0001 - [email protected]

Project Link: https://github.com/TheTrustyPwo/ZBSchools-Macro

(back to top)