Skip to content

minisphere 3.1.0

Choose a tag to compare

@fatcerberus fatcerberus released this 07 May 07:00

minisphere 3.1.0 is the second minor release in the 3.x series. This release brings several improvements to SphereFS and Galileo, three new miniRT components, and fixes several minor bugs. Upgrading is highly recommended.

Release Notes - Breaking Changes

  • SphereFS prefixes have changed. Single-character prefixes are now used for
    SphereFS paths instead of the ~usr, ~sgm, and ~sys aliases used in
    previous versions. Any code depending on the old prefixes will need to be
    updated.
  • The user data folder has been renamed to "minisphere". This was done to be
    more friendly to Linux users, for whom filenames with spaces are often
    inconvenient. If you need to keep your save data from minisphere 3.0, move
    it into <documents>/minisphere/save.
  • The Galileo API has been updated with new features. These improvements bring
    some minor breaking changes with them as well. Refer to the API reference
    for details.
  • The search path for CommonJS modules has changed since 3.0. Modules are now
    searched for in @/lib/ instead of @/commonjs/.
  • ListeningSocket has been renamed to Server. Networking code will need to
    be updated.

Changes in this release

  • SphereFS now uses single-character aliases: #/ for built-in engine assets,
    @/ for the root of the sandbox, and ~/ for the user data directory (for
    save data).
  • Changes the user data directory name back to "minisphere" to be more friendly
    to Linux users.
  • Adds some new components to miniRT: miniRT/binary for easy loading of
    structured binary data, miniRT/xml for XML parsing and DOM generation, and
    miniRT/prim to pre-render expensive-to-draw primitives like circles.
  • Adds a new Transform object which allows working with transformation
    matrices.
  • Improves the Galileo API: Shapes can now be drawn directly, Groups have a
    transform property which allows their transformation matrices to be
    manipulated, and shader uniforms can be set using group.setInt(),
    group.setFloat(), and group.setMatrix().
  • Adds new Galileo Shape types SHAPE_LINE_LOOP and SHAPE_LINE_STRIP.
  • minisphere now looks for CommonJS modules in lib/ instead of commonjs/.
  • Async() is now called DispatchScript() for API consistency.
  • ListeningSocket is now called Server.
  • You can now use -0 through -4 on the command line to specify the engine
    log verbosity level.

Installing in Windows

Simply download and run minisphereSetup-3.1.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_3.1.0_i386.deb, while 64-bit users should download minisphere_3.1.0_amd64.deb. Once downloaded, simply double-click the file and your package manager will guide you through the process of installing the package.