Skip to content

Latest commit

 

History

History
125 lines (84 loc) · 5.06 KB

README.md

File metadata and controls

125 lines (84 loc) · 5.06 KB
Raw

The External HH Engine, Client & API
Github All Releases license Build Status

About Nova

What is Nova
Nova it's an External HH Client made in Node.js with Electron, it's also an Engine and also an API. Nova allows you to play any Retro Server with the same Client, without opening browser and downloading anything. Without needing to authenticate again. Nova works in any OS. Nova it's for you.

What are the advantages of Nova?
Nova uses 2FA (Two-Factor-Authentication) to Login into the Hotel. After the first Login, your account is saved in the Nova Repository in your PC. Nova works with Flash Hotels (Habbo Beta+, R38+, R63{A,B,C+}) and in the future also with Shockwave Clients.

Nova is secure, fast, neaty and responsive. Allowing you to see how many users are online, logout, read the hotel news and many more functionalities. You can play any hotel that you regularly plays.* Nova is convenient. Nova it's the future.

* The Hotel need to use Nova

How to use Nova Development Version

I want to configure Nova

  • Download latests builds of Nova Engine and HabClient App in Releases Section
  • Configure the Nova Engine Settings on client.php
  • You can run a test environment of Nova by starting PhP Built-In server (explained above)
  • Package the HabClient App
  • Open the client (Engine) http://yoursite.com:8080/client.php
  • Copy the Token Hash
  • Open Nova App
  • Enter your hotel URI (eg.: http://yoursite.com:8080)
  • Enter the Generated Token, and press the Button.
  • Client will load instantly.

Observation.: Be sure that your Emulator is running! And that the External_Variables are configured correctly.

I want to play HabClient with a Development Server that is deployed

  • Open the client (Engine) http://yoursite.com:8080/client.php
  • Copy the Token Hash
  • Open Nova App
  • Enter your hotel URI (eg.: http://yoursite.com:8080)
  • Enter the Generated Token, and press the Button.
  • Client will load instantly.

How to build Nova Engine? (Development)

For Nova Engine

  • First you need clone or Download a ZIP of this repository.
  • Open your console and Build Nova by entering this on your console:
cd engine/
php build.php
  • After that you can run Nova API by entering this on your console:
cd engine/
php -S 0.0.0.0:8080 ./

Observation.: Remember that the Nova Engine works directly from the client.php

For Nova Electron App

  • You need Have Installed NPM Package Manager
  • After Installing it, open your console and enter this:
npm install -g electron
npm install -g --save-dev electron-packager
npm install -g --save-dev electron-menus
npm install -g --save-dev electron-json-storage
npm install -g --save-dev electron-winstaller
npm install -g --save-dev ini
  • Now Build for your Platform:

Darwin (OS X)

electron-packager app/ Nova --version 1.4.7 --platform darwin --out output/ --icon app/icon.icns

Windows (x64)

electron-packager app/ Nova --version 1.4.7 --platform win32 --out output/ --icon app/icon.ico

Linux

electron-packager app/ Nova --version 1.4.7 --platform linux --out output/
  • Nova was builded successfully ;) (Multi Platform)

How to Install Nova? (Production)

I'm a Player, how i install Nova?
You only need download the Nova directly from the Releases Pages of this Repository, or directly from the Retro Server that you play.

Observation.: We remember you that you need Java JRE to run HabClient. Java JRE it's the same mechanism used for playing Minecraft.

I'm an owner/developer of a Retro Server, how i use Nova?
See our guide in the Wiki Page, by clicking here. All documentation about Installation, and Customization can be find in the Wiki Page.

You also can see the API Documentation by clicking here.

Considerations about Flash

Nova actually uses PepperFlash, since Electron emulates a Chrome Container. Actually i'm researching to enable NPAPI Plugins, like Adobe Shockwave (Adobe Flash v18.0) (Netscape API). Since the Pepper Flash (Adobe Flash v24.0+) (Pepper API) excludes the Adobe Shockwave Directory and obviously the Adobe Shockwave Flash.

This will be the biggest blocking step in this project. Winning this phase, will literally make the project working for Shockwave.

Anyways, i'm actually gathering the PepperFlash Plugin Files {.plugin, .dll, .so} for their respective SO's, Other mission will be updating continuously the Flash versions.