Skip to content

minisphere 4.0.0

Choose a tag to compare

@fatcerberus fatcerberus released this 12 Aug 04:14

minisphere 4.0.0 is the fourth major minisphere release. This version introduces the brand-new Sphere v2 API for a fully modern Sphere development experience.

Release Notes - Breaking Changes

  • Several object constructors such as Image, Color, and Surface have been
    repurposed as Sphere v2 APIs, while constructors for legacy objects such as
    ByteArray have been removed entirely. Any code using the constructors will
    need to be updated.
  • Objects constructed using a Sphere v2 API--such as the Image constructor
    (see above), Color.Black et al., and so on--are no longer compatible with
    the Sphere v1 API. For example, you can't use a v2 Color object with
    Rectangle() or assign a v2 Image to a v1 spriteset. Doing so will cause
    a TypeError.
  • The Sphere v1 API is now deprecated in its entirety. It is not recommended
    to use any Sphere v1 functions in new games, and the v1 API is thus no longer
    documented. New games should use the Sphere v2 API exclusively and migration
    is highly recommended for existing games.
  • Automatic CoffeeScript and TypeScript transpilation has been removed from the
    engine. This was always a bit of a misfeature as Duktape isn't quite fast
    enough to do this on demand without causing unwieldy delays. Any
    transpilation must now be done in advance.

Changes in this Release

  • Introduces the new Sphere v2 API. The entire Sphere v1 API, including the
    map engine, has been deprecated and is no longer recommended for use in new
    games. For information on using the functions in the new API, see
    docs/sphere2-api.txt.
  • miniRT has been overhauled and repurposed as minisphere's implementation of
    the Sphere v2 standard library. See docs/miniRT-api.txt for more
    information.
  • Drops support for on-the-fly transpilation of TypeScript and CoffeeScript.
    This must now be done in a separate step.

Installing in Windows

Simply download and run minisphereSetup-4.0.0.exe. The Inno Setup install wizard will walk you through the installation process.

Installing in Linux

For Ubuntu (14.04 and later), minisphere is available via personal package archive (PPA):

Installing from a PPA is easy. Simply open Terminal and run the following commands:

  • sudo add-apt-repository ppa:fatcerberus/minisphere
  • sudo apt-get update
  • sudo apt-get install minisphere

You only need to do this once. The system will automatically notify you of future minisphere updates.

For other Debian distributions such as Linux Mint or Debian itself, simply download one of the .deb packages below. Users of 32-bit systems will want minisphere_4.0.0_i386.deb, while 64-bit users should download minisphere_4.0.0_amd64.deb. Once downloaded, simply double-click the file and your package manager will guide you through the process of installing the package.