╔══════════════════════════════════════════════════════════════════════════════╗
║    _____     _   _            ___    _____ _     _       _      ___   ___    ║
║   | __  |___|_|_| |___    ___|  _|  |  _  |_|___| |_ ___| |_   |_  | |   |   ║
║   | __ -|  _| | . | -_|  | . |  _|  |   __| |   | . | . |  _|  |  _|_| | |   ║
║   |_____|_| |_|___|___|  |___|_|    |__|  |_|_|_|___|___|_|    |___|_|___|   ║
║                                                                              ║
╠══════════════════════════════════════════════════════════════════════════════╣
║         Official Bride of Pinbot 2.0 code changelog by Dutch Pinball         ║
║               www.dutchpinball.com    support@dutchpinball.com               ║
║     Please report bugs and feature requests at issues.dutchpinball.com       ║
╚══════════════════════════════════════════════════════════════════════════════╝

Version 1.21 - December 2021

• PinMAME: Sound is now coming from PinSound Studio which improves the quality of especially the voice samples to match the original machine output.
• PinMAME: The helmet lights are now true to the original instead of showing one looping lightshow.
• PinMAME: Fixed the issue of holding the start button to return to game selection causing a game being started last minute and sometimes a ball being served to the shooter lane.

• Attract mode:
• Added Andrew Burch to the special thanks section.
• Added PinSound logo.
• Replaced PinballControllers logo with Multimorphic logo.
• Added "Software Menu -> USB export" submenu to easily export the log file and database to a USB stick for support or backup needs.
• Added "Adjustment Menu > Williams (1.0)" submenu. Moved the (renamed) "Game ROM" setting here.
• New setting "Adjustment Menu > Williams (1.0) > Sound engine", which let's you choose between the new PinSound engine (default) or the "old" PinMAME sound engine (with decreased latency compared to before).

• When completing the "Extra Ball", "Lites Extra Ball" or "Lites Jackpot" wheel modes with a quick drain, the award would not be awarded because the end animation was still playing.
• If near the end of a wheel mode a ball was shot into the shuttle ramp and rested in the lock trough while an animation played, no music would start.
• After the 3rd super skillshot the chase light goes back and forth but this behavior was flawed, which is fixed now.

• During boot up you will now see a white screen for a second or two before the game starts. This is the PinSound software, which we unfortunately could not get to hide.

• Mark Sunnucks (Snux): PinMAME updates, Documentation
• Andrew Burch (Jesder): Testing, Sound Fixes, Documentation
• PinSound: PinSound Studio, initial BoP sound package - www.pinsound.org

Version 1.19 - April 5th 2017

• Added knocker usage and credit award for highscores (+ settings, see below).
• Reworked slingshot reloading to prevent "machine-gunning" slingshots.

• Split "Adjustments Menu -> Rules" into "Standard Rules" and "BOP2.0 Rules".
• Added "Adjustment Menu -> Pricing / Awards -> Highscore awards" with 5 settings for Grand Champion and Highscore 1 to 4. When a player now gets a highscore and saves it (selects profile), he will be awarded the specified amount of credits. By default 1 credit for GC and HS1.
• Updated setting "Adjustment Menu -> Coil Strengths -> Knocker" to include an "off" option, to disable the knocker.

• Factory Reset would result in crashing the software under 1.18.
• Super Jackpot sound effect was cut off early.
• Coil testing of jets and slingshots was broken under 1.18.

Beta Version 1.18 - March 1st 2017

• The jets slingshot now counts as a jet hit by default, in normal play and in the "Fueling Frenzy" wheel mode as long as the jets sling is active - it's disabled 5 seconds after the 1st hit (used to be 3 seconds... and buggy).
• A random wheel mode is selected at the start of the game (same for all players) to guarantee mode variation in the case of low jets activity.

• PinMAME emulation now scales according to the display scale setting to support displays with a different resolution.
• Start button:
• the special function popup now takes longer to show up. This fixes the issue that only a really short button press would start game / add player.
• solved retrigger issue were after removing a player / stopping the game a start button action would occur when releasing the start button.
• flaky start button switch double switch events should now be filtered.
• Added a visual countup effect to the current player's score.
• Improved videomode framerate/performance.
• New trophy sound.

• Added setting "Adjustments Menu -> Rules -> Jets sling counts as jet hit". This determines if the jets slingshot counts as a jet hit in normal play and in the "Fueling Frenzy" wheel mode. Defaults to "yes".
• Improved USB updating to properly handle update files that accidentally contain suffixes like "(1)" or " - Copy".

• After some lightshows the G.I. would stay off.
• Multiball 2 Lock callouts would be cut off early.
• The "Slot Machine" mode would start a reels spinning sound that would not stop when the mode ended.
• After a "Factory Reset" the PIN*BOT letters factory default was incorrect.
• Metamorphosis heartbeat startup background music for heartbeat level 2 to 5 would be muted on the 2nd (and later) ball this phase is played.
• If a wheel mode was interupted by a multiball start during its outro or total screen, it would be restarted again after the multiball.
• Fixed weird sounding sound issue with "Planet Pythonia" wheel mode intro.
• Fixed ball saver animation/voicecall being triggered during attract mode.

Beta Version 1.17 - August 5th 2016

• If a wheel mode is interupted by a multiball, it will now continue after the multiball has ended.
• During wheel modes, shooting the scoop (if not lit for a shot) now adds 5 seconds to the remaining mode time. A setting to tweak this time was added: "Adjustments Menu -> Rules -> Wheel -> Scoop time added".
• The default amount of jackpots needed to complete Multiball 1 has been reduced to 3. This is still a setting that can be set anywhere from 1 to 10.
• The default amount of PIN*BOT letters that are pre-lit has been raised to 3. This means videomode is easier to lite the first time. This is still a setting that can be set anywhere from 0 to 6.

• Live DMD is now also updating during PinMAME emulation.
• Holding the start button can now remove the last player from a game if he is still at 00 points (useful for any accidental player additions).
• Holding the start button is now visualized by a popup that tells you what action is being executed (removing player, stopping game, to game launcher).
• To enter profile selection during skillshot you now have to hold the right flipper button, to minimize accidental entering of the profile menu. This is now also visualized by a popup.
• After selecting a profile you can now enter a "Profile Info" menu with the right flipper button. This lets you view your highscores and trophies, and let's you update your profile or logout.
• Trophies used to be either 1, 2 or 3 stars. This has now changed to bronze, silver, gold and platinum. The platinum trophy is awarded when the player has collected all other trophies.
• Updated animations for "Extra Ball" mode so the 4 screen panels now better match the orange extra ball inserts.

• Added 3 settings to "Adjustment Menu -> Start Button". To enable or disable the functions for holding the start button. Useful for operators or tour- naments where you want to disable restarts or access to PinMAME software.
• Added "Software Menu -> Current version -> Factory Reset" menu item, which performs a factory reset for the current version, resetting all settings, audits, highscores & profiles.
• If you experienced a delay when entering the service menu this was likely caused by the player profiles menu being repopulated every time. To fix this delay we now only load the player profiles when this item is selected.

• PinMAME emulation did not show periods (commas were fine).
• Game/skillshot "Planet PIN*BOT" intro would keep showing for subsequent skillshots if it wasn't watched till the end previously. Also it was missing the voicecall since version 1.14. Now added 2 alternative "welcome back" voicecalls for subsequent games.
• Trophy title only showing half or not at all during bonus countdown.

Version 1.16 - January 14th 2016

• Added setting "Adjustment Menu -> Pricing -> Units per credit". This provides fractional credits functionality. The existing settings for the 4 coin slots now define how many "credit units" each coin adds.
• Bugfix: Live functionality from v1.15 caused game to freeze in some cases.
• Bugfix: if a flipper is held this now prevents a ballsearch from starting.

Version 1.15 - December 24th 2015

• Multiple CPU cores are now utilized which improves performance overall, most notably Videomode and the PinMAME alphanumeric display emulation.
• Added support for future "Delta" updates, meaning future updates can be much smaller in size if updated from at least version 1.15.
• Changed "Adjustment Menu -> Live -> DMD update interval" setting, it's now called "Live DMD framerate" and supports up to 16 frames per second.
• Tournament Mode removes the credits scroll and some logos from attract mode to maximize screen time for the Game Over / last scores screen.
• Colorized highscore "Skip / Save score" screen.
• Bugfix: Slingshots and jets coil strength settings didn't update right away.
• Bugfix: Slingshots and Jets wouldn't disable when the game was tilted.
• Removed various legacy display settings to keep in line with our latest codebase. Specifically removed classic dmd support, color display monochromatic color settings and background color settings.

Version 1.14 - November 6th 2015 - Alivia benefit event exclusive

• Added basic coin support. Settings for Freeplay and the coin slots added under "Adjustments Menu -> Rules -> Pricing".
• Added Tournament Mode setting under "Adjustments Menu -> Rules". Tournament Mode eliminates the randomization in the "Slot Machine" mode.
• Added three settings under "Adjustments Menu -> Rules -> Extra Balls" for the maximum extra balls (total & per ball), and the alternative award score.
• During "Mission Control" the heartbeat ramp no longer lites locks for the Multiball 2 since the locks can't be made during this mode and the lit locks time out.
• Updated "Planet Python" callout to "Planet Pythonia".
• Skillshot bonus category is now more in balance with other bonus categories. Now a normal skillshot is 25k in bonus and a super skillshot 125k. It used to be the entire skillshot value, which made skillshots too valuable.
• Super Skillshot difficulty increases after each collected Super Skillshot. The walking light will increase in speed and vary directions later on.

Version 1.13 - August 7th 2015

• Changed "Planet Python" to "Planet Pythonia", as we have now learned this is actually where Python Anghelo said he would go back to when he passed away.
• After 100% completing a Small Wheel mode, a Big Wheel mode is lit. After playing the Big Wheel Mode, a Small Wheel Mode will be lit again, etc.
• Tweaked some of the trophies' stars (indication of difficulty).
• Tweaked and added basic point scoring and bonus "Story Progress" points for shots towards Multiball 2 and Metamorphosis.
• Added trophy "Completed Small Wheel", awarded when all the Small Wheel modes are started within one game.
• Added trophy "Completed Big Wheel", awarded when all the Big Wheel modes are started within one game.

Version 1.122 - August 5th 2015

• This is a Pre-Beta version that skips Multiball 1 and only lites Big Wheel modes for testing purposes.
• Added callouts and sounds for the Big Wheel mode titles and awards.
• Metamorphosis heartbeat startup now indicates that the heart rate level is about to drop down again by blinking the blocks and using the helmet lights.
• Added setting "Heart rate drop time" to "Rules -> Multiball" Which determines how much time you have before the heart rate drops down a level.
• Added a lightshow to the Metamorphosis start.
• During "Planet Python" the ramps are no longer available for progressing towards multiball. This stack was buggy and confusingly different for the various multiballs. Also fixes a jackpot value bug (value ending in ,999).
• Added ball saver to "Big Wheel Billion", the duration of the ball saver is a setting found under "Adjustment Menu -> Rules -> Wheel -> Big Wheel".
• Finishing "Big Wheel Billion" no longer raises the jackpot value or awards Double Scoring, to be consistent with the other Big Wheel modes. Also the intro for this mode can't be skipped anymore to build the tension.
• Bugfix: during Metamorphosis the head would move to the wrong face if it was at the face with the eye holes while starting Metamorphosis.
• Bugfix: During "Shooting Range" the mini playfield gate no longer opens when the shuttle ramp shot is lit or just before that.
• Bugfix: If the scoop was shot at the end of the "Slot Machine" mode, the ball would not eject.
• Bugfix: "Live" related memory leak resulting in low framerates and crashes.

Version 1.121 - July 29th 2015

• This is a Pre-Beta version that skips Multiball 1 and only lites Big Wheel modes for testing purposes.
• Added Heartbeat phase, Metamorphosis & Unlimited balls multiball that is reached after Multiball 2 is completed.
• Added 6 Big Wheel modes. The Billion mode is always the last Big Wheel mode.
• Added trophy "Welcome to the Billionaires Club", awarded when you complete the "Big Wheel Billion" mode.
• Added trophy "R.I.P. Python Anghelo", awarded when you spell PLANET PYTHON 3 times in the "Planet Python" mode.
• Added trophy "Combo King", awarded when you complete 2 combos in the "Cosmic Combos" mode.
• Added trophy "Single-handedly", awarded when you collect 3 awards in the "Slot Machine" mode.
• Added trophy "Sharpshooter", awarded when you collect all 6 different shots in the "Shooting Range" mode.
• Added trophy "To the limit", awarded when you collect a 10M award in the "Unlimited Millions" mode.
• Added trophy "She's alive!", awarded when you reach the Metamorphosis.
• Added settings for each Big Wheel length to "Rules -> Wheel -> Big Wheel".
• If the audio jack is not plugged in properly when booting, the game now informs you about it and restarts when the jack is plugged in.
• If the P-ROC is not connected or powered correctly, the game now informs you about it and restarts when the situation is resolved.
• Improved loading time by about 50% and changed the helmet lights during it.
• Service menu opens much quicker the first time you open it.
• Moved "Power Charge time" setting to subfolder "Rules -> Multiball".
• Moved "Values doubled time" setting to subfolder "Rules -> Wheel".
• Bugfix: Hitting the 5K targets during Multiball 2 made the display go black for most of the remaining Multiball.

Version 1.12 - May 22th 2015

• Bugfix: Retry P-ROC initialization over a period of 10 seconds if it fails.
• Bugfix: Failed Internet Update list retrieval would restart the game.

Version 1.11 - May 20th 2015

• Public release of the 1.10x beta updates' changes.
• Added "Software Menu -> Internet update" item to service menu, where you can, if connected to the internet, download future updates.
• Added settings under "Adjustment Menu -> Sound" for music, SFX and voice volume. Normal volume control is called master volume here.
• Colorized USB update screens.
• Bugfix: Disk space error in USB update would not show up properly.

Beta Version 1.103 - April 24th 2015

• Sound volume can now be controlled to a finer degree.
• Game launcher can now be controlled by coin door buttons too in addition to the flippers and start button.
• Added scoring to in/outlanes (25k)
• Slingshots now award 10 points to increase randomization of scores.
• Jets now award 10010 instead of 10k to increase randomization of scores.
• Added setting "Adjustment Menu -> Live -> DMD update interval", which specifies the interval at which DMD screenshots are send to the Live server. Defaults to "1 second"; increase or set to "off" if bandwidth is tight.
• Added settings under "Adjustment Menu -> Coil Strengths" for all pulsing coils. Trick: Holding Enter down for a second on a value does a test pulse. Also tweaked some of the default pulse lengths down.
• Added 3 options under "Software Menu -> Current Version":
• "Exit current game" exits the running game - equivalent to holding the start button while in game.
• "Exit to launcher" exits to the game launcher - equivalent to holding the start button while in attract mode.
• Restarts the current software version if needed for some reason.
• Removed setting "Adjustment Menu -> Live -> Live host" from service menu.
• Removed setting "Adjustment Menu -> Sound volume" from service menu.
• Removed "Adjustment Menu -> Game" and moved items to elsewhere in the menu.
• Flipper Switch Mod support: Flippers disabled during bonus count down and implemented paging through attract mode screens.

Beta Version 1.102 - April 17th 2015

• Added Multiball 2 "Activating the Bride", which can be build towards after finishing Multiball 1 (arriving at Planet PIN*BOT).
• Added trophy "Batteries not included", awarded when you start Multiball 2 (by unloading the 3 power cells from the space shuttle).
• Added trophy "Now I see you", awarded when you complete Multiball 2.
• Tweaked videomode levels based on feedback from MGC.
• Videomode now defaults to 0 extra lives, but up to 3 extra lives can be earned by shooting the mini playfield while the videomode is already lit.
• Every 5 seconds the current DMD image is send to the Live server (if Live is enabled).

Alpha Version 1.101 - April 10th 2015 - MGC Exclusive

• Added Videomode, which can be lit by spelling PIN*BOT at the mini playfield (when nothing is lit at the shuttle ramp), and then started at the scoop - indicated by a faster blinking "Spin small wheel" insert.
• Gate to mini playfield now opens up during wheel modes too (except EB mode), and skillshots are awarded too.
• Added setting "Adjustment Menu -> Peripherals -> Flipper Switch Mod", which adds support for the "BoP2.0 Flipper Switch Mod" by disabling the flipper coils while in player profile menus and Videomode.
• Added setting "Adjustment Menu -> Rules -> Videomode -> Videomode enabled", (enabled by default), if disabled the mini playfield functionality is the same as in previous versions.
• Added setting "Adjustment Menu -> Rules -> Videomode -> PIN*BOT letters pre-lit", which can make lighting videomode easier (but 0 by default).
• Added trophy "Lights out, away we go!", awarded when you start Videomode.
• Added trophy "Seasoned Racer", awarded when you finish Videomode level 6.
• First shot animation of the G-Force Challenge mode now loops properly.
• 75K Super skillshot animation text effect fixed.
• Bugfix: During MB1 the shuttle and travel dots did not match up if setting "Adjustment Menu -> Rules -> Multiball 1 -> Jackpots required" was changed from the default value. The range for this setting is now limited to 1 to 6.

Version 1.10 - March 20th 2015

• Public release of the 1.09x beta updates' changes.
• Colorized jackpot value font.
• Improved the White Water-esque multiplier (heartbeat ramp) period at the start of multiball; it no longer listens to the left inlane switch but instead stops 3.5 seconds after the 3rd ball is released.
• Improved USB stick reading; this now (for future updates) only happens on request, so the stick can be inserted while the game is already running.
• Bugfix: flippers would sometimes get disabled by the watchdog while in service menu. Now the flippers will get enabled again if this happens.
• Bugfix: 5k targets would only award 5k when blinking, now they always do.
• Bugfix: blinking 5k targets would only show their accompanying visual towards bonus multiplier during general gameplay, now they always do.
• Bugfix: service menu would often break when deleting player profiles or when installing / delete software versions.

Beta Version 1.092 - February 20th 2015

• PinMAME: added L-6 ROM.
• Added setting "Software Menu -> PinMAME ROM". Which enables switching between ROMs L-6, L-7, or other ROMs added to the pinmame\roms\ folder (at your own risk).
• 5k Target inserts now blink during the bonus countdown multiplier screen.
• Bugfix: Bonus multiplier sound during gameplay and bonus countdown would not play correctly for all multiplier levels.
• Bugfix: Ball tracking bug resulting in the turn being ended, most frequently experienced during super jackpot phase (introduced in 1.091).
• Bugfix: no skillshot would be awarded if ball came from right mini playfield exit (introduced in 1.091).

Beta Version 1.091 - January 23th 2015

• Improved ball search, it is no longer canceled by flippers, listens to more switches and pulses more solenoids including the lock post (after the first ball search).
• Improved trough and lock trough ball tracking. Should now be able to correctly handle airballs to the head and the lock post releasing multiple balls.
• Slightly improved helmet lights strobing when using LEDs, but incandescents still yield much better results.
• Heartbeat ramp hits no longer require the entrance switch to work. Instead the miniplayfield left exit is checked.
• Status report during multiball now only triggers with 2 flippers up.
• Colorized status report.
• Fixed some color issues with skillshot animations.
• Bugfix: Ball saver showing animation when draining trough outlanes, but then ball would be ended anyway (when 2 balls were in the lock tray).
• Bugfix: Changed the way skillshots are awarded from the miniplayfield. This would sometimes cause a crash when the twisty ramp wasn't working right or if the mini playfield exit gates were swapped.
• Bugfix: bonus countdown trophy screens text formatting fixed.
• Bugfix: don't start game or add player when pressing start in service menu.
• Bugfix: flasher locked on (experienced mostly during wheel modes) fixed.
• PinMAME flipper switch detection (lane change & initials entry) fixed.
• PinMAME flippers are now disabled during attract mode.
• PinMAME can now be closed by holding the start button for 0.75 seconds, similar to closing BoP2.0 and returning to the launch menu.
• PinMAME helmet lights now show a lightshow.
• PinMAME head motor is now controlled via the aux port. These PinMAME improvements are courtesy of Mark Sunnucks (a.k.a. Snux)! Thank you Mark for working with us to improve the emulated BoP experience.

Version 1.09 - November 27th 2014

• Nicer alphanumeric display simulation for PinMAME.
• PinMAME settings are now carried over when updating.
• Added "Player Profiles" menu to the service menu. Basic functionality right now allows to edit and delete existing profiles.
• Colorized launch menu.
• Colorized PIN*BOT spelling.
• Colorized Values Doubled status bar.
• Added setting "Adjustment Menu -> Rules -> Wheel -> Small Wheel -> EB mode -> Lanes can unlite". By default the extra ball lanes during the EB mode now can't unlite to avoid confusion. Also double switch hits (ball bouncing when falling out of the left ramp) won't register double hits anymore - except if you skillfully do a lane change in between (for Shatzing the inlane).
• Improved performance of service menu.
• Bugfix: Bonus total is now correctly displayed (what was previously displayed was the unmultiplied total, even though the awarded score was multiplied).
• Bugfix: a selected profile's initials would get overwritten if a logged in user switched to a "new" profile.
• Bugfix: skipping the "Player X Shoot Again" animation would freeze the game.
• Bugfix: pressing the start button during some profile related yes/no prompts would crash the game.

Version 1.08 - November 13th 2014

• Initial release.