Welcome to the TabletopUI project!
We are a team of 4th semester students studying IT-Systems Engineering at Hasso-Plattner-Institute and this is the first project including a Tabletop UI. It is part of a lecture in software engineering techniques (SWT).
- Get Squeak 5.2 or later
- Load Metacello
- Finally, load the package with the following command:
Metacello new
baseline: 'Tabletop';
repository: 'github://hpi-swa-teaching/TabletopUI:main/packages';
load.
You can open the Tabletop UI with the command TTTabletopWindow open. A window will open offering you different configuration options before starting a Tabletop game.
You can switch to the desired player by clicking on its name in the player selection menu next to the input field.
There are certain commands that can only be executed when the gamemaster is selected.
Every player including the gamemaster can execute a dice roll.
To do so, you can use the dice tool which can be found on the left of the screen.
Alternatively you can roll the dice via the input prompt on the bottom right.
The dice command is roll dx. x represents the maximum number of eyes the rolled dice can show. Valid dice sizes are 4, 6, 8, 10, 12 and 20.
In the dice command a number y can be added or subtracted to the dice result. This is done by roll dx[+|-]y.
It is also possible to roll z dices at once using the command roll zdx.
You can also combine modifiers and multiple dice rolls like this: roll zdx[+|-]y or roll different dice types by combining them with + or -.
When the gamemaster is selected, one can choose to begin an initiative roll. The command to start an initiative roll is start fight, start initiative or start ini.
After this command, all players except the gamemaster may now roll a dice to determine their fight position. Not all players have to roll the dice. The gamemaster ends the dice roll round with end initiative or end ini.
Now, the fight begins and the turnorder appears as a pop up list.
A player can roll the dice as often as he/she wants to and ends its turn manually by typing "end turn".
At any time the gamemaster can remove players from the fight via the command remove [playername].
To end the fight and return to the default mode the gamemaster can use end fight.
NPCs can be added during the entire game through the side bar. To do this, a valid name must be entered in the provided input field and then the "Add NPC" button must be pressed.
To measure distances on the map you can use the ruler tool on the left of the screen. A new window displaying the distance will open. If you want to measure the distance between two tiles simply drag your cursor between them. The distance will also be displayed in the log.
Select Sheet on the left of the screen to open a Character Sheet. It shows the all relevant attributes of the current player and allows you to edit them. If you click the label of an attribute a corresponding modiefier will be added to a dice roll.