/Easy-Multi

Extremely easy multi instancing software for minecraft speedrunning.

Primary LanguagePythonMIT LicenseMIT

This project has been superseded by Julti, Usage of Easy Multi is not recommended

Easy Multi

Extremely easy multi/single instancing software for minecraft speedrunning.

image

A couple of goals of this project:

  • Setup multi in minutes
  • No file editing to adjust settings
  • Easy

I believe I have met all of these goals.

Usage

Hotkeys

  • Pressing the "Reset" hotkey will do various things:
    • Reset the instance you currently have open and move to the next instance.
      • Manually changing the opened window will not have an effect on this.
    • If automatic world clearing is enabled, all speedrun worlds except for the latest 5 in each instance will be cleared upon resetting.
    • All borderless windows will have their position and size reset, essentially unhiding them (see hiding below).
    • When moving to the next instance, Easy Multi will press alt + the number corresponding to the next instance (eg. alt+1, alt+2, etc...). This is to help obs know which instance you are on.
  • Pressing the "Hide" hotkey will set all borderless instances to 1x1 pixels to hide them, other than the one currently opened.

Control Panel

  • "Setup Instances" will find all open Minecraft instances. It will also rename them to their instance number (eg. "1", "2", "3"...).
  • "Go Borderless" will set all current instances to a borderless window with the set window size in reset options.
  • "Restore Windows" will set all current instances to the default Minecraft size and stack them in a row.

Reset Options Panel

  • Pressing either "Reset: ___" and "Hide: ___" will let you set the hotkeys for the respective action.
  • Pressing "Window Size: x" will pop up a window which lets you select the size of a borderless window when it is not in a hidden state.
  • The checkboxes in "Scene Switching" determine what key will be pressed when switching to an instance. For example, with both "Use Alt" and "Use Numpad" selected, Alt + Numpad 2 will be pressed when switching to instance 2. This option is to help obs know which instance Easy Multi switched to.

Log Panel

  • The large box taking the majority of the panel shows the output of the app, including resets, world clearings, etc...
  • "Current Instances: x" shows the amount of instances the app currently controls.
  • Pressing "Copy Log" will copy the currently visible lines from the log.

MultiMC Clearing Panel

  • Pressing "Clear Speedrun Worlds" will clear out all select types of speedrun worlds from the selected MultiMC instances folder except for the latest 5 speedrun worlds in each instance.
  • Enabling "Automatically Clear" will do the above action on every single reset.
  • You can set the MultiMC Instances Folder by pressing the small folder icon.
    • Easy Multi will do its best to locate the instances folder if you do not select the correct folder. For example selecting a ".minecraft" will probably lead Easy Multi to find the instances folder.
  • In the "World Types to Clear" section, you can enable various types of speedrun world names which will get detected by the world clearing.

Auto Hide Panel

  • Enabling "Automatically Hide" will enable automatic hiding of instances after a set amount of time.
    • Automatic hiding will occur the set amount of time after the latest of any of the following actions are done: Any buttons on the control panel being pressed, or using the reset hotkey while in an instance.
  • Scrolling on the text below the Automatically Hide option will change the amount of time before instances are automatically hiden.

Notes

  • Wall is not supported, and probably never will be.
  • F3+ESC will never be supported, nor will background resetting.

Acknowledgements

Thanks to all the following individuals and teams for their projects which helped make this project possible: