RO Patcher Lite Help (c) 2009-2024 Ai4rei/AN This pre-release content is subject to changes.

This article has been migrated to the help system and might not apply the necessary markups to fit with the remaining content.

[v2.4.5+]None of this applies anymore, settings support has been removed in favor of the RO Patcher Lite+ROCred merge.

Settings Documentation

File syntax

The patcher looks at start-up for a file in same folder, which has the same base name like itself; that means if the patcher is called rsu.exe, it will look for rsu.ini, if the patcher is called patcher.exe, it will look for patcher.ini. The settings file follows the typical INI file structure of sections and key-value pairs.

; Comment
[SectionName]
SettingName = SomeValue
AnotherSettingsName = OtherValue

That way it can be easily modified with every text editor like Notepad. Note, that you always have to modify the file yourself, if you want to change a setting. The patcher will not write into the settings file.

↑ TOP

Sections

All settings are organized into different sections to be easily recognized, what they are refering to. In the following all known or reserved names are listed. If you intent to write a plug-in, that uses settings, make sure, that it does not use settings, that are already in use by other plug-ins. Only exception are mutually-exclusive plug-in pairs, which cannot be loaded at same time.

↑ TOP

[rsu]

This section is reserved to the patcher itself, plug-ins must not use it.

PlugIn
Default: empty
Semi-colon (;) separated list of plug-ins to load. Use the base name only.
```
PlugIn = ipatch;i18n;panhtml
```
CheckForUpdates
Default: 1 (true)
Enables the patcher to check periodically for updates and show a notification, when a new version is available.
```
CheckForUpdates = 1
```
LastUpdateCheckedOn
Default: N/A
This entry is maintained by the patcher.

↑ TOP

[rsu.patchinfo]

This section is used by following plug-ins: ipatch, panhtml, pantext.

External Patch Information (ipatch)
- InfFile
  Default: empty
  Name of file, to store last applied patch id to (required)
```
InfFile = patchRE.inf
```
- GrfFile
  Default: empty
  Name of GRF archive, that is considered primary (required).
```
GrfFile = rdata.grf
```
- ExeFile
  Default: empty
  Name of the file, to be started after successful patch process, with Start button (ex. game client) (optional).
```
ExeFile = ragexeRE.exe
```
- ExeCmdl
  Default: empty
  Command line parameters to pass to ExeFile (optional).
```
ExeCmdl = 1sak1
```
- WebSite
  Default: empty
  Hostname/IP to use for WebDeny and WebList entries (required). Note: Host is required to offer files through HTTP service.
```
WebSite = webpatch.ragnarok.co.kr
```
- WebPort
  Default: 80
  Port on which the host specified in WebSite entry offers HTTP service (optional).
```
WebPort = 80
```
- WebPath
  Default: empty
  Path on WebSite, where WebDeny and WebList are stored (optional).
```
WebPath = /patch
```
- WebDeny
  Default: empty
  Name of file, that handles allow/deny on patching (required).
```
WebDeny = patch_allow_RE.txt
```
- WebList
  Default: empty
  Name of file, that contains list of available patches (required).
```
WebList = patchRE3.txt
```
- FtpSite
  Default: empty
  Hostname/IP to use for retrieving patch files (required). Note: Host is required to offer files through FTP service.
```
FtpSite = ragnarok1-gravity.ktics.co.kr
```
- FtpPort
  Default: 21
  Port on which the host specified in FtpSite entry offers FTP service (optional).
```
FtpPort = 21
```
- FtpUser
  Default: empty
  Username required for FtpSite (optional).
```
FtpUser = ragadmin
```
- FtpPass
  Default: empty
  Password required for FtpSite (optional).
```
FtpPass = icsragadmin!@
```
- FtpPath
  Default: /
  Path on FtpSite, where patch files are stored (optional).
```
FtpPath = /Patch
```
Patch News Html & Text (panhtml, pantext)
- PanOpen
  Default: empty
  Website to load into news window, when patching is allowed (required).
```
PanOpen = http://www.ragnarok.co.kr/gamenotice/Sakray.html
```
- PanDown
  Default: empty
  Website to load into news window, when patching is disallowed, ex. server on maintenance (required).
```
PanDown = http://www.ragnarok.co.kr/gamenotice/ServerClose.html
```

↑ TOP