Interface PresetRegistry

public interface PresetRegistry
Provides the preset metadata used when submitting new maze requests.

Queries require the server thread and an enabled MazeEngine provider; otherwise they throw IllegalStateException. A successful reload changes subsequent queries, while previously returned snapshots remain intact.

These are the current configured presets. To inspect the settings retained by an existing maze, use MazeSnapshot.preset().

  • Method Summary

    Modifier and Type
    Method
    Description
    List<PresetSnapshot>
    all()
    Lists all currently configured presets in their display order.
    Optional<PresetSnapshot>
    find(String id)
    Looks up a configured preset by its case-insensitive identifier.

  • Method Details

    • all

      List<PresetSnapshot> all()
      Lists all currently configured presets in their display order.

      The default preset comes first. Other presets follow in display-name order, as prepared by the configuration loader.

      Returns:
      an immutable list of current preset snapshots

    • find

      Optional<PresetSnapshot> find(String id)
      Looks up a configured preset by its case-insensitive identifier.

      The lookup uses the identifier from configuration, not its player-facing display name. An unknown identifier produces an empty result.

      Parameters:
      id - the configured preset identifier
      Returns:
      the matching current preset, or empty when no preset has that identifier
      Throws:
      NullPointerException - if id is null