Dev Environment setup

The Server setup is quite complicated and individual steps might change. Join the discord server and ask in #general-dev for setup help if you run into issues.

1. Download and install dotnet 7
2. Install HKO like normal using the latest launcher

This makes sure that your client is fully up to date.

3. Download and install MariaDB 10
4. Clone this repo to any directory and open a terminal prompt in said directory
5. Open a Mariadb console and input the following:

CREATE DATABASE hko;
USE hko;
CREATE TABLE account (
  id bigint NOT NULL PRIMARY KEY,
  username tinytext NOT NULL UNIQUE KEY COLLATE utf8mb4_general_ci,
  password tinyblob NOT NULL,
  data text DEFAULT NULL
);

This creates the account database

6. Replace these lines in the Program.cs with your MySQL credentials: https://github.com/HelloKittyOnline/HKO-re/blob/main/Server/Program.cs#L324
7. Replace these lines in the Extractor Program.cs with your paths: https://github.com/HelloKittyOnline/HKO-re/blob/main/Extractor/Program.cs#L86 (hkoPath is the path to your HKO installation, outPath is where you want the patched files to be extracted to)
8. Run dotnet build

This will compile the server and Extractor tool.

9. Run the Extractor.exe in the Extractor bin directory to patch your Hello Kitty Online client

10. In the MariaDB console, input the following:

INSERT INTO `account` (`id`, `username`, `password`, `data`) VALUES (1, 'test', 0x73b5a6bead178fe1b7442d5944ce297398677173e9a6b3eaa591982510fff09c91797af05be14b8364ee39e5959cb161, null);

This will create a user called test with the password asdasdasd

11. Copy all Data JSONs to the same directory as the Server.exe file
12. Run dotnet Server.dll to launch the Server. It should say Listening at :25000
13. Launch HKO and login with the test credentials you created above
14. You should be in the game now!