LlamaServer FAQ

[llamabeast]

Hmm, there's not really a lot I can think to write here.

Okay, the single thing which most commonly goes wrong with game admin is that the admin will get knocked out, and despite his or her best intentions stop following the game thread. This is only human. Therefore, if you get knocked out of the game, you must pass on the admin password to one of the remaining players. Preferably it will be someone relatively active on the forum.

Okay, next, the most important thing is to find the admin options. From www.llamaserver.net, click the name of the game you're admining, then click the "Admin options" link at the bottom of the page. From there I think it is fairly self-explanatory.

One option people don't seem to use very much is the "Change Message of the Day" option. This (which could perhaps use a better name - suggestions?) allows you to put a message on the game page for players to read. This might be useful to give players information about the game - upcoming delays for instance - or just to post a joke or a random comment.

One thing which is not obvious is how to set a player to AI. You shouldn't need to do this - the player should do it themselves - but sometimes players just disappear. Here's how to do it:

- "Admin options"->"Change a player's e-mail address", and then change it to the address of someone who can fairly look at the player's turn. Yourself if you're not in the game, or some trusted 3rd party otherwise (me, Gandalf, lch, DrPraetorius, Xietor, LazyPerfectionist, there's loads). We'll call this person Person A.
- Go back to the main page for your game and "Request turn resend"
- Person A will receive the absent player's turn, and should then set the player to AI and e-mail the resulting 2h file back to the server. Sorted!

That's all I can think of for now.

7th August 2008: Note that if you've been a game admin for a while, you should check your admin options again - you now have lots of powers you didn't use to have. There shouldn't be very much now that you can't do.

[llamabeast]

The actual process of creating a new game is pretty straightforward. Just go to www.llamaserver.net/createDom5Game.cgi, and hopefully it will all be fairly self-explanatory. You should note that even once you create the game you can go back and change any of the settings, so you needn't worry about things becoming too set in stone.


So, the bigger question is when and how you should organise a new game. Here are a few guidelines:

- Anyone is welcome to create a new LlamaServer game. If you just want to make a small game for you and your friend, go ahead.

- Don't actually create the game on the LlamaServer until all the players have signed up, or at least nearly all. However, you may find it useful to look at the Create Game page to see all the options you have available.

- To organise a game, make a new thread in the multiplayer part of whichever forum you're using to organise the game. You should state what game settings, map and mods you plan to use, and any house rules you want to use.

- Make sure that you state what the game's policy towards treaties and non-aggression pacts is. Should they be inviolable, as many players prefer, or should they be mere words, as in real life? The choice is yours but it's important the players know the ground rules.

- Make sure the thread has a word like "open" or "recruiting" in its title. Be sure to change this once the game's full.

- As players sign up, keep an up-to-date list of nations in the game and who's playing them. This makes it easier for players to see which nation is taken, and later for them to work out who to message if they want to conduct diplomacy.

- As the game organiser, you'll also be the game admin, so read the FAQ section on that as well. In particular, make sure that if you get knocked out you pass the admin password on to one of the players still in the game.

[llamabeast]

In this section:

- How does the LlamaServer work?
- What's the capacity of the LlamaServer?
- Can you tell me how to make my own AnimalServer?
- Is there anything I can do?
- Are there any known issues?

- How does the LlamasServer work?

Ooh, lots to say here! But this is for the interested only, and could be quite dull. So, the LlamaServer actually consists of 3 computers:
- A computer actually called the LlamaServer which lives in my cupboard, and in fact has no other purpose (clearly I have difficulties in prioritising my expenditures!).
- The Cambridge Student-Run Computing Facility (SCRF) machine, which is an amazing service provided by student volunteers, and hosts the website.
- A mail server, owned by my brother.
plus obviously a load of DNS servers to point at the website. You wouldn't believe how long the DNS took to sort out (various evil "free" companies inserted pop-ups, and many other such problems).

Amyway, the LlamaServer itself is a linux box (running Ubuntu), and it runs a perl program ('goLlamaServer'!) every five minutes. The program first connects to the mail server to check if there's any new e-mail and download it all (using the Perl Email Project's libraries, slightly hacked by me). Then for each e-mail it checks if there are any attachments. If there are any archives (zips etc) it unzips them. After all that it sees if it has a 2h file on its hands (it can only cope with one per e-mail).

If it does have a 2h it sticks it in a folder called savedgames/test in the dominions directory, and then runs 'dom3 --verify test', which verifies the 2h file. If the 2h file is fine (it almost always is), Dominions gives a game number and a turn number. The game numbers are all kept in a file containing details for each game, so if the game is known the 2h file is stuck in the right directory. Whatever happens it writes an e-mail back to the sender (using an excellent perl script called sendEmail which I highly recommend).

Next it contacts (ssh) the SRCF computer to see if any new admin commands have been given, and if they have it does them.

After that it sees if any games need hosting, and if they do it hosts them and sends the new files. Finally it sends updated files to the SRCF computer.

The website itself was a whole extra task. I don't think there's much point describing it though, because I probably know less than a good proportion of people here about web programming - I know exactly what was required to do the LlamaServer website and nothing more, since I looked it all up as I went.

- What's the capacity of the LlamaServer?

I don't know. It's big - maybe 100 games? PBEM has the advantage of not having much in the way of overheads.

- Can you tell me how to make my own AnimalServer?

Well, not easily. The code for the LlamaServer is several thousand lines long. In principle I'm probably happy to distribute the code if people are interested, though I'd rather just make any suggested improvements myself - it's hardly going to run out of capacity so there should be no need for any more AnimalServers for Dominions.

If you're interested in creating an equivalent for another PBEM game though, I'd be very interested in helping. It would still be a biggish job, since quite a few bits are Dominions specific. But it would probably be doable.

- Is there anything I can do?

You could organise and admin games. And you could make suggestions for improvements. That's all I can think of really. Organising games is good though.

- Are there any known issues?

Yes, unfortunately. Two I can think of.

- Very occasionally e-mails from a particular player just won't get through, or will be delayed. I don't know what's going on here - since they never actually get to my end I'm a bit stuck. Maybe it's an internet thing, or maybe the mail server is slightly dodgy. Solution: retry. If that doesn't work, ask the game admin for an extension and try again later. This is obviously potentially serious as it could cause staling, but it's only happened a few times ever.

- Very weirdly, a problem's happened twice where a particular turn file arrives in a player's inbox corrupt. On requesting a resend, the turn arrives corrupt again. But the file's fine on the LlamaServer, and if I change the e-mail address to my own and get it to resend it works fine. Solution: ask the admin to get the file sent to him (by temporarily changing the nation's e-mail address) and have him forward the file to you. The next turn the problem should have gone. This is super super weird, but fortunately also super rare.

[llamabeast]

Reserved

[llamabeast]

Being as I finally wrote this I thought maybe I should bump it. Although it's not very interesting apart from for reference.

[JimMorrison]

Originally Posted by llamabeast

Reserved

Oh, times were simpler back then.....


Maybe the MP server thread could just be redone? Currently it's a bit of a mess - not as clearly informative as it could be, and with several posts that shouldn't really even be there.

But anyway, that has a link to this thread, which I think is best solution.