GTB-Solver

GTB-Solver Demo Branch | [Beta] GTB-Solver OCR Branch

⚜ Function Introduction

简体中文 | 繁體中文 | 日本語 | English

Quickly guess the theme of "Guess The Build" game on Hypixel server based on multi-language hints and regular expressions.

⚜ Update Log

2024/06/03 - v4.3

• [Add] Added program self-check
• [Opt] Optimized the output style of log assisted processing mode
• [Opt] Code optimization

2024/05/12 - v4.2

• [Add] Added log assisted processing mode
• [Add] Added theme auxiliary recording mode
• [Add] Added semi-automatic sending mode
• [Opt] Thesaurus update

2024/04/18 - v4.1

• [Add] Added word frequency statistical index
  • The word frequency statistical index is weighted by time gradient and calculated from a total of approximately 15,000 rounds of game data provided by multiple players, and it is for reference only
• [Opt] The program now defaults to outputting in descending order according to word frequency statistical index
  • If you still need to output according to the original rules, please use the "English" column as the sort basis in the thesaurus file GTB_Thesaurus_Demo.xlsx, and sort in ascending order of English letters
• [Opt] Thesaurus update

2024/04/02 - v4.0

• [Add] Traditional Chinese input matching support

• [Add] Japanese input matching support

• [Fix] Fixed an issue where the character ' could not be matched

  # The following theme(s) have now been able to be matched correctly
  0.25 - Santa's Workshop
  0.00 - Santa's Sleigh

• [Opt] Now the user can match Traditional Chinese by prefixing @cht

• [Opt] Now the user can match Japanese by prefixing @jp

• [Opt] Thesaurus update

2024/03/25 - v3.6

• [Add] Added thesaurus self-check
• [Opt] Now the user can match Shortcut(s) by prefixing @sc
• [Opt] Now the user can match Multiword(s) by prefixing @mw

2024/03/17 - v3.5

• [Add] Added matching word count prompt for non-multi-word count result(s)
• [Opt] Now the user can switch the output language within the program
• [Opt] Code optimization

2024/02/29 - v3.4

• [Opt] Now the user can exit the program normally by pressing Ctrl+C
• [Opt] Code optimization

2024/02/20 - v3.3

• [Fix] Fixed an issue where the character . could not be matched

  # The following theme(s) have now been able to be matched correctly
  0.00 - Mrs. Claus

• [Opt] Code optimization

2024/02/14 - v3.2

• [Add] GTB-Solver OCR Branch Link
• [Add] macOS & Linux system support
• [Add] English & Simplified Chinese matching selection support
• [Fix] Fixed re.error crash that could be caused by illegitimate user inputs

2024/02/13 - v3.1

• [Fix] Fixed an issue that the number of related dependency libraries may be insufficient even after running Installation of Dependency Libraries.bat to install the related dependency libraries
• [Opt] Updated the way the system language is fetched to work with future versions of Python

2024/02/08 - v3.0

• [Add] Simplified Chinese input matching support

• [Fix] Fixed an issue where the character - could not be matched

  # The following theme(s) have now been able to be matched correctly
  3.00 - T-Shirt - Tricou
  1.75 - T-Rex
  0.00 - Jack-O-Lantern
  0.00 - Trick-or-Treating

• [Fix] Fixed KeyError crash that could be caused by incorrectly configured thesaurus column name

2024/02/04 - Demo_202402

• [Add] Multi-language readme support
• [Add] Added output moe mode
• [Fix] Fixed OverflowError crash that could be caused by illegitimate user inputs
• [Fix] Fixed re.error crash that could be caused by illegitimate user inputs
• [Opt] Program output language now depends on system language by default
• [Opt] Thesaurus update
• [Opt] Code refactoring

⚜ Pre-conditions

1. Set up the Python runtime environment

• Visit the official Python website to download
  • It is recommended that you install Python 3.10 and above, bugs in older versions will not be fixed
  • When installing Python for the first time, be sure to check Add Python x.x to PATH to add environment variables

2. Install the related dependency libraries

• Windows: Run Installation of Dependency Libraries.bat to install the related dependency libraries
• macOS & Linux: Run Installation of Dependency Libraries.sh to install the related dependency libraries

3. Set Hypixel server language to English (Recommend)

• Type /lang en in Hypixel server to complete the setup

⚜ How to Use

1. Run the main program

• Windows: Once the preconditions are met, run GTB-Solver.bat
• macOS & Linux: Once the preconditions are met, run GTB-Solver.sh

2. Exit the main program

• GTB-Solver runs repeatedly by default, enter 0 or press Ctrl+C to exit the program

⚜ Matching Rules

1. Number: Number of underscores

2. Letter: Will be matched and can be inserted directly before and after the number

   • Letters are not case sensitive when entering

3. Hyphen: Will be matched and can be inserted directly before and after the number

4. Space: Will NOT be matched, needs to be manually entered into the matching expression

5. Regular Expression Characters: Partially available

6. Default Matching: English

7. Exact Matching: If there is no need for multi-language matching, you can add the corresponding prefix to the matching expression for exact matching

   • Matching Content and Corresponding Prefix List

     Matching Content	Corresponding Prefix
     Simplified Chinese	@zh
     Traditional Chinese	@cht
     Japanese	@jp
     English	@en
     Shortcut(s)	@sc
     Multiword(s)	@mw

⚜ How to Guess (Take Water Bottle as an Example)

1. Use numbers + letters to guess

Theme: _____ ______
Please enter the matching expression: 5 6
The theme is 12 characters long
16.75 - Water Bucket - Vandspand
12.00 - Table Tennis - Bordtenni
10.25 - Train Tracks - Rail - Rautatie
10.00 - Ender Dragon
10.00 - Light Switch - Lysbryter
8.50 - Water Bottle - Waterfle
8.25 - Paint Bucket - Fargburk
8.25 - Swiss Cheese
7.75 - Horse Racing - Zavod koni
6.75 - Chili Pepper - Piment
6.75 - Magic Carpet
4.50 - Fruit Basket - Obstkorb
4.50 - Scuba Diving - Buceo
4.50 - Solar System - Solsystem
3.50 - Horse Riding - Ridning
3.00 - Build Battle
0.25 - Snowy Forest

Theme: _a___ ______
Please enter the matching expression: 1a3 6
The theme is 12 characters long
16.75 - Water Bucket - Vandspand
12.00 - Table Tennis - Bordtenni
8.50 - Water Bottle - Waterfle
8.25 - Paint Bucket - Fargburk
6.75 - Magic Carpet
# Here you can choose according to the general outline of the player's building

Theme: _a___ _o____
Please enter the matching expression: 1a3 1o4
The theme is 12 characters long
8.50 - Water Bottle - Waterfle

2. Guessing in conjunction with the use of regular expressions

Theme: _a___ ______
Please enter the matching expression: .a3 .*
16.75 - Water Bucket - Vandspand
12.00 - Table Tennis - Bordtenni
11.00 - Water Slide - Tobogan
9.50 - Magic Hat - Joben
8.50 - Water Bottle - Waterfle
8.25 - Paint Bucket - Fargburk
7.00 - Candy Cane - Acadea
7.00 - Paper Airplane - Papirfly
6.75 - Magic Carpet
6.50 - Party Hat
6.25 - Water Park
5.75 - Games Controller - Controller
5.50 - Magma Cube
5.50 - Paint Palette - Verfpalet
5.25 - Water Balloon - Gavettone
4.00 - Magic Wand
4.00 - Table Cloth - Dug
0.75 - Santa Claus
0.00 - Candy Buckets

Theme: _a___ _o____
Please enter the matching expression: .a3 .o.*
8.50 - Water Bottle - Waterfle
5.75 - Games Controller - Controller
# Here you can choose according to the general outline of the player's building

Theme: _a___ _o___e
Please enter the matching expression: .a3 .o.*e
The theme is 12 characters long
8.50 - Water Bottle - Waterfle

⚜ Configuration Modification

1. Modify the path of the thesaurus file or replace the thesaurus file

• The default path is the same folder as GTB-Solver_main.py. If you need to modify the path of the thesaurus file or replace the thesaurus file, please find the following code in GTB-Solver_main.py and replace the path in quotation marks

GTB_THESAURUS = r"GTB_Thesaurus_Demo.xlsx"

• Note: There should be at least an "English" column in the thesaurus file (strictly case sensitive)

2. Modify the program output language

• The default output language is the system language, or English if the system language is not yet supported. If you need to modify the default output language of the program, please find the following code in GTB-Solver_main.py and add the corresponding language code in quotation marks. If you only need to temporarily modify the program output language, you can directly enter the corresponding switching command

MULTI_LANG = ""

• Language Code and Switching Command List

  Output Language	Language Code	Switching Command
  Simplified Chinese	zh	/lang zh
  Traditional Chinese	cht	/lang cht
  Japanese	jp	/lang jp
  English	en	/lang en

3. Modify the output moe mode status

• The output moe mode is disabled by default. If you need to enable the output moe mode, please find the following code in GTB-Solver_main.py and replace False with True

MOE_MODE = False

4. Modify the automatic copying mode status

• The automatic copying mode is disabled by default. If you need to automatically copy the first matching entry to the clipboard, please find the following code in GTB-Solver_main.py and replace False with True

AUTO_COPY = False

5. Modify the log assisted processing mode status

• The log assisted processing mode is disabled by default. If you need to output game-related status online, compare the themes guessed by players in the game with the already output matching entries, and re-output them after filtering, please find the following code in GTB-Solver_main.py and replace False with True

LAP_MODE = False

• Example of Output Style (Among them, 3 is the current round, 10 is the total rounds, NoticeYou is the name of the builder of the current round, and 12 is the number of characters in the current round theme including spaces)

  [3/10] NoticeYou(12)

• Example of Comparative Guessing (Take Shopping Bag as an Example)

  Theme: ________ ___
  [3/10] NoticeYou(12)
  Please enter the matching expression: 8 3
  The theme is 12 characters long
  8.25 - Shopping Bag - Handlepose
  7.25 - Sleeping Bag - Sovepose
  4.00 - Baseball Bat

  [3/10] NoticeYou(12)
  NoticeSC: sovepose
  Detects that the player guessed theme(s) Sleeping Bag but did not guess correctly, and the filtered matching entries will be output accordingly
  8.25 - Shopping Bag - Handlepose
  4.00 - Baseball Bat

  [3/10] NoticeYou(12)
  NoticeZH: 棒球棍
  Detects that the player guessed theme(s) Sleeping Bag, Baseball Bat but did not guess correctly, and the filtered matching entries will be output accordingly
  8.25 - Shopping Bag - Handlepose
  # Here you can guess the correct theme directly

• Tip: The log assisted processing mode supports processing when the server language is set to Simplified Chinese, Traditional Chinese, Japanese or English, and supports to compare the themes guessed by players using Simplified Chinese, Traditional Chinese, Japanese, English, Shortcut(s) or Multiword(s). If your thesaurus file version is different, the actual comparison effect may change

6. Modify the path of the log file

• The default path is C:\Minecraft\.minecraft\logs\latest.log, and it is for reference only, please modify it according to the actual situation. If you need to modify the path of the log file, please find the following code in GTB-Solver_main.py and replace the path in quotation marks

LOG_FILE = r"C:\Minecraft\.minecraft\logs\latest.log"

7. Modify the repeat reading interval of the log file

• The default interval is 0.05 seconds. If you need to modify the repeat reading interval of the log file, please find the following code in GTB-Solver_main.py and modify the value

LAP_INTERVAL = 0.05

• Tip: It is recommended to set the interval in the range of 0.01 ~ 0.20 seconds. If you find that the game-related status is not updated in time or fail to capture the themes guessed by players after enabling the log assisted processing mode, you can reduce the repeat reading interval appropriately

8. Modify the custom copy content at the end of the game

• The default copy content is Good Game. If you need to modify the custom copy content at the end of the game, please find the following code in GTB-Solver_main.py and replace the content in the quotation marks

CUSTOM_CONTENT = "Good Game"

• Note: Custom content will only be copied when automatic copying mode and log assisted processing mode are enabled. For details on how to enable automatic copying mode, see Configuration Modification Method 4, and for how to enable log assisted processing mode, see Configuration Modification Method 5

9. Modify the theme auxiliary recording mode status

• The theme auxiliary recording mode is disabled by default. If you need to record the correct theme to the auxiliary recording file for subsequent statistical processing, please find the following code in GTB-Solver_main.py and replace False with True

TAR_MODE = False

• Note: Enabling theme auxiliary recording mode requires enabling log assisted processing mode at the same time. For details on how to enable log assisted processing mode, see Configuration Modification Method 5

10. Modify the path of the theme auxiliary recording file

• The default path is the same folder as GTB-Solver_main.py. If you need to modify the path of the theme auxiliary recording file, please find the following code in GTB-Solver_main.py and replace the path in quotation marks

GTB_TAR_FILE = r"GTB_TAR_File.txt"

11. Modify the semi-automatic sending mode status

• The semi-automatic sending mode is disabled by default. If you need to automatically send the first matching entry to the game after entering the matching expression, please find the following code in GTB-Solver_main.py and replace False with True

SAS_MODE = False

• Note: Enabling semi-automatic sending mode requires enabling automatic copying mode and log assisted processing mode at the same time. For details on how to enable automatic copying mode, see Configuration Modification Method 4, and for how to enable log assisted processing mode, see Configuration Modification Method 5

12. Modify the semi-automatic sending interval

• The default interval is 2.0 seconds. If you need to modify the interval between sends, please find the following code in GTB-Solver_main.py and modify the value

SAS_INTERVAL = 2.0

• Tip: This interval is the additional pause time after subtracting the remaining cooldown time of the repeat guess, it is recommended to set the interval in the range of 1.0 ~ 5.0 second(s). Setting the interval too short may trigger the server's anti-spam mechanism and result in being kicked out of the game

13. Modify the game window title

• The semi-automatic sending mode activates the first window containing the word Minecraft by default. If you are using a non-original client, please find the following code in GTB-Solver_main.py and replace the content in quotation marks with the game window title

WINDOW_TITLE = "Minecraft"

⚜ Important Notes

• This project is for Demo ONLY, the provided thesaurus file GTB_Thesaurus_Demo.xlsx contains 100 pairs of sample words and a few Shortcut(s) & Multiword(s), you can continue to supplement it on the original basis or replace the thesaurus file according to the aforementioned configuration modification method
• Abuse of GTB-Solver will give you an unfair advantage in the game! Please use it reasonably within a limited scope. The author is NOT responsible for the BAN caused by the abuse of the program