Pages

Friday, February 28, 2020

Comparison of D2 Inventory Plugins

The Phrozen Keep hosts several UI plugins that expand the sizes of the player inventory, stash, and Horadric Cube. These can be dropped in and used in your Diablo 2 mod right away. Here's a rough comparison of several inventory plugins for D2 1.10+.

Mega Inventory Stash Cube (v1.10s & v1.10 Final)

This plugin increases the inventory, cube, and stash sizes while preserving the overall layout.

10x6 inventory 10x8 cube 10x10 stash
  • Inventory: 10x6
  • Cube: 10x8
  • Stash: 10x10

Saturday, January 18, 2020

Writing on GitHub: Markdown vs AsciiDoc vs reStructuredText

I've been experimenting with several popular markup languages for writing documentation on GitHub's wikis: GitHub Flavored Markdown, AsciiDoc, and reStructuredText.

AsciiDoc and reStructuredText offer advanced formatting features unavailable to GFM. Many of these features are not available in GitHub's wikis, because GitHub strips off most HTML tags and styles from the rendered HTML.

Here's a summary of my opinions on all three. Note that while I have plenty of experience with Markdown, I've used AsciiDoc and reStructuredText for only a few days. I may be poorly informed or biased.

GitHub Flavored Markdown

Pros
  • Easy and widespread
  • Can mix HTML
  • Simple table format
  • Can align table content using GFM markup
Cons
  • Table cells cannot span multiple rows or columns (workaround: use HTML tables)
  • No native support for definition lists (though HTML can be used directly)
  • No table of contents, though there are tools that can generate TOCs for you:
  • No footnotes
  • No native definition lists, though HTML can be used.

AsciiDoc

Pros
Cons
  • No strikethrough or underline syntax (workaround: use HTML tags)
  • Large margins between list items, due to them being enclosed in <p> tags. See relevant AsciiDoctor issue on GitHub.
  • Large padding in table cells, also due to them being enclosed in <p> tags.

Also check out tips on using AsciiDoc in GitHub.

reStructuredText

Pros
  • Familiar to Python developers, since the language (and many software written in it) uses reStructuredText for documentation.
  • Table cells can natively span multiple rows or columns
  • Definition lists
  • Footnotes that can be inserted anywhere, not just the bottom of the page
  • Table of contents (use the contents directive, since toctree is unsupported in GitHub)
Cons
  • No strikethrough or underline syntax (see docutils docs on why underline is missing)
  • Verbose and strict table syntax
  • Difficult to determine the level of a heading, if you haven't unified and memorized the hierarchy of heading underline symbols.
  • Table column width is controlled by the renderer instead of being managed by the browser. This may result in undesirable layouts on small screens.
  • Limited support for direct HTML, using the .. raw:: html directive.

Thursday, January 9, 2020

How to solve ACCESS_VIOLATION error when running Diablo 2 with PlugY in Windows 10

Disclaimer: I tested this under the following setup:

  • Windows 10 Enterprise x64 v1903
  • Diablo 2 v1.13c
  • PlugY v11.02

Windows 10 users may be stumped when attempting to run Diablo 2 with a Zipped version of PlugY. The game will refuse to run, showing this popup instead:

Popup message box that says, UNHANDLED EXCEPTION: ACCESS_VIOLATION (c0000005)

I got it working by copying the PlugY directory inside the ZIP file (the one containing files such as LocalizedStrings.ini) to the Diablo 2 installation directory (C:\Program Files (x86)\Diablo II). What an arbitrary fix.