kimi gone wild

lib/odinsea/game/events.ex

@@ -0,0 +1,178 @@
+defmodule Odinsea.Game.Events do
+  @moduledoc """
+  Event type definitions and map IDs.
+  Ported from Java `server.events.MapleEventType`.
+
+  Each event type has associated map IDs where the event takes place.
+  """
+
+  @typedoc "Event type atom"
+  @type t :: :coconut | :coke_play | :fitness | :ola_ola | :ox_quiz | :survival | :snowball
+
+  # ============================================================================
+  # Event Map IDs
+  # ============================================================================
+
+  @event_maps %{
+    # Coconut event - team-based coconut hitting
+    coconut: [109080000],
+
+    # Coke Play event (similar to coconut)
+    coke_play: [109080010],
+
+    # Fitness event - 4 stage obstacle course
+    fitness: [109040000, 109040001, 109040002, 109040003, 109040004],
+
+    # Ola Ola event - 3 stage portal guessing game
+    ola_ola: [109030001, 109030002, 109030003],
+
+    # OX Quiz event - True/False quiz
+    ox_quiz: [109020001],
+
+    # Survival event - Last man standing (2 maps)
+    survival: [809040000, 809040100],
+
+    # Snowball event - Team snowball rolling competition
+    snowball: [109060000]
+  }
+
+  @doc """
+  Returns all event types.
+  """
+  def all do
+    Map.keys(@event_maps)
+  end
+
+  @doc """
+  Returns the map IDs for a given event type.
+
+  ## Examples
+
+      iex> Odinsea.Game.Events.map_ids(:coconut)
+      [109080000]
+
+      iex> Odinsea.Game.Events.map_ids(:fitness)
+      [109040000, 109040001, 109040002, 109040003, 109040004]
+  """
+  def map_ids(event_type) do
+    Map.get(@event_maps, event_type, [])
+  end
+
+  @doc """
+  Returns the entry map ID (first map) for an event type.
+  """
+  def entry_map_id(event_type) do
+    case map_ids(event_type) do
+      [first | _] -> first
+      [] -> nil
+    end
+  end
+
+  @doc """
+  Gets an event type by string name (case-insensitive).
+
+  ## Examples
+
+      iex> Odinsea.Game.Events.get_by_string("coconut")
+      :coconut
+
+      iex> Odinsea.Game.Events.get_by_string("OX_QUIZ")
+      :ox_quiz
+
+      iex> Odinsea.Game.Events.get_by_string("invalid")
+      nil
+  """
+  def get_by_string(str) when is_binary(str) do
+    str = String.downcase(str)
+
+    Enum.find(all(), fn type ->
+      Atom.to_string(type) == str or
+        String.replace(Atom.to_string(type), "_", "") == str
+    end)
+  end
+
+  def get_by_string(_), do: nil
+
+  @doc """
+  Returns a human-readable name for the event type.
+
+  ## Examples
+
+      iex> Odinsea.Game.Events.display_name(:coconut)
+      "Coconut"
+
+      iex> Odinsea.Game.Events.display_name(:ola_ola)
+      "Ola Ola"
+  """
+  def display_name(event_type) do
+    event_type
+    |> Atom.to_string()
+    |> String.replace("_", " ")
+    |> String.split()
+    |> Enum.map(&String.capitalize/1)
+    |> Enum.join(" ")
+  end
+
+  @doc """
+  Returns the number of stages/maps for an event.
+  """
+  def stage_count(event_type) do
+    length(map_ids(event_type))
+  end
+
+  @doc """
+  Checks if a map ID belongs to any event.
+  Returns the event type if found, nil otherwise.
+  """
+  def event_for_map(map_id) when is_integer(map_id) do
+    Enum.find(all(), fn type ->
+      map_id in map_ids(type)
+    end)
+  end
+
+  def event_for_map(_), do: nil
+
+  @doc """
+  Checks if a map ID is the finish map (109050000).
+  """
+  def finish_map?(109050000), do: true
+  def finish_map?(_), do: false
+
+  @doc """
+  Returns true if the event is a race-type event (timed).
+  """
+  def race_event?(:fitness), do: true
+  def race_event?(:ola_ola), do: true
+  def race_event?(:survival), do: true
+  def race_event?(_), do: false
+
+  @doc """
+  Returns true if the event is team-based.
+  """
+  def team_event?(:coconut), do: true
+  def team_event?(:snowball), do: true
+  def team_event?(_), do: false
+
+  @doc """
+  Returns true if the event has multiple stages.
+  """
+  def multi_stage?(event_type) do
+    stage_count(event_type) > 1
+  end
+
+  @doc """
+  Returns the stage index for a map ID within an event.
+  Returns 0-based index or nil if not part of event.
+  """
+  def stage_index(event_type, map_id) do
+    map_ids(event_type)
+    |> Enum.find_index(&(&1 == map_id))
+  end
+
+  @doc """
+  Returns all event data as a map.
+  """
+  def all_event_data do
+    @event_maps
+  end
+end