Getting Started

This quick-start guide is designed to get you up and running with Pixel Vision8. It covers everything you need to know about launching Pixel Vision 8, playing games, installing Pixel Vision OS, and creating your first game project.

Running Pixel Vision 8

Pixel Vision 8 works on Mac, PC, and Linux. Simply run the installer or copy it to where you keep Applications on your computer. Once installed, run the executable to boot up the Fantasy Console.
By default, Pixel Vision 8 runs in window mode. You can change the scale of Pixel Vision 8 while it's loading by holding down the 1 - 4 keys or press F to toggle between fullscreen and windowed mode. Your changes will be saved between sessions.

Installing Pixel Vision OS

When you boot up Pixel Vision 8 for the first time, it will ask you to install Pixel Vision OS.
InstallingPixelVisionOS_image_0.png 4.54 KB

The installer allows you to select only the parts of the OS you’d like copied over to the drive. For a fresh install, it’s best to just leave everything selected. When you are ready, hit the install button and the OS will be copied over to the drive.
InstallingPixelVisionOS_image_1.png 6.45 KB

Once installed, the drive will change icons showing it can be booted and you are free to eject the disk to reload the OS from the drive.
InstallingPixelVisionOS_image_2.png 2.71 KB

At this point, you should have everything you need to run Pixel Vision OS from the Workspace drive. When Pixel Vision OS is correctly installed, you’ll see all of the tools load up on the boot screen.
InstallingPixelVisionOS_image_4.png 3.01 KB

If a tool you need is missing or wasn’t installed correctly, you can always manually re-install just that tool by selecting it on the OS installer.
InstallingPixelVisionOS_image_5.png 6.52 KB

See the reinstalling Pixel Vision OS section for more information on how to do this.

Creating A New Project

Pixel Vision OS allows you to create new projects in the Workspace drive or on a disk that has read/write access on your computer’s file system. You can not create new projects on the desktop or inside the root of another game’s folder. Each version of Pixel Vision 8 has its own template project. To get started, select New Project from the menu and give it a name.

Here is what you’ll see when you create a new PV8 project. This project template includes all of the core files you need to make a PV8 game. 

By default, the template doesn’t include a Tilemap or Music file. These can be added via the drop-down menu.

If a core game file already exists in a game folder, its name will be disabled in the menu. You can always delete a game file and create a new one from scratch if you want to start over again. Likewise, creating a new color, sprite, tilemap, sound or music file can not be renamed when creating them from scratch.

Running Games Projects

You can play any PV8 game project that has a Run icon in the root of its folder by double clicking on it or pressing Ctrl + R.
You can run the new game project and it will display some text to let you know that everything is working and is ready to be modified. When you are done running a PV8 game project, simply hit Esc to exit out of it.
image.png 10.75 KB

Join The Club

The Fantasy Console Club is free to join and offers exclusive access to updates, tutorials, and more. By joining, you'll get a free copy of Pixel Vision 8, it's documentation, and a collection of API example tutorials to get you started, which is everything you need to start making 8-bit games.
Become A Member Today

Help Support Pixel Vision 8

Pixel Vision 8 is still in development. Currently, it is offered as "early access" and may contain bugs, unexpectedly crash, or have missing features. These early access builds help get feedback, identify bugs, and stress test the tool-chain. Join the dedicated Discord server for support and sharing with the community.
Join The Discord Server