Code Monkey home page Code Monkey logo

aquastar's Introduction

AquaStar

AquaStarLogo

AquaStar is a custom AqLite launcher. It aims to uses the latest aqlite .swf while providing additional features.

How to download

Go to this link: https://github.com/aquaspy/AquaStar/releases

and download the correct one for your system

Current working and missing

Working:

Linux build (x86, x64, and ARMv7) Windows Build (x86 and x64) ChromeBook support (more on that bellow!)

Missing:

Mac Build - There is support but we dont have a Mac to compile it.

ChromeBook:

According to /u/Primal_Majin on reddit, AquaStar (and game launcher, if you want that) is able to run on chromebooks using the Linux (Beta) support.

  • On the linux terminal, (he used Debian Buster, the current one at this time), install the package "libnss3", doing the following command:
sudo apt install libnss3
  • Then, on the appimage file, add a shortcut to ChromeOS or make it executable by double clicking, and its done!

If you want a suggestion for making appimage shortcuts on ChromeOS, Primal_Majin also suggested menulibre, to make it.

Searching for Custom Keybinding stuff?

Open Keybinding.MD in this repository!

Searching for why does this exists and if its safe?

Open Motivation.MD in this repository!

Will it be cross platform?

As cross as we can. Currently there are ARM, both 32 bits and 64 for windows and Linux, and Mac is suposedly supported. Try it out and give us Feedback.

Key diferences from official AqLite

The core is the same. You should thank 133spider instead of me for making all that amazing features. All I did was to write a simple code that uses his swf file and compile it for linux and mac, so linux and mac users can play too in a launcher. We also putted some sparkles on top of it as a fully browser only to run flash seems... wastefull :D

After version 1.2: Now that AQLite is "dead", as its merged into official game, our launcher loads the AE version instead. Older aqlite support is still there.

Just some new features on AquaStar:

  • Screenshot button that grabs the game part only.
  • Keybindings for alt windows and vanilla aqw windows (up to 1.2, as vanilla is merged with aqlite)
  • Even more Keybindings for Wiki, design notes, and char pages
  • Tabbed window for that browser feel in the Wiki, design notes... the website windows
  • Support to use an older aqlite file if desired (or any custom flash file, as flash is... you know, dead).
  • Saving your character from flash character page with high resolution (as high as you monitor can render) into a .png in your pc!
  • Colour customization is shown in char page when its saved.
  • And also a keybinding to save your char page!
  • Custom keybindings! just create a aquastar.json in the designed folder!
  • Record the game screen!
  • (For devs and content creators only) Logging of the SWF URLs! Enable it with a aquastar.json file (more on KEYBINDING.MD and aquastar_testing.json)
  • (For those looking at your childhood) Load a custom URL into the launcher for old flash games/content! Enable it with a aquastar.json file (more on KEYBINDING.MD and aquastar_testing.json)

How to build it yourself

Requirements:

  • npm/nodejs installed.
  • This repository's code or git installed.

Instructions:

Download this project's folder into your PC, or clone it directly from this repository using git like:

  git clone https://github.com/aquaspy/AquaStar.git

If your Operating System's flash library file (like .dll or .so) is not in the FlashPlayer folder, get it from your own system (win64 and linux are already supported, and mac's one is in the folder too)

Put the aqlite.swf file in the SAME FOLDER of main.js (the project root), if isnt there by any reason.

Install the dependencies using NPM (nw-flash-trust, [email protected] and electron-builder) like:

  cd path/to/project/folder
  npm install

npm install will install automatically all dependencies, so no need to specify them manually, just use "npm install".

Now you are ready to run it! before making a package, you can test it running npm start.

If aqlite opens correctly, build the package so you can run in any folder you like. Go to FlashPlayer folder and remove the flash libraries you don't need. (ex: delete .so in windows, and .dll in linux, as it's irrelevant)

Type: npm run dist, and in the new "dist" folder, is your files. In linux case, it's a AppImage file! In windows, it's an Exe! And Mac should be a DMG file!

PS: DO NOT run ./build.sh as it will build EVERY supported version at the same time. its used for releases in the github.

Troubleshooting

Stuck at 0%

  • Try to control + f5 the launcher. It will reload the page.
  • Try to shift + f5, to clear cache
  • Try the Spider's solutions for this problem.

Keybindings dont work

  • Some Keybindings only work in some places. Most can only be used in the game window.
  • The only ones that work on HTML, are Alt+B e Alt+F. The rest are AQW game windows exclusives.
  • Check out Keybinding.MD in this repository for Custom Keybinds FAQ and problems.

Screenshot isnt taken

  • Up to 0.5, there is no confirmation to Screenshot took, but they are saved not in the same folder, but in the Pictures file in your User folder. Press F1 and you will see where it is.

aqlite_old.swf is in the same folder, but doesnt work.

  • Check the F1 menu, and see if the path is the same as the one your file is. Its not the shortcut folder, so it must be the .exe's real location!

I need to reinstall it everytime i need to open the game?

  • On windows, unlike with official aqlite and linux versions, windows's version is an installer. So next time you want to open the game, try searching it on the windows menu.

I have another problem

  • Tell us the information that appears in F9 about OS and Arch, and open a issue on github saying what happened.

aquastar's People

Contributors

aquaspy avatar caiofviana avatar theselfhostingart avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar

Forkers

ackermankenny

aquastar's Issues

Build fails on M1 Mac

Build fails on M1 Mac due to a missing electron darwin-arm64 release. electron v11 seems like the first version with this build target.

 AquaStar (main) npm install
npm ERR! code 1
npm ERR! path ~~~~~~~~~/AquaStar/node_modules/electron
npm ERR! command failed
npm ERR! command sh -c -- node install.js
Downloading tmp-86297-0-electron-v4.2.12-darwin-arm64.zip
npm ERR! Error: GET https://github.com/electron/electron/releases/download/v4.2.12/electron-v4.2.12-darwin-arm64.zip returned 404
npm ERR! ~~~~~~~~~/AquaStar/node_modules/electron/install.js:49
npm ERR!   throw err
npm ERR!   ^
npm ERR!
npm ERR! Error: Failed to find Electron v4.2.12 for darwin-arm64 at https://github.com/electron/electron/releases/download/v4.2.12/electron-v4.2.12-darwin-arm64.zip

ChromeOS Linux aarch64

I'm trying to run this doing all I can but I cant get the AppImage to run. I have tried all three and its the same response each time. I keep getting "cannot execute binary file: Exec format error.
Edit: running the armV7 one it says
-bash: ./AquaStar-1.6.0-armv7l.AppImage: cannot execute: required file not found

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.