What's new

Welcome to RetroTools.XYZ - We Make It Easier To Manage Your Habbo Retro By Yourself!

Join us now to get access to all our features. Once registered and logged in, you will be able to create topics, post replies to existing threads, give reputation to your fellow members, get your own private messenger, and so, so much more. It's also quick and totally free, so what are you waiting for?

Free Nitro Websocket Proxy

Tired of paying to avoid random disconnections and want better protection on your Habbo Retro? Please click the icon on the top right.

Answer

Answer Questions and Become an Expert on Your Topic

Contact Staff

Our Experts are Ready to Answer your Questions

How to set up a retro in 2022 | 2023 (IIS) (Nitro HTML5) - (Part 1)

RetroPlug

Member
Staff member
Management Team
Joined
Nov 12, 2020
Messages
37
Reaction score
13
Points
8
Hi RetroTools 👋

I've seen on multiple occasions that some people wish to make their own retro, but struggle to do so! This is why I've decided to take the time and write a three-part series that covers everything from A to Z, using modern & updated technologies in the year 2022.

We'll be using Windows IIS to set up your new Habbo retro - The reason for choosing IIS is that it's a lot more user-friendly than for example a Linux server and I believe most people looking for a series like this are more comfortable using Windows & having a GUI, rather than a plain terminal ✨

Internet Information Services (IIS) setup
MariaDB setup
PHP 8.1+ setup
Composer v2 installation
GIT setup
Cloudflare setup
Atom CMS setup
Atom HK setup
Arcturus Emulator 3.5.1 setup
Volta (multi-node version support) installation
Java installation
Nitro v2 setup (Latest as of October 2022)
Nitro Converter setup

A Windows VPS - If you currently don't have a Windows VPS you can buy one from
Please, Log in or Register to view URLs content!
.

Contabo is the host I personally use for all my servers, as they are stable, one of the cheapest on the market, and offer one of the best value for money when it comes to servers - Here's a direct link to the server setup I would recommend you from Contabo:
Please, Log in or Register to view URLs content!
.

You can however use any host you'd want, it doesn't have to be Contabo, the important thing is just that it has Windows on it.

You'll also need a domain for you and your users to visit - I personally recommend
Please, Log in or Register to view URLs content!


Enough of the introduction! Let's get started 🚀

The first step of our journey is to install & set up IIS and to do that, start by opening the "Server Manager" application if it isn't already open.
  1. Click on the "Add rules and features" button - A popup should appear showing a "Before you begin" introduction. Click on "skip this page by default" unless you want to be prompted with this introduction every time you open it
  2. Click on "next" and make sure "Role-based or feature-based installation" is toggled and then click "next" two times (this should land you on the "Server Roles" section
  3. Within the "Server Roles" section scroll down until you find "Web Server (IIS)" and check it (a popup should appear, within this popup click "Add Features". Once done click on "Next" 3 times. This should land you on the "Role services" within the "Web Server Role (IIS) section
  4. Scroll down until you find "Security" and check the "IP and Romain Restrictions"
  5. Open up the "Application Development" category (should be just beneath "Security") and check "CGI" once checked, click "Next" and "Install"
Step two:
  1. Install the PHP Manager extension -
    Please, Log in or Register to view URLs content!
  2. Install URL Rewrite extension -
    Please, Log in or Register to view URLs content!
Once the steps above have been followed-through, you should be able to enter your server IP within your browser and see the IIS Installation screen. Which would look like this:

1669998359521.png
Add the .nitro MIME type:
To allow us to connect to our client, later on, we must tell IIS to allow ".nitro" file types otherwise, IIS won't accept them and therefore not allow us to connect.

To add the ".nitro" MIME type, all we have to do is open up our "Internet Information Services" application, expand the section just beneath the "Start Page" and double click on the "MIME Types" module:

1669998423393.png

Once you have double-clicked on the "MIME Types" module, you should be able to click "Add..." in the right top corner. when "Add..." has been clicked, a new popup should appear asking for a "Filename extension:" and a "MIME type:".

In the "File name extension:" field add ".nitro" and inside the "MIME type:" field add: "application/octet-stream" and click "OK".

Here's a GIF on how to do it:
Please, Log in or Register to view URLs content!

Requirements:
  • Any text editor / IDE of your choice - My personal recommendation is
    Please, Log in or Register to view URLs content!
  • Git -
    Please, Log in or Register to view URLs content!
    - Click on the
    Please, Log in or Register to view URLs content!
    button
  • PHP 8.1 or greater (This guide will be using PHP 8.1) -
    Please, Log in or Register to view URLs content!
    - Select the "VS16 x64 Non Thread Safe" (it should be the first one - As .zip format)
  • Composer v2 -
    Please, Log in or Register to view URLs content!
    - Select the "
    Please, Log in or Register to view URLs content!
    "

Install an editor of your choice:
As mentioned before, it's totally up to you to choose which text editor / IDE you'd want to install & use, the most important thing is to use something you're comfortable with. My recommendation however is Visual Studio Code which you can
Please, Log in or Register to view URLs content!
. Once downloaded simply go through the setup process, by clicking next until finished.

Install GIT:
You'll have to install GIT as not only is it an amazing tool, but it will also be necessary for us later on.
To install GIT simply
Please, Log in or Register to view URLs content!
and go through the installation process, by clicking next until finished.

PHP 8.1 setup:
In this tutorial, we will be using PHP 8.1.x which is the most recent PHP version as of October 2022.

To set up PHP 8.1 you'll simply have to
Please, Log in or Register to view URLs content!
and choose the "VS16 x64 Non Thread Safe" (which should be the first one).

Once downloaded browse yourself into
Code:
Please, Log in or Register to view codes content!

and create a new folder named "PHP".
Once the PHP folder has been created, simply copy all the downloaded PHP files into your new "PHP" folder.

Register your PHP version
To make sure IIS will be using your newly downloaded PHP version, open your "Internet Information Services" application, click on the section just below "Start Page", find the PHP manager module, and double-click on it.

1669998524232.png

Once you have opened your PHP Manager click on "Register new PHP version" when clicked a popup should appear, asking you to provide the path to the PHP version. Click the 3 dots next to the input field and browse into C:\Program Files\PHP and select the "php-cgi.exe" and click "open". The path to the "php-cgi.exe" should now be set and click "OK".
If everything was successful you should now see your PHP version etc all within the PHP manager tab

1669998552296.png1669998583645.png

Install the necessary redistributables:
PHP requires you to download some redistributables, you don't really have to think anything of it. Simply
Please, Log in or Register to view URLs content!
and go through the setup process, by accepting the terms and clicking next until finished.

Composer setup:
It's time to set up Composer. Composer is in the short-term a package managing tool, that we will be needing later on to install the necessary Composer packages required for Atom CMS & Atom HK.
Please, Log in or Register to view URLs content!
and select "
Please, Log in or Register to view URLs content!
".

Once Composer has been downloaded, open the "Composer-setup" application that you just downloaded and select "Install for all users (recommended)".

You'll then be prompted with "Installation options" leave it as it is and click "Next". Once you have clicked "Next" you should see the "Settings Check" which a little further down should have your php.exe listed automatically for you. If the path seems correct check the "Add this PHP to your path" and click on "Next".

If for whatever reason the automatically selected PHP path isn't correct simply click "Browse..." and browse yourself into "C:\Program Files\PHP" and select "php.exe" then click on "Open" and make sure the "Add this PHP to your path" is checked, then click on "Next".

1669998610724.png

Once you've clicked on "Next" you'll see a "Proxy settings" screen, leave everything as it is and click "Next" and "Install" - Once Composer has finished its installation click "Next" and then "Finish".

The composer is now fully installed and ready to use!

To get started, with the installation of MariaDB click the "Download" button on the
Please, Log in or Register to view URLs content!
.

Next, open the installation file, that just got downloaded and click "next" until you reach the part where you have to set a password for the root user. Fill out a secure password, that you have noted somewhere safe. It's important that you don't forget this password as it will be the password to access your database. Once you have filled out the password fields, go ahead and check the "Use UTF8 as the default server's character set" - It should look something like the image below:

1669998689126.png

Click "Next" and leave everything to their default presets until you can click "Install" then click "install", and wait for the installation to be finished. Once the installation has finished click on "Finish".

Hurray! Your database server has now been set up and will be ready to use 🎉

To manage our database, we'll need a database manager. In this series, we'll be installing DBeaver, which is a free but yet powerful manager.

MariaDB automatically installs HeidiSQL however as we're going to use DBeaver, you can go ahead and uninstall HeidiSQL if you wish.

The first step will be to install DBeaver itself, which
Please, Log in or Register to view URLs content!
, and select "
Please, Log in or Register to view URLs content!
".

Once DBeaver has been downloaded, go through the setup process, by simply clicking "Next" until you can click "Install" as it's not necessary to select or change anything.

Open DBeaver and click "No" to the popup asking if you want to create a sample database.

Select "MariaDB" from the list of database servers and click on "Next".

1669998776295.png

Database credentials:
It's time to connect to our database server and to do that, you'll have to fill out the necessary credentials, which will be the following:
Server host: localhost
Port: 3306
Database: Leave this field empty
Username: root
Password: The password you set when installing MariaDB

Once the credentials have been put in place, click "Test Connection" which will ask you to download the necessary drivers, which you can install by simply pressing "Download".

If the filled-in credentials are correct, DBeaver is going to show you a success message looking like the image below.

1669998796939.png

Simply click on "OK"

Create a new database:
Double-click on your "localhost" connection showing on the left side of DBeaver and then right-click on the "Databases" folder and select "Create new database" which will show you a popup asking for a database name.

1669998811411.png

Fill in a database name of your choice (in my case I'll just be using "hotel" as the name) and click "OK" - The Charset & Collation doesn't have to be changed from their default preset.

1669998839485.png

Import your Arcturus morningstar database:
To import your Arcturus morningstar database, you'll have to clone it down from the GIT repository first, and to do that all you have to do is:
Open your CMD (Command prompt) application on your server and write:

Code:
Please, Log in or Register to view codes content!

and press enter.

Next, write the following

Code:
Please, Log in or Register to view codes content!

and press enter.

A new folder will now appear on your desktop at your server name: "arcturus-morningstar-base-database"

Next, open up your DBeaver application once again, right-click on your newly created database and hover the "Tools" and select "Restore Database" Which would look like the image below:

1669998907529.png

Once "Restore database" has been selected, click on the orange folder next to the "Input File:" field and navigate to your desktop -> arcturus-morningstar-base-database folder, and select the arcturus_morningstar_default_db_without_roomb.sql file. Once the .SQL file has been selected click "Start". The database import will then start. Once it has finished successfully a popup looking like the image below should appear:

1669998930262.png

click on "OK" and then click on the "Script configuration" on the top left corner and repeat the process for all the .sql files (except the: purchase_history_addon.sql & the hotfix_1.sql) inside the "SQLUPDATES" folder as well as all the .sql files inside the "ADDONS" Folder.

In case "patch1_2_final.sql" fails just skip to the next.

If you feel a little confused and don't know what exactly to do, that's totally fine. Here's a gif of the entire database import process:
Please, Log in or Register to view URLs content!


Once you have successfully imported all of the .sql files double click on your database to make it show all the newly imported tables.

You have now successfully created and imported a database for Arcturus Morningstar, which we, later on, will be connecting to Atom CMS & Atom HK when setting that up.

To add some basic protection to our hotel, we will be adding Cloudflare.

Cloudflare makes it a breeze to set up DNS and add page rules, on top of that it adds a decent layer of protection to our hotel as it will automatically proxy your server IP (hide your server IP so if people are trying to find it, they will get Cloudflare's IP) once set up, it will also do its best to mitigate DDoS attacks for you.

I will not cover how you can set up a hotel without a domain or without Cloudflare. If you don't want to use Cloudflare to set up your hotel, you'll have to figure out how to set up a hotel on your own.

Cloudflare setup:
The first thing you'll need to set up Cloudflare is a domain. You can purchase a domain from plenty of different domain providers - My recommendation is
Please, Log in or Register to view URLs content!
.

Once you have got your hands on a domain, head to
Please, Log in or Register to view URLs content!
and either log in or create a new account.

Once you have logged in or created your new account, click on the account within the "Accounts" section and then click "Add a site" (the blue button on the right).

You will now be sent to a page where you can enter your domain name, once you have entered your domain name click on "Add site".

Once your site has been added, Cloudflare will ask you to select a plan. Scroll to the bottom and click on the free plan and then "Continue"

Cloudflare will be scanning & reviewing your DNS records, once that has been done a full list of your records will be shown. Delete all the records except the "A" record and the "CNAME" record at the top - To delete a record click "Edit" and then "Delete"

Once all the records have been deleted, edit the IP address attached to the A record so that it contains your VPS IP.
The CNAME record should be changed so that the content field matches your domain name.

It should look something like this screenshot (with your domain & VPS IP)

1669999027584.png

Once the above has been done click on "Continue".

Cloudflare will then take you to a page explaining what you should do with your nameservers.

Once you have replaced your nameservers, click on "Done check nameservers"

* It may take up to 24 hours before nameserver changes take effect. However, in most cases, it won't take very long before the changes have been processed.

The next step will be Cloudflare showing you a "Quick Start Guide"

Click on "Get started" and allow the following
Automatic HTTPS Rewrites - On
Always use HTTPS - On
Auto-minify CSS and HTML
Brotli - On

Once your nameservers have been changed and registered your Cloudflare should look like this

1669999050689.png

That's it! easy right? Your Cloudflare has now been set up and you're now ready to set up Atom CMS & Atom HK 🔥

Head to part 2 of the series and learn how to set up Atom CMS!
Part 2 of the How to set up a retro (IIS)

Did I miss anything?
Please let me know if I've missed a step 🚨

Credits: Object / Dennis
 
Last edited:

AgentCasserole

New member
Joined
Jun 16, 2023
Messages
3
Reaction score
1
Points
3
update: I am very new at all of this, trying to get PHP setup
 
Last edited:
shape1
shape2
shape3
shape4
shape7
shape8
Top