-
Notifications
You must be signed in to change notification settings - Fork 5
/
TD_USER_GUIDE
231 lines (189 loc) · 12.7 KB
/
TD_USER_GUIDE
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
Tournament Director's User Guide
--------------------------------
Before You Start
----------------
You're going to need an account on a site running the software.
The site operator needs to give you the appropriate permissions.
Throughout this document, we'll assume the site is https://example.com/.
Concepts
--------
Most of this should be fairly familiar, but there are some subtleties.
Things will be more obvious if you have a good understanding of these concepts.
A Player is a person who plays Diplomacy.
A Tournament is an event where people play Diplomacy competitively.
A Tournament consists of a number of Rounds, each of which has a number of Games.
Each Game is played with a GameSet (e.g. the Avalon Hill edition).
Tournaments may be part of a Series, for example an annual tournament or an
event like DipCon that is hosted by different tournaments in different years.
A Tournament hands out Awards to deserving Players based on various criteria.
By default, these are just seven "Best Country" awards.
When Players register to play in a Tournament, this is represented by a
TournamentPlayer. When Players are present at roll call for a particular Round,
this is represented by a RoundPlayer. A Player playing a particular Game is
represented by a GamePlayer (note that the system doesn't currently support
replacement players - each Great Power in a Game has exactly one GamePlayer).
Games are scored using some GameScoringSystem (the system has support for all
the systems commonly used in North America). Scores for Games in a Round are
combined using a RoundScoringSystem. This only matters if you have players
playing multiple Games in a Round - you may want all games played by a player to
contribute to their score or just the best result. You may also want to give points
to players who volunteer to sit out a round to make the numbers work.
Similarly, Round scores get combined using a TournamentScoringSystem.
The system currently support "best 2 rounds", "best 3 rounds", and "best 4 rounds".
This allows you to have a "drop round" or to include all round scores.
The option "Sum best 4 games in any rounds" is also an option, in which case
the actual rounds are ignored and all game scores are considered. For this case, you
can specify "None" as the RoundScoringSystem.
The system also knows about SupplyCentres, CentreCounts, and DrawProposals, all
of which should be fairly self-explanatory.
The final concept is a SeederBias. This is used to guide the game seeding algorithm.
Essentially it tells the system to do its best not to have those players play a
game against each other. It is intended for use when you have family members
that you would prefer not to end up at the same board.
Finally, it reads background information from the World Diplomacy Database and
stores it as PlayerAwards, PlayerGameResults, PlayerRankings, and PlayerTournamentRankings,
but you shouldn't need to worry about those at all.
Creating Your Tournament
------------------------
Start out at https://example.com/admin/tournament/tournament/add.
Give the tournament a name (the year will automatically be appended), format (FTF
or vFTF), location, dates, and pick a TournamentScoringSystem and RoundScoringSystem.
Decide whether you want the system to seed the games or not, how Great Powers
will be assigned, what you're going to tell players about failed DrawProposals,
and whether best countries are determined by score or centre count.
If there's a Discord channel for the tournament, you can create a webhook to that
channel on Discord and add it to the tournament. This will allow the system to
post board calls directly to that Discord channel.
Next come some items to control how the site will treat the Tournament. Make
yourself a Manager (you can add others too if you like), and decide whether to
publish the Tournament on the site. Unpublished Tournaments will only be visible
to users with accounts on the site, so it's a good idea to keep it unpublished
while you're getting everything set up. You might not want to publish it at all,
or only to publish it after the Tournament is over. Keep the Tournament Editable
until it's over and all the data has been entered. Check the "no email"
checkbox if you're going to be doing any experimenting (e.g. tying out game
seeding) or if you don't want the system to send email to the players at all.
You may also want to check "Delay publishing game URL" if you are going to have
games taking place on Backstabbr or recorded in Backstabbr sandboxes. By default
in these case, the system will link to Backstabbr.
There is also a field to enter the Tournament's id in the World Diplomacy Database,
but you won't be able to enter this until after the results have been uploaded to
the WDD.
Next you can add Rounds. For each one, you need to specify the start and end times and dates,
and the scoring system used for games in that Round (most Tournaments will use the
same scoring system for every round, but the system supports deviations from that).
You also need to decide whether Draws in the Round include all survivors (DIAS).
If you want, you can specify that a Round ends after a particular game year or
between specified times.
Scroll all the way to the bottom to find the "Save" button.
Now your Tournament has its own page on the site. Let's assume it's
https://example.com/tournaments/42/.
Registering Players
-------------------
The tournament page will list the number of players currently registered near the
top of the page. This is a link to the Tournament Players page at
https://example.com/tournaments/42/players/, where you will see them listed and
you can add and remove them.
Unregistering a player is as simple as clicking the button by their name. Note, though,
that the system will get very confused if you unregister a player who has already
played any games. Once the Tournament is underway, you're probably best just leaving
anyone who didn't show up, just to be safe.
Registering a player is very easy as long as the system knows about them - just
select their name from the dropdown list and click "Submit". You can currently add
up to 4 players at a time, and you'll end up back at the same page.
If the Player you want to add doesn't appear in the dropdown list, follow the link to
https://example.com/admin/tournament/player/add/ where you can add them. Please
do check before adding them - de-duplicating players who are in the system twice has
to be done by hand and is quite tricky! Note that email address, if provided, will
be used to send board calls to, and also to send a link to enter power preferences
if that's how Great Powers are assigned in your Tournament. The "WDD id" is used to
provide background information about the Player. The "picture" is for future use.
Any "Backstabbr username" will be displayed in board calls for vFTF Tournaments.
"Backstabbr profile URL" is still a work-in-progress.
"Location" and "Nationalities" are displayed in the list of registered players.
The "User" field is to match-up Players who are also TDs who use the system (by
default, Players who play in a Tournament that they help manage will be "Unranked"
- they won't be eligible for Best Country awards and their score will be noted
separately to everyone else.
This is also a good time to add any SeederBias that you might need. Your Tournament
page has a link to https://example.com/admin/tournament/seederbias/add/ where you
can specify the pairs of TournamentPlayers to keep apart.
Great Power Preferences
-----------------------
If you're using preference lists to assign Great Powers, hopefully most players will
provide you with an email address. In that case, when you register them, the system
will send them an email (unless you checked that "no email" flag for the Tournament)
with a unique URL where they can enter their preferences for the Tournament. You can
see which have been sent out from the tournament player page, and you can also re-send
them from here if needed.
For players who don't provide an email, you can enter their preferences by hand at
https://example.com/tournaments/42/prefs. Preferences are entered as a string of
characters, for example "FGIRT" meaning "France, then Germany, then Italy, then
Russia, then Turkey, with England and Austria joint last".
Roll Call and Game Seeding
--------------------------
Note: the software has the concept of "the current round", which is determined
by which rounds have RoundPlayers (i.e. roll call has been done) and Games that
haven't yet finished. One effect of this is that you shouldn't enter roll call
information until you're actually about to start the round (in practice, you
don't know for sure who's going to show up until then anyway).
Shortly before the Round starts, go to the round page, which should be
https://example.com/tournaments/42/current_round/
There you will find a "Roll Call" link to https://example.com/tournaments/42/rounds/1/roll_call/
Here you simply check the "Present" box by each player who is present to play the round.
You can also flag players as "Standby" if they would prefer not to actually play
but are willing to play if needed, and as "Sandboxer" if they are willing to record their
game in Backstabbr as it progresses. "Rounds played" is for TD information, in case
you want to enforce that players don't play every round.
Once you have everyone entered, press "Submit".
This will take you to the "get seven" page. If you have an exact multiple of seven
players (possibly including standby players), you can just seed the games from here.
Otherwise, the system will prompt you to either have players sit out the round or to
have players play multiple games. Just select them from the dropdown lists and hit "Seed Games".
The system will go ahead and seed the boards. This page annotates players willing to
record their game with an asterisk so that you can ensure that every board has somebody
recording it if needed. Note that you can refresh this page to re-do the seeding if needed.
You can also make changes manually. For a vFTF tournament with games on Backstabbr, you
can enter links to the games on backstabbr on this page to make it easier to import
centre-count information. Once you're happy, press "Submit" and the Games will be created,
including sending out emails to the players (unless your Tournament has the "no email"
option selected) and posting to the Discord webhook (if any).
Game Tracking
-------------
How much you do here really depends on what you want to achieve. The system is designed
to allow people to follow along with the tournament as it progresses, but that obviously
means more data entry on your part than just tracking the results of games.
Your options are:
Upload images for games as they progress. Ideally every season, but gaps are ok.
Enter SupplyCentre ownership data after each game year (in this case the system will
calculate CentreCounts).
Enter CentreCounts after each game year. (For a vFTF game, if the Game has a
backstabbr URL, you can grab the current CentreCounts from Backstabbr by
just clicking the "Import SC Counts from Backstabbr" link on the Game page).
For DrawProposals, you can enter all of them or just the ones that pass.
The bare minimum is the final year CentreCounts and any successful DrawProposals. These are
needed to calculate scores. For some scoring systems, you'll also need to enter elimination
years if you don't enter SC Counts for those years.
If you were to enter all the above data, people would be able to see timelapse-style
displays of the board state, charts of SC ownership and centre counts, graphs of
centre-counts over time, and textual highlights like "Austria dropped from 5 to 2, losing
Trieste to Italy, Greece to Turkey, and Budapest to Russia", as well as up-to-date "if all
games ended now" scores.
Remember that if you want people to be able to follow the Tournament, or even just see the
standings, you'll need to set it to "Published".
Results
-------
The system will calculate scores as games progress (it continually updates all the scores
on an "if all games ended now" basis), and will provide charts for best countries,
as well as a leaderboard.
If necessary, you can override the calculated scores.
The system will automatically determine every player's placement in the tournament as well
as who earned each "Best Country" award. You can record who earned any other awards and/or
change the "Best Country" recipients if needed on the "Awards" page for the Tournament.
Once the Tournament is over and all the data has been entered, please uncheck the "Editable"
checkbox for the Tournament (and Save it). This will help prevent inadvertant changes.
Upload to WDD
-------------
Once your Tournament is complete, the system can generate the two CSV files needed to
upload the results to the WDD. Once your Tournament is actually on the WDD, please take
a moment to set its "WDD Id" (and Save it) to help with cross-referencing.