Item Generator

The Item Generator turns RDR2’s own inventory icons into inventory items for your framework. Click the items you want, adjust the name, label and the framework’s options, and copy the result: an INSERT statement for a VORP database, or rows for RSG’s shared/items.lua. One more click downloads the icons as PNG, already in the folder your inventory reads, together with the SQL or Lua.

What it is for

Adding items by hand means finding an icon, renaming it, and writing a database row or a Lua table entry with the right columns for your framework. The game already has icons for coffee, arrows, pelts, tonics and over a thousand other things, and for many of them it also has a proper name and description. This tool puts those together so you only choose.

Quick start

1. Pick your framework on the right: VORP (SQL) or RSG (items.lua).
2. Search the item list, or narrow it with a group chip (Provisions, Consumables, Weapons and so on).
3. Click items to add them. Click again to remove one. Picked items are outlined in red.
4. Edit each picked item: Item name, Label, Description and the framework’s own fields.
5. Copy the code under the list, or press Download icons and SQL (or Download icons and Lua).

The item list

There are 1,229 icons, every texture of the game’s three inventory icon dictionaries. 763 of them have their own name in the game’s English text and 404 also have a description. Turn on Only items with a game label to hide the ones without a name.

The group chips come from the start of the texture name, with their counts:

The search matches both the texture name and the label. The grid shows 96 icons at a time with a button for more.

Editing a picked item

A label made from the texture name drops a leading consumable_, provision_, document_, kit_, upgrade_, generic_, clothing_, collector_ or mp_ and capitalises the rest, so ammo_bullet_express becomes Ammo Bullet Express. Change it to something better before you ship.

Switching between VORP and RSG keeps your picks and resets every weight to that framework’s default, because the two use different scales.

VORP output

With Coffee and Arrows picked:

-- Generated with fivemad.com/redm/tools/item-generator
-- Run it on your VORP database. Icons go in vorp_inventory/html/img/items/<item>.png.
INSERT IGNORE INTO `items` (`item`, `label`, `limit`, `can_remove`, `type`, `usable`, `metadata`, `desc`) VALUES
('consumable_coffee', 'Coffee', 10, 1, 'item_standard', 1, '{}', 'Regular Coffee Brew. Moderately restores Stamina Core and Dead Eye Core.'),
('ammo_arrow', 'Arrows', 10, 1, 'item_standard', 1, '{}', 'Arrows');

These are the same columns the official VORP recipe uses for its own items. An item with no description gets its label as the description.

Write the weight column adds a weight column with each item’s weight. Turn it on only if your items table has that column (newer VORP databases do, with a default of 0.25); on an older table the statement fails.

Run the SQL on your VORP database, put the icons in vorp_inventory/html/img/items, and restart the server.

RSG output

The same two items for RSG:

-- Generated with fivemad.com/redm/tools/item-generator
-- Paste these rows inside RSGShared.Items in rsg-core/shared/items.lua.
-- Icons go in rsg-inventory/html/images/<item>.png.
    consumable_coffee = { name = 'consumable_coffee', label = 'Coffee', weight = 100, type = 'item', image = 'consumable_coffee.png', unique = false, useable = true, shouldClose = true, description = 'Regular Coffee Brew. Moderately restores Stamina Core and Dead Eye Core.' },
    ammo_arrow = { name = 'ammo_arrow', label = 'Arrows', weight = 100, type = 'item', image = 'ammo_arrow.png', unique = false, useable = true, shouldClose = true, description = '' },

The rows have the same shape as the items RSG ships with. Paste them inside the RSGShared.Items = { ... } table, put the icons in rsg-inventory/html/images, and restart rsg-core and the inventory.

The download

Download icons and SQL (or Lua) gives you redm-items-vorp.zip or redm-items-rsg.zip with:

• every picked icon as a PNG, named after your Item name, inside vorp_inventory/html/img/items/ or rsg-inventory/html/images/;
• items.sql or items.lua, the same code shown on the page.

Rename an item before you download and its icon follows. The icons are 192 pixels.

Common mistakes

The warning panel catches these:

• “… is picked twice.” Two picks with the same item name. The legendary animal carcasses are the usual case: names such as provision_role_naturalist_carcass_bear_legendary_01, _02 and _03 are longer than 50 characters, so all three are cut to the same name. Rename them, for example to legendary_bear_pelt_1.
• “… use only letters, digits and underscores.” Spaces or dashes in an item name.
• “… the item has no name.” An empty Item field.

And two it cannot catch:

• The item exists already. VORP’s INSERT IGNORE skips a row whose item name is already in the table, so running the SQL again does not change an existing item. Edit or delete the old row first if you want new values.
• The icon does not show. The PNG has to be named exactly like the item and sit in the folder above. If you rename an item in the database later, rename the PNG too.

Limitations

• Picks are not saved. Reloading the page empties the list, so copy or download before you leave.
• It writes plain items only: no weapons, ammo types, metadata or item use handlers. Those still need code in your framework.
• The labels and descriptions are the game’s English text. Translate them yourself for another language.

Related tools

• Game Text Search
• server.cfg Generator
• Hash Calculator