Spark Unforged

What is Spark Unforged?

Spark Unforged is an adapted version of the popular performance profiling tool Spark, specifically designed for Minecraft version 1.12.2. This project is a fork of the original Spark and is distributed under the GNU GPLv3 license.

Main Features

Spark Unforged provides comprehensive tools for analyzing the performance of your Minecraft server or single-player game. Key features include:

• CPU load profiling
• Memory usage monitoring
• Server status reports
• Asynchronous profiling
• Load process profiling

New Features in Version 1.11.1

Important note: Spark Unforged now requires Mixin. Most mod packs already include some mod that loads Mixin, but if yours doesn't, you'll need to add a compatible mod such as MixinBootstrap or Mixin 0.7-0.8 Compatibility.

One of the new features is load profiling. This capability allows analyzing CPU performance and time consumption (and, on systems supporting Async profiler, memory allocation) throughout the entire loading process. Options are available for profiling individual stages including coremod, init, postinit, as well as complete game and server loading.

Load profiling is disabled by default and can be activated through the configuration file in config/spark/config.json. Settings are written to the file upon first access, so all configuration options become available after the first run.

Advantages Over Older Versions

Although other Spark variants exist for version 1.12.2, they are significantly outdated and lack many modern features. Spark Unforged brings improved data availability, asynchronous profiling, and unique capabilities such as load profiling to the older game version.

Differences from Modern Spark

Spark Unforged maintains the core functionality of the original mod, including commands and main features, with some exceptions:

• Added load profiling with options for analyzing various loading stages
• Load profiling is compatible with memory allocation analysis and asynchronous profiling
• Improved configuration file system
• Additional server metadata feature disabled (irrelevant for version 1.12.2)
• Real-time profile viewing disabled due to Java 8 limitations

Usage

Spark Unforged is practically identical to the modern Spark version in terms of functionality and uses the same commands and formatting. For detailed information about commands, usage, and tips, it's recommended to refer to the official Spark documentation.

Profiling results are automatically saved to the config/spark/data folder and can be uploaded to the Spark website for detailed analysis.