• Announcements

    • khawk

      Download the Game Design and Indie Game Marketing Freebook   07/19/17

      GameDev.net and CRC Press have teamed up to bring a free ebook of content curated from top titles published by CRC Press. The freebook, Practices of Game Design & Indie Game Marketing, includes chapters from The Art of Game Design: A Book of Lenses, A Practical Guide to Indie Game Marketing, and An Architectural Approach to Level Design. The GameDev.net FreeBook is relevant to game designers, developers, and those interested in learning more about the challenges in game development. We know game development can be a tough discipline and business, so we picked several chapters from CRC Press titles that we thought would be of interest to you, the GameDev.net audience, in your journey to design, develop, and market your next game. The free ebook is available through CRC Press by clicking here. The Curated Books The Art of Game Design: A Book of Lenses, Second Edition, by Jesse Schell Presents 100+ sets of questions, or different lenses, for viewing a game’s design, encompassing diverse fields such as psychology, architecture, music, film, software engineering, theme park design, mathematics, anthropology, and more. Written by one of the world's top game designers, this book describes the deepest and most fundamental principles of game design, demonstrating how tactics used in board, card, and athletic games also work in video games. It provides practical instruction on creating world-class games that will be played again and again. View it here. A Practical Guide to Indie Game Marketing, by Joel Dreskin Marketing is an essential but too frequently overlooked or minimized component of the release plan for indie games. A Practical Guide to Indie Game Marketing provides you with the tools needed to build visibility and sell your indie games. With special focus on those developers with small budgets and limited staff and resources, this book is packed with tangible recommendations and techniques that you can put to use immediately. As a seasoned professional of the indie game arena, author Joel Dreskin gives you insight into practical, real-world experiences of marketing numerous successful games and also provides stories of the failures. View it here. An Architectural Approach to Level Design This is one of the first books to integrate architectural and spatial design theory with the field of level design. The book presents architectural techniques and theories for level designers to use in their own work. It connects architecture and level design in different ways that address the practical elements of how designers construct space and the experiential elements of how and why humans interact with this space. Throughout the text, readers learn skills for spatial layout, evoking emotion through gamespaces, and creating better levels through architectural theory. View it here. Learn more and download the ebook by clicking here. Did you know? GameDev.net and CRC Press also recently teamed up to bring GDNet+ Members up to a 20% discount on all CRC Press books. Learn more about this and other benefits here.
  • entries
  • comments
  • views

Viewback - A Video Game Design Tool

Sign in to follow this  
Followers 0


Viewback is a tool that helps game designers conduct usability play tests. It forwards the debug information from your game to your wireless device, where you can see it and the player can't. Now you can diagnose problems with the game while your playtester enjoys her experience. You can see changes to internal game state and send commands to the game in real time.

You can watch this video to get an idea of how it works:


The Viewback server is written in C and can be easily integrated into any game engine. It uses a permissive MIT license, avoids blocking networking calls, and uses only a few hundred bytes of memory. The server compiles on any C compiler with no dependencies, and the monitor is available for Windows and Android, with OSX and iOS coming soon.

Since Viewback is written in C it can be used in just about any game engine environment. Any engine written in C or C++ (Id Tech engines, Unreal, Source) can use Viewback with no extra effort. Users of engines written in Java or C# (Unity, Minecraft) can either write language bindings or implement the Viewback network protocol on their own.

This repository contains the header and source code for the Viewback server, which will typically be integrated into your game's client, if your game is multiplayer. It looks like this:

Scrap - Page 43.png

Installation Instructions

First, download the source code from the GitHub page and copy all files in the server directory to a directory inside your source tree. If you're familiar with git, you can use a git submodule for this purpose. Then add viewback.cpp and viewback_util.cpp to your project files. In whichever files you want to use Viewback, add at the top:#include "viewback_util.h"
Now you are ready to implement the API.

Sample Code

This code uses the vb_util interface, which handles memory allocations for you. If you care about how Viewback manages memory, see viewback.h for an interface that allows you to allocate the memory that Viewback uses.#include "viewback_util.h"vb_util_initialize(); // This is optional.// A "channel" is a stream of data to be sent to the Viewback monitor for display.// Here we create an integer channel called "Health".vb_channel_handle_t health_channel;vb_util_add_channel("Health", VB_DATATYPE_INT, &health_channel);// The name you pass in here will be displayed in the server list on the monitor.vb_util_server_create("My Amazing Game");while (game_running()){ // Call this as many times as you like, but at least once per game frame. vb_server_update(game_time); // You can send data once per frame, or only when the data changes. It's up to you. if (!vb_data_send_int(health_channel, player->GetHealth())) printf("Error sending to Viewback channel\n");}vb_server_shutdown();
At this point you should be ready to use the Viewback monitor to see your data. If you are on the same WiFi network as the Viewback server then the monitor should automatically find the server. If your network is special then you may have to find the IP address and connect manually. Once connected you will asked to select a group to display, and then you'll be able to see your channels.



A channel is a stream of data to be sent to the Viewback monitor for display. Each channel has a type, currently supported types are integer, float, or vector. Depending on the type of the vector the data will be displayed in the monitor in a different panel. Floats and ints will be shown in the time display and vectors will be shown in the 2D display.


A group allows you to organize your channels. You can add a channel to a group and then activate a group to see all of the channels in that group. For example an "Animation" group may contain these channels:

  • PlayerYaw
  • ViewVector
  • PlayerVelocity

    while the "PlayerMovement" group would contain

    • PlayerVelocity
    • JumpButton
    • OnGround

      A channel can belong to multiple groups or no groups.


      Integer channels are often enumerations - i.e. each value represents a state. These states often have names and looking at the names is nicer than looking at the numbers. So for integer channels you can specify that a certain value has a name, and this name will show up in the monitor instead of the number. For example for the PlayerState channel you may have these labels:

      0: Dead
      1: Respawning
      2: Alive
      3: DeathAnimation
      4: Spectating

      Whenever the channel has the value of "2", the monitor will show the "PlayerState" channel as being "Alive".


      You can specify controls to modify parameters of your game in real time. These controls appear in the monitor and when they are manipulated by the user, the callbacks that you specify will be triggered in the game code. There are currently two types of controls supported.


      When pressed, a callback function in the game will execute. For example, a "Pause" button could call this function:void viewback_pause_callback(){ Game()->TogglePause();}
      Other ideas for buttons:

      • Take a screenshot without leaning over your playtester.
      • Turn cheats on and off.
      • Activate the bug report system.
      • Reset the level if your playtester got stuck.


        When the slider handle is moved a callback in the game will execute. Sliders can specify integer or float values. Some ideas for sliders:

        Adjust the difficulty of the game if your playtester is having trouble (or not enough trouble)
        Adjust the number of bots in the game
        Real-time tuning of a design parameter that you've been trying to get right, like the player run speed or jump height.


        If your game has a console, you can forward the console to Viewback. Output from the console will appear in the Viewback monitor and the user can input commands into the monitor which will get forwarded to the game.

        Don't have a console in your game? No sweat, you can use the Viewback monitor as your console. Just call the Viewback vb_console_append() function with whatever messages you want to see, and it will show up on the Viewback monitor.


        The status string is like the console but it's always visible. New status lines replace old lines and they never scroll off the screen. Use it for things like the framerate, memory used, and how many monsters are currently spawned.

Sign in to follow this  
Followers 0


Hi, i really like this idea and i´m trying to implement it on my engine right now to do some tests, however i've found some issues and i hope you could help me.


1.- I have a 4.4.4 nexus 5 and the client app it´s not working there :(

2.- I have already followed the implementation instructions, connected with the windows client application and it seems to be working, however i can´t see any data channel.

3.- As a comment, maybe is a good idea to remark that when you want to release all the objects after calling vb_server_shutdown() you also need to call vb_util_initialize() again in order to release the allocated memory.


That's it for now, i hope someone could guide me a little with this issues. :)


Share this comment

Link to comment

Are you the one who sent me the email? I saw it -- I'll reply once I have a chance to look into it.


Share this comment

Link to comment
Oh okay well send me an email bs.vino@gmail.com and well get you all sorted out.

Share this comment

Link to comment

Create an account or sign in to comment

You need to be a member in order to leave a comment

Create an account

Sign up for a new account in our community. It's easy!

Register a new account

Sign in

Already have an account? Sign in here.

Sign In Now