Installation Guide Update

[mrantares]

Installation Guide Update

[MrAntares]

Added /api.html and tools/build/index.html anyways. The client/index.php is already there.

fd610f1
87e93e9

Feel free to list any still missing files.

[MrAntares]

@cheffNFT You are absolutely right, it is somewhat confuzing to get started, but really it is not that complicated. There are many options, but I never tried all of them only one. Out server uses websocket+wsproxy. It is the best method so far.

• You install and start the WSProxy on a port like myserver:5900, that points to the server's address that you use with a normal desktop client, like myserver:6900.
• You add your grfs and the DATA.INI (grf order) to the client/resources folder in robrowser and the clientinfo.xml (client-server information) to the client/data folder and if required set up the client/configs.php so that everything points to the right folder and file.
• You create a blank html with a DIV that has the ID "robrowser"
• You add a script that references the api.js
• You add a script that configures the roBrowser api with websocket+proxy and you provide all the addresses and settings, eg:

function initialize() {
				var ROConfig = {
					target:        document.getElementById("robrowser"),
					type:          ROBrowser.TYPE.FRAME,
					application:   ROBrowser.APP.ONLINE,
					remoteClient:  "http://yourserver/client/",
					servers: 'data/clientinfo.xml',
					socketProxy: 'ws://yourserver:5900',
					development:    true,
					packetver: 20120410
				};
				var RO = new ROBrowser(ROConfig);
				RO.start();
			}

• and finally call the initialize after the page loads at the end of your script tag:

window.addEventListener("load", function(){ 
					initialize();
				}, false);

That is all.
Unfortunately, you need to understand a bit how this whole stuff works on client and server side and a bit of HTML/JavaScript to make it work, because there are many things you can configure, but you can always peek from a working example, just like I did from the original roBrowser test server.

[waken22]

I'm gonna point out my experience, because i think it could be useful for a future detailed guide.

If you are having problems to login to map-server consider the following steps:

1- Disable pincode.
2- Disable packet_obfuscation. (no idea if this is supported out of the box by robrowser using Packet Encryption)
3- If you are using wsproxy (in windows) i needed to press enter to make it work, it's weird but it happened to me.

And if robrowser is not loading the resources, please, open the network chrome tab and check if the path is correct or not, and then modify ROConfig.remoteClient accordingly.

[waken22]

And another reminder, for remote client yes, it's kinda obvious but you are gonna need a web server (apache using xamp, lamp) or whatever to serve the php files.

[wjrosa]

Hello!
You will still need those files. I guess they got removed due to copyright issues (that caused the original repository to be taken down). But I think you can still grab them there:
https://github.com/vthibault/roBrowser/

[juliolitwin]

@MrAntares
Which client version you recommend to use?

[MrAntares]

I use clientver 30, which is 2012.04.10. Our server didn't change version eversince, because the login window was removed, and I didn't want to fiddle with the 3rd party login tools. The last packet change that is implemented is 2014.10.22 if I remember correctly. Any change after that needs to be implemented (but many are missing from before as well). I'm not sure how rAthena handles packets nowadays, but you can always reference it's source how packets are implemented, or ask for help from rA devs.

[xptodevx]

there are no settings.js anymore. I'm not very surprised people not using this alternative, the installation docs originally were impossible to follow. literally, even for experienced devs and operators, the instructions are far from clear and straightforward.
I dont know if the chrome app is possible now because the older file settings.js is not there anymore and I dont know why.
another point of concern, where the hell should we download compatible client version? which one is exactly perfect for this?

[MrAntares]

Fixed in b094c85