ModernUO/Projects/UOContent/Engines/ML Quests/MLQuest.cs
Kamron Batman 16bf3016fb
feat: Pre-Publish 14 Crafting (supersedes #2181, #2381) (#2476)
## Summary

Adds authentic **T2A-era (pre-UO:Third-Dawn) packet-based crafting menus**, enabled via the **`t2aCraftMenus` server setting** (read once at startup; default **`!Core.UOTD`**, so a pre-UO:TD shard gets them automatically). When enabled, double-clicking a crafting tool opens the classic `0x7C`/`0x7D` item-list menu — skill- and material-filtered — instead of the modern gump, covering all 8 tool/skill crafts (blacksmithy, tailoring, tinkering, carpentry, alchemy, bowcraft/fletching, inscription, cartography). It is **not** a runtime/admin-flippable feature flag.

This is the **definitive, reconciled** branch and **supersedes**:
- **#2181** (Delphi — `T2A_CraftingMenus`): the original effort.
- **#2381** (Jack/UOLL — `t2a_crafting_menus`): the research-grounded superset (Delphi's base + 12 corrections), rebased onto current `main`.

Original authorship is preserved across the cherry-picked history: foundation commit **@Delphi79**, mechanic fixes **@jackuoll (Jack Ward)**, reconciliation/fixes/docs mine.

## How it was built

1. Cherry-picked Jack's 13 commits onto current `main` (superset of Delphi's; only 2 trivial FeatureFlags conflicts).
2. Applied targeted fixes (below) with tests.
3. Full convention audit, build, and test pass.

Grounded in independent historical research plus Jack's deep dive. Maintainer reference: `dev-docs/t2a-crafting.md`.

## Mechanics (highlights)

- Double-click tool → target resource → skill/material-filtered menu → craft. Resource pre-selection per skill; make-last by targeting the tool.
- **Stacked-gem jewelry:** target a gem stack → the **full stack** is consumed and the piece is named by count ("a 1000 diamond ring"); count persists (`BaseJewel` serialization **v4 → v5**, new `_gemCount`).
- **Tool-less inscription & cartography** (skill-list invoked; no pen/sextant); inscription consumes reagents+scroll on success and failure, mana only on success.
- **Tailoring matching-hue consumption:** targeting hued cloth/leather consumes only that hue. Crafted items take color from their **`CraftResource`** (not the dyed hue), so dyed leather/cloth don't tint the product; in T2A only colored ingots/ore color items (metal armor/shields).
- **Half-resources on failed non-scroll crafts** (pre-UO:TD).
- **Maker's mark** always prompted for exceptional items, via the shared `QueryMakersMarkGump`.
- Server-side menu infra changes are additive (`ItemListEntry.CraftIndex`, `Entries` setter, `HasSent`).

## Notable changes on top of the cherry-pick

- **Toggle is a startup server setting, not a feature flag.** Removed `ContentFeatureFlags.T2ACraftMenus` (and its admin-flippable plumbing); the value is read once via `ServerConfiguration.GetSetting("t2aCraftMenus", !Core.UOTD)` into `T2ACraftSystem.Enabled`. Since the default tracks the era and it can't be flipped at runtime, there's no incoherent "menus-on / UO:TD-era" state.
- **Stacked-gem consumption (B3a/B3):** consume the full `PendingGemCount` (was deliberately consuming 1 while naming by the stack), null-safe gem type, plain-piece fallback + message. New `T2AJewelGemCraftTests`.
- **Convention audit:** `new List<Item>()` → `PooledRefList<Item>` on the hue-aware consume path; removed dead code.

## Decisions & deviations

- `make-last` kept as **QoL** (post-T2A gump-era feature).
- `half-on-failure` (non-scroll) kept as a **reconstruction** (not OSI-confirmed).
- **Stacked-gem** behavior set per shard authority (overrides the "single gem" reconstruction).
- **Cooking** out of scope (no T2A crafting menu existed for it).
- **No colored items from dyed materials:** crafted color comes from the `CraftResource` type. Pre-AOS leather has no colored variant, so leather is always uncolored; weapons retain resource color only in AOS+ (unchanged, intended).

## Test plan

- Automated: `dotnet build ModernUO.slnx -c Debug` clean; `dotnet test Projects/UOContent.Tests` → **421 passed** (incl. 3 new jewelry tests).
- Manual (needs a running T2A shard + client):
  - [ ] Each of the 8 skills opens the correct menu; empty-menu guard fires.
  - [ ] Make-last repeats the last craft (jewelry re-prompts gem).
  - [ ] Jewelry consumes the full targeted gem stack and names by count.
  - [ ] Cartography consumes blank maps only with T2A enabled / maps+scrolls when disabled.
  - [ ] Tailoring consumes only the targeted-hue material; crafted items are not tinted by dyed cloth/leather.
  - [ ] Maker's-mark prompt on exceptional.
  - [ ] Failed non-scroll craft consumes half resources.
  - [ ] Inscription: reagents+scroll on success/failure, mana only on success.
  - [ ] T2A disabled: gump crafting unchanged.

## Credits

Co-authored-by: @Delphi79
Co-authored-by: @jackuoll
2026-06-07 20:27:22 -07:00

307 lines
8.8 KiB
C#

using System;
using System.Collections.Generic;
using Server.Collections;
using Server.Engines.MLQuests.Gumps;
using Server.Engines.MLQuests.Objectives;
using Server.Engines.MLQuests.Rewards;
using Server.Engines.Spawners;
using Server.Mobiles;
namespace Server.Engines.MLQuests
{
public enum ObjectiveType
{
All,
Any
}
public class MLQuest
{
// You've completed a quest! Don't forget to collect your reward.
public static TextDefinition CompletionNoticeDefault = 1072273;
public static TextDefinition CompletionNoticeShort = 1046258; // Your quest is complete.
// Your quest is complete. Return for your reward.
public static TextDefinition CompletionNoticeShortReturn = 1073775;
// You obtained what you seek, now receive your reward.
public static TextDefinition CompletionNoticeCraft = 1073967;
public MLQuest()
{
Activated = false;
Objectives = new List<BaseObjective>();
ObjectiveType = ObjectiveType.All;
Rewards = new List<BaseReward>();
CompletionNotice = CompletionNoticeDefault;
Instances = new List<MLQuestInstance>();
SaveEnabled = true;
}
public bool Deserialized { get; set; }
public bool SaveEnabled { get; set; }
// TODO: Flags? (Deserialized, SaveEnabled, Activated)
public bool Activated { get; set; }
public List<BaseObjective> Objectives { get; set; }
public ObjectiveType ObjectiveType { get; set; }
public List<BaseReward> Rewards { get; set; }
public List<MLQuestInstance> Instances { get; set; }
public bool OneTimeOnly { get; set; }
public bool HasRestartDelay { get; set; }
public bool IsEscort => HasObjective<EscortObjective>();
public bool IsSkillTrainer => HasObjective<GainSkillObjective>();
public bool RequiresCollection => HasObjective<CollectObjective>() || HasObjective<DeliverObjective>();
public virtual bool RecordCompletion => OneTimeOnly || HasRestartDelay;
public virtual bool IsChainTriggered => false;
public virtual Type NextQuest => null;
public TextDefinition Title { get; set; }
public TextDefinition Description { get; set; }
public TextDefinition RefusalMessage { get; set; }
public TextDefinition InProgressMessage { get; set; }
public TextDefinition CompletionMessage { get; set; }
public TextDefinition CompletionNotice { get; set; }
public virtual int Version => 0;
public bool HasObjective<T>() where T : BaseObjective
{
foreach (var obj in Objectives)
{
if (obj is T)
{
return true;
}
}
return false;
}
public virtual void Generate()
{
if (MLQuestSystem.Debug)
{
Console.WriteLine("INFO: Generating quest: {0}", GetType());
}
}
public MLQuestInstance CreateInstance(IQuestGiver quester, PlayerMobile pm) =>
new(this, quester, pm);
public bool CanOffer(IQuestGiver quester, PlayerMobile pm, bool message) =>
CanOffer(quester, pm, MLQuestSystem.GetContext(pm), message);
public virtual bool CanOffer(IQuestGiver quester, PlayerMobile pm, MLQuestContext context, bool message)
{
if (!Activated || quester.Deleted)
{
return false;
}
if (context != null)
{
if (context.IsFull)
{
if (message)
{
MLQuestSystem.Tell(quester, pm, 1080107); // I'm sorry, I have nothing for you at this time.
}
return false;
}
var checkQuest = this;
while (checkQuest != null)
{
if (context.HasDoneQuest(checkQuest, out var nextAvailable))
{
if (checkQuest.OneTimeOnly)
{
if (message)
{
MLQuestSystem.Tell(quester, pm, 1075454); // I cannot offer you the quest again.
}
return false;
}
if (nextAvailable > Core.Now)
{
if (message)
{
// I'm sorry, but I don't have anything else for you right now.
// Could you check back with me in a few minutes?
MLQuestSystem.Tell(quester, pm, 1075575);
}
return false;
}
}
if (checkQuest.NextQuest == null)
{
break;
}
checkQuest = MLQuestSystem.FindQuest(checkQuest.NextQuest);
}
}
foreach (var obj in Objectives)
{
if (!obj.CanOffer(quester, pm, message))
{
return false;
}
}
return true;
}
public virtual void SendOffer(IQuestGiver quester, PlayerMobile pm)
{
QuestOfferGump.DisplayTo(pm, this, quester);
}
public virtual void OnAccept(IQuestGiver quester, PlayerMobile pm)
{
if (!CanOffer(quester, pm, true))
{
return;
}
var instance = CreateInstance(quester, pm);
pm.SendLocalizedMessage(1049019); // You have accepted the Quest.
pm.SendSound(0x2E7); // private sound
OnAccepted(instance);
foreach (var obj in instance.Objectives)
{
obj.OnQuestAccepted();
}
}
public virtual void OnAccepted(MLQuestInstance instance)
{
}
public virtual void OnRefuse(IQuestGiver quester, PlayerMobile pm)
{
QuestConversationGump.DisplayTo(pm, this, RefusalMessage);
}
public virtual void GetRewards(MLQuestInstance instance)
{
instance.SendRewardGump();
}
public virtual void OnRewardClaimed(MLQuestInstance instance)
{
}
public virtual void OnCancel(MLQuestInstance instance)
{
}
public virtual void OnQuesterDeleted(MLQuestInstance instance)
{
}
public virtual void OnPlayerDeath(MLQuestInstance instance)
{
}
public virtual TimeSpan GetRestartDelay() => TimeSpan.FromSeconds(Utility.Random(1, 5) * 30);
public static void Serialize(IGenericWriter writer, MLQuest quest)
{
MLQuestSystem.WriteQuestRef(writer, quest);
writer.Write(quest.Version);
}
public static void Deserialize(IGenericReader reader, int version)
{
var quest = MLQuestSystem.ReadQuestRef(reader);
var oldVersion = reader.ReadInt();
if (quest == null)
{
return; // not saved or no longer exists
}
quest.Refresh(oldVersion);
quest.Deserialized = true;
}
public virtual void Refresh(int oldVersion)
{
}
public void PutSpawner(Spawner s, Point3D loc, Map map)
{
var name = $"MLQS-{GetType().Name}";
using var queue = PooledRefQueue<Item>.Create();
foreach (var item in map.GetItemsAt(loc))
{
// This predates GUIDs. Let's build these spawners and export them so we can delete this code!
if (item is BaseSpawner spawner && spawner.Name == name)
{
queue.Enqueue(item);
}
}
while (queue.Count > 0)
{
queue.Dequeue().Delete();
}
s.Name = name;
s.MoveToWorld(loc, map);
}
public static void PutDeco(Item deco, Point3D loc, Map map)
{
using var queue = PooledRefQueue<Item>.Create();
foreach (var item in map.GetItemsAt(loc))
{
if (item.ItemID == deco.ItemID && item.Z == loc.Z)
{
queue.Enqueue(item);
}
}
while (queue.Count > 0)
{
queue.Dequeue().Delete();
}
deco.MoveToWorld(loc, map);
}
}
}