Warning

This documentation is for an unreleased version of MPF!

This is the developer documentation for MPF 0.51, which is the “dev” (next) release of MPF that is a work-in-progress. Use the “Read the Docs” link in the lower left corner to view the developer docs for the version of MPF you’re using.

self.machine.multiballs.*

class mpf.devices.multiball.Multiball(*args, **kwargs)

Bases: mpf.core.system_wide_device.SystemWideDevice, mpf.core.mode_device.ModeDevice

Multiball device for MPF.

Accessing multiballs in code

The device collection which contains the multiballs in your machine is available via self.machine.multiballs. For example, to access one called “foo”, you would use self.machine.multiballs.foo. You can also access multiballs in dictionary form, e.g. self.machine.multiballs['foo'].

You can also get devices by tag or hardware number. See the DeviceCollection documentation for details.

Methods & Attributes

Multiballs have the following methods & attributes available. Note that methods & attributes inherited from base classes are not included here.

add_a_ball(**kwargs)

Add a ball if multiball has started.

disable(**kwargs)

Disable the multiball.

If the multiball is not enabled, it cannot start. Will not stop a running multiball.

Parameters:**kwargs – unused
enable(**kwargs)

Enable the multiball.

If the multiball is not enabled, it cannot start.

Parameters:**kwargs – unused
raise_config_error(msg, error_no, *, context=None)

Raise a ConfigFileError exception.

reset(**kwargs)

Reset the multiball and disable it.

Parameters:**kwargs – unused
start(**kwargs)

Start multiball.

start_or_add_a_ball(**kwargs)

Start multiball or add a ball if multiball has started.

stop(**kwargs)

Stop shoot again.