RuneApps forums

Skillbert

Administrator

Registered: 2014-12-30

Posts: 1,061

Developing your own 3rd party apps

Apps in Alt1 are simply webpages that are running in a special overlay on top of Runescape. The Alt1 browser exposes an API to make the more advanced features possible. There are also several library's that should help with making the apps.

Requirements to develop an app
Apps are webpages inside a built-in browser, as such you will need an understanding of how websites work

• Knowledge of html, javascript and css.

• A place to host your apps on the internet.

• Being familiar with node.js, npm and typescript are a great plus.

All apps generally start with the @alt1/base library, this library provides some abstraction classes to deal with performant image capture as some image detection features. It also provides type information for the window.alt1 object for your code editor.

Libraries and resources

• https://github.com/skillbert/alt1minimal Minimalistic example of how modern Alt1 app are made with webpack+typescript, this should be a decent starting point if you're familiar with the modern js/node.js ecosystem.

• https://www.npmjs.com/package/@alt1/base Base wrapper library to interact with the Alt1 API and basic image detection classes. Also contains IDE type information for the window.alt1 object.

• https://www.npmjs.com/search?q=%40alt1 All alt1 libraries on npm.

• https://github.com/skillbert/alt1 The open-source wrapper libraries for the Alt1 API. This is the source for the @Alt1/xxx libraries on npm.

Useful links

• http://runeapps.org/apps/alt1/example/ Old example app based on the old libraries (without typescript) with lots of comments in code that should get you started. (Right-click>inspect element to view the code)

• alt1://browser/http://runeapps.org/apps … t1api.html Documentation of the API generated by Alt1.

• http://runeapps.org/downloads/Color_multitool_3.zip This tool will help out a ton if you're planning to make anything pixel related.

Installing apps and permissions
You can install apps by browsing to them in the built-in browser. There will be an 'add app' button on the top right if an app config is registered by the webpage. Clicking this button will create a bookmark to that webpage that is set to app mode. Alt1 will still behave very much like any other browser until the user enables the different permissions.

Tips
Alt1 is based on the chromium browser, this means that there is quite an extensive developer console. You can open this by right-clicking the settings spanner on the top-right, or by the 'dev tools' option when you right-click an app.

Last edited by Skillbert (2022-01-09 04:51:10)