This guide is about the modified neoncube patcher for RoseOnline. If there is anything missing, feel free to submit a comment to this thread. Credits are going to "figure" for his guide on ragezone.
Requirements
For the web-based stuff, you need some webspace with ftp access for uploading the patch files. If you want to compile the neoncube source by yourself, you need visual c++ 2005/8 and the PSDK from microsoft. Microsoft .NET Framework 2.0 is required for running the executable.
Getting the files
There are two ways to get a working neoncube executable, either you download the source code from svn or you download the compliled version. For people who are new to programming, I suggest to use the compiled project because I won't go in detail here on how to compile the source.
Neoncube compiled: http://rapidshare.com/files/88106288/ne ... 2.rar.html
Neoncube SVN: https://osrosepp.svn.sourceforge.net/sv ... /Neoncube/
Configurate neoncube.ini
First you have to open the neoncube.ini inside the \neoncube\ folder. At the top you can find a description for the various variables which is in my eyes not very clear at some points. I hope that I can make it more clear for you:
server_name: The name of your RoseOnline server (EG: SpeedRose)
notice_url: URL of a news system or a server status checker (EG: www.srose-online.com/news.php)
patch_site: URL of your patchsite (EG: www.srose-online.com)
patch_port: Port of your webserver (standard: 80)
patch_list: Absolute path to patchlist.txt (EG: /patch/patchlist.txt)
patch_folder: Path to the folder where your patches are stored (EG: /patch/)
executable: Name of the game's exe (EG: TRose.exe)
ragexe_call: Additional parameters for game's exe (EG: TRose.exe @TRIGGER_SOFT@ _server 127.0.0.1)
registration_link: URL of the website registration (EG: http://www.srose-online.com/index.php?link=reg)
skin: Name of your skin folder (EG: skin_default)
vfs_file: Name of the vfs file for patching (EG: 3DDATA.VFS)
startup_option: Just leave it at 3 for the best result (or read the description in neoncube.ini)
Setting up patchlist.txt
First create a patchlist.txt where you have setted the path to in the neoncube.ini. In this case it is http://www.srose-online.com/patch/patchlist.txt. This is not the path we're using for out patches, so don't wonder when it says "file not found".
There are two kinds of "flags" you can use in the patchlist: FLD and VFS. FLD is for writing to a data folder, or any other folder in the RoseOnline directory. VFS is for writing to the VFS specified in the vfs_file in the neoncube.ini.
At the beginning of every new patch, you have to use an "ID". NeonCube grabs the file patchlist and reads the ID of the patch. If the number of the patch is higher than what the number in the neoncube.file in your user's directory is, it gets that file, then the next if there is another patch. The neoncube.file will be created automatically for the patcher to see which patches the user already got.
If you want to update an excisting file, you have to remove it first. Removing a file is very easy, you just have to put a "*" at the end of the line.
A patchlist.txt can look like this:
1 VFS 3DDATA/STB/LIST_NPC.STB*
2 VFS 3DDATA/STB/LIST_NPC_S.STL*
3 VFS LIST_NPC.rar
This deletes LIST_NPC.STB and LIST_NPC_S.STL first and extracts the new files in the LIST_NPC.rar to the 3DDATA.VFS right after. The data structur of the LIST_NPC.rar has to look like the following: 3DDATA/STB/LIST_NPC.STB | 3DDATA/STB/LIST_NPC_S.STL. Terr0risT provided a screenshot which should make it more clear for you: http://img163.imageshack.us/my.php?imag ... istqz8.jpg
Things to know:
- You must put each patch on a new line.
- You must increase the patch number by -atleast- 1 each time
- You must have all the patches in the same folder as the patchlist.txt
- You must use the rar file format when you plan to use the FLD flag
Closing words
I hope you enjoyed this guide about the neoncube patcher. Please check this thread from time to time because of new updates.
Edit by lmame:
If on your website you have:
-> your news here: http://www.your_site.com/news.php
-> your patchlist.txt here: http://www.your_site.com/patch/patchlist.txt
-> your patches (like patch01.rar) here: http://www.your_site.com/patch/
Then in the "neoncube.ini" file, you should have:
Do exacty like this else you'll have some weird problems...
Edit 2:
In this post there is an .exe that deletes a file before it's inserted in the VFS:
viewtopic.php?f=28&t=716&start=320#p27261