HoweScape Unity3d WebGL

Description

The Unity3d WebGL support creates a directory of files.
This is not convent to load on your WordPress web site.
This plugin takes the “Release” directory from your game and places it
inside the plugin. When compiling the output directory need to be “Builds_WebGL”.
This plugin can then be referenced from with a short code.
The parameters in the short code are the game name and the width and height.

ie. [hs_unity3d_web_gl_game src=”Roll-A-Ball” height=500 width=600]

To extend the support for Unity3d to version 5.5.1 an additional parameter has been added.
This parameter allows the specification of a version. The version support is 5.5.1 or the original version supported by the plugin. (ie. original version 5.3.1)
The Unity3d version 5.5.1. creates a directory “Development”. This is what I have uploaded in the included example. (ie. Roll-A-Ball-5_5_1-Release)
The short code is now looks like the following example.

ie. [hs_unity3d_web_gl_game src=”Roll-A-Ball” height=500 width=600 u3dver=5.5.1]

In reviewing the latest verion of Unity3d I noticed that the file orginization for the WebGL has been updated again.
With this update there are now 3 supported version 5.3.1, 5.5.1 and 5.6.0. When using the newest version you would have a short code like the following.

ie. [hs_unity3d_web_gl_game src=Roll-A-Ball height=500 width=600 u3dver=5.6.0]

All other features should work as before. There are other features being considered please let me know if you desire anything functionality.

With the addition of the settings page it is now possible to place
the release directory in a zip file. (ie. <gamename>-Release.zip)
Once the file is uploaded the setting page for the plugin will allow extraction
of the files into a location which the short code can locate. When naming games from version 5.5.1 you will need
to include the version number. (ie. <gamename>-5_5_1-Release.zip) With this version place the
files from the Development directory in the zip file. For the latest verion it is the same. (ie. <gamename>-5_6_0-Release.zip)

In the process of doing the latest update I wanted to switch between the different games to verify that everything was working.
To make this task simpler I added a short code which displays a list of the avaiable games and allows the selection of a game.
The major reason for the addition was game development. Since I thought it might be useful I have added it to the plugin.

ie. [hs_unity3d_web_gl_gamepage]

If you use this short code with just the plugin you will have three games. Two versions of the Roll-A-Ball sample game and the space-shooter sample game.
There are 2 ways games can be added one is making them part of the plugin. The second is as a zip file which gets uploaded to the media directory.
Once uploaded the uploaded game zip file can be expanded into the plugin from the settings page. There is also a delete option on the settings page.
It can remove any game added from the media directory.

Arbitrary section

A brief Markdown Example

[hs_unity3d_web_gl_game src=”Roll-A-Ball” height=500 width=600]

Screenshots

  • Screen capture of Roll-A-Ball game from unity3d.com
  • Screen capture of Roll-A-Ball game with updates to colors
  • Screen capture of error message caused by building to incorrect directory

Installation

From your WordPress dashboard

  1. Visit ‘Plugins > Add New’
  2. Search for ‘HoweScape Unity3d WebGL’
  3. Activate HoweScape Unity3d WebGL from your Plugins page.

From WordPress.org

  1. Download HoweScape Unity3d WebGL.
  2. Upload the ‘HoweScape Unity3d WebGL’ directory to your ‘/wp-content/plugins/’ directory, using your favorite method (ftp, sftp, scp, etc…)
  3. Activate HoweScape Unity3d WebGL from your Plugins page.

FAQ

  1. Can I use this plugin with my own Unity3d game?

    Yes Take the release directory from Unity3d Build directory and place in the plugin directory. Prefix the release directory with the name of the game ending in “-Release” The game name then is used in the short code.

  2. Can there be multiple games in the plugin?

    Yes. Each game is in its own <gamename>-Release directory

    There are currently three games in the delivered plugin.

  3. Can the games be placed outside the plugin?

    Yes, In the media directory

    The settings page allows games to be extracted into the plugin.

  4. How do I move the ball?

    The arrow keys allow movement of the ball to collect the cubes.

  5. How to play space Shooter.

    Arrow keys move ship.

    Mouse button fires gun. Mouse needs to be in window.

  6. My game does not work I get an error message.

    “An error occured running the Unity content on this page.”

    “The error was: uncaught exception: incorrect header check”

    When I compiled my Unity3d game I used “Builds_WebGL” as the directory.
    This seems to be a requirement of the plugin.

  7. For version 5.5.1 and 5.6.0 the game name restriction.

    With these versions the restriction on build directory has been removed. The names needs to not contain spaces.

Installation Instructions

From your WordPress dashboard

  1. Visit ‘Plugins > Add New’
  2. Search for ‘HoweScape Unity3d WebGL’
  3. Activate HoweScape Unity3d WebGL from your Plugins page.

From WordPress.org

  1. Download HoweScape Unity3d WebGL.
  2. Upload the ‘HoweScape Unity3d WebGL’ directory to your ‘/wp-content/plugins/’ directory, using your favorite method (ftp, sftp, scp, etc…)
  3. Activate HoweScape Unity3d WebGL from your Plugins page.

Contributors & Developers

“HoweScape Unity3d WebGL” is open source software. The following people have contributed to this plugin.

Contributors

Changelog

0.6.1

  • Updated application to support translation.
  • Tested with WordPress version 4.8.1

0.5.1

  • Added support for Unity3d 5.6.0. This is an expansion of the parameter added in version 0.3.1

0.3.1

  • Added support for Unity3d 5.5.1. This requires adding a parameter to the Short code.
  • This parameter is not required for Web GL games which have a .htaccess file
  • Example of parameter u3dver=5.5.1
  • At this time there is no other values which are supported.
  • The template data directory was also added to support version 5.5.1.

0.1.1

  • Added Settings page. This provides three groups of information.
    The first group is a list of the Unity3d games in the plugin.
    The second lists is of Unity3d games expanded into the plugin.
    The third is a list of zip files in the media directory which the plugin recoginise as Unity3d gamems
  • The extract button takes the identified zip file and expands the game into a subdirectory.
  • Updated processing to to include search to include expanded games.

0.2

  • Update file Calling to use recommended
  • Removed “Created with unity” link from plugin

0.1

  • Original Release