Task System - Revision history

Arafelis: dev cat added.

2008-09-08T02:45:46Z

dev cat added.

←Older revision		Revision as of 02:45, 8 September 2008
Line 138:		Line 138:
	=== Dissention ===		=== Dissention ===
	** Orginiator dictates Actor must cause strife between targets Objective. Polar opposite of Ally.		** Orginiator dictates Actor must cause strife between targets Objective. Polar opposite of Ally.
		+
		+
		+	[[Category: Development]]

Chaos: /* Task_Stage */

2008-05-22T01:38:26Z

Task_Stage

←Older revision		Revision as of 01:38, 22 May 2008
Line 41:		Line 41:
	==== Task_Stage ====		==== Task_Stage ====
	* '''Data type''': string		* '''Data type''': string
-	* '''Description''': One of the set of stage strings defined by the task type. These stages are "active" only while the Task_Status is Task_Status_Assigned. Outside of that status, the most they indicate is the stage the task was in when it left Task_Status_Assigned.	+	* '''Description''': One of the set of stage strings defined by the task type. These stages are "active" only while the Task_Status is Task_Status_Assigned. Outside of that status, the most they indicate is the stage the task was in when it left Task_Status_Assigned. The task may be considered as a finite state machine that moves between these stages according to the plot defined in the type definition's code.
	* '''Example''': "assigned", "begun", "stage_1", "stage_2"		* '''Example''': "assigned", "begun", "stage_1", "stage_2"
		+
	==== Task_Parts ====		==== Task_Parts ====
	* '''Data type''': descriptor array		* '''Data type''': descriptor array

Chaos: /* Task_Unique_Tag */

2008-05-22T01:35:04Z

Task_Unique_Tag

←Older revision		Revision as of 01:35, 22 May 2008
Line 66:		Line 66:

	==== Task_Unique_Tag ====		==== Task_Unique_Tag ====
-	* '''Data type''': int	+	* '''Data type''': string
-	* '''Description''': A system generated unique numeral tag for this task.	+	* '''Description''': A system generated unique string tag for this task.
-	* '''Example''': -1159877561	+	* '''Example''': "-1159877561", "/usr/foo"

	=== Flags ===		=== Flags ===

Chaos: /* Task_Flags */

2008-05-22T01:34:32Z

Task_Flags

←Older revision		Revision as of 01:34, 22 May 2008
Line 62:		Line 62:
	* '''Data type''': bitmask		* '''Data type''': bitmask
	* '''Description''': This field holds the various bitmask flags for the descriptor.		* '''Description''': This field holds the various bitmask flags for the descriptor.
-	* '''Example''': Task_Flag_Active	+	* '''Example''': Task_Flag_Necessary
	* '''See''': [[Task System#Flags]]		* '''See''': [[Task System#Flags]]
		+
	==== Task_Unique_Tag ====		==== Task_Unique_Tag ====
	* '''Data type''': int		* '''Data type''': int

Chaos at 01:34, 22 May 2008

2008-05-22T01:34:01Z

←Older revision		Revision as of 01:34, 22 May 2008
Line 43:		Line 43:
	* '''Description''': One of the set of stage strings defined by the task type. These stages are "active" only while the Task_Status is Task_Status_Assigned. Outside of that status, the most they indicate is the stage the task was in when it left Task_Status_Assigned.		* '''Description''': One of the set of stage strings defined by the task type. These stages are "active" only while the Task_Status is Task_Status_Assigned. Outside of that status, the most they indicate is the stage the task was in when it left Task_Status_Assigned.
	* '''Example''': "assigned", "begun", "stage_1", "stage_2"		* '''Example''': "assigned", "begun", "stage_1", "stage_2"
		+	==== Task_Parts ====
		+	* '''Data type''': descriptor array
		+	* '''Description''': May optionally contain one or more tasks which are associated with the parent task, creating tasks with prerequisites or optional components.
		+	* '''Example''': array of task descriptors
	==== Task_Roles ====		==== Task_Roles ====
	* '''Data type''': mapping		* '''Data type''': mapping
Line 49:		Line 53:
	* '''See''': [[Task System#Task Types]]		* '''See''': [[Task System#Task Types]]
	==== Task_Objectives ====		==== Task_Objectives ====
-	* '''Data type''': ?? (does this need to be a seperate descriptor type possibly?)	+	* '''Data type''': ?? (does this need to be a separate descriptor type possibly?)
	* '''Description''': This would ideally describe the objective of the task in some meaningful way.		* '''Description''': This would ideally describe the objective of the task in some meaningful way.
	* '''Example''': ([ "/d/Almeria/Losthaven/Sewers/mon/rat" : 30 ])		* '''Example''': ([ "/d/Almeria/Losthaven/Sewers/mon/rat" : 30 ])
Line 67:		Line 71:
	=== Flags ===		=== Flags ===
	==== Task_Flag_Necessary ====		==== Task_Flag_Necessary ====
		+	* '''Meaning''': When considering a given task and its Task_Parts, designates this task as one which must be completed in order for the parent task to be considered completed. The parent task itself need not have this flag. A task with no Task_Parts is implicitly necessary without having this flag on.
	==== Task_Flag_Sufficient ====		==== Task_Flag_Sufficient ====
		+	* '''Meaning''': When considering a given task and its Task_Parts, designates this task as one which suffices, by itself, for the parent task to be considered completed. To be considered completed, therefore, the set of tasks must have all tasks with Task_Flag_Necessary completed, and either at least one with Task_Flag_Sufficient completed, or the entire set.
	=== Functions ===		=== Functions ===
	* task_setup?		* task_setup?

Matts: /* Task Types */

2008-05-22T01:29:12Z

Task Types

←Older revision		Revision as of 01:29, 22 May 2008
Line 78:		Line 78:

	== Task Types ==		== Task Types ==
-	=== Courier ===	+	=== Deliver ===
	* '''Description''': Actor must deliver a package from Originator to Target		* '''Description''': Actor must deliver a package from Originator to Target
	* '''Roles''':		* '''Roles''':
Line 84:		Line 84:
	** Actor		** Actor
	** Target		** Target
-	=== Knowledge ===	+	=== Learn ===
	* '''Description''': Actor must become familiar with and/or memorize the topics decreed by Originator		* '''Description''': Actor must become familiar with and/or memorize the topics decreed by Originator
	* '''Roles''':		* '''Roles''':
	** Originator		** Originator
	** Actor		** Actor
-	=== Exploration ===	+	=== Explore ===
	* '''Description''': Actor must become familiar with and/or memorize a specific location.		* '''Description''': Actor must become familiar with and/or memorize a specific location.
	* '''Roles''':		* '''Roles''':
Line 95:		Line 95:
	** Actor		** Actor
	* '''Notes''': This may actually be a subset of Knowledge, do we want to split them like this for clarity of purpose?		* '''Notes''': This may actually be a subset of Knowledge, do we want to split them like this for clarity of purpose?
-	=== Elimination ===	+	=== Eliminate ===
	* '''Description''': Actor must kill Target dictated by Originiator		* '''Description''': Actor must kill Target dictated by Originiator
	* '''Roles''':		* '''Roles''':
Line 101:		Line 101:
	** Actor		** Actor
	** Target		** Target
-	=== Collection ===	+	=== Collect ===
	** Originator dictates X Objective items that Actor must gather.		** Originator dictates X Objective items that Actor must gather.
	=== Escort ===		=== Escort ===

Chaos at 01:28, 22 May 2008

2008-05-22T01:28:07Z

←Older revision		Revision as of 01:28, 22 May 2008
Line 35:		Line 35:
	* '''Description''': A verbose description of what the task entails.		* '''Description''': A verbose description of what the task entails.
	* '''Example''': "Aildrek's tavern, the Lost Lamb, has an ongoing rat problem that needs dealing with."		* '''Example''': "Aildrek's tavern, the Lost Lamb, has an ongoing rat problem that needs dealing with."
-	==== Task_State ====	+	==== Task_Status ====
		+	* '''Data type''': enumerated integer: Task_Status_Unassigned, Task_Status_Assigned, Task_Status_Completed, or Task_Status_Failed
		+	* '''Description''': The general, system-level status of the task.
		+	* '''Example''': per data type
		+	==== Task_Stage ====
	* '''Data type''': string		* '''Data type''': string
-	* '''Description''': One of the set of state strings defined by the task type.	+	* '''Description''': One of the set of stage strings defined by the task type. These stages are "active" only while the Task_Status is Task_Status_Assigned. Outside of that status, the most they indicate is the stage the task was in when it left Task_Status_Assigned.
	* '''Example''': "assigned", "begun", "stage_1", "stage_2"		* '''Example''': "assigned", "begun", "stage_1", "stage_2"
	==== Task_Roles ====		==== Task_Roles ====
Line 62:		Line 66:

	=== Flags ===		=== Flags ===
-	* Task_Flag_Active	+	==== Task_Flag_Necessary ====
		+	==== Task_Flag_Sufficient ====
	=== Functions ===		=== Functions ===
	* task_setup?		* task_setup?

Chaos at 01:23, 22 May 2008

2008-05-22T01:23:02Z

←Older revision		Revision as of 01:23, 22 May 2008
Line 35:		Line 35:
	* '''Description''': A verbose description of what the task entails.		* '''Description''': A verbose description of what the task entails.
	* '''Example''': "Aildrek's tavern, the Lost Lamb, has an ongoing rat problem that needs dealing with."		* '''Example''': "Aildrek's tavern, the Lost Lamb, has an ongoing rat problem that needs dealing with."
-	==== Task_Status ====	+	==== Task_State ====
-	* '''Data type''': ?? (should this be a Task_Flag instead?)	+	* '''Data type''': string
-	* '''Description''': ...	+	* '''Description''': One of the set of state strings defined by the task type.
-	* '''Example''': ...	+	* '''Example''': "assigned", "begun", "stage_1", "stage_2"
	==== Task_Roles ====		==== Task_Roles ====
	* '''Data type''': mapping		* '''Data type''': mapping

Matts: /* Fields */

2008-05-21T18:53:50Z

Fields

←Older revision		Revision as of 18:53, 21 May 2008
Line 22:		Line 22:
	=== Fields ===		=== Fields ===
	==== Task_Type_Code ====		==== Task_Type_Code ====
-	** '''Data type''': int	+	* '''Data type''': int
-	** '''Description''': Identifies the task's type which defines default beavhior.	+	* '''Description''': Identifies the task's type which defines default beavhior.
-	** '''Defined by''': /lib/task_types.h, /def/task_type/*	+	* '''Defined by''': /lib/task_types.h, /def/task_type/*
-	** '''Example''': Task_Type_Elimination	+	* '''Example''': Task_Type_Elimination
-	** '''See''': [[Task System#Task Types]]	+	* '''See''': [[Task System#Task Types]]
	==== Task_Name ====		==== Task_Name ====
-	** '''Data type''': string	+	* '''Data type''': string
-	** '''Description''': A basic short title for the task.	+	* '''Description''': A basic short title for the task.
-	** '''Example''': "Aildrek's Rat Problem"	+	* '''Example''': "Aildrek's Rat Problem"
	==== Task_Description ====		==== Task_Description ====
-	** '''Data type''': string	+	* '''Data type''': string
-	** '''Description''': A verbose description of what the task entails.	+	* '''Description''': A verbose description of what the task entails.
-	** '''Example''': "Aildrek's tavern, the Lost Lamb, has an ongoing rat problem that needs dealing with."	+	* '''Example''': "Aildrek's tavern, the Lost Lamb, has an ongoing rat problem that needs dealing with."
	==== Task_Status ====		==== Task_Status ====
-	** '''Data type''': ?? (should this be a Task_Flag instead?)	+	* '''Data type''': ?? (should this be a Task_Flag instead?)
-	** '''Description''': ...	+	* '''Description''': ...
-	** '''Example''': ...	+	* '''Example''': ...
	==== Task_Roles ====		==== Task_Roles ====
-	** '''Data type''': mapping	+	* '''Data type''': mapping
-	** '''Description''': An infostore field that will hold the varying roles unique to each task type.	+	* '''Description''': An infostore field that will hold the varying roles unique to each task type.
-	** '''Example''': ([ "actor" : "/usr/erebus", "originator" : "/d/Almeria/Losthaven/npc/aildrek", "target" : "/d/Almeria/Losthaven/Sewers/mon/rat" ])	+	* '''Example''': ([ "actor" : "/usr/erebus", "originator" : "/d/Almeria/Losthaven/npc/aildrek", "target" : "/d/Almeria/Losthaven/Sewers/mon/rat" ])
-	** '''See''': [[Task System#Task Types]]	+	* '''See''': [[Task System#Task Types]]
	==== Task_Objectives ====		==== Task_Objectives ====
-	** '''Data type''': ?? (does this need to be a seperate descriptor type possibly?)	+	* '''Data type''': ?? (does this need to be a seperate descriptor type possibly?)
-	** '''Description''': This would ideally describe the objective of the task in some meaningful way.	+	* '''Description''': This would ideally describe the objective of the task in some meaningful way.
-	** '''Example''': ([ "/d/Almeria/Losthaven/Sewers/mon/rat" : 30 ])	+	* '''Example''': ([ "/d/Almeria/Losthaven/Sewers/mon/rat" : 30 ])
	==== Task_Info ====		==== Task_Info ====
-	** '''Data type''': variable	+	* '''Data type''': variable
-	** '''Description''': A general purpose infostore for the descriptor.	+	* '''Description''': A general purpose infostore for the descriptor.
	==== Task_Flags ====		==== Task_Flags ====
-	** '''Data type''': bitmask	+	* '''Data type''': bitmask
-	** '''Description''': This field holds the various bitmask flags for the descriptor.	+	* '''Description''': This field holds the various bitmask flags for the descriptor.
-	** '''Example''': Task_Flag_Active	+	* '''Example''': Task_Flag_Active
-	** '''See''': [[Task System#Flags]]	+	* '''See''': [[Task System#Flags]]
	==== Task_Unique_Tag ====		==== Task_Unique_Tag ====
-	** '''Data type''': int	+	* '''Data type''': int
-	** '''Description''': A system generated unique numeral tag for this task.	+	* '''Description''': A system generated unique numeral tag for this task.
-	** '''Example''': -1159877561	+	* '''Example''': -1159877561

	=== Flags ===		=== Flags ===

Matts: /* Fields */

2008-05-21T18:52:56Z

Fields

←Older revision		Revision as of 18:52, 21 May 2008
Line 21:		Line 21:
	== Task Descriptor ==		== Task Descriptor ==
	=== Fields ===		=== Fields ===
-	* Task_Type_Code	+	==== Task_Type_Code ====
	** '''Data type''': int		** '''Data type''': int
	** '''Description''': Identifies the task's type which defines default beavhior.		** '''Description''': Identifies the task's type which defines default beavhior.
Line 27:		Line 27:
	** '''Example''': Task_Type_Elimination		** '''Example''': Task_Type_Elimination
	** '''See''': [[Task System#Task Types]]		** '''See''': [[Task System#Task Types]]
-	* Task_Name	+	==== Task_Name ====
	** '''Data type''': string		** '''Data type''': string
	** '''Description''': A basic short title for the task.		** '''Description''': A basic short title for the task.
	** '''Example''': "Aildrek's Rat Problem"		** '''Example''': "Aildrek's Rat Problem"
-	* Task_Description	+	==== Task_Description ====
	** '''Data type''': string		** '''Data type''': string
	** '''Description''': A verbose description of what the task entails.		** '''Description''': A verbose description of what the task entails.
	** '''Example''': "Aildrek's tavern, the Lost Lamb, has an ongoing rat problem that needs dealing with."		** '''Example''': "Aildrek's tavern, the Lost Lamb, has an ongoing rat problem that needs dealing with."
-	* Task_Status	+	==== Task_Status ====
	** '''Data type''': ?? (should this be a Task_Flag instead?)		** '''Data type''': ?? (should this be a Task_Flag instead?)
	** '''Description''': ...		** '''Description''': ...
	** '''Example''': ...		** '''Example''': ...
-	* Task_Roles	+	==== Task_Roles ====
	** '''Data type''': mapping		** '''Data type''': mapping
	** '''Description''': An infostore field that will hold the varying roles unique to each task type.		** '''Description''': An infostore field that will hold the varying roles unique to each task type.
	** '''Example''': ([ "actor" : "/usr/erebus", "originator" : "/d/Almeria/Losthaven/npc/aildrek", "target" : "/d/Almeria/Losthaven/Sewers/mon/rat" ])		** '''Example''': ([ "actor" : "/usr/erebus", "originator" : "/d/Almeria/Losthaven/npc/aildrek", "target" : "/d/Almeria/Losthaven/Sewers/mon/rat" ])
	** '''See''': [[Task System#Task Types]]		** '''See''': [[Task System#Task Types]]
-	* Task_Objectives	+	==== Task_Objectives ====
	** '''Data type''': ?? (does this need to be a seperate descriptor type possibly?)		** '''Data type''': ?? (does this need to be a seperate descriptor type possibly?)
	** '''Description''': This would ideally describe the objective of the task in some meaningful way.		** '''Description''': This would ideally describe the objective of the task in some meaningful way.
	** '''Example''': ([ "/d/Almeria/Losthaven/Sewers/mon/rat" : 30 ])		** '''Example''': ([ "/d/Almeria/Losthaven/Sewers/mon/rat" : 30 ])
-	* Task_Info	+	==== Task_Info ====
	** '''Data type''': variable		** '''Data type''': variable
	** '''Description''': A general purpose infostore for the descriptor.		** '''Description''': A general purpose infostore for the descriptor.
-	* Task_Flags	+	==== Task_Flags ====
	** '''Data type''': bitmask		** '''Data type''': bitmask
	** '''Description''': This field holds the various bitmask flags for the descriptor.		** '''Description''': This field holds the various bitmask flags for the descriptor.
	** '''Example''': Task_Flag_Active		** '''Example''': Task_Flag_Active
	** '''See''': [[Task System#Flags]]		** '''See''': [[Task System#Flags]]
-	* Task_Unique_Tag	+	==== Task_Unique_Tag ====
	** '''Data type''': int		** '''Data type''': int
	** '''Description''': A system generated unique numeral tag for this task.		** '''Description''': A system generated unique numeral tag for this task.