Get started in
minutes, not hours.
This guide walks you through every feature of the RDL Item Generator — from installation and license activation to generating headgears, weapons, mobs, NPCs, and item packages for your Ragnarok Online private server.
Installation
Download the latest Windows installer from the home page and run it. The setup wizard will handle everything automatically.
Download the installer
Click Download for Windows on the home page. The file is named RDL_x.x.x_x64-setup.exe.
Run the setup wizard
Double-click the installer. If Windows SmartScreen appears, click More info → Run anyway. Follow the on-screen prompts.
Launch RDL Item Generator
After installation, a desktop shortcut is created. Double-click it or find RDL Item Generator in your Start Menu.
License Activation
RDL uses hardware-locked licenses. Your license key is tied to your machine and verified server-side every time the app launches.
Obtain your license key
Purchase a license through the official RDL Discord or storefront. You will receive a key in the format XXXX-XXXX-XXXX-XXXX.
Enter the key on first launch
On first run, the activation screen appears automatically. Paste your key and click Activate. An internet connection is required.
Activation confirmed
A green checkmark confirms your license is valid. The app will remember your activation and only re-verify on startup.
Interface Overview
The main window is divided into a sidebar for tool selection and a workspace panel where you configure and generate content.
Sidebar
Switch between Item Generator, Mob Tools, NPC Tools, and Settings.
Config Panel
Fill in item IDs, names, sprites, and properties for the selected tool.
Output Preview
See the generated file content before exporting to your server folder.
Export
Write files directly to your server directory or copy to clipboard.
Item Generator
The Item Generator is the core tool. It produces all the files needed to add a new item to your Ragnarok server: item DB entries, client-side data, and sprite references.
Select the item type
Choose Headgear, Weapon, Garment, or Consumable from the type selector at the top of the panel.
Assign an Item ID
Enter a unique item ID or use Auto-assign to let the tool pick the next available ID from your tracked range.
Fill in item properties
Set the name, description, weight, price, equip location, and any bonus scripts. Required fields are highlighted in gold.
Attach a sprite
Browse to your .spr / .act files or type the sprite name. The tool validates the filename format automatically.
Generate & Export
Click Generate to preview all output files, then Export to write them to your server directory.
Headgears
Headgear generation handles upper, mid, and lower slots. The tool outputs the item DB entry, accessoryid.lub, accname.lub, and the view ID mapping.
Set the equip location
Select Upper, Mid, Lower, or a combination. The view ID field appears automatically for upper headgears.
Assign a View ID
Enter a View ID or use Auto-assign. The tool tracks used View IDs to prevent collisions across all your headgears.
Add bonus scripts (optional)
Type bonus scripts directly into the script field, e.g. bonus bStr,5; bonus bAgi,3;. Syntax highlighting helps catch errors.
// Example generated item DB entry (item_db.yml) - Id: 31000 AegisName: Custom_Crown Name: Custom Crown Type: Armor Buy: 20000 Weight: 100 Locations: Head_Top: true EquipLevelMin: 1 View: 2500 Script: | bonus bStr,5; bonus bAgi,3;
Weapons & Garments
Weapons and garments follow the same workflow as headgears but include additional fields for weapon type, attack value, slots, and garment sprite direction.
Weapon Type
Select from Dagger, Sword, Spear, Axe, Mace, Rod, Bow, Knuckle, Instrument, Whip, Book, Katar, Revolver, Rifle, Gatling, Shotgun, Grenade Launcher, Fuuma.
Attack & Slots
Set base ATK, weapon level (1–4), and number of card slots (0–4).
Garment Sprites
Garments require male and female sprite references. Use the file browser to locate your .spr files.
Mob Generator
Add new monsters to your server with auto-generated mob DB entries, mob skill files, and client-side mob name/sprite data.
Enter mob stats
Fill in HP, ATK, DEF, MDEF, stats (STR/AGI/VIT/INT/DEX/LUK), level, and EXP values.
Set drop table
Add up to 9 item drops with individual drop rates. Use the item ID picker to search your existing item DB.
Assign mob sprite
Enter the sprite name or browse to your data/sprite/¸ó½ºÅÍ folder. The tool generates the correct client-side entries.
Generate GM command
After generating, the tool provides a ready-to-use @spawn GM command to test your mob in-game immediately.
NPC Tools
Quickly scaffold NPC scripts including basic dialogue NPCs, warp NPCs, and shop NPCs. The output is a ready-to-paste .txt script file.
Dialogue NPC
Create a talking NPC with configurable map, coordinates, sprite, and multi-line dialogue.
Warp NPC
Generate warp portals between maps with source and destination coordinates.
Shop NPC
Build a shop NPC with a custom item list. Prices are auto-filled from the item DB.
Item Packages
Item packages (random boxes / prize bags) let you bundle multiple items into a single box item. The tool generates the package DB entry and the associated script.
Create the box item
Generate a new item for the box itself (e.g. Mystery Box) using the Item Generator first, then switch to the Package tab.
Add package contents
Search and add items to the package list. Set quantities and individual probabilities. Probabilities must sum to 10000 (100.00%).
Link box to package
Select the box item ID in the Trigger Item field. The tool writes the getrandgroupitem script automatically.
ID Management
RDL tracks all item IDs, View IDs, and mob IDs you have generated to prevent collisions. You can configure your ID ranges in Settings → ID Ranges.
Open Settings → ID Ranges
Set the minimum and maximum ID for each category. RDL will only auto-assign within these bounds.
Import existing IDs
Use Import from DB to scan your existing item_db.yml or mob_db.yml and register all used IDs, preventing future conflicts.
Manual override
You can always type a specific ID manually. RDL will warn you if the ID is already in use but will not block you.
Exporting Files
After generating content, you have two export options: write directly to your server directory, or copy individual file contents to the clipboard.
Direct Export
Set your server root path in Settings. RDL writes files to the correct subdirectories automatically.
Clipboard Copy
Copy any generated file's content to clipboard for manual pasting into your editor.
Preview Mode
Review all generated output in the preview panel before committing any changes to disk.
FAQ
My license says "Invalid" even though I just bought it
Ensure you have an active internet connection. If the issue persists, contact support in the RDL Discord with your order ID.
Can I use RDL on multiple PCs?
Licenses are hardware-locked to one machine. Contact support to request a transfer if you change your PC.
The app won't open after a Windows update
Try running as Administrator. If that doesn't help, reinstall the latest version from the home page — your settings and ID registry are preserved.
Does RDL support rAthena and Hercules?
Yes. You can select your emulator type in Settings → Server Type. Output format (YAML vs TXT) adjusts automatically.
Where are my generated files saved?
Files are saved to the server path you configured in Settings. If no path is set, files are saved to Documents/RDL/Output/ by default.