V-Play Installation

The V-Play Engine Installation takes 3 steps:

  1. Sign up for V-Play
  2. Install Requirements
  3. Download & Install V-Play

Sign up for V-Play

To install the V-Play SDK, a V-Play account is required.

Go to https://v-play.net/pricing to create a new account. You can also upgrade your V-Play license there. If you already have a V-Play account, you can skip this step.

Install Requirements

macOS Requirements

Download and install the latest Xcode from the App Store or http://developer.apple.com/xcode/.

Install V-Play on Linux

Install V-Play on Debian & Ubuntu

Open a terminal and install the following packages with

 sudo apt-get install build-essential libglu1-mesa-dev libpulse-dev libglib2.0-dev

If the installed OS is lower than (but not equal to) Debian 8 or Ubuntu 17.04 also install these additional packages:

 sudo apt-get install libgstreamer-plugins-base0.10-0

Note: If the installer does not start because of missing OpenSSL libraries, please have a look at the SSL fix mentioned in the Fedora & CentOS installation guide.

Install V-Play on Fedora & CentOS

To install V-Play on Fedora or CentOS, see this guide for tips.

Install V-Play on Arch Linux

Open a terminal and install the following packages using

 sudo pacman -S base-devel

If SSL is not working in your application, you may adjust the SSL library path because Arch Linux stores the needed SSL library versions in a different path. To do that, replace the Exec=bash -c line in the launcher shortcut to be found below with:

 Exec=bash -c 'LD_LIBRARY_PATH=/usr/lib/openssl-1.0/ %%VPLAYDIR%%/Tools/QtCreator/bin/qtcreator.sh %F'

Tips for Installing V-Play on Linux

The above installation instructions may also work on derivatives of said distributions. Because there different dependencies per distribution there may be some packages missing for V-Play to work. In this case please try to install the distributions Qt5 package to resolve missing dependencies. The package is usually called qt5-default or qt5-base.

Symlinks with V-Play Installation

V-Play and its contained software may not function properly if files or folders are symlinked (soft links). Thus always specify the real path to the V-Play installation folder on the filesystem and do not change its contents.

Tip: Create a V-Play Launcher for Linux

If you want to have an easy to use launcher, create the following file in your home directory, paste the contents and make it executable. Replace %%%VPLAYDIR%%% with your V-Play installation directory:

 [Desktop Entry]

 Name=V-Play Qt Creator
 Exec=bash -c '%%%VPLAYDIR%%%/Tools/QtCreator/bin/qtcreator.sh %F'

 [Desktop Action maint]
 [Desktop Action vpdocs]
 Name=-> V-Play Docs
 Exec=xdg-open "https://v-play.net/doc/"
 [Desktop Action qtdocs]
 Name=-> Qt Docs
 Exec=xdg-open "https://doc.qt.io/qt-5/index.html"

If you need any help to install V-Play on your PC or for other platforms, please contact us here.

Download & Install V-Play

watch video tutorial

Download the latest V-Play Installer from https://v-play.net/download/

Note: Please see Add V-Play to Existing Qt Installation if you already have a Qt installation on your system.

The Installer allows you to the select the parts of the V-Play & Qt SDK for your desired target platforms. So it helps to keep the download size small, because you can select beforehand which parts of the SDK are downloaded.

Open the V-Play Installer and follow the instructions on screen.

Note: By default, only a desktop-compiler is installed. You can add compilers for mobile platforms later on.

Log In with your V-Play Account

After opening Qt Creator, you will be asked to provide your login credentials. Enter the email address that you used for signing up and your password.

Note: To protect your account from unauthorized access, it is locked after ten failed login attempts. Please contact us if you accidentally locked your account.

Getting Started

After installation start Qt Creator and select File/New Project. Choose a V-Play project for starting to develop V-Play.

Also have a look at the V-Play examples and demos: they are located in the folder of your Qt installation in the folder <QtSDK>/Examples/V-Play/.

We also prepared a lot of tutorials to get you started, you can find them in our documentation.

Need Help?

If you experience issues at installation or during development, please let us know in the V-Play Qt 5 support forum.

Add V-Play to Existing Qt Installation

If you already installed Qt 5 on your system, install V-Play in parallel using our installer, to solve Qt and Qt Creator version compatibility issues. The V-Play and Qt installation will work side-by-side in two different directories.

However, you can try to add V-Play to your installation. Open the executable called Maintenance Tool and follow these steps:

Choose the Package Manager option so the Settings button is shown in the bottom left corner.

Click the Settings button and in the Settings window, click on the Repositories tab. Click on the bottom section User defined repositories and then click the Add Repository button.

Now enter the URL for your development platform in the text box. It is either:

  • https://sdk.v-play.net/2/windows
  • https://sdk.v-play.net/2/macx
  • https://sdk.v-play.net/2/linux

Next, confirm the V-Play installation repository with OK and proceed with the Package Manager option by pressing the Next button.

For a more detailed explanation, see the blog post How to Add V-Play to your Existing V-Play Installation.

Note: Each V-Play version is compatible with a certain Qt and Qt Creator version. For example, the V-Play version 2.12.1 uses Qt 5.9.0. If you are using an different version of Qt or Qt Creator that is used within V-Play, parts of the V-Play SDK will not work properly. Please have a look at the V-Play Update Guide to view recent changes and Qt version updates of V-Play, and to find out which Qt version is currently used by the latest V-Play version.

If you have problems adding V-Play to your installation, we recommed to install V-Play in addition to your existing Qt SDK by using the V-Play Installer. The two installations will not interfere with each other, and both work independently.

You can then proceed with the steps of Download & Install V-Play like described above.

Add V-Play to your Qt Mobile App

If you have an existing Qt Mobile App, you can extend your Qt application with V-Play components to improve your mobile app experience. You can mix all of the V-Play and Qt components and have them combined in your project. For more information, please see our blog post How to Add V-Play to your Qt Mobile App.

Voted #1 for:

  • Easiest to learn
  • Most time saving
  • Best support

Develop Cross-Platform Apps and Games 50% Faster!

  • Voted the best supported, most time-saving and easiest to learn cross-platform development tool
  • Based on the Qt framework, with native performance and appearance on all platforms including iOS and Android
  • Offers a variety of plugins to monetize, analyze and engage users
create apps
create games
cross platform
native performance
3rd party services
game network
level editor
easiest to learn
biggest time saving
best support