Draft: /clock command

.gitignore

@@ -371,5 +371,8 @@ omnisharp.json
 
 # local configuration
 debugGuilds.json
+token.json
+
+# gamecontent db
 GameContent.db
-token.json
+GameContent.db*

TheOracle2/AskTheOracle/AskOption.cs

@@ -0,0 +1,33 @@
+using System.ComponentModel.DataAnnotations;
+namespace TheOracle2;
+public enum AskOption
+{
+  [Display(Name = "Sure thing")]
+  SureThing = 90,
+  Likely = 75,
+  [Display(Name = "Fifty-fifty")]
+  FiftyFifty = 50,
+  Unlikely = 25,
+  [Display(Name = "Small chance")]
+  SmallChance = 10
+}
+
+public class AskDefs
+{
+  public Dictionary<int, string> ByNumber { get; set; }
+  public Dictionary<string, int> ByString { get; set; }
+
+  public AskDefs()
+  {
+    ByNumber = new()
+    {
+      { 10, "small chance" },
+      { 25, "unlikely" },
+      { 50, "fifty-fifty" },
+      { 75, "likely" },
+      { 90, "sure thing" }
+    };
+    ByString = new();
+  }
+}
+

TheOracle2/AskTheOracle/OracleAnswer.cs

@@ -0,0 +1,63 @@
+namespace TheOracle2.GameObjects;
+
+public class OracleAnswer : Die, IMatchable
+{
+  public OracleAnswer(Random random, int odds, string question) : base(random, 100)
+  {
+    if (odds is < 1 or > 99) { throw new ArgumentOutOfRangeException(nameof(odds), "Chance must be from 1 to 99, inclusive."); }
+    Question = question;
+    Odds = odds;
+  }
+  public string Question { get; set; }
+  public int Odds { get; }
+  public bool IsYes => Value <= Odds;
+  public bool IsMatch => MatchResults.Contains(Value);
+  private static readonly List<int> MatchResults = new() { 11, 22, 33, 44, 55, 66, 77, 88, 99, 100 };
+
+  public override string ToString()
+  {
+    return $"Rolled {Value} vs. {Odds}: **{AnswerString}**";
+  }
+  public Color OutcomeColor()
+  {
+    return IsYes switch
+    {
+      true => new Color(0x47AEDD),
+      false => new Color(0xC50933)
+    };
+  }
+  private static string MatchMessage => "You rolled a match! Envision an extreme result or twist.";
+  private string AnswerString
+  {
+    get
+    {
+      string str = IsYes ? "Yes" : "No";
+      if (IsMatch)
+      {
+        str = $"hell {str}!".ToUpperInvariant();
+      }
+      return str;
+    }
+  }
+  public static Dictionary<int, string> OddsString => new()
+  {
+    { 10, "Small chance" },
+    { 25, "Unlikely" },
+    { 50, "50/50" },
+    { 75, "Likely" },
+    { 90, "Sure thing" }
+  };
+
+  public EmbedBuilder ToEmbed()
+  {
+    string authorString = $"Ask the Oracle: {OddsString[Odds]}";
+    string footerString = IsMatch ? MatchMessage : "";
+    return new EmbedBuilder()
+    .WithAuthor(authorString)
+    .WithDescription(ToString())
+    .WithTitle(Question.Length > 0 ? Question : "Ask the Oracle")
+    .WithFooter(footerString)
+    .WithColor(OutcomeColor())
+    ;
+  }
+}

TheOracle2/Clock/CampaignClock.cs

@@ -0,0 +1,39 @@
+namespace TheOracle2.GameObjects;
+public class CampaignClock : Clock
+{
+  public CampaignClock(Embed embed) : base(embed) { }
+
+  public CampaignClock(ClockSize segments, int filledSegments, string title, string description = "") : base(segments, filledSegments, title, description) { }
+  public override string EmbedCategory => "Campaign Clock";
+  public override string LogMessage => "The event is triggered or the project is complete. Envision the outcome and the impact on your setting.";
+
+  public SelectMenuBuilder MakeSelectMenu()
+  {
+    SelectMenuBuilder selectMenu = new SelectMenuBuilder()
+      .WithPlaceholder("Advance clock...")
+      .WithCustomId($"clock-menu:{Filled}/{Segments}")
+      .WithMinValues(0)
+      .WithMaxValues(1)
+      .AddOption("test", "test");
+    return selectMenu;
+  }
+  public override ComponentBuilder MakeComponents()
+  {
+    SelectMenuBuilder menu = new SelectMenuBuilder()
+        .WithCustomId($"clock-menu:{Filled}/{Segments}")
+        .WithMinValues(0);
+    if (!IsFull)
+    {
+      menu.AddOption(IClock.AdvanceOption());
+      foreach (AskOption odds in Enum.GetValues(typeof(AskOption)))
+      {
+        menu.AddOption(IClock.AdvanceAskOption(odds));
+      }
+    }
+    if (Filled != 0)
+    {
+      menu.AddOption(IClock.ResetOption());
+    }
+    return new ComponentBuilder().WithSelectMenu(menu);
+  }
+}

TheOracle2/Clock/Clock.cs

@@ -0,0 +1,57 @@
+namespace TheOracle2.GameObjects;
+
+public abstract class Clock : IClock
+{
+  protected Clock(Embed embed)
+  {
+    var values = IClock.ParseClock(embed);
+    Title = embed.Title;
+    Description = embed.Description;
+    Filled = values.Item1;
+    Segments = values.Item2;
+  }
+  protected Clock(ClockSize segments = (ClockSize)6, int filledSegments = 0, string title = "", string description = "")
+  {
+    if (filledSegments < 0 || filledSegments > ((int)segments))
+    {
+      throw new ArgumentOutOfRangeException(nameof(filledSegments), "filledSegments can't exceed segments");
+    }
+    Title = title;
+    Segments = (int)segments;
+    Filled = filledSegments;
+    Description = description;
+  }
+  public int Segments { get; }
+  public int Filled { get; set; }
+  public string Title { get; set; }
+  public string Description { get; set; }
+  public string Footer { get; set; }
+  public abstract string EmbedCategory { get; }
+  public string AlertFooter { get; }
+  public bool AlertOnIncrement { get; } = true;
+  public bool AlertOnDecrement { get; }
+  public bool LogOnIncrement { get; } = true;
+  public bool LogOnDecrement { get; } = true;
+  public bool IsFull => Filled >= Segments;
+
+  public virtual EmbedBuilder ToEmbed()
+  {
+    var embed = new EmbedBuilder()
+      .WithAuthor(EmbedCategory)
+      .WithTitle(Title)
+      .WithDescription(Description)
+    ;
+    return IClock.AddClockTemplate(embed, this);
+  }
+  public EmbedBuilder AlertEmbed()
+  {
+    return IClock.AlertStub(this);
+  }
+  public virtual string LogMessage => Filled == Segments ? "The clock fills!" : $"The clock advances to {Filled}/{Segments}";
+  public virtual ComponentBuilder MakeComponents()
+  {
+    return new ComponentBuilder()
+    .WithButton(IClock.AdvanceButton().WithDisabled(IsFull))
+    .WithButton(IClock.ResetButton().WithDisabled(Filled == 0));
+  }
+}

TheOracle2/Clock/ClockSize.cs

@@ -0,0 +1,31 @@
+using System.ComponentModel.DataAnnotations;
+using Discord.Interactions;
+namespace TheOracle2.GameObjects;
+
+// TODO: add display names once ChoiceDisplayAttribute is available
+public enum ClockSize
+{
+  [Display(Name = "4 segments")]
+  Four = 4,
+
+  [Display(Name = "6 segments")]
+  Six = 6,
+
+  [Display(Name = "8 segments")]
+  Eight = 8,
+
+  [Display(Name = "10 segments")]
+  Ten = 10
+}
+
+public enum SceneChallengeClockSize
+{
+  [Display(Name = "4 segments")]
+  Four = 4,
+
+  [Display(Name = "6 segments")]
+  Six = 6,
+
+  [Display(Name = "8 segments")]
+  Eight = 8,
+}