self.machine.extra_balls.*

class mpf.devices.extra_ball.ExtraBall(machine, name)

Bases: mpf.core.mode_device.ModeDevice

An extra ball which can be awarded once per player.

Accessing extra_balls in code

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

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

Methods & Attributes

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

award(**kwargs)

Award extra ball to player if enabled.

reset(**kwargs)

Reset extra ball.

Does not reset the additional ball the player received. Only resets the device and allows to award another extra ball to the player.