Awesome_E site icon Home
Projects
Webplayer
Scores

The Modded Webplayer

Why did I make it?

The original goal of the project was to replicate the Hopscotch project embed page, while allowing custom data to be put into the project. This meant that I would gather JSON data via a request or local variables, and then initiate the webplayer with that Hopscotch JSON code. While it definitely took some work, the replication of the player worked, and you can play any Hopscotch project from your web browser.

But, that was just the beginning. As I began to explore the webplayer (and modifying it), I figured out how certain aspects work (specifically, I was looking at how blocks were run), and thought to myself, “Why don't I add features that I always wish Hopscotch had?” That's where the modded part of the player began. Things like keyboard support, an improved error tracing / debug system, and (eventually) multiplayer!

What is Modding?

Modding is just a shorthand for “modifying” something – in this case, the Hopscotch web player. To get the whole rig working, I had to change how the player read the file, then I had to initiate it, and so on, and so on. But, modding is more than just getting things to work.

What can I do?

You can do a lot! Anything you dream up and are willing to learn the mechanics of, you can add to something that already exists. People have modded games such as Minecraft, operating systems like iOS (the whole jailbreak community), and much more. As for me, I modified Hopscotch to support many different custom actions that only work inside of my player as well as developing my own Chrome Extension for personal use, which adds lots of functionality to several different websites, including the Hopscotch play page.

What's the point?

Well, in addition to creating an Awesome (E) fork of an Awesome (E) app, you actually learn a lot more than by just using that same app. Also, modifications of projects often do get the attention of the original creators, as seen with the Web Explorer; the goal of many modders, including myself, is to develop a proof of concept, hoping that it can one day make its way into the vanilla (unmodified) application. In the case of iOS, homescreen widgets and dark mode were jailbreak tweaks developed by modders long before Apple incorporated it into their operating system.

What does this Player Offer?

You can use it to test drafts, load projects that are filtered or unpublished, and run custom actions! All of my HS Tools projects use this player when playing a Hopscotch project because of conveniece features such as easier debug, autoplay, project info, and the support of my custom actions. If you want to learn more about how you can use the modded player actions, check out the documentation.