vh-bombsquad-modded-server-files/dist/ba_data/python/bastd/actor/spawner.py

# Released under the MIT License. See LICENSE for details.
#
"""Defines some lovely Actor(s)."""

from __future__ import annotations

from typing import TYPE_CHECKING

import ba

if TYPE_CHECKING:
    from typing import Any, Sequence, Callable


# FIXME: Should make this an Actor.
class Spawner:
    """Utility for delayed spawning of objects.

    Category: **Gameplay Classes**

    Creates a light flash and sends a Spawner.SpawnMessage
    to the current activity after a delay.
    """

    class SpawnMessage:
        """Spawn message sent by a Spawner after its delay has passed.

        Category: **Message Classes**
        """

        spawner: Spawner
        """The ba.Spawner we came from."""

        data: Any
        """The data object passed by the user."""

        pt: Sequence[float]
        """The spawn position."""

        def __init__(
            self,
            spawner: Spawner,
            data: Any,
            pt: Sequence[float],  # pylint: disable=invalid-name
        ):
            """Instantiate with the given values."""
            self.spawner = spawner
            self.data = data
            self.pt = pt  # pylint: disable=invalid-name

    def __init__(
        self,
        data: Any = None,
        pt: Sequence[float] = (0, 0, 0),  # pylint: disable=invalid-name
        spawn_time: float = 1.0,
        send_spawn_message: bool = True,
        spawn_callback: Callable[[], Any] | None = None,
    ):
        """Instantiate a Spawner.

        Requires some custom data, a position,
        and a spawn-time in seconds.
        """
        self._spawn_callback = spawn_callback
        self._send_spawn_message = send_spawn_message
        self._spawner_sound = ba.getsound('swip2')
        self._data = data
        self._pt = pt
        # create a light where the spawn will happen
        self._light = ba.newnode(
            'light',
            attrs={
                'position': tuple(pt),
                'radius': 0.1,
                'color': (1.0, 0.1, 0.1),
                'lights_volumes': False,
            },
        )
        scl = float(spawn_time) / 3.75
        min_val = 0.4
        max_val = 0.7
        ba.playsound(self._spawner_sound, position=self._light.position)
        ba.animate(
            self._light,
            'intensity',
            {
                0.0: 0.0,
                0.25 * scl: max_val,
                0.500 * scl: min_val,
                0.750 * scl: max_val,
                1.000 * scl: min_val,
                1.250 * scl: 1.1 * max_val,
                1.500 * scl: min_val,
                1.750 * scl: 1.2 * max_val,
                2.000 * scl: min_val,
                2.250 * scl: 1.3 * max_val,
                2.500 * scl: min_val,
                2.750 * scl: 1.4 * max_val,
                3.000 * scl: min_val,
                3.250 * scl: 1.5 * max_val,
                3.500 * scl: min_val,
                3.750 * scl: 2.0,
                4.000 * scl: 0.0,
            },
        )
        ba.timer(spawn_time, self._spawn)

    def _spawn(self) -> None:
        ba.timer(1.0, self._light.delete)
        if self._spawn_callback is not None:
            self._spawn_callback()
        if self._send_spawn_message:
            # only run if our activity still exists
            activity = ba.getactivity()
            if activity is not None:
                activity.handlemessage(
                    self.SpawnMessage(self, self._data, self._pt)
                )