HexScape Manual

Learn how to use HexScape, your virtual hex board !

Get HexScape »

You should have downloaded the HexScape client. It takes the form of a single file named HexScape_client-<version>.jar. Create an "HexScape" folder where you want on your computer, and move the HexScape client into it. Congratulation, you just installed HexScape !

HexScape is written in Java, and need it to run. Java is usually installed on most computer, but if you need to, you can easilly install Java »

To launch HexScape, just double click on it !

The home view is the view that is presented to you when you Launch HexScape. This view consits of the HexScape logo, and 3 buttons :

The Option button

The option button is located at the bottom left of the Home View.

A click on the button opens the Option Dialog Window. The Option Dialog Window contains two tabs.

The Configuration Tab allows to change the username of the player, and the host of the HexScape server to use. The main HexScape server is currently located at hexscape.lyrgard.fr.



The Assets Tab allows to import assets into HexScape. Assets are 3d models, cards, marker and dice definition.



If you want to play a game, you need to download the assets for that game (.hsd files) and import them here.

The Solo Mode Button

The Solo Mode Button is used to launch a solo game. This mode does not require internet connection, nor a HexScape server. A click on this button opens the New Game Dialog. Once the game is created, the game will start and the Game View will be displayed.

Solo mode is usefull if you want to visualize a map with figures on it, to take screenshots, or if you want to play a game by yourself, to test a custom for instance

The Online Mode Button

The Online Button is used to connect to the configured HexScape Server (in the Configuration Tab). If HexSCape can successfully connect to the server, you'll be connected to the HexScape Room and the Room View will be displayed.

The New Game Dialog

The New Game Dialog allows to create a new game. Creating a game require 3 informations : a name for the game, the number of player (fixed to 1 in Solo Mode) and the map to use for the game. The map is loaded from a .hsc file. .hsc files are created with a software named VirtualScape, widely used to create Heroscape Maps, but it can be used to create map for others games as well. You can download VirtualScape » to create your own maps, or use already created maps.

Once connected to the HexScape server, the room view will be displayed. For now, only one room exists, named hexscape. There are four zones in the room view :

The Game List Panel

At the left of the screen, this lists the games that currently exist in the room.

For each game are displayed its name, a flag indicating the status of the game, the number of players that joined the game, and the number of player this game is for. The flag can have three colors : green means the game has not started yet, and is still waiting for players; orange means the max number of player have joined the game, but the game hasn't started yet; red indicates a game currently running.

At the bottom of this zone, a button allow you to create a new game. A click on it will open the New Game Dialog. This time, you'll be able to choose the max number of players for this game (for now, max 2).

When you create a game, it will appear in the Game List Panel, and you'll automatically join the game. The Selected Game Panel will be shown, showing the game you just created.

The Selected Game Panel

This panel will be displayed at the middle bottom of the screen, but only if you just created a game, or if you click on a game in the Game List Panel.

This panel shows a 3D view of the map for the game (if you click on it, you can rotate it with the arrow keys). The left of this panel will display the actions you can do with this game : Join the game as a player if you didn't already joined it; Leave the game if you have joined it (take care, a game without any player in it will be deleted); Start the game if you joined it (take care : anyone who joined a game can start it, and you can start the game even if the max number of player is not reached yet). The right part of the panel shows the current list of players that joined the game.

The Player List Panel

This panel is located at the right side of the window. It lists all the players currently connected to this room.

Along with their username, a flag will show their status : green means that the player is not part of any game right now; orange shows that the players joined a game that has not started yet; red indicates that the player is currenty playing a game and won't see the room chat anymore.

The Chat Panel

The Chat Panel is the biggest part at the center. A text field at the bottom allow to enter text, and the enter key sent it. You can organize games here, or just have a little chat.

When a game you joined starts, you'll automatically leave the Room View to go to the Game View

This where you play a game. Once again, this screen has four zones :

The Army Panel

This panel is on the left. At first it contains a button to load an army (in the HexScape Army format, .hsa), and when you loaded your army, it will display the cards of the army.

The button on each card, with an arrow, allow to place on the map the figures of this card.

A left click on the card icon will show the full card below. This mini-card will also show when you select a figure on the 3d View Panel. On this mini-card, a magnifier button allows to see the full scale army card.

A right click on the card icon will displays a menu to manage markers.

Pass your mouse hover your hidden markers to see their hidden value. A right click on a hidden marker give the possibility to reveal it.



The army of your opponent will be displayed in a second tab when he/she loads it.

It is currently not possible to join back a game if you leave it, so take care not to click on the Leave Game button by mistake !

The 3d View Panel

This is the big panel at the center, displaying the map.

To move the view, you can click on this zone and use the arrow keys. The keys "+" and "-" of the numpad allow to zoom in or out.

A left click on a figure select it. The selection cursor of your color will show around the figure. The escape key cancel your selection. The delete key remove from board the selected figure (take care, you can remove your opponent figures too)

You can move figures by drag and droping them around. The mouse wheel allows to rotate the selected figure

When a figure is selected, you can enter Point of View mode with the "p" key, or by clicking on the Point of View button. This mode is usefull to see if a figure can see another figure. In Point of View mode, use the arrow keys or drag and drop with the mouse to rotate the camera. You can revert back to the Normal View mode with the escape key, or by clicking the Map View button

The current Point of View implementation is still lacking. The point of view is fixed at the middle of the model, at 80% of its height. With figures with long parts, like spears for instance, it can make the Point of View to be quite far from the eyes of the figures. The Point of View mode will be made better later on.

The Game Chat Panel

At the right of the window, this panel allow you to chat with your opponent. It also display some game event, like markers being placed or revealed, figures being removed, dice rolls results, and so on.

The Dice Panel

At the right bottom of the window, this panel has a tab for each type of dice defined. When you select a tab, buttons with numbers on it will be displayed. The number is the number of this type of die that will be rolled if you click on it. The results of dice rolls will be displayed in the Game Chat Panel