fix(core): correct DamageType's rotated bits and ItemType's shifted craft ladder

Two enums disagreed with the retail client, and both disagreements were the
quiet kind - nothing read the wrong members, so nothing was visibly broken. They
were traps armed for the first person to write a comparison against them.

DamageType had its four drain/restore bits rotated. acdream assigned
Nether/Mana/Health/Stamina to 0x80/0x100/0x200/0x400; retail's DAMAGE_TYPE
(acclient.h:3788) assigns Health/Stamina/Mana/Nether. The ACE weenie corpus
attests retail's order independently - 0x100 Stamina, 0x200 Mana, 0x400 Nether -
and so does the vendored client-side enum catalog. Tellingly, both of acdream's
live damage-type name tables, CombatChatTranslator.FormatDamageType (ported from
holtburger) and ItemAppraisalTextFormatter.TryDamageTypeName, already used
retail's order reading the raw wire uint directly. The enum was the only thing in
the tree that was wrong. Retail's BASE_DAMAGE_TYPE (0x10000000) was also missing;
CombatChatTranslator already knew about it.

ItemType had two separate problems. The craft ladder was shifted one bit:
CraftAlchemyIntermediate sat on 0x02000000, which retail leaves unused, and an
invented CraftCookingIntermediate occupied 0x04000000, which is retail's real
alchemy-intermediate bit. The weenie corpus attests 0x04000000 as
Craft_Alchemy_Intermediate 235 times and contains no cooking-intermediate at all -
there is no such item type. Separately, the composite masks were recomputed
locally from the bits above them instead of transcribed, which is exactly how the
ladder drifted in the first place. That made Weapon (retail 0x101, melee|missile)
an exact alias of WeaponOrCaster (0x8101), and left Item at 0x830F where retail's
TYPE_ITEM is 0x2DFBEF - a mask two orders of magnitude broader. The composites are
now transcribed as literals with retail's value, not derived, and the five
retail-only masks acdream never had (portal/lockable magic targets, the
enchantable and redirectable targets, and the two vendor masks) come along.

Note for the reader wondering why the campaign trusted retail over the catalog
here: on CraftFletchingBase the catalog is the one that is wrong (it says
0x02000000; retail and acdream both say 0x01000000). No single oracle was assumed
correct - retail's header decided, with the weenie corpus as the tiebreak.

Behavior: no production code reads any changed member. The only reference in the
tree is a test that wants a nonzero HookItemTypes and does not care which. So no
branch changes and no wire behavior moves - but the values did change, which is
why this is a fix commit and not a data commit. No divergence-register row: these
were unintentional errors, now retired, not deviations we chose.

RetailEnumConformanceTests pins both enums to the acclient.h tables, asserts
acdream declares nothing retail does not, and calls out the two specific traps -
that 0x02000000 stays unclaimed, and that Weapon and WeaponOrCaster are no longer
the same value.

Core tests 3,726 -> 3,785.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
Erik 2026-07-29 01:21:10 +02:00
parent 251dd68a92
commit f3e95a3ebd
3 changed files with 196 additions and 13 deletions

View file

@ -0,0 +1,152 @@
using System;
using System.Linq;
using AcDream.Core.Combat;
using AcDream.Core.Items;
using Xunit;
namespace AcDream.Core.Tests.Properties;
/// <summary>
/// Pins the wire-adjacent enums acdream shares with the retail client to the values
/// in the Sept 2013 EoR header, <c>docs/research/named-retail/acclient.h</c>. Each
/// table below is transcribed from the cited <c>enum</c> block, so a hand edit that
/// drifts from retail fails here.
///
/// <para>These tables are the reason the 2026-07-29 enum campaign found real bugs:
/// <see cref="DamageType"/> had its four drain/restore bits rotated, and
/// <see cref="ItemType"/> had a shifted craft ladder plus locally recomputed composite
/// masks. Both are corrected and pinned below.</para>
/// </summary>
public sealed class RetailEnumConformanceTests
{
/// <summary>acclient.h:3788, <c>enum DAMAGE_TYPE</c>. FORCE_*_32_BIT omitted.</summary>
public static TheoryData<string, uint> RetailDamageType => new()
{
{ "Undef", 0x0 },
{ "Slash", 0x1 },
{ "Pierce", 0x2 },
{ "Bludgeon", 0x4 },
{ "Cold", 0x8 },
{ "Fire", 0x10 },
{ "Acid", 0x20 },
{ "Electric", 0x40 },
{ "Health", 0x80 },
{ "Stamina", 0x100 },
{ "Mana", 0x200 },
{ "Nether", 0x400 },
{ "Base", 0x10000000 },
};
[Theory]
[MemberData(nameof(RetailDamageType))]
public void DamageTypeMatchesRetail(string name, uint value)
{
Assert.True(Enum.IsDefined(typeof(DamageType), name),
$"DamageType.{name} is missing");
Assert.Equal(value, (uint)Enum.Parse<DamageType>(name));
}
[Fact]
public void DamageTypeDeclaresNothingRetailDoesNot()
{
var expected = RetailDamageType.Select(r => (string)r[0]).OrderBy(n => n, StringComparer.Ordinal);
var actual = Enum.GetNames<DamageType>().OrderBy(n => n, StringComparer.Ordinal);
Assert.Equal(expected, actual);
}
/// <summary>
/// acclient.h:3300, <c>enum ITEM_TYPE</c>. TYPE_UNDEF and TYPE_SELF both sit on 0
/// in retail; acdream spells that single zero <c>None</c>. FORCE_*_32_BIT omitted.
/// </summary>
public static TheoryData<string, uint> RetailItemType => new()
{
{ "None", 0x0 },
{ "MeleeWeapon", 0x1 },
{ "Armor", 0x2 },
{ "Vestements", 0x6 },
{ "Clothing", 0x4 },
{ "Jewelry", 0x8 },
{ "Creature", 0x10 },
{ "Food", 0x20 },
{ "Money", 0x40 },
{ "Misc", 0x80 },
{ "MissileWeapon", 0x100 },
{ "Weapon", 0x101 },
{ "Container", 0x200 },
{ "LockableMagicTarget", 0x280 },
{ "Useless", 0x400 },
{ "Gem", 0x800 },
{ "SpellComponents", 0x1000 },
{ "Writable", 0x2000 },
{ "Key", 0x4000 },
{ "Caster", 0x8000 },
{ "WeaponOrCaster", 0x8101 },
{ "RedirectableItemEnchantmentTarget", 0x8107 },
{ "Portal", 0x10000 },
{ "Lockable", 0x20000 },
{ "PromissoryNote", 0x40000 },
{ "ManaStone", 0x80000 },
{ "ItemEnchantableTarget", 0x88B8F },
{ "Service", 0x100000 },
{ "MagicWieldable", 0x200000 },
{ "Item", 0x2DFBEF },
{ "CraftCookingBase", 0x400000 },
{ "VendorGrocer", 0x446220 },
{ "CraftAlchemyBase", 0x800000 },
{ "CraftFletchingBase", 0x1000000 },
{ "CraftAlchemyIntermediate", 0x4000000 },
{ "CraftFletchingIntermediate", 0x8000000 },
{ "LifeStone", 0x10000000 },
{ "PortalMagicTarget", 0x10010000 },
{ "TinkeringTool", 0x20000000 },
{ "TinkeringMaterial", 0x40000000 },
{ "VendorShopkeep", 0x480467A7 },
{ "Gameboard", 0x80000000 },
};
[Theory]
[MemberData(nameof(RetailItemType))]
public void ItemTypeMatchesRetail(string name, uint value)
{
Assert.True(Enum.IsDefined(typeof(ItemType), name),
$"ItemType.{name} is missing");
Assert.Equal(value, (uint)Enum.Parse<ItemType>(name));
}
[Fact]
public void ItemTypeDeclaresNothingRetailDoesNot()
{
var expected = RetailItemType.Select(r => (string)r[0]).OrderBy(n => n, StringComparer.Ordinal);
var actual = Enum.GetNames<ItemType>().OrderBy(n => n, StringComparer.Ordinal);
Assert.Equal(expected, actual);
}
/// <summary>
/// The craft ladder specifically: retail leaves 0x02000000 unused, and the ACE
/// weenie corpus attests 0x04000000 as Craft_Alchemy_Intermediate 235 times. This
/// is the pairing acdream had wrong.
/// </summary>
[Fact]
public void CraftLadderMatchesRetailAndLeavesTheUnusedBitUnclaimed()
{
Assert.Equal(0x00400000u, (uint)ItemType.CraftCookingBase);
Assert.Equal(0x00800000u, (uint)ItemType.CraftAlchemyBase);
Assert.Equal(0x01000000u, (uint)ItemType.CraftFletchingBase);
Assert.Equal(0x04000000u, (uint)ItemType.CraftAlchemyIntermediate);
Assert.Equal(0x08000000u, (uint)ItemType.CraftFletchingIntermediate);
Assert.DoesNotContain(Enum.GetValues<ItemType>(), t => (uint)t == 0x02000000u);
}
/// <summary>
/// <c>Weapon</c> and <c>WeaponOrCaster</c> were aliases before the campaign, because
/// <c>Weapon</c> was recomputed locally as melee|missile|caster. Retail keeps them
/// distinct and only the latter includes the caster bit.
/// </summary>
[Fact]
public void WeaponExcludesCasterAndWeaponOrCasterIncludesIt()
{
Assert.NotEqual(ItemType.Weapon, ItemType.WeaponOrCaster);
Assert.Equal(ItemType.MeleeWeapon | ItemType.MissileWeapon, ItemType.Weapon);
Assert.Equal(ItemType.Weapon | ItemType.Caster, ItemType.WeaponOrCaster);
}
}