Item Icons and Names

Why You Have to Do This

The website that comes with your server has a browsable game database: items, monsters, NPCs, skills, forces, quests, stores and maps, with a live map showing who is where.

The icons and the readable item names are the game client’s artwork and the game client’s text. We do not have the right to hand those out, so they are not in the download. Everything else is: the stats, the levels, the prices, the drop tables, the positions and the search are all your server’s own data and work the moment you start it.

So the release ships a small tool that reads the client you already installed to play, and writes the art out beside your server.

It ships with 2.2.3.2 today. The other versions’ releases do not carry it yet, and their control panels draw the placeholders described below until they do.

Running It

From the archive root, pointed at your RF Online folder:

server/linux/rfassets -client /home/rf/RFOnline

On Windows:

server\windows\rfassets.exe -client "C:\RFOnline"

That is the whole thing. It prints what it found, writes a webassets folder next to your settings.cfg, and the website picks it up on the next restart.

Point -client at the folder that has SpriteImage and DataTable inside it. If you are not sure which one that is, it is the folder containing RF_Online.bin.

Before and After

Until you run it, every icon on the site is a neutral placeholder and items show their internal code (Iwa01) instead of a name. Nothing is broken and nothing 404s: the site knows there is no art pack and draws placeholders deliberately, so the database is fully usable without it.

After you run it, the same pages show the real icons and the real names.

Options

Flag	What it does
-client	Your RF Online folder. Required.
-dry-run	Report what would be extracted and write nothing.
-locale	Which language folder to take item names from. Defaults to whichever one your client has.
-out	Write the pack somewhere else. Defaults to webassets beside your settings.cfg.
-data-path	The folder holding your settings.cfg, if it is not found automatically.

Run it with no arguments for the same list.

Things Worth Knowing

Your client is only ever read. Every file the tool opens under -client is opened read-only. It cannot change, move or corrupt your game install.

Re-run it whenever you like. The pack is a plain folder of files, not an archive and not a database table. Running the tool again overwrites it. Deleting it puts the site back to placeholders. There is nothing to migrate either way.

Use a client that matches your server. The icons are numbered by item category, and those numbers moved between versions. A 2.2.3.2 server wants a 2.2.3.2 client, or some icons will be the wrong picture rather than a missing one, which is harder to notice.

It is a one-time step per install. If you move the server to a new box, copy the webassets folder across with the rest of your server directory, or run the tool again there.

Serving it from somewhere else. Because it is static files, you can point a CDN or a separate web server at the folder if you are running a large site. Nothing in the game server depends on it.

If the Site Still Shows Placeholders

Restart the webserver. It notices a new pack on start, and rechecks periodically, but a restart is immediate.

If it still shows placeholders, check that webassets landed in the same folder as the settings.cfg your server actually loaded. On a box with two installs that is the usual cause, and -out pointed at the right folder fixes it.