Installation
- Install LiveSplit: http://livesplit.github.io/downloads/
Activating the In-Game Time script
- Right click anywhere in LiveSplit and choose Edit Splits
- Ensure the Game Name matches the below image exactly (for the category, see "Level Skip" section below). Underneath the Attemps box ensure that the Activate button is clicked.
- The script starts, splits, and resets. You can enable or disable any of these functions by clicking the Settings button seen in the above image.
Displaying both Real Time and Game Time in LiveSplit
- Right click in LiveSplit and choose Edit Layout
- Click on the + button and choose Timer
- Click Layout Settings in the bottom left.
- For one of your Timers, choose "Game Time"
- For the other Timer, choose "Real Time"
- Right click in LiveSplit and choose Compare Against and Game Time
- To comply with the rules you must display both of these timers.
Run as Administrator
If you followed the above guide but the automatic splitting still doesn't seem to be working, try running LiveSplit as administrator (right click the icon and choose Run as administrator from the context menu). This helps in many cases.
Level Skip category
If your category name contains "Level Skip" or "LevelSkip" (see the rules for Any% Level Skip category for more details) the script will work in a special way:
- splits will not be invoked for levels 1-3
- base time will be set to 15 minutes (so your timer will be negative until you press Shift+L, this is normal)
Script settings
You can press Settings in the Splits Editor (see point 3. above) to view the autosplitter settings:
- Sound On At Start? - activate this option to prevent the timer from starting if you have sound set to OFF (useful when running Glitchless category which requires sound to be enabled)
- Disable Level Skip detection - activate this option to re-enable the splits for levels 1-3 when Level Skip category is detected (see section above for details)
- Don't split between Levels 12 and 13 - disable the automatic split between level 12 and 13 (after the invisible bridge). Note that even the game displays LEVEL 12 for both levels, but the actual internal level number is 13. For this reason, many runners keep these two levels a single segment.
- Single Level Mode - special mode where starting any level (by CTRL+A or finishing a level) will reset the timer to 0:00. Used for individual level runs. Check the section below for detalis.
Please note that for most runners can ignore these settings as they're highly specialized, crafted for individual needs.
Notes about Single Level Mode
The single level mode (mentioned in Script settings above) is a special mode in the script that allows running individual levels.
It works by monitoring multiple obscure values to determine a level was started/restarted and reset the base time to the time left at the point of restarting (resulting in a timer reset to 0:00).
In this mode, in most cases the timer must be started manually for the first time (using a LiveSplit hotkey).
For technical reasons, the timer will not be reset again if you press CTRL+A again quicker than 2.5 seconds after previous CTRL+A. Please keep that in mind and watch the timer if you have a habit of mashing the reset key after failure.
Please make sure that your LiveSplit is set to have only a single segment because the timer will reset right after splitting after level completion, hiding your time and messing up your next segment.
Additional Notes
- if you followed the guide and the autosplitter doesn't seem to work, the first thing to check is to ensure you have the proper versions of DOSBox and Prince of Persia (they should be DOSBox 0.74-3 and Prince of Persia 1.4). Check also this guide for more details.
- the name of each split is not important
- if making your own splits, you need to ensure you have the number of splits the script is expecting, OR you can disable the Split action in point 4. above - you will have to split manually in this case
- some runners might consider using the Alternate Timing Method component for LiveSplit instead of explicitly adding two separate timers.