WELCOME TO DARKSIGNS TUTORIAL:

This tutorial was done with the target of guiding users with DarkSignsOnline from scratch, so they don't have any problems later we will see all the DSO functions and features one by one.

(This tutorial may be uncomplete, I'll keep updating it)

The DSO Window:

Well, after installing DSO on you computer and registering an account on the webpage, you can run it just like another program or game, you'll find this:



Let's explain it:

1. This is the login state, login is the first part we are going to look at before doing anything else.

2. With these buttons, you can minimize or close DSO, you can also hit 'esc' key for closing DSO.

3. This is the Communication Window, or CommWindow for short, it displays basic info, as login, connection and transfers. As you can see, in this image it is notifying us about problem in login, what is what we are going to do next.

TIP: You can read the chat in this window too if you want, you just have to enter:

On the command prompt.

4. This is the main window, here we are going to see what we are doing, as monitor running scripts or just the local echo of the commands we are giving (local echo means the results that our commands are giving on the console)

5. This little thing is the prompt, if you ever tried using cmd or bash in real life, you shouldn't have much problems with it from now on (If you know how does this work, just read the login part of this tutorial, and then you can skip all the basics that will go below it, and go to the next section of the tutorial). It is used for typing the commands that we need to give to the console.

6. This are the console swap buttons, (yes, you can use up to 4 consoles) if you press any of these buttons, you will change to the console indentified with that number, you can also use F1, F2, F3 and F4 keys respectively for consoles 1,2,3 and 4.

7. This button is used to show/hide the CommWindow.

8. This is the chat button, it works with IRC and on this tutorial, we will see how it works later. You can access the chat by clicking this button or pressing F5.
Note: You go back to the desired console, as explained in point 6.

9. This is the database button, usually called just 'db' by other users, which will be explained later too, it is a very useful window, where you can find all scripts that users wanted to share, anything that you download from db goes automaticly to the /downloads directory.

Logging in:
Alright! That were the basics that you needed to know for getting started with DSO, now we are going to start with the real thing:

Well, as you can see... You aren't logged in, you just have to set up your username and password like this:



As you can see, I just gave the console the two following commands. (in white as they appear)

The universal formula is this one.

Where your username goes on <username> and password on <password>
Note that the <> symbols are for defining a variable word, that symbols will never be typed, ok?

For example if I want to tell you to enter your name in a command, I will tell you like this:

Where the variable is your name in this case.

Well, let's continue, after setting username and password on the console, we just give this command to login:


And this is the result:



Now in CommWindow you can see the login info, (I've hidden my personal data, the basic of any user that just started in DSO is: "You have $200 and 1 domain names") And the login status is diplayed as "You are online as <username>"

The console filesystem:
Well, if you followed the instructions propely, you are ready for using your console.
Let's get started with the local filesystem (or console filesystem) which is the one that is saved on your computer.

First of all, let's clear the window, since we have lots of stuff there, right? Just type:

or

command for clearing up the main window.

Ok, the console always starts on root directory, which is being displayed on the prompt as "/" now, we are going to take a look at what more have we got in there. Just use:

Command for displaying the whole content of the current directory, the result will look like this:



As you can see, you have three directories in root by default.
Downloads - Where downloads from db go.
Home - Where you can save all your stuff
System - Where the files can be edited, so you can customize and set up some console features, such as security or startup script.

Well... We are going to try creating a file for playing with it on the filesystem, such as moving, copying, and deleting it.

Creating a new file:
Let's start, just use:

command, calling the filename as you wish.
The editor window will appear, type whatever you wish in the file (this one is just for testing) and click "close and save" button.

Now, just use the "dir" command again, the file will appear now, (I just called it "testfile.txt" for this tutorial)



Moving a file:
Well... now your file is on root... but you may want it on /home , right? Let's try moving it to the /home directory, just try this:

So, if you did right, the file will be now on /home dir.
Let's check, we have to change of directory (cd, for short, the command is called in same way)
So just try:

then




Great, our file is where we wanted it!

TIP: For renaming a file, you just have to use this command:

You can also rename when moving just with:

Where "path" is the dir where you want the file.

Copying a file:
Let's go back to previous dir, (root) just use:

Copying a file just works as moving it, but we get a copy of it on the desired location.
Just try repeating the last process, but just changing "move" with "copy" on the commands.

Deleting a file:
Well... we are already tired of that file, don't you think? We already know how to move files, so we can delete it.
Just use:


Creating a directory:
It's as easy as:


Deleting a directory:
Easy too:

Note: The deleted dir must be empty before deleting, if not, it will not be deleted.

Working with paths:
Well, so we know how to move, copy and delete files, we also know how to edit them just for creating a new one or just editing it. But, now, we are going to do the same just without changing of directory, so in this part of the tutorial "cd" command is forbidden, ok?

For practice, just create a new file, and make a copy of it on /home folder, and then move the original one with other name, as we did before.
Now, just try to get back that copy, moving it with another name to root dir.
Just try:


After this, try the same for deleting all files you have moved/copied. Using the same process.

Two important things:
- Root path is just "\".

- You can use multiple dir paths as: \home/<other dir>/<filename>
Just try it, for practice if you want.

Well... We already know how to use the most basic things on local, now let's go out to the world!

The DataBase:
Also called "db" by most users, it is full of useful (and, well... also not so useful) scripts that can be taken as reference, and usually used freely.

The main objective of this section is to show you how to download an script from the database and make it work in a server (notice that you obviously can use your own on the servers), I will explain how in-game servers work during this tutorial.

Let's get started:
If we click the "db" button, this window will appear:



Let's explain this:

1. Script category menu

2. Avaiable scripts list

3. These buttons are very useful, they are used for uploading, and removing your own files over the db. The last one "Text space" is some space where you can find some text channels, where users share texts or whatever. Just try it if you want, but please, don't delete other user's text channels.

4. Download selected file, in this image, as you can see I already selected the script that I choosen as example for this tutorial, just let's choose a file (please, don't try with malware, it's annoying to find malware in domains) and download it using that button.

Well, we have the file, so where does it get stored? You're right! It's on "downloads" directory, you can move it using the methods explained on the previous section of this tutorial.

Uploading a script to a server:

So then, let's try to make the script work in your server, I've choosen this one for the tutorial, because it needs some little set up, as others may need too. Just try to:

When on the correct directory.

Let's read the file comments and follow the setup instructions carefully, we have to set a username and a password, pay attention! Never put your REAL account password on the script, the source can be downloaded by other users, and then the password read by others!!!

After we set up that username and password for the script, we upload it to the server, any server usually has a main script on port 80, so it can be easily found by simply connecting it. (other ports may need portscan in order to be found)

Well, we need to know which is our domain name, our starting one is always <username>.usr, in my case it is saberuneko.usr, you can register more domains when you get more cash in-game, but you can have some extra others using part of your $200 which you start with.

If you still not sure of what domains/servers do you have, just try this command:

It will show a list of all the domains you have.

So, once we know how is our domain name, just let's try to upload the script to our server:



Well! What did the set-up say? Yes, we have already set up that username-password and stopword... so we only have to log as admin and reset the guestbook. Let's connect to the domain:



And login as admin, just use the menu. Then reset the guestbook.
Ok, now, we have a completely functional guestbook script running on your domain, just try it, it should work!

Closing a port:
When you need to close a port, just use the following command:



Server Theory
This is all theory about servers, how they work and the differences between port scripts and filesystem files.

All servers have ports that you can open from port 1 to 65536, like happens on RL.
On ports you always have to upload scripts because connecting to a server port will run that script, if you put a file, it won't be shown properly!

On filesystem, you put all other files, you can put scripts too, but it's hard to run them from there, so there we have other files, that can be back-ups, log files or configs from server's scripts!

Listing files in a server:

Let's just have a look at the server's filesystem:





This command will show you the files contained on the server's filesystem, differently than the local filesystem, servers haven't got directories, only files.

Removing files from a server:

As you can see, uploading the rsg.ds to your domain just created the file that it needed to work, let's make some cleanup!

Just use the following command:



The file should just dissappear.

Using the DYNIX:

DYNIX is a powerful file manager for any server, it needs easy configuration, just follow the same process as we did before: Locate and download DYNIX from the db > Edit file following the comment instructions > Upload it to some special port (Try to avoid uploading the DYNIX to port 80, just use another one, this script is just for personal use, so you will be it's only user.)

After uploading the DYNIX, just connect to the port where you uploaded it, If you have followed it's instructions properly, it should be running on your server. Let's connect:





I usually use port 23 for DYNIX, since it works somewhat similar to the RL telnet...

Ok... if this appears (with your username instead of mine) the dynix is running properly and waiting your command.

Let's check what functions does this tool have:





As this tool is just awesome, it explains itself perfectly! Just have a look arround and try all the functions.

Basicly, that's all what we need for working with the filesystem.

Advanced Server Usage:

PORTSCAN:

Let's get started with the real thing:
You can open as much ports as you want in your domain, just have to upload scripts to them, some usual problem comes when we forget which ports are used... It's portscanning time!

For portscanning, you have various options:
- Script your own portscanner.
- Use another user's scanner which you can download from the db, (or forums).
- Connect to my server (sky.net) which has some powerful scanners.

RANGED IP SCAN:
You sometimes will need to scan in a range of IP numbers, (usually needed on some missions), same happens here, you have the same three options.

USING THE IRC (INTERNET RELAY CHAT):

Well, in this part of the tutorial, we are going to learn about how to use the IRC chat window.

First of all, we click the IRC button or press F5



We will find something like this, (notice that I just cleared most part of the IRC window, because it shows lots of personal information, let's take a look at it's parts:

1. Status window, just ignore it, you can report any issue telling us the error info that appears on this window in case of experiencing any problems.

2. Users on chat

3. Chat window

4. You type here

BASIC SET UP FOR IRC

Changing your nickname:

You usually start with a default nickname that usually follows this rule DSO_<username>_<two cypher random #>
If you want to change it just use:

On the IRC window.

Registering the nickname:

Since you feel comfortable with a IRC nickname, you might want to register it, so any other user can't use it!
Change to that nick with "/nick" command, then just use this other command, also typed on IRC window:



A confirmation email will be sent to your mail account, after confirming it, you can use your nickname only for you!

Identifying the nickname:
When you have your nickname registered, you may be asked to confirm it each time you login for being able to use it on IRC with this message:


Just follow the instruction:


Using the IRC from console (Advanced Set-Up):

Thanks to a command and one of my scripts, you can chat from console, this part of the tutorial will help you with that.

First, just set the console for receiving the chat messages on the CommWindow, just use this command in console:



Then, locate the "Console Quick Answer 2" script (Mine), and download it... it's set up is a little harder, you have to move the file manually using windows' browser (if you try to move it using the console, the access will be denied)

After downloading the file, close or minimize DSO and move the "cs.ds" script to the "system/commands" folder, after doing this, just restart DSO.

After this setup, you can now read messages on the CommWindow, and reply from the console using the script.
You just have to type:

Then push enter, enter the message, and push enter again. For letting you know that you are typing a message, the text line you are typing changes to yellow color.

A last little useful script that you can add to the console is the "Clear All" script, (done by me too) that can be found on the db, you just set up in the same way you did with "cs.ds", it is useful for clearing both windows at the same time, since DSO has not got an original command for clearing the comm window.
The script is used with this simple command:

The next step is learning how-to script! But that's another tutorial, whenever you feel ready, just go on!

viewtopic.php?f=9&t=959