@rpg-engine/long-bow 0.8.202 → 0.8.205

package/src/stories/Features/marketplace/CharacterMarketplace.stories.tsx

@@ -37,8 +37,24 @@ const mockCharacterListings: ICharacterListing[] = [
       mode: 'Hardcore',
       skills: { sword: 10, shield: 8 },
       equipment: [
-        { slot: 'weapon', itemName: 'Broad Sword', itemKey: 'items/broad-sword', rarity: 'Common' },
-        { slot: 'armor', itemName: 'Steel Armor', itemKey: 'items/steel-armor', rarity: 'Rare' },
+        {
+          slot: 'rightHand',
+          itemName: 'Broad Sword',
+          itemKey: 'broad-sword',
+          rarity: 'Common',
+        },
+        {
+          slot: 'armor',
+          itemName: 'Jacket',
+          itemKey: 'jacket',
+          rarity: 'Rare',
+        },
+        {
+          slot: 'head',
+          itemName: 'Iron Helmet',
+          itemKey: 'iron-helmet',
+          rarity: 'Uncommon',
+        },
       ],
       textureKey: 'black-knight',
     },
@@ -61,7 +77,24 @@ const mockCharacterListings: ICharacterListing[] = [
       mode: 'Standard',
       skills: { fireball: 15, frostbolt: 12 },
       equipment: [
-        { slot: 'weapon', itemName: 'Fire Staff', itemKey: 'items/fire-staff', rarity: 'Epic' },
+        {
+          slot: 'rightHand',
+          itemName: 'Fire Staff',
+          itemKey: 'fire-staff',
+          rarity: 'Epic',
+        },
+        {
+          slot: 'armor',
+          itemName: 'Mystic Cape',
+          itemKey: 'mystic-cape',
+          rarity: 'Legendary',
+        },
+        {
+          slot: 'neck',
+          itemName: 'Bandana',
+          itemKey: 'bandana',
+          rarity: 'Rare',
+        },
       ],
       textureKey: 'pink-mage-1',
     },
@@ -84,7 +117,18 @@ const mockCharacterListings: ICharacterListing[] = [
       mode: 'Hardcore',
       skills: { stealth: 10, backstab: 12 },
       equipment: [
-        { slot: 'weapon', itemName: 'Dagger', itemKey: 'items/dagger', rarity: 'Uncommon' },
+        {
+          slot: 'rightHand',
+          itemName: 'Dagger',
+          itemKey: 'dagger',
+          rarity: 'Uncommon',
+        },
+        {
+          slot: 'neck',
+          itemName: 'Bandana',
+          itemKey: 'bandana',
+          rarity: 'Common',
+        },
       ],
       textureKey: 'redhair-girl-1',
     },
@@ -107,8 +151,24 @@ const mockCharacterListings: ICharacterListing[] = [
       mode: 'Standard',
       skills: { holy: 20, shield: 15 },
       equipment: [
-        { slot: 'weapon', itemName: 'Holy Sword', itemKey: 'items/holy-sword', rarity: 'Legendary' },
-        { slot: 'armor', itemName: 'Divine Armor', itemKey: 'items/divine-armor', rarity: 'Epic' },
+        {
+          slot: 'rightHand',
+          itemName: 'Angelic Sword',
+          itemKey: 'angelic-sword',
+          rarity: 'Legendary',
+        },
+        {
+          slot: 'armor',
+          itemName: 'Leather Jacket',
+          itemKey: 'leather-jacket',
+          rarity: 'Epic',
+        },
+        {
+          slot: 'head',
+          itemName: 'Iron Helmet',
+          itemKey: 'iron-helmet',
+          rarity: 'Rare',
+        },
       ],
       textureKey: 'dragon-knight',
     },
@@ -131,7 +191,18 @@ const mockCharacterListings: ICharacterListing[] = [
       mode: 'Standard',
       skills: { archery: 12, tracking: 8 },
       equipment: [
-        { slot: 'weapon', itemName: 'Longbow', itemKey: 'items/longbow', rarity: 'Rare' },
+        {
+          slot: 'rightHand',
+          itemName: 'Redwood Longbow',
+          itemKey: 'redwood-longbow',
+          rarity: 'Rare',
+        },
+        {
+          slot: 'head',
+          itemName: 'Hunters Cap',
+          itemKey: 'hunters-cap',
+          rarity: 'Uncommon',
+        },
       ],
       textureKey: 'pink-hair-girl-1',
     },
@@ -157,7 +228,18 @@ const mockMyCharacterListings: ICharacterListing[] = [
       mode: 'Standard',
       skills: { sword: 18, shield: 16 },
       equipment: [
-        { slot: 'weapon', itemName: 'Epic Sword', itemKey: 'items/epic-sword', rarity: 'Epic' },
+        {
+          slot: 'rightHand',
+          itemName: 'Knights Sword',
+          itemKey: 'knights-sword',
+          rarity: 'Epic',
+        },
+        {
+          slot: 'armor',
+          itemName: 'Leather Jacket',
+          itemKey: 'leather-jacket',
+          rarity: 'Rare',
+        },
       ],
       textureKey: 'black-knight',
     },
@@ -180,7 +262,18 @@ const mockMyCharacterListings: ICharacterListing[] = [
       mode: 'Standard',
       skills: { fireball: 8 },
       equipment: [
-        { slot: 'weapon', itemName: 'Basic Staff', itemKey: 'items/staff', rarity: 'Common' },
+        {
+          slot: 'rightHand',
+          itemName: 'Wooden Staff',
+          itemKey: 'wooden-staff',
+          rarity: 'Common',
+        },
+        {
+          slot: 'neck',
+          itemName: 'Bandana',
+          itemKey: 'bandana',
+          rarity: 'Common',
+        },
       ],
       textureKey: 'red-mage-1',
     },
@@ -277,7 +370,7 @@ CharacterBrowseEmpty.storyName = 'Empty State';
 export const CharacterBrowseFiltered: Story = () => (
   <RPGUIRoot>
     <CharacterMarketplacePanel
-      characterListings={mockCharacterListings.filter(l =>
+      characterListings={mockCharacterListings.filter((l) =>
         l.characterSnapshot.name.toLowerCase().includes('warrior')
       )}
       totalCount={2}
@@ -359,7 +452,8 @@ export const MyCharacterListingsNoEligible: Story = () => (
   </RPGUIRoot>
 );
 
-MyCharacterListingsNoEligible.storyName = 'My Listings - No eligible chars to list';
+MyCharacterListingsNoEligible.storyName =
+  'My Listings - No eligible chars to list';
 
 export const CharacterListingPending: Story = () => (
   <RPGUIRoot>

package/src/stories/Features/store/Store.stories.tsx

@@ -155,23 +155,99 @@ const characterSkinItems: IProductBlueprint[] = [
   }
 ];
 
-// Create duplicated items once with unique keys
-const duplicatedItems: IProductBlueprint[] = [
+// Showcase items for large number formatting
+const largePriceItems: IProductBlueprint[] = [
+  {
+    key: 'mega-booster',
+    name: 'Mega Booster',
+    description: 'A massive boost for high-end players.',
+    price: 15.00,
+    currency: PaymentCurrency.USD,
+    texturePath: 'items/angelic_sword_1.png',
+    textureAtlas: 'items',
+    textureKey: 'items/angelic_sword_1.png',
+    type: PurchaseType.Item,
+    dcPrice: 150000, // 150k
+    onPurchase: async () => { },
+    itemType: ItemType.Other,
+    itemSubType: ItemSubType.Other,
+    rarity: ItemRarities.Rare,
+    weight: 0,
+    isStackable: true,
+    maxStackSize: 99,
+    isUsable: true,
+  },
+  {
+    key: 'galactic-throne',
+    name: 'Galactic Throne',
+    description: 'The ultimate symbol of wealth.',
+    price: 99.99,
+    currency: PaymentCurrency.USD,
+    texturePath: 'items/throne.png',
+    textureAtlas: 'items',
+    textureKey: 'items/throne.png',
+    type: PurchaseType.Item,
+    dcPrice: 2500000, // 2.5M
+    onPurchase: async () => { },
+    itemType: ItemType.Other,
+    itemSubType: ItemSubType.Other,
+    rarity: ItemRarities.Epic,
+    weight: 10,
+    isStackable: false,
+    maxStackSize: 1,
+    isUsable: true,
+  },
+  {
+    key: 'godly-artifact',
+    name: 'Godly Artifact',
+    description: 'Relic from ancient times.',
+    price: 1000.00,
+    currency: PaymentCurrency.USD,
+    texturePath: 'items/staff_1.png',
+    textureAtlas: 'items',
+    textureKey: 'items/staff_1.png',
+    type: PurchaseType.Item,
+    dcPrice: 1600000000, // 1.6B
+    onPurchase: async () => { },
+    itemType: ItemType.Other,
+    itemSubType: ItemSubType.Other,
+    rarity: ItemRarities.Legendary,
+    weight: 0,
+    isStackable: false,
+    maxStackSize: 1,
+    isUsable: true,
+  }
+];
+
+// Create Social Crystal item
+const socialCrystalItem: IProductBlueprint = {
+  key: 'social-crystal',
+  name: 'Social Crystal',
+  description: 'A mysterious crystal that resonates with social energy. Use it to unlock community rewards!',
+  price: 4.99,
+  currency: PaymentCurrency.USD,
+  texturePath: 'books/soul-crystal.png',
+  textureAtlas: 'items',
+  textureKey: 'books/soul-crystal.png',
+  type: PurchaseType.Item,
+  dcPrice: 250,
+  onPurchase: async () => { },
+  itemType: ItemType.Other,
+  itemSubType: ItemSubType.Other,
+  rarity: ItemRarities.Rare,
+  weight: 0,
+  isStackable: true,
+  maxStackSize: 99,
+  isUsable: true,
+};
+
+// Cleaned up items list without "junk" duplicates
+const allStoreItems: IProductBlueprint[] = [
   ...storeItems,
   characterNameChangeItem,
   ...characterSkinItems,
-  ...storeItems.map((item, index) => ({
-    ...item,
-    key: `copy1-${item.key}-${index}`,
-  })),
-  ...storeItems.map((item, index) => ({
-    ...item,
-    key: `copy2-${item.key}-${index}`,
-  })),
-  ...storeItems.map((item, index) => ({
-    ...item,
-    key: `copy3-${item.key}-${index}`,
-  })),
+  socialCrystalItem,
+  ...largePriceItems,
 ];
 
 // Mock packs data
@@ -227,7 +303,7 @@ const mockPacks: IItemPack[] = [
 export const Default: Story = {
   render: () => (
     <Store
-      items={duplicatedItems}
+      items={allStoreItems}
       packs={mockPacks}
       userAccountType={UserAccountTypes.Free}
       onPurchase={(purchase: Partial<IPurchase>) => {
@@ -235,7 +311,7 @@ export const Default: Story = {
         return Promise.resolve(true);
       }}
       customWalletContent={<DCWalletContent
-        dcBalance={1200}
+        dcBalance={150000000} // 150M
         historyData={{ transactions: [], totalPages: 1, currentPage: 1 }}
         historyLoading={false}
         onRequestHistory={() => {}}
@@ -274,7 +350,9 @@ export const Default: Story = {
         'original-greater-life-potion-0': { originalPrice: 15.00 },
         'character-name-change': { originalPrice: 15.00 },
         'skin-character-customization': { originalPrice: 20.00 },
-        'starter-pack': { originalPrice: 9.99 }
+        'starter-pack': { originalPrice: 9.99 },
+        'mega-booster': { originalPrice: 200000 },
+        'godly-artifact': { originalPrice: 2500000000 }
       }}
     />
   ),
@@ -284,7 +362,7 @@ export const Default: Story = {
 export const BRL: Story = {
   render: () => (
     <Store
-      items={duplicatedItems}
+      items={allStoreItems}
       packs={mockPacks}
       userAccountType={UserAccountTypes.Free}
       onPurchase={(purchase: Partial<IPurchase>) => {
@@ -292,7 +370,7 @@ export const BRL: Story = {
         return Promise.resolve(true);
       }}
       customWalletContent={<DCWalletContent
-        dcBalance={1200}
+        dcBalance={150000000} // 150M
         historyData={{ transactions: [], totalPages: 1, currentPage: 1 }}
         historyLoading={false}
         onRequestHistory={() => {}}
@@ -331,7 +409,9 @@ export const BRL: Story = {
         'original-greater-life-potion-0': { originalPrice: 15.00 },
         'character-name-change': { originalPrice: 15.00 },
         'skin-character-customization': { originalPrice: 20.00 },
-        'starter-pack': { originalPrice: 9.99 }
+        'starter-pack': { originalPrice: 9.99 },
+        'mega-booster': { originalPrice: 200000 },
+        'godly-artifact': { originalPrice: 2500000000 }
       }}
     />
   ),
@@ -341,7 +421,7 @@ export const BRL: Story = {
 export const EUR: Story = {
   render: () => (
     <Store
-      items={duplicatedItems}
+      items={allStoreItems}
       packs={mockPacks}
       userAccountType={UserAccountTypes.Free}
       onPurchase={(purchase: Partial<IPurchase>) => {
@@ -349,7 +429,7 @@ export const EUR: Story = {
         return Promise.resolve(true);
       }}
       customWalletContent={<DCWalletContent
-        dcBalance={1200}
+        dcBalance={150000000} // 150M
         historyData={{ transactions: [], totalPages: 1, currentPage: 1 }}
         historyLoading={false}
         onRequestHistory={() => {}}
@@ -388,7 +468,9 @@ export const EUR: Story = {
         'original-greater-life-potion-0': { originalPrice: 15.00 },
         'character-name-change': { originalPrice: 15.00 },
         'skin-character-customization': { originalPrice: 20.00 },
-        'starter-pack': { originalPrice: 9.99 }
+        'starter-pack': { originalPrice: 9.99 },
+        'mega-booster': { originalPrice: 200000 },
+        'godly-artifact': { originalPrice: 2500000000 }
       }}
     />
   ),
@@ -398,7 +480,7 @@ export const EUR: Story = {
 export const GBP: Story = {
   render: () => (
     <Store
-      items={duplicatedItems}
+      items={allStoreItems}
       packs={mockPacks}
       userAccountType={UserAccountTypes.Free}
       onPurchase={(purchase: Partial<IPurchase>) => {
@@ -406,7 +488,7 @@ export const GBP: Story = {
         return Promise.resolve(true);
       }}
       customWalletContent={<DCWalletContent
-        dcBalance={1200}
+        dcBalance={150000000} // 150M
         historyData={{ transactions: [], totalPages: 1, currentPage: 1 }}
         historyLoading={false}
         onRequestHistory={() => {}}
@@ -445,7 +527,9 @@ export const GBP: Story = {
         'original-greater-life-potion-0': { originalPrice: 15.00 },
         'character-name-change': { originalPrice: 15.00 },
         'skin-character-customization': { originalPrice: 20.00 },
-        'starter-pack': { originalPrice: 9.99 }
+        'starter-pack': { originalPrice: 9.99 },
+        'mega-booster': { originalPrice: 200000 },
+        'godly-artifact': { originalPrice: 2500000000 }
       }}
     />
   ),
@@ -455,7 +539,7 @@ export const GBP: Story = {
 export const JPY: Story = {
   render: () => (
     <Store
-      items={duplicatedItems}
+      items={allStoreItems}
       packs={mockPacks}
       userAccountType={UserAccountTypes.Free}
       onPurchase={(purchase: Partial<IPurchase>) => {
@@ -463,7 +547,7 @@ export const JPY: Story = {
         return Promise.resolve(true);
       }}
       customWalletContent={<DCWalletContent
-        dcBalance={1200}
+        dcBalance={150000000} // 150M
         historyData={{ transactions: [], totalPages: 1, currentPage: 1 }}
         historyLoading={false}
         onRequestHistory={() => {}}
@@ -502,7 +586,9 @@ export const JPY: Story = {
         'original-greater-life-potion-0': { originalPrice: 15.00 },
         'character-name-change': { originalPrice: 15.00 },
         'skin-character-customization': { originalPrice: 20.00 },
-        'starter-pack': { originalPrice: 9.99 }
+        'starter-pack': { originalPrice: 9.99 },
+        'mega-booster': { originalPrice: 200000 },
+        'godly-artifact': { originalPrice: 2500000000 }
       }}
     />
   ),
@@ -512,7 +598,7 @@ export const JPY: Story = {
 export const INR: Story = {
   render: () => (
     <Store
-      items={duplicatedItems}
+      items={allStoreItems}
       packs={mockPacks}
       userAccountType={UserAccountTypes.Free}
       onPurchase={(purchase: Partial<IPurchase>) => {
@@ -520,7 +606,7 @@ export const INR: Story = {
         return Promise.resolve(true);
       }}
       customWalletContent={<DCWalletContent
-        dcBalance={1200}
+        dcBalance={150000000} // 150M
         historyData={{ transactions: [], totalPages: 1, currentPage: 1 }}
         historyLoading={false}
         onRequestHistory={() => {}}
@@ -559,7 +645,9 @@ export const INR: Story = {
         'original-greater-life-potion-0': { originalPrice: 15.00 },
         'character-name-change': { originalPrice: 15.00 },
         'skin-character-customization': { originalPrice: 20.00 },
-        'starter-pack': { originalPrice: 9.99 }
+        'starter-pack': { originalPrice: 9.99 },
+        'mega-booster': { originalPrice: 200000 },
+        'godly-artifact': { originalPrice: 2500000000 }
       }}
     />
   ),
@@ -568,7 +656,7 @@ export const INR: Story = {
 export const WithRedeemTab: Story = {
   render: () => (
     <Store
-      items={duplicatedItems}
+      items={allStoreItems}
       packs={mockPacks}
       userAccountType={UserAccountTypes.Free}
       onPurchase={(purchase: Partial<IPurchase>) => {
@@ -583,7 +671,7 @@ export const WithRedeemTab: Story = {
         return { success: false, error: 'Invalid voucher code.' };
       }}
       customWalletContent={<DCWalletContent
-        dcBalance={1200}
+        dcBalance={150000000} // 150M
         historyData={{ transactions: [], totalPages: 1, currentPage: 1 }}
         historyLoading={false}
         onRequestHistory={() => {}}
@@ -621,7 +709,9 @@ export const WithRedeemTab: Story = {
         'original-greater-life-potion-0': { originalPrice: 15.00 },
         'character-name-change': { originalPrice: 15.00 },
         'skin-character-customization': { originalPrice: 20.00 },
-        'starter-pack': { originalPrice: 9.99 }
+        'starter-pack': { originalPrice: 9.99 },
+        'mega-booster': { originalPrice: 200000 },
+        'godly-artifact': { originalPrice: 2500000000 }
       }}
     />
   ),

package/src/stories/Features/trading/Marketplace.stories.tsx

@@ -42,6 +42,9 @@ const mockYourBuyOrders: IMarketplaceBuyOrderItem[] = [
   { _id: 'bo-1', owner: 'player-1', itemBlueprintKey: 'items/abyssal-edge', itemRarity: 'Rare', maxPrice: 500, escrowedGold: 500, fee: 25, status: MarketplaceBuyOrderStatus.Active, createdAt: daysAgo(3), updatedAt: daysAgo(3) },
   { _id: 'bo-2', owner: 'player-1', itemBlueprintKey: 'items/angelic-sword', maxPrice: 2000, escrowedGold: 2000, fee: 100, status: MarketplaceBuyOrderStatus.Fulfilled, fulfilledBy: 'DarkKnight42', createdAt: daysAgo(14), updatedAt: daysAgo(1) },
   { _id: 'bo-3', owner: 'player-1', itemBlueprintKey: 'items/leather-armor', maxPrice: 300, escrowedGold: 0, fee: 15, status: MarketplaceBuyOrderStatus.Expired, createdAt: daysAgo(35), updatedAt: daysAgo(7) },
+  { _id: 'bo-mega', owner: 'player-1', itemBlueprintKey: 'items/dragon-scale', maxPrice: 2500000, escrowedGold: 2500000, fee: 125000, status: MarketplaceBuyOrderStatus.Active, createdAt: daysAgo(1), updatedAt: daysAgo(1) },
+  { _id: 'bo-godly', owner: 'player-1', itemBlueprintKey: 'items/phoenix-feather', maxPrice: 1500000000, escrowedGold: 1500000000, fee: 7500000, status: MarketplaceBuyOrderStatus.Active, createdAt: daysAgo(0), updatedAt: daysAgo(0) },
+  { _id: 'bo-bugfix', owner: 'player-1', itemBlueprintKey: 'missing-blueprint-key', itemRarity: 'Epic', maxPrice: 150000, escrowedGold: 150000, fee: 7500, status: MarketplaceBuyOrderStatus.Active, createdAt: daysAgo(2), updatedAt: daysAgo(2), itemTexturePath: 'swords/angelic-sword.png' } as any,
 ];
 
 const ITEM_KEYS = [
@@ -58,11 +61,12 @@ const RARITIES = ['Common', 'Uncommon', 'Rare', 'Epic', 'Legendary'] as const;
 const allMockOpenBuyOrders: IMarketplaceBuyOrderItem[] = Array.from({ length: 100 }, (_, i) => ({
   _id: `obo-${i + 1}`,
   owner: `player-${(i % 20) + 2}`,
-  itemBlueprintKey: ITEM_KEYS[i % ITEM_KEYS.length],
+  itemBlueprintKey: i === 0 ? 'missing-key-for-test' : ITEM_KEYS[i % ITEM_KEYS.length],
   itemRarity: RARITIES[i % RARITIES.length] as any,
-  maxPrice: Math.round((100 + i * 47) / 10) * 10,
-  escrowedGold: Math.round((100 + i * 47) / 10) * 10,
-  fee: Math.round((100 + i * 47) / 10) * 10 * 0.05,
+  ...(i === 0 ? { itemTexturePath: 'potions/greater-life-potion.png' } : {}),
+  maxPrice: i === 0 ? 3000000 : Math.round((100 + i * 47) / 10) * 10,
+  escrowedGold: i === 0 ? 3000000 : Math.round((100 + i * 47) / 10) * 10,
+  fee: i === 0 ? 150000 : Math.round((100 + i * 47) / 10) * 10 * 0.05,
   status: MarketplaceBuyOrderStatus.Active,
   createdAt: daysAgo(i % 30),
   updatedAt: daysAgo(i % 30),

package/src/utils/__test__/atlasUtils.spec.ts

@@ -33,6 +33,21 @@ describe('resolveAtlasSpriteKey', () => {
     expect(resolveAtlasSpriteKey(atlasJSON, 'silver-arrow')).toBe(
       'ranged-weapons/silvermoon-arrow.png'
     );
+    expect(resolveAtlasSpriteKey(atlasJSON, 'social-crystal')).toBe(
+      'crafting-resources/tile049.png'
+    );
+    expect(resolveAtlasSpriteKey(atlasJSON, 'bloodroot-blossom-flower')).toBe(
+      'crafting-resources/bloodroot-blossom.png'
+    );
+    expect(resolveAtlasSpriteKey(atlasJSON, 'sunspire-lotus-flower')).toBe(
+      'crafting-resources/sunspire-lotus.png'
+    );
+    expect(resolveAtlasSpriteKey(atlasJSON, 'mana-shield-tome')).toBe(
+      'spell-tomes/spell-tome-blue-4.png'
+    );
+    expect(resolveAtlasSpriteKey(atlasJSON, 'entangling-roots-tome')).toBe(
+      'spell-tomes/spell-tome-green-2.png'
+    );
   });
 
   it('returns null when no atlas sprite can be resolved', () => {

package/src/utils/atlasUtils.ts

@@ -3,6 +3,84 @@ export const NO_IMAGE_SPRITE_KEY = 'others/no-image.png';
 const atlasSpriteAliases = new Map<string, string>([
   ['mysticstaff', 'staffs/mystic-lightning-staff.png'],
   ['silverarrow', 'ranged-weapons/silvermoon-arrow.png'],
+  // Runtime blueprint keys whose atlas filenames do not match their item ids.
+  ['arcaneexplosiontome', 'spell-tomes/spell-tome-special-blue-2.png'],
+  ['arrowcreationspelltome', 'spell-tomes/spell-tome-gray-4.png'],
+  ['arrowstormtome', 'spell-tomes/spell-tome-gray-5.png'],
+  ['berserkerbloodthirsttome', 'spell-tomes/spell-tome-special-red-3.png'],
+  ['berserkerexecutiontome', 'spell-tomes/spell-tome-brown-5.png'],
+  ['berserkerfrenzytome', 'spell-tomes/spell-tome-special-red-2.png'],
+  ['berserkerragetome', 'spell-tomes/spell-tome-red-6.png'],
+  ['blankrunecreationspelltome', 'spell-tomes/spell-tome-gray-4.png'],
+  ['bleedingedgetome', 'spell-tomes/spell-tome-brown-4.png'],
+  ['blizzardtome', 'spell-tomes/spell-tome-special-blue-1.png'],
+  ['bloodrootblossomflower', 'crafting-resources/bloodroot-blossom.png'],
+  ['boltcreationspelltome', 'spell-tomes/spell-tome-blue-6.png'],
+  ['bombcreationtome', 'spell-tomes/spell-tome-red-4.png'],
+  ['chefsdelighttome', 'spell-tomes/spell-tome-brown-2.png'],
+  ['cleavingstomptome', 'spell-tomes/spell-tome-brown-6.png'],
+  ['corruptionbolttome', 'spell-tomes/spell-tome-dark-1.png'],
+  ['corruptionrunecreationspelltome', 'spell-tomes/spell-tome-dark-3.png'],
+  ['corruptionwavetome', 'spell-tomes/spell-tome-dark-2.png'],
+  ['crimsonarrowcreationtome', 'spell-tomes/spell-tome-red-6.png'],
+  ['curseofweaknesstome', 'spell-tomes/spell-tome-dark-6.png'],
+  ['darkrunecreationspelltome', 'spell-tomes/spell-tome-dark-3.png'],
+  ['dispelmagictome', 'spell-tomes/spell-tome-blue-4.png'],
+  ['druidshapeshifttome', 'spell-tomes/spell-tome-special-green-2.png'],
+  ['druidsilencetome', 'spell-tomes/spell-tome-green-3.png'],
+  ['duskwispherbflower', 'crafting-resources/duskwisp-herb.png'],
+  ['dwarfstoneformtome', 'spell-tomes/spell-tome-brown-5.png'],
+  ['elvenarrowtome', 'spell-tomes/spell-tome-green-5.png'],
+  ['emeraldarrowcreationtome', 'spell-tomes/spell-tome-green-4.png'],
+  ['energyboltrunecreationspelltome', 'spell-tomes/spell-tome-blue-6.png'],
+  ['energywavetome', 'spell-tomes/spell-tome-blue-5.png'],
+  ['entanglingrootstome', 'spell-tomes/spell-tome-green-2.png'],
+  ['fireboltcreationspelltome', 'spell-tomes/spell-tome-red-2.png'],
+  ['fireboltrunecreationspelltome', 'spell-tomes/spell-tome-red-4.png'],
+  ['firebolttome', 'spell-tomes/spell-tome-red-1.png'],
+  ['firerunecreationspelltome', 'spell-tomes/spell-tome-red-3.png'],
+  ['firestormtome', 'spell-tomes/spell-tome-special-red-1.png'],
+  ['focusswifttome', 'spell-tomes/spell-tome-gray-3.png'],
+  ['focustome', 'spell-tomes/spell-tome-gray-2.png'],
+  ['foodcreationspelltome', 'spell-tomes/spell-tome-brown-1.png'],
+  ['fortifydefensetome', 'spell-tomes/spell-tome-brown-5.png'],
+  ['frostarrowcreationtome', 'spell-tomes/spell-tome-blue-2.png'],
+  ['frostbolttome', 'spell-tomes/spell-tome-blue-1.png'],
+  ['greaterhealingspelltome', 'spell-tomes/spell-tome-special-yellow-2.png'],
+  ['healingrunecreationspelltome', 'spell-tomes/spell-tome-gray-1.png'],
+  ['hunterexecutiontome', 'spell-tomes/spell-tome-special-gray-2.png'],
+  ['hunterquickfiretome', 'spell-tomes/spell-tome-gray-6.png'],
+  ['ironwilltome', 'spell-tomes/spell-tome-special-yellow-1.png'],
+  ['magicshurikentome', 'spell-tomes/spell-tome-blue-7.png'],
+  ['manadraintome', 'spell-tomes/spell-tome-blue-3.png'],
+  ['manashieldtome', 'spell-tomes/spell-tome-blue-4.png'],
+  ['masshealingtome', 'spell-tomes/spell-tome-special-yellow-3.png'],
+  ['minotaurbullstrengthtome', 'spell-tomes/spell-tome-brown-6.png'],
+  ['naturesrevengetome', 'spell-tomes/spell-tome-special-green-1.png'],
+  ['pickpockettome', 'spell-tomes/spell-tome-gray-3.png'],
+  ['poisonarrowcreationspelltome', 'spell-tomes/spell-tome-green-5.png'],
+  ['poisonrunecreationspelltome', 'spell-tomes/spell-tome-green-6.png'],
+  ['powerstriketome', 'spell-tomes/spell-tome-brown-1.png'],
+  ['rogueexecutiontome', 'spell-tomes/spell-tome-special-gray-1.png'],
+  ['roguestealthspelltome', 'spell-tomes/spell-tome-gray-2.png'],
+  ['selfhastespelltome', 'spell-tomes/spell-tome-gray-1.png'],
+  ['selfhealingspelltome', 'spell-tomes/spell-tome-special-yellow-1.png'],
+  ['shieldbashtome', 'spell-tomes/spell-tome-brown-2.png'],
+  ['smallwoodensticks', 'crafting-resources/small-wood-sticks.png'],
+  ['socialcrystal', 'crafting-resources/tile049.png'],
+  ['spelldivineprotectiontome', 'spell-tomes/spell-tome-special-yellow-1.png'],
+  ['spelleagleeyestome', 'spell-tomes/spell-tome-gray-7.png'],
+  ['spellphysicalshieldtome', 'spell-tomes/spell-tome-brown-3.png'],
+  ['spellpolymorphtome', 'spell-tomes/spell-tome-special-blue-2.png'],
+  ['sunspirelotusflower', 'crafting-resources/sunspire-lotus.png'],
+  ['teleporttome', 'spell-tomes/spell-tome-special-blue-1.png'],
+  ['thunderrunecreationspelltome', 'spell-tomes/spell-tome-blue-7.png'],
+  ['vampiricstormtome', 'spell-tomes/spell-tome-dark-4.png'],
+  ['veilofundeathtome', 'spell-tomes/spell-tome-dark-5.png'],
+  ['vinegrasptome', 'spell-tomes/spell-tome-green-1.png'],
+  ['warriorexecutiontome', 'spell-tomes/spell-tome-special-brown-1.png'],
+  ['warriorstuntargettome', 'spell-tomes/spell-tome-brown-3.png'],
+  ['wildfirevolleytome', 'spell-tomes/spell-tome-red-5.png'],
 ]);
 
 const atlasBaseNameLookupCache = new WeakMap<object, Map<string, string>>();

package/src/utils/numberUtils.ts

@@ -0,0 +1,31 @@
+/**
+ * Formats a number using modern gaming standards (k for thousands, M for millions, B for billions).
+ * @param num The number to format
+ * @param useKNotation Whether to use the k/M/B notation
+ * @returns Formatted string
+ */
+export const formatMMORPGNumber = (num: number, useKNotation: boolean = true): string => {
+  if (!useKNotation || num < 1000) {
+    return num.toLocaleString();
+  }
+
+  // Billions (B)
+  if (num >= 1000000000) {
+    const value = num / 1000000000;
+    return value.toFixed(value % 1 === 0 ? 0 : 1) + 'B';
+  }
+
+  // Millions (M)
+  if (num >= 1000000) {
+    const value = num / 1000000;
+    return value.toFixed(value % 1 === 0 ? 0 : 1) + 'M';
+  }
+
+  // Thousands (k)
+  if (num >= 1000) {
+    const value = num / 1000;
+    return value.toFixed(value % 1 === 0 ? 0 : 1) + 'k';
+  }
+
+  return num.toLocaleString();
+};