Setting up a server

From ECO Wiki
Jump to: navigation, search

Setting up Eco Server[edit | edit source]

1447993034722-server-1.png

Ok, here is a quick start guide on how to set up your Eco Server. Right now i am using a non feature complete pre alpha version, and your version might be very different. i will try to keep this post updated.

it seems there is a build missing ExportedMods folder in the mods folder .. this might create issue when joining a world not loading for the client .. manual creating it might fix the issue

First of all Eco Server Default ports are: 3000 for the client 3001 For The Web interface !!! when manualy adding the server to the client list you need to use the web port !!! ( is used in voting for laws and so on ) you can change the default ports under the network tab and then select the Config tab There is a new setting under network / config called Public server. You need to set this value to true if you want your alpha 4 ++ server shown in the server browser When you opened all the ports in your router and firewall you can proceed to start the server exe. You can go here and check how to portforward your router portforward.com You will be then meet with a console status window ( don't close this one or your server shuts down)

your folder structure should look like this : Main Folder / Builds - here you can find your server exe Configs - here are all your configs in a json text format Logs - here are some server logs Mods - here you can install your mods Storage - here the world data and user data is saved .. if you want to reset your World and user data just delete all content in here WebClient - here are the files for the Law system web server stored

1447993041480-server-2.png

if you are meet with the error message on start up as shown above you server has insufficient rights and cant host the web ui. you can easily fix that by running the server as Administrator.

1447993046722-server-3.png

After the initial core has loaded you will get a second window. Her you can configure your server and can see the status of your server. It will take some time for the world to generate. after this window has loaded. but you can follow the progress here.

1447993052333-server-4.png

Under the tab World Generator you can change world size, seed and many other options on how your world will be generated. You can easily regenerate your world by going to "World" menu and regenerate the world ( This will not affect players and other placed objects like doors) or you can also stop the server and delete the content in your "storage" folder that is with your server folder.

1447993057922-server-5.png

The UserManager Window tab lets you set a white list or blacklist users by there name.

Setting up the network[edit | edit source]

Eco Network Map.png

I will refer several times to the image above here, Several computers , phones etc are numbered from 1 to 6. I will refer to these numbers. The map above is help to visualize where we are on the network.

Hosting a private server just for your self requires to add eco server to the windows firewall while public or private servers that other players outside of your home should have access to require also configuration to your router. Since routers have different configuration methods and pages I wont cover those but I will give an example on standard ASUS routers that are very simple. You need to google how to forward ports for your own router!

Setting up the firewall on your server (1)[edit | edit source]

!!! 3rd party AntiViruses software or firewall might still block ports even if you open them!!!

Please configure those software or disable them if needed!

To get your server configured you need to open some ports before you can start the Eco Server.

You can find your firewall options in your control panel ( on newer version of windows you can just hit the windows button and search right away for the firewall application) 

Firewall Shortcut.PNG


When opening the Advanced Firewall settings you are med with a screen that has allot of rules from before. Please select the “Inbound Rules” and click the “New Rule…” button.

Firewall Overview.PNG


This will open a wizard. Here you should select that the new rule should be a port rule (Selecting Program might later cause issues when updating the server!)

Firewall Wizard 1.PNG


On the next screen you should select TCP and give the rule a specific port range. A "from - to" range can be set with help of the “-“ sign. This means if you like to open port 3000 and 3001 you should write 3000 – 3001 (reference image below)

Firewall Wizard 2.PNG


On the next screen you select what to do with these ports. Here you should let the default “Allow the connection” stay and click to the next screen.

Firewall Wizard 3.PNG

For the next screen let all items remain checked ( All of them should be selected by default!)

Firewall Wizard 4.PNG

Finally you need you need to name your rule. Good naming practice now, will make it much easier to find the correct rule later; should you need to make adjustments.

Firewall Wizard 5.PNG

Forwarding your router ports (4)[edit | edit source]

To give other people access to your server you need to tell your router how to handle incoming request from certain port that come from an external computer like a friend that is living in another town (6).

On an Asus router you can find these settings under Wan -> Virtual Server / Port Forwarding. ( I censored my own setup to keep my server secure but this should give some idea). First of all you need to set a name (Service name ) . The next item is the port range, on my router I would write 3000:3001 to give it the right range . Next item is the local IP. This should be your server iIP (1) my IP would be 192.168.0.60. The next thing is the Local port, normally this should be blank.

Router Forwarding.PNG


Troubleshooting[edit | edit source]

Normally if you did the above as described you should now have a server that people could access.

If not, you need to troubleshoot to find out where the issue is.

• Check if your server is running properly. On your server(1) open your browser and type Localhost:3001

If your unable to see the your eco server site you might need to start the server as an administrator. Other possible issue can also be an outdated .net installation. Its recommended to have at least .net 4.6.2 or higher !, you can download .net 4.6.2 from here https://www.microsoft.com/en-us/download/details.aspx?id=53344


• Repeat the same thing but from a different computer (2) or phone (3) that is connected via cable or WiFi to the same local network. You will need to write the server address this time in your local browser instead of local host. In our case I would write 192.168.0.60:3001.


If you are unable to see the eco server status page you have not opened your local firewall. Remember that external antiviruses like AVG , Kaspersky etc running on your computer that host the Eco server might still block your ports. Disabling or uninstalling would be the simplest solution here. Another cause could also be that you have not configurated the right ports. (in future you might also need to open UDP ports instead only TCP ports ).

• So far so good. most likely your local network is now working properly but other people can't still see your server. First of all check if you can access the server page again. For this you need a device(5) or computer(6) that is not connected to your local network. You also need to know your external IP address. You can find your external IP address by visiting this site from any device or computer on your local network (1),(2) or (3). You can find your external / public IP herehttps://www.google.no/search?q=whats+my+ip&oq=whats+&aqs=chrome.0.69i59j69i57j0l4.1063j0j4&sourceid=chrome&ie=UTF-8 . Lets say google did tell me that my local IP address is 77.77.77.56. I should try to connect via my external phone(5) or computer (6) with the web browser to the address 77.77.77.56:3001.

If you are able to connect but you cant see the server in the server browser you might have forgotten to set your server in the server configuration to public. This can be done via the Eco Server GUI under Network/Config/ServerIsPublic set to true. If you are unable to access the eco server status site from an external Device (5),(6) you have most likely miss configurated your router and need to reconfigure or restart your router. There is not allot more to this actually .. in most cases it is this simple. If you have additional questions or issues please search and post on the forums and if your issue is still unresolved, send a message to Eco Support at [email protected]

One last thing. It seems that some people got a DS-Lite tunnel or other similar on there router, this unfortunately will make it impossible to to host a Eco server since open ports wont be forwarded in this network configuration. You can try to ask your ISP to give you a normal ipv4 address instead of an ipv6 tunnel with a shared ipv4 address by several customers like DS-Lite does.