IsleHorse/HISP
1
0
Fork 0
mirror of https://github.com/islehorse/HISP.git synced 2025-04-06 05:05:40 +12:00
Code Issues Projects Releases Packages Wiki Activity Actions
HISP/README.md
Bluzume ba33a8967d
Update README.md
2021-08-24 20:58:03 +12:00

3.5 KiB
Executable file
Raw Blame History

HISP - Horse Isle Server Program

Linux Windows

HISP is a "Server Emulator" for Horse Isle 1
You may know of "private servers" for big MMO games such as Runescape or Club Penguin
well they essentailly run off "Server Emulators".

!!! ALL FEATURES NOW IMPLEMENTED (um, unless theres some obscure thing i dont know about :D)

tl;dr, think "Club Penguin Rewritten" but with Horse Isle.

Setup

  • Download the latest Windows or Linux binary.

  • Setup a SQL Server, (eg, MariaDB).

  • Setup a webserver with PHP8.0, intl and mysqli modules (eg, Apache).

  • Create a database for the master site, and for all game sites you may have

  • Copy files from the binary ZIP's www/master-site into your webserver.
    have a separate virtual host for each www/game-site.

  • Edit each game-site/config.php to have your SQL login information.
    Change the server host to your public IP or a Domain that points.
    to it and also change the HMAC Secret

  • Edit master-site/servers.php and put each server your hosting
    in the array. this is what will appear in the server list

  • Edit master-site/config.php and set your SQL Server credentials, for the master-site
    and change the hmac_secret to match that of every game-site

  • For each server, run the HorseIsleServer binary. on first run, it will
    crash due to trying to connect. But will create a "server.properties" file,
    as well as a CrossDomainPolicy.xml, Edit server.properies and change the DB connection.
    to your SQL server credentials- Change whatever other settings you want there as well.

  • Run HorseIsleServer again and this time it will connect to the server and start up.

  • Create an account on the master-site/ webserver.
    And login using game-site/Horseisle.php,

  • That's it your now running HISP Server.
    Forward the port you used for the server and 80 for the webserver.
    And people can login over the internet.

  • You can give yourself admin by executing UPDATE Users SET Admin='YES' Moderator='YES' WHERE Username='<YOUR USERNAME>' on the master database, (and any game databases)

Depends

HISP Depends on a SQL Server, its been tested and known to work specifically with MariaDB, https://mariadb.org/ Set its information into server.properties or the server will just crash on first run /-/

Platforms

The server has been tried and known to work on Windows x86, x64, Linux x64, ARM and ARM64. CI Provides pre-built binaries for all these platforms,

Building

Building the server from source requires Microsoft .NET Core SDK, targetting version 5.0 https://dotnet.microsoft.com/download/dotnet-core use dotnet build to build a debug build, (requires .NET Core Runtime) quickly or one of our publishing XML's ex:
dotnet publish -p:PublishProfile=Linux64.pubxml to to build it standalone.

Web Server

Theres a bunch of saved files from the Horse Isle 1.0 website, as well as some basic functionality to make it work like the original site, the files are in the "WebInterface" folder, it requires PHP 8.0, with the modules "intl" and "mysqli"