mc-benchmark icon indicating copy to clipboard operation
mc-benchmark copied to clipboard

Collect information about load time from Debug.log and output it in .MD file

MC Benchmark

Build charts about load time of 1.12 Minecraft modpack.

Modded Minecraft modpack could takes ~10 minutes to load. Its could be useful to know, what mod or load step takes so long. This script parsing debug.log file, generated by Forge, and using https://quickchart.io/ API to generate chart images.

Usage

  1. Install latest NodeJS for Windows or Unix

  2. Open console, navigate to your Minecraft directory (one with the logs/ directory or crafttweaker.log file)

    > cd C:/Instances/MyModpack
    
  3. Run:

    > npx mc-benchmark
    
  4. File benchmark.md would be generated in current working directory.

Minecraft must be launched at least once in advance to generate file logs/debug.log.

Some lunchers disable the creation of a logs/debug.log file. Change the settings of your luncher in such a case. Example for CurseForge Luncher.

crafttweaker.log file is not necessary.

Options

Positionals:
  input  Debug.log path  [string] [default: "logs/debug.log"]

Options:
      --help      Show help  [boolean]
  -c, --ctlog     crafttweaker.log path  [string] [default: "crafttweaker.log"]
  -a, --data      Output of gathered .json data  [string]
  -d, --detailed  Count of detailed mods in main pie chart  [number] [default: 16]
  -t, --template  Non-default template path  [string]
  -m, --modpack   Modpack name in header  [string]
  -v, --verbose   Verbose level -v INFO or -vv DEBUG  [count]
      --cwd       Minecraft directory to OPEN files from  [string] [default: "./"]

Examples

  • examples/benchmark.md - Default output without options. Useful for version control, because all data that would be changed on new mc-benchmark run would be changed in separate lines. On Github you will see missed images , because GitHub cant parse spaces.
  • examples/benchmark-nospaces.md - Replace all space characters \s+ with %20. Messed up formatting, but could be seen from GitHub

Author

  • https://github.com/Krutoy242