feat: Add Kanturu Refinery Tower event implementation

src/DataModel/Configuration/MiniGameType.cs

@@ -38,4 +38,9 @@ public enum MiniGameType
     /// The doppelganger event.
     /// </summary>
     Doppelganger,
+
+    /// <summary>
+    /// The Kanturu Refinery Tower event.
+    /// </summary>
+    Kanturu,
 }

src/GameLogic/MiniGames/IKanturuEventViewPlugIn.cs

@@ -0,0 +1,201 @@
+// <copyright file="IKanturuEventViewPlugIn.cs" company="MUnique">
+// Licensed under the MIT License. See LICENSE file in the project root for full license information.
+// </copyright>
+
+namespace MUnique.OpenMU.GameLogic.MiniGames;
+
+using MUnique.OpenMU.GameLogic.Views;
+
+/// <summary>
+/// View plugin interface for Kanturu-specific server-to-client packets (0xD1 group).
+/// Each method maps to one packet subcode.
+/// </summary>
+public interface IKanturuEventViewPlugIn : IViewPlugIn
+{
+    /// <summary>
+    /// Shows packet 0xD1/0x00 — Kanturu state info (response to NPC talk / info request).
+    /// This opens the <c>INTERFACE_KANTURU2ND_ENTERNPC</c> dialog on the client, showing
+    /// the current event state, how many players are inside, and whether entry is possible.
+    /// </summary>
+    /// <param name="state">Main event state.</param>
+    /// <param name="detailState">Detail state for the current main state.</param>
+    /// <param name="canEnter">True if entrance is open (Enter button enabled).</param>
+    /// <param name="userCount">Number of players currently inside the event map.</param>
+    /// <param name="remainTime">
+    /// Remaining time. Semantics depend on state:
+    /// Standby → time until the event opens (client shows minutes).
+    /// Tower   → time the tower has been open (client shows hours).
+    /// Otherwise zero.
+    /// </param>
+    ValueTask ShowStateInfoAsync(KanturuState state, byte detailState, bool canEnter, int userCount, TimeSpan remainTime);
+
+    /// <summary>
+    /// Shows packet 0xD1/0x01 — Kanturu enter result.
+    /// Sent after the player's entry attempt is processed.
+    /// On the client side this stops the NPC animation and closes the dialog.
+    /// On success the player is teleported before this is sent.
+    /// </summary>
+    /// <param name="success">True if the player was successfully entered; false otherwise.</param>
+    ValueTask ShowEnterResultAsync(bool success);
+
+    /// <summary>
+    /// Shows packet 0xD1/0x03 — Kanturu state change.
+    /// On the client side this:
+    ///   - Shows/hides the in-map HUD (<c>INTERFACE_KANTURU_INFO</c>).
+    ///   - Switches background music (Maya, Nightmare, Tower themes).
+    ///   - When <paramref name="state"/> == <see cref="KanturuState.Tower"/> and
+    ///     <paramref name="detailState"/> is <see cref="KanturuTowerDetailState.Revitalization"/> or <see cref="KanturuTowerDetailState.Notify"/>,
+    ///     reloads the success terrain file (<c>EncTerrain&lt;n&gt;01.att</c>), which visually removes the Elphis barrier.
+    /// </summary>
+    /// <param name="state">Main state.</param>
+    /// <param name="detailState">Detail state for the current main state.</param>
+    ValueTask ShowStateChangeAsync(KanturuState state, byte detailState);
+
+    /// <summary>
+    /// Shows packet 0xD1/0x04 — Kanturu battle result.
+    /// <list type="bullet">
+    ///   <item>False = failure — shows <c>Failure_kantru.tga</c> overlay.</item>
+    ///   <item>True = success — shows <c>Success_kantru.tga</c> overlay
+    ///     (only when client state is already <see cref="KanturuState.NightmareBattle"/>).</item>
+    /// </list>
+    /// </summary>
+    /// <param name="victory">True if the event was won; false if defeated.</param>
+    ValueTask ShowBattleResultAsync(bool victory);
+
+    /// <summary>
+    /// Shows packet 0xD1/0x05 — countdown timer for the Kanturu HUD.
+    /// The HUD divides by 1000 to get seconds and counts down visually.
+    /// </summary>
+    /// <param name="timeLimit">The time limit to display.</param>
+    ValueTask ShowTimeLimitAsync(TimeSpan timeLimit);
+
+    /// <summary>
+    /// Shows packet 0xD1/0x07 — remaining monster count and current user count.
+    /// Updates the numbers displayed in the Kanturu HUD.
+    /// </summary>
+    /// <param name="monsterCount">Number of monsters still alive in the current wave.</param>
+    /// <param name="userCount">Number of players currently inside the event map.</param>
+    ValueTask ShowMonsterUserCountAsync(int monsterCount, int userCount);
+
+    /// <summary>
+    /// Shows packet 0xD1/0x06 — Maya wide-area attack visual trigger.
+    /// The client calls <c>MayaSceneMayaAction(attackType)</c> on receipt, which plays
+    /// one of two client-side visual sequences on the Maya body object:
+    /// <list type="bullet">
+    ///   <item>Storm (true) = stone-storm effect (<c>MODEL_STORM3</c> + falling debris around Hero)</item>
+    ///   <item>Rain (false) = stone-rain effect (<c>MODEL_MAYASTONE</c> projectiles falling on Hero)</item>
+    /// </list>
+    /// This is a purely cosmetic broadcast — damage is handled by the server-side
+    /// <see cref="MonsterDefinition.AttackSkill"/> on Maya Hands (#362/#363).
+    /// </summary>
+    /// <param name="isStorm">True for storm visual; false for stone-rain visual.</param>
+    ValueTask ShowMayaWideAreaAttackAsync(bool isStorm);
+}
+
+/// <summary>
+/// Kanturu main state codes matching the client's <c>KANTURU_STATE_TYPE</c> enum.
+/// </summary>
+public enum KanturuState : byte
+{
+    /// <summary>No active state.</summary>
+    None = 0,
+
+    /// <summary>Waiting for players to enter.</summary>
+    Standby = 1,
+
+    /// <summary>Maya battle phase (Phases 1–3 + boss waves).</summary>
+    MayaBattle = 2,
+
+    /// <summary>Nightmare battle phase.</summary>
+    NightmareBattle = 3,
+
+    /// <summary>Tower of Refinement open (post-victory).</summary>
+    Tower = 4,
+
+    /// <summary>Event ended.</summary>
+    End = 5,
+}
+
+/// <summary>
+/// Detail state codes for the Nightmare battle phase,
+/// matching <c>KANTURU_NIGHTMARE_DIRECTION_TYPE</c>.
+/// </summary>
+public enum KanturuNightmareDetailState : byte
+{
+    /// <summary>No direction set.</summary>
+    None = 0,
+
+    /// <summary>Idle — Nightmare present but not yet in battle.</summary>
+    Idle = 1,
+
+    /// <summary>Nightmare intro animation.</summary>
+    NightmareIntro = 2,
+
+    /// <summary>Active battle — shows the HUD on the client.</summary>
+    Battle = 3,
+
+    /// <summary>Battle ended.</summary>
+    End = 4,
+}
+
+/// <summary>
+/// Detail state codes for the Tower of Refinement phase,
+/// matching <c>KANTURU_TOWER_STATE_TYPE</c>.
+/// </summary>
+public enum KanturuTowerDetailState : byte
+{
+    /// <summary>No tower state.</summary>
+    None = 0,
+
+    /// <summary>
+    /// Tower is open after Nightmare's defeat.
+    /// Sending this triggers the client to reload <c>EncTerrain&lt;n&gt;01.att</c>
+    /// (the success terrain), which visually removes the Elphis barrier.
+    /// </summary>
+    Revitalization = 1,
+
+    /// <summary>Tower closing soon — client warns players.</summary>
+    Notify = 2,
+
+    /// <summary>Tower closed.</summary>
+    Close = 3,
+}
+
+/// <summary>
+/// Detail state codes for the Maya battle phase,
+/// matching <c>KANTURU_MAYA_DIRECTION_TYPE</c>.
+/// </summary>
+public enum KanturuMayaDetailState : byte
+{
+    /// <summary>No direction.</summary>
+    None = 0,
+
+    /// <summary>Notify cinematic — camera pan + Maya rise animation (KANTURU_MAYA_DIRECTION_NOTIFY).</summary>
+    Notify = 2,
+
+    /// <summary>Phase 1 monster wave active — shows HUD.</summary>
+    Monster1 = 3,
+
+    /// <summary>Phase 1 boss (Maya Left Hand) — shows HUD.</summary>
+    Maya1 = 4,
+
+    /// <summary>Phase 2 monster wave active — shows HUD.</summary>
+    Monster2 = 8,
+
+    /// <summary>Phase 2 boss (Maya Right Hand) — shows HUD.</summary>
+    Maya2 = 9,
+
+    /// <summary>Phase 3 monster wave active — shows HUD.</summary>
+    Monster3 = 13,
+
+    /// <summary>Phase 3 bosses (both hands) — shows HUD.</summary>
+    Maya3 = 14,
+
+    /// <summary>
+    /// Maya phase 3 end cycle — triggers the full Maya explosion + player fall cinematic
+    /// (<c>KANTURU_MAYA_DIRECTION_ENDCYCLE_MAYA3 = 16</c> on the client).
+    /// Sending this via 0xD1/0x03 activates <c>Move2ndDirection()</c>:
+    /// camera pans to Maya room → <c>m_bMayaDie = true</c> (explosion) → <c>m_bDownHero = true</c> (fall).
+    /// </summary>
+    EndCycleMaya3 = 16,
+}