https://github.com/janzert/maproll

Simple Factorio Map Rerolls
https://github.com/janzert/maproll

factorio livesplit speedrun

Last synced: 4 months ago
JSON representation

Simple Factorio Map Rerolls

• Host: GitHub
• URL: https://github.com/janzert/maproll
• Owner: Janzert
• License: other
• Created: 2024-09-16T23:30:26.000Z (over 1 year ago)
• Default Branch: master
• Last Pushed: 2024-10-17T14:25:46.000Z (over 1 year ago)
• Last Synced: 2025-10-31T02:28:00.152Z (8 months ago)
• Topics: factorio, livesplit, speedrun
• Language: AutoHotkey
• Homepage:
• Size: 76.2 KB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: License

Awesome Lists containing this project

README

          
# Factorio Map Roller

A small script for rerolling maps and starting Livesplit in Factorio random seed speedruns.

Instead of using a static location for the reroll button it has a simple system to find the button automatically. This allows it to adjust for any UI scale and screen resolution. While also stopping accidentally triggering, and resetting Liveplit, while outside of the map preview.

Has the ability to control Livesplit with either hotkeys or TCP network connection.

![Screenshot showing keyboard settings](screenshot_keyboard.png)

![Screenshot showing TCP settings](screenshot_tcp.png)

## Usage

### Initial Setup

1. Download the MapRoll script to a conventient location.

   - The `.exe` executable can be used on its own.

   - The source `.ahk` script file requires AutoHotkey v2 installed to run it.

2. Launch the script for the first time.

3. Configure the Livesplit control method and reroll hotkey (see below for details).

4. Start your map rolling quest for that perfect map (or maybe just a moderately acceptable one).

### Configuring Reroll Hotkey

1. The default reroll hotkey is F12.

2. To change the reroll hotkey:

   - Click on the hotkey field in the MapRoll interface.

   - Press the desired key or key combination.

   - The new hotkey will be set automatically.

### Configuring Livesplit Control

There are two methods to control Livesplit: Keyboard and TCP.

#### Keyboard Control

1. In the MapRoll interface, select the Keyboard control method.

2. Set two hotkeys:

   - One for resetting Livesplit

   - One for starting Livesplit

3. Click on each field and press the desired key or key combination.

#### TCP Control

1. In the MapRoll interface, select the TCP control method.

2. Enter the IP address where Livesplit is running:

   - Use `127.0.0.1` if Livesplit is on the same computer.

3. Enter the port number Livesplit is using for TCP connections. This defaults

   to `16834` in Livesplit.

4. Note: As of Livesplit version 1.8.29, you need to start the TCP server each time you launch Livesplit.

### Testing Livesplit Connection

1. After configuring Livesplit control, use the "Test livesplit" button in the MapRoll interface.

2. This button will start the Livesplit timer and then reset it after 5 seconds.

3. Use this to easily verify that your Livesplit control is set up correctly.

### Using MapRoll

1. Run MapRoll and Livesplit.

2. Start Factorio and navigate to the map preview screen.

3. Use the configured reroll hotkey (default F12) to generate a new map and reset Livesplit.

4. When you're satisfied with the map, start your speedrun.

### Tips

- The automatic button detection helps guard against triggering accidental resets when outside the map preview screen.

- You can combine a hotkey with Ctrl, Alt, or Shift for more complex key combinations. You might particularly want to do this for the Livesplit reset hotkey to help prevent accidental resets.

- Use the "Test livesplit" button whenever you make changes to your Livesplit configuration to ensure everything is working correctly.