    module Game.LambdaHack.Client.UI.TutorialHints
      ( TutorialHints (..)
      , renderTutorialHints
      ) where

    import Prelude ()

    import Game.LambdaHack.Core.Prelude

    data TutorialHints =
        DamageOfDifferentKind
      | NewFloorNewOpportunity
      | CannotHarmYouInMelee
      | CaughtProjectile
      | HitsWithNoDirectDamage
      | TemporaryConditions
      | WokenUpActors
      | AvoidWalkingEnemies
      | AlotOfDamageFromOneSource
      | TerrainNotFullyKnown
      | OutOfSightEvents
      | HearingRadius
      | SwitchTeammate
      | MeleeEnemies
      | UseTerrainEffect
      | SwitchPointmanAndAvoidMeleeAlone
      | SwitchPointmanAndSoftenFoes

    -- | Generate the standard textual representation for the tutorial hints.
    renderTutorialHints :: TutorialHints -> Text
    renderTutorialHints :: TutorialHints -> Text
    renderTutorialHints = \case
      TutorialHints
    DamageOfDifferentKind ->
        Text
    "You took damage of a different kind than the normal piercing hit, which means your armor couldn't block any part of it. Normally, your HP (hit points, health) do not regenerate, so losing them is a big deal. Apply healing concoctions or take a long sleep to replenish your HP (but in this hectic environment not even uninterrupted resting that leads to sleep is easy)."
      TutorialHints
    NewFloorNewOpportunity ->
        Text
    "New floor is new opportunities, though the old level is still there and others may roam it after you left. Viewing all floors, without moving between them, can be done using the '<' and '>' keys."
      TutorialHints
    CannotHarmYouInMelee ->
        Text
    "This enemy can't harm you in melee. Left alone could it possibly be of some use?"
      TutorialHints
    CaughtProjectile ->
        Text
    "You managed to catch a projectile, thanks to being braced and hitting it exactly when it was at arm's reach. The obtained item has been put into the shared stash of your party."
      TutorialHints
    HitsWithNoDirectDamage ->
        Text
    "Some hits don't cause piercing, impact, burning nor any other direct damage. However, they can have other effects, bad, good or both."
      TutorialHints
    WokenUpActors ->
        Text
    "Woken up actors regain stats and skills, including sight radius and melee armor, over several turns."
      TutorialHints
    AvoidWalkingEnemies ->
        Text
    "To avoid waking enemies up, make sure they don't lose HP nor too much Calm through noises, particularly close ones. Beware, however, that they slowly regenerate HP as they sleep and eventually wake up at full HP."
      TutorialHints
    AlotOfDamageFromOneSource ->
        Text
    "You took a lot of damage from one source. If the danger persists, consider retreating towards your teammates or buffing up or an instant escape, if consumables permit."
      TutorialHints
    TemporaryConditions ->
        Text
    "Temporary conditions, especially the bad ones, pass quickly, usually after just a few turns. While active, they are listed in the '@' organ menu and the effects of most of them are seen in the '#' skill menu."
      TutorialHints
    TerrainNotFullyKnown ->
        Text
    "Solid terrain drawn in pink is not fully known until searched. This is usually done by bumping into it, which also triggers effects and transformations the terrain is capable of. Once revealed, the terrain can be inspected in aiming mode started with the '*' key or with mouse."
      TutorialHints
    OutOfSightEvents ->
        Text
    "Events out of your sight radius (as listed in the '#' skill menu) can sometimes be heard, depending on your hearing radius skill. Some, such as death shrieks, can always be heard regardless of skill and distance, including when they come from a different floor."
      TutorialHints
    HearingRadius ->
        Text
    "Enemies you can't see are sometimes heard yelling and emitting other noises. Whether you can hear them, depends on their distance and your hearing radius, as listed in the '#' skill menu."
      TutorialHints
    SwitchTeammate ->
        Text
    "You survive this mission, or die trying, as a team. After a few moves, feel free to switch the controlled teammate (marked on the map with the yellow box) using the Tab key to another party member (marked with a green box)."  -- assuming newbies don't remap their keys
      TutorialHints
    MeleeEnemies ->
        Text
    "Enemies are normally dealt with using melee (by bumping when adjacent) or ranged combat (by 'f'linging items at them)."
      TutorialHints
    UseTerrainEffect ->
        Text
    "Enemies can be dealt with not only via combat, but also with clever use of terrain effects, stealth (not emitting nor reflecting light) or hasty retreat (particularly when foes are asleep or drowsy)."
      TutorialHints
    SwitchPointmanAndAvoidMeleeAlone ->
        Text
    "When dealing with groups of enemies, remember than you fight as a team. Switch the pointman (marked on the map with the yellow box) using the Tab key until you move each teammate to a tactically advantageous position. Avoid meleeing alone."
      TutorialHints
    SwitchPointmanAndSoftenFoes ->
        Text
    "When dealing with groups of armed enemies, remember than you fight as a team. Switch the pointman (marked on the map with the yellow box) using the Tab key until you move each teammate to a tactically advantageous position. Retreat, if necessary to form a front line. Soften the foes with missiles, especially of exploding kind."