Skip to main content

Developer Tools

This page contains miscellaneous utilities that may be of interest, but don't warrant a dedicated repository.

EBM Export (with zlib)​

Decompressing guild emblems is trivial in any language environment that has bindings to the zlib API:

const fs = require("fs");
const zlib = require("zlib");

const EBM_FILE_PATH = "some-guild-emblem.ebm";

const buffer = fs.readFileSync(EBM_FILE_PATH);
const bitmap = zlib.inflateSync(buffer);

fs.writeFileSync(EBM_FILE_PATH + ".bmp", bitmap);

Example: Decompressing EBM files using Node.js' builtin zlib module

EUC-KR Path Conversion​

File names have traditionally been stored as EUC-KR encoded Windows paths inside the GRF archive.

If you want to convert them to a more practical Unicode format, you can use the following snippet:

import iconv from "iconv-lite";
const { decode: iconv_decode } = iconv;

// Converts the input string from EUC-KR to UTF-8 using iconv-lite
function decodeUnicodeFilePath(input) {
  const decoded = iconv_decode(Buffer.from(input, "binary"), "EUC-KR");

  // Replace Windows path separators with UNIX style separators (optional)
  const output = decoded.replace(/\\/g, "/");

  // Transparently deal with inconsistent capitalization (for Linux/Mac OS)
  return output.toLowerCase();
}

export { decodeUnicodeFilePath };

This also standardizes path separators (\ becomes /). Running the code requires NodeJS with iconv-lite.

Example:

  • data\model\¿ÜºÎ¼ÒÇ°\Æ®·¦01.rsm will be converted to data/model/외부소품/트랩01.rsm

You can then paste into Google Translate to receive an English file name, or use their API to translate in bulk.

RagLite Developer Toolkit​

The latest iteration of my toolkit is now freely available on GitHub: RagnarokResearchLab/RagLite

While I won't be releasing all of my old tooling, which I expect to become fully obsolete over time, this version is kept continuously in sync with the documentation published on these pages. Here's what it generally aims to do:

  • Make it easy to analyze RO-specific binary file formats in their many different versions, convert them, etc.
  • Visualize 2D sprites and 3D geometry in a "realistic" (close-enough approximation) ingame environment
  • Validate hypotheses and verify claims by reimplementing the features in question, where it makes sense

Please note that this is explicitly NOT a full game client or server implementation. If you want that, there are many other projects aiming to accomplish this lofty goal. My focus is on research, and the tool reflects that.