mki3dgame

README

mki3dgame

This game uses designs produced with MKI3D web 3D editor.

• The AppImages can be found on:

  • the releases page,
  • Sourceforge: ,
  • Bintray:

• Snapped version is available at:

  • https://snapcraft.io/mki3dgame-snap
  • https://uappexplorer.com/snap/ubuntu/mki3dgame-snap

• Flatpak version is available on:

  • Flathub
  • also installable with package manager on Linux Mint.

In the game, you have to collect tokens scattered in the stages and avoid being captured by the monsters.

If you build the game from source code or use the AppImage (which is not sandboxed), then you can run the game with the path to your own assets directory as the command line argument.

The assets directory has the following sub-directories:

• icons - icon .png files (some systems may use them ...)
• monsters - monster shapes .mki3d files - made with MKI3D
• sectors - shapes of screen sectors .mki3d - made with MKI3D, specific to the code
• stages - stages .mki3d files - made with MKI3D
• tokens - token shapes .mki3d files - made with MKI3D
• scripts - scripts used to display messages in Zenity dialog windows

You can design your own stages and the shapes of monsters or tokens with MKI3D Modeler. The best way is to copy the assets directory and replace the files in the respective sub-directories 'stages', 'monsters', or 'tokens' of the main assets directory with your own designs. Shapes of the monsters, tokens and stages are selected randomly from each sub-directory for each stage.

To build the the game from the source code with Go compiler you need the following packages:

• "github.com/go-gl/gl/v3.3-core/gl"
• "github.com/go-gl/glfw/v3.2/glfw"
• "github.com/go-gl/mathgl/mgl32"
• "github.com/mki1967/go-mki3d/mki3d"
• "github.com/mki1967/go-mki3d/glmki3d"

This project has been moved here from the collection of Go program demos at https://github.com/mki1967/test-go-mki3d.git

INSTALLATION FROM THE SOURCE CODE REPOSITORY

• Install Go language on your system, unless you already have it. (See: https://golang.org/doc/install , do not forget to set the GOPATH environment variable)

• Install requirements for your system for gl and glfw listed in the README.md files:

  • https://github.com/go-gl/gl/blob/master/README.md
  • https://github.com/go-gl/glfw/blob/master/README.md

• Try to use the command: go get -u github.com/mki1967/mki3dgame (It can take some time to complete ...)

• The binary compiled file should be installed in ${GOPATH}/bin directory.

• Note that you can provide your own path to the assets directory as a command line argument. Otherwise the program will try to find the assets directory either in ${GOPATH}/src/github.com/mki1967/mki3dgame/ or (if GOPATH is not set) in the current directory.

• You can also prepare your own AppImage for Linux as described in https://github.com/mki1967/mki3dgame/blob/master/appImage-instructions.txt