[Freeciv-Dev] Re: freeciv 1.12.1 spec?

["jdorje@xxxxxxxxxxxx" <dbsmith@xxxxxxxxxxx>]

Originally to: David Bryan Smith

  by provide.net (CommuniGate Pro SMTP 3.5b5)
  with ESMTP id 6261815 for dbsmith@xxxxxxxxxxx; Wed, 05 Dec 2001 15:14:14 -0500
Received: from pi (localhost [127.0.0.1])
        by pi.glockenspiel.complete.org (Postfix) with ESMTP
        id 7C9F43B9F1; Wed,  5 Dec 2001 15:14:00 -0500 (EST)
Received: with LISTAR (v1.0.0; list freeciv-dev); Wed, 05 Dec 2001 15:14:00 
-0500 (EST)
Delivered-To: virtual-freeciv.org-freeciv-dev@xxxxxxxxxxxx
Received: from mtapop1pub.verizon.net (mtapop1pub.gte.net [206.46.170.34])
        by pi.glockenspiel.complete.org (Postfix) with ESMTP id 0D0C93B853
        for <freeciv-dev@xxxxxxxxxxx>; Wed,  5 Dec 2001 15:14:00 -0500 (EST)
Received: from verizon.net (pool-141-158-105-237.pitt.east.verizon.net 
[141.158.105.237])
        by mtapop1pub.verizon.net  with ESMTP
        for <freeciv-dev@xxxxxxxxxxx>; id OAA10985958
        Wed, 5 Dec 2001 14:13:59 -0600 (CST)
Message-ID: <3C0E7F31.7060406@xxxxxxxxxxx>
Date: Wed, 05 Dec 2001 15:10:25 -0500
From: Jason Short <vze2zq63@xxxxxxxxxxx>
Reply-To: jdorje@xxxxxxxxxxxx
User-Agent: Mozilla/5.0 (X11; U; Linux i686; en-US; rv:0.9.5) Gecko/20011014
X-Accept-Language: en-us
MIME-Version: 1.0
To: Freeciv List <freeciv-dev@xxxxxxxxxxx>
Subject: [Freeciv-Dev] Re: freeciv 1.12.1 spec?
References: 






05130224.62720.qmail@xxxxxxxxxxxxxxxxxxxxxxx> 

16Bf3E-00089u-00@xxxxxxxxxxxxxxxxxxxxxxxxxxx> 
<20011205204505.A1150@xxxxxxxxxxxxxxx> 
<E16Bi8F-00063r-00@xxxxxxxxxxxxxxxxxxxxxxxxx>
Content-Type: text/plain; charset=ISO-8859-1; format=flowed
Content-Transfer-Encoding: 8bit
X-archive-position: 5098
X-listar-version: Listar v1.0.0
Sender: freeciv-dev-bounce@xxxxxxxxxxx
Errors-To: freeciv-dev-bounce@xxxxxxxxxxx
X-original-sender: vze2zq63@xxxxxxxxxxx
Precedence: bulk
X-list: freeciv-dev

Andrew Sutton wrote:

> On Wednesday 05 December 2001 02:45 pm, Daniel Sjölie wrote:
>
>>Nah... I don't think this is the right way to do it...
>>Tutorials should be all client side... I guess the foundation should be
>>common for all clients but that's it... No need to make it more
>>compliated than that I think...
>>
>>
>
> i thought a tutorial was essentially a saved game. maybe we're talking about
> different things :) anyway, if its a saved game, there'd have to be some
> server support i imagine...

I had always assumed it would be handled client-side, via a "tutorial
mode" rather than a specific saved game.

I guess I'm thinking back to the way PayCivs did it - this was, IMO,
pretty good.  When in "tutorial mode", there would be hooks for specific
events client-side.  When that event happened, a popup window would give
you tutorial information, and then the hook for that event would be
removed (so that it was not given again).


Here's a rough example, using only text.  In theory we shouldn't just
have text, but images, linkes, etc. - this is a bit outside my scope.

upon starting a game: "your first job should be founding a city.  Find a
suitable spot and choose 'build city' from the 'orders' menu."

upon moving a settler into a good city position: "this looks like a good
spot to build a city.  choose 'build city' from the 'orders' menu to do
it."  (I remember this one from CivI :-). )

upon founding a city: "left-click on the city to open a window for that
city".

...and so on.  These would obviously need to be refined, and there
should be a lot more of them.  But once the infrastructure is in place,
I don't think we'll have any trouble coming up with tutorial text.


In theory it'd be good to have this text be common to all civ GUI's, but
that may not be possible if it gives UI information that differs between
GUI's.  I'm not sure how to handle this.  Obviously the hooks should be
in common code (if at all possible), but the implementation of the popup
will need to be gui-specific (although it's possible a function exists
already that will do such a popup).

jason