d2cube / d2cube

A unique interactive and visual D2 companion experience.

d2cube

A unique interactive and visual D2 companion experience.

---

To be updated!

Intro

Contents

Features

App

API

Docs

Roadmap

Project

Contribute

Sponsor

Support this project and give back by sponsoring it. Your profile and contributions will be recognized below.

Backstory

License

MIT © Chris Zhou

d2cube's Issues

[RFC] Codegen DB data from game files

Context
The current ItemDB is hardcoded by me (@chrisrzhou) 😮 as part of a personal reverse-engineering exercise exploring the initial project. We should prefer a more robust way to do this.

Proposal

• Scrape game files to codegen files in ~/db.
• It is important to ensure that we still want to maintain the static authorship of each file (including enum keys for objects). This is important enough as part of the DX and type discovery in maintaining the codebase. Simply outputting static data is not sufficient.
• It is likely various data mappings are not accounted or inaccurately modeled. Refactor the app accordingly before committing further.

Considerations

• Due to a lack of knowledge on the source game files, this has been postponed, but it is still a long-term goal of the project to translate to/from the source game files.

References

• https://d2mods.info/home.php
• https://github.com/jcageman/d2itemreader

[RFC] Prefix/Affix Magic/Rare Item Generator

Context
Support a way to create magic/rare items based on prefixes.

Proposal
Allows creation of magic/rare items and extend completness to other areas of the app needing these (e.g. Cube).

[RFC] Prelaunch Feedback

Context
Feedback from prelaunch

Proposal
In order of painpoints

• Mobile-friendly
  • [BUG] 100% Unusable on mobile right now [4] [6] [8] [9] [10] [11] [13] [16]
• Home page improvements
  • Navs should link to pages as primary action instead of opening a preview iframe every time. [1] [2]
  • Incorrect timer [12]
• Runewords page
  • [BUG] Destruction called Death [15]
  • Support for Ethereal and Ebugging in Runewords page [2] [15]
• Items page improvements
  • [BUG] Items page has a horizontal scrollbar on slightly smaller resolutions [2]
  • Filtering by item tier (normal/exceptional/elite) is not clear (might need a dedicated alias filter for for this) [2]
  • Easy Quick filters (extend Search component to support predefined quick filters) [3]
  • Cube page improvements
    • [BUG] Prefixes/affixes do not render properties [3]
    • [BUG] 3 Magic Rings -> 1 Magic Rings
    • Missing crafting recipes [3]
    • Missing quest recipes
    • Show additional description of recipes [3]
    • Socket recipes don't show sockets [3]
    • Improve discoverability of durability recipe by indicating pre-durability/charges and rechard durability/charges [3]

      • The cube recipe Ort + Chipped Gem + Weapon says the result is fully repaired weapon, but it's supposed to be fully repaired and recharged weapon. It'd be good to demonstrate this one with a staff of Teleport to show how useful this recipe is.

      • The recipes "3 Chipped Gems + 1 Magic Weapon" and "3 Flawless Gems + 1 Magic Weapon", I'm not sure I understand the difference between them. The site shows 1 socket vs 2 socket, but is that right? Arreat summit shows one is ilvl 25 and the other 30 but both are 1-2 sockets. Is it because certain items can only roll 1 socket at ilvl 25 but can roll 2 at ilvl 30?

• Others
  • Persistent URLs [3]
  • Support for prefix/affix [4]
  • Update viewport meta [14]
  • SEO-friendly (social thumbnail/image).
• Ambitious
  • Advanced item details (attack speed breakpoints, sockets by number) [5]
  • Loot drop-rate table

References

• https://www.reddit.com/r/Diablo/comments/pq43v0/d2cube/
• https://www.reddit.com/r/diablo2/comments/pq68us/d2cube/
• https://www.reddit.com/r/Diablo_2_Resurrected/comments/pq4abb/d2cube/

[RFC] Character Stats

Context
Diablo 2 is a game about items, skills, and stats. This RFC focuses on deeply integrating character stats with the existing app (as of the time of this writing, only supports items).

Proposal

• Confirm/improve existing logic in calcItemStats.
• Aggregate calculated item stats.
• Render this with the appropriate UI.

Considerations

• We can just integrate with d2planner, but d2cube intends to be an opinionated self-maintained project with its own ID/item/skill/stat system and APIs.

References

• https://d2planner.github.io/skills/
• https://d2.maxroll.gg/d2planner/

[RFC] Bookmarkable URLs

Context
d2cube should support bookmarkable URLs for easy sharing.

Proposal
Drive page initial state via URL.

Considerations
Will likely start work in a later phase when pages and APIs are stable.

[APP BUG] Missing Crafted Item recipes

Describe the bug
Cube page is missing Crafted items recipes

Reproduce

1. Go to Cube page
2. Crafted item recipes not found.

Expected behavior
Crafted item recipes should be supported.

[RFC] Inventory Management

Context
Deeply simulate the in-game experience of moving/transferring/socketing/equipping/swapping items. Useful in the Sets page to observe incomplete set bonuses, and also as a general useful sim to socketing runes/gems in items.

Proposal

• Update Inventory to support event handlers to equip/move items in the specified grid. Implement these with utils.
• Should work with Cube.
• Set bonuses should now dynamically be determined based on its equipped status.

References

• https://d2.maxroll.gg/d2planner/

[Roadmap] Short-term goals

Keeping a very rough list of short-term roadmap goals. This issue maybe subject to change.

High pri

• Update Docs.
• Abstract ~/db and ~/api to their own repos.
• Snapshot test ~/db. Unit test ~/api.
• Research and codegen files in ~/db from source game files.

Lowpri

• Revisit and improve uinix utils and uinix-ui bugs uncovered.
• Set up and preview the UI system knowledge (e.g. via uinix-ui-system-preview).
• Cleanup code and smell e.g. rollItem.
• Implement Bookmarkable URLs.
• Implement Inventory.

[RFC] Character Skills

Context
Diablo 2 is a game about items, skills, and stats. This RFC focuses on deeply integrating character skills with the existing app (as of the time of this writing, only supports items).

Proposal

• Statically define and model character skills in relation to existing item skill property.
• Implement static definitions in ~/db
• Implement appropriate APIs in ~/api
• Implement a skill planner UI using data from ~/db similar to the amazing https://d2planner.github.io/skills/

Considerations

• We can just integrate with d2planner, but d2cube intends to be an opinionated self-maintained project with its own ID/item/skill system and APIs.

References

• https://d2planner.github.io/skills/
• https://d2.maxroll.gg/d2planner/

[RFC] D2R Image Assets

Context
The app is currently using Classic D2 image assets.

Proposal

• Add the D2R image assets in public/images/d2r.
• Items should be named following the ItemID naming convention and be saved in in .webp format.
• Support a toggle in the UI to toggle between Classic vs Resurrected assets.

Considerations

• Potential impact on app loading times.

References
The following sites provide D2R assets although a programmatic way to scrape from the source game files is preferred.

• https://maxroll.gg/
• https://www.diablo-2.net/