Final Delivery Checklist (3/4 Complete)

The postmortem is complete!  Click here to read it if you'd like.  Only one more bit of "homework" to do and then I can graduate!

Final Delivery Checklist
Deliverable	Done?
Demo video showing all major features and gameplay.	No
Project blog (You're lookin' at it.)	Yes
5-8 page post mortem / reflection paper on the project	Yes
Executable build	Yes

Final Delivery Checklist (1/2 Complete)

The build scripts have been repaired and updated to reflect the new package structure of the MHFramework engine and the newly added directories in Team Laser Combat.  I can once again build a stand-alone version of the game.

Final Delivery Checklist
Deliverable	Done?
Demo video showing all major features and gameplay.	No
Project blog (You're lookin' at it.)	Yes
5-8 page post mortem / reflection paper on the project	No
Executable build	Yes

Final Delivery Checklist (1/4 Complete)

In order for my work on TLC to be evaluated as my Master's capstone, I must submit the following deliverables per the independent study agreement with Professor Keenan.  This is my primary objective for the week...along with my suffocating workload, of course.

Final Delivery Checklist
Deliverable	Done?
Demo video showing all major features and gameplay.	No
Project blog (You're lookin' at it.)	Yes
5-8 page post mortem / reflection paper on the project	No
Executable build	No

Milestone 3 Complete!

Milestone 3 is complete!  It took about 16 hours of effort today plus about another six or so last weekend.  So, about 20 to 25 hours total.  Funny, that's less than one week's worth of effort when I couldn't complete Milestone 2 in a month and a half.

So now I have a choice to make:

1. Start wrapping up the documentation and the gameplay video now to make sure I hit next week's deadline.  This is the stuff I'm getting graded on for my capstone requirement.
2. Try to fix those defects in some of Milestone 2's Power Tokens. There are just a few that don't work quite right.
3. Add some better graphics for the items on the floor from Milestone 3. The placeholders I have now are confusing.

I'll decide later. Too tired now.

Here's the recap of Milestone 3:

Milestone 3: The Game World Environment
Requirement ID	Description	Status
3.1.1	The system shall place a coin bonus item in a random, unobstructed location on the game board at the start of each match.	Complete
3.1.2	The system shall place a token bonus item in a random, unobstructed location on the game board at the start of each match.	Complete
3.1.3	The system shall place a snack bonus item in a random, unobstructed location on the game board at the start of each match.	Complete
3.1.4	The system shall place a weapon upgrade bonus item in a random, unobstructed location on the game board at the start of each match.	Complete
3.1.5	The system shall place an armor upgrade bonus item in a random, unobstructed location on the game board at the start of each match.	Complete
3.1.6	The system shall place a boots upgrade bonus item in a random, unobstructed location on the game board at the start of each match.	Complete
3.2.1	When a unit travels onto a space occupied by a coin, the system shall add one coin to that unit's team's budget.	Complete
3.2.2	When a unit travels onto a space occupied by a token, the system shall draw one random token from the team's token source and add it to the team's inventory.	Complete
3.2.3	When a unit travels onto a space occupied by a snack, the system shall add one point to the unit's health up to that unit's maximum.	Complete
3.2.4	When a unit travels onto a space occupied by a weapon upgrade, the system shall apply a free upgrade to that unit's weapon.	Complete
3.2.5	When a unit travels onto a space occupied by an armor upgrade, the system shall apply a free upgrade to that unit's armor.	Complete
3.2.6	When a unit travels onto a space occupied by a boots upgrade, the system shall apply a free upgrade to that unit's movement stats.	Complete
3.3	The system shall remove a bonus item from the board after its effect has been applied.	Complete
3.4	The system shall place one invisible hazard in a random, unobstructed location on the game board at the start of each match.	Complete
3.5	When a unit travels into the space occupied by the random hazard, the system shall deduct one hit point from the unit.	Complete
3.6	When a unit is damaged by a random hazard, the user interface shall display a notification to all players indicating which unit was damaged but not revealing which space contains the hazard.	Complete
3.7	While loading the data from a map file, the system shall recognize identifiers for destructible containers and instantiate them onto the board accordingly.	Complete
3.8	The attack validator shall recognize destructible containers as valid targets to be attacked.	Complete
3.9	When a container is attacked, it is removed from the board and replaced by a random bonus item: a coin, a token, a snack, a weapon upgrade, an armor upgrade, or a boot upgrade.	Complete

Milestone 3 in Progress

Nearly a week after starting Milestone 3, a good number of the requirements are either complete or well on their way.

What's my secret, you wonder?  First of all, Milestone 3 was the simplest milestone by design. I did that on purpose just in case the monstrous Milestone 2 overflowed its bounds...which it did.  And second, I went out of town last weekend to a place with no internet access, so I couldn't work on my job duties.  That meant that the only productive thing I could do was work on TLC, so I hit it hard and fast!

In summary, there are 19 individual requirements in all, of which:

• 11 are completely finished
• 5 have been implemented but not yet tested
• 3 have not yet been started

Milestone 3: The Game World Environment
Requirement ID	Description	Status
3.1.1	The system shall place a coin bonus item in a random, unobstructed location on the game board at the start of each match.	Complete
3.1.2	The system shall place a token bonus item in a random, unobstructed location on the game board at the start of each match.	Complete
3.1.3	The system shall place a snack bonus item in a random, unobstructed location on the game board at the start of each match.	Complete
3.1.4	The system shall place a weapon upgrade bonus item in a random, unobstructed location on the game board at the start of each match.	Complete
3.1.5	The system shall place an armor upgrade bonus item in a random, unobstructed location on the game board at the start of each match.	Complete
3.1.6	The system shall place a boots upgrade bonus item in a random, unobstructed location on the game board at the start of each match.	Complete
3.2.1	When a unit travels onto a space occupied by a coin, the system shall add one coin to that unit's team's budget.	Untested
3.2.2	When a unit travels onto a space occupied by a token, the system shall draw one random token from the team's token source and add it to the team's inventory.	Complete
3.2.3	When a unit travels onto a space occupied by a snack, the system shall add one point to the unit's health up to that unit's maximum.	Untested
3.2.4	When a unit travels onto a space occupied by a weapon upgrade, the system shall apply a free upgrade to that unit's weapon.	Untested
3.2.5	When a unit travels onto a space occupied by an armor upgrade, the system shall apply a free upgrade to that unit's armor.	Untested
3.2.6	When a unit travels onto a space occupied by a boots upgrade, the system shall apply a free upgrade to that unit's movement stats.	Untested
3.3	The system shall remove a bonus item from the board after its effect has been applied.	Complete
3.4	The system shall place one invisible hazard in a random, unobstructed location on the game board at the start of each match.	Complete
3.5	When a unit travels into the space occupied by the random hazard, the system shall deduct one hit point from the unit.	Complete
3.6	When a unit is damaged by a random hazard, the user interface shall display a notification to all players indicating which unit was damaged but not revealing which space contains the hazard.	Complete
3.7	While loading the data from a map file, the system shall recognize identifiers for destructible containers and instantiate them onto the board accordingly.	Not started
3.8	The attack validator shall recognize destructible containers as valid targets to be attacked.	Not started
3.9	When a container is attacked, it is removed from the board and replaced by a random bonus item: a coin, a token, a snack, a weapon upgrade, an armor upgrade, or a boot upgrade.	Not started

Milestone 3, Here I Come

Bad news about Milestone 2. Apparently, in order to correct the defects listed in the last post, I will have to redesign the combat evaluator to separate more of the functionality into different methods for handling the more specialized Power Tokens. Since the project is already behind schedule, what can I do about this?

Nothing, I'm afraid. My current strategy is to document the defects in the Milestone 2 requirements and move on to Milestone 3. I will return to the combat evaluator at the end of the capstone phase if there is time. Otherwise, the capstone version of TLC will simply be known to be defective, and these defects will be corrected post-graduation.

So I'm turning my attention to Milestone 3 now, which is defined as follows:

Milestone 3: The Game World Environment
Requirement ID	Description	Dependencies
3.1.1	The system shall place a coin bonus item in a random, unobstructed location on the game board at the start of each match.	None.
3.1.2	The system shall place a token bonus item in a random, unobstructed location on the game board at the start of each match.	None.
3.1.3	The system shall place a snack bonus item in a random, unobstructed location on the game board at the start of each match.	None.
3.1.4	The system shall place a weapon upgrade bonus item in a random, unobstructed location on the game board at the start of each match.	None.
3.1.5	The system shall place an armor upgrade bonus item in a random, unobstructed location on the game board at the start of each match.	None.
3.1.6	The system shall place a boots upgrade bonus item in a random, unobstructed location on the game board at the start of each match.	None.
3.2.1	When a unit travels onto a space occupied by a coin, the system shall add one coin to that unit's team's budget.	3.1.1
3.2.2	When a unit travels onto a space occupied by a token, the system shall draw one random token from the team's token source and add it to the team's inventory.	3.1.2
3.2.3	When a unit travels onto a space occupied by a snack, the system shall add one point to the unit's health up to that unit's maximum.	3.1.3
3.2.4	When a unit travels onto a space occupied by a weapon upgrade, the system shall apply a free upgrade to that unit's weapon.	3.1.4
3.2.5	When a unit travels onto a space occupied by an armor upgrade, the system shall apply a free upgrade to that unit's armor.	3.1.5
3.2.6	When a unit travels onto a space occupied by a boots upgrade, the system shall apply a free upgrade to that unit's movement stats.	3.1.6
3.3	The system shall remove a bonus item from the board after its effect has been applied.	3.2
3.4	The system shall place one invisible hazard in a random, unobstructed location on the game board at the start of each match.	None.
3.5	When a unit travels into the space occupied by the random hazard, the system shall deduct one hit point from the unit.	3.2
3.6	When a unit is damaged by a random hazard, the user interface shall display a notification to all players indicating which unit was damaged but not revealing which space contains the hazard.	3.5
3.7	While loading the data from a map file, the system shall recognize identifiers for destructible containers and instantiate them onto the board accordingly.	None.
3.8	The attack validator shall recognize destructible containers as valid targets to be attacked.	1.1
3.9	When a container is attacked, it is removed from the board and replaced by a random bonus item: a coin, a token, a snack, a weapon upgrade, an armor upgrade, or a boot upgrade.	3.1, 3.8

Milestone 2 Inches Forward

As another night comes to a close, Milestone 2 draws ever closer to completion.  Here's an updated view of the status of the requirements.

In summary:

• 13 complete
• 3 defective
• 2 inconclusive

Milestone 2: Combat Resolution
Requirement ID	Description	Status
2.1	When a unit is attacked, the system shall notify the player controlling the unit by presenting a Defend UI which allows selection of a defensive combat token from the player’s inventory.	Complete
2.2	The game server shall resolve combat interactions by evaluating the stats of the characters and their selected combat tokens and updating the data model accordingly.	Complete
2.2.1	The combat evaluator shall process Combat Tokens for their basic attack and defense values.	Complete
2.2.2	The combat evaluator shall process the Vampire Power Token | If the attack does damage, the attacker heals one hit point per unit of damage dealt.	Defective
2.2.3	The combat evaluator shall process the Lucky Shot Power Token | If the attack does damage, the damage amount is doubled.	Complete
2.2.4	The combat evaluator shall process the Desperation Power Token | The attack value is normally 4, but if the attacker is the only remaining member of the team, then the attack value is 10.	Complete
2.2.5	The combat evaluator shall process the Blaze of Glory Power Token | If the attack does damage, the damage amount is doubled, but if the attack is blocked, the attacker takes 5 points of damage.	Complete
2.2.6	The combat evaluator shall process the Reflection Power Token | Any attack, regardless of power, is reflected back at the attacker. The defender takes no damage.	Defective
2.2.7	The combat evaluator shall process the Resolve Power Token | Defense value goes up as the character health goes down. DF = maxHP - currentHP	Inconclusive
2.2.8	The combat evaluator shall process the Lucky Break Power Token | If the attack is blocked, any excess defense points are converted to health points for your unit.	Inconclusive
2.2.9	The combat evaluator shall process the Shatter and Scatter Power Token | If the attack is blocked, each member of the attacking team takes two points of damage.	Defective
2.2.10	The combat evaluator shall process Grenade Tokens | The attack functions like a Combat Token but cannot be blocked, has no defense value, and does two points of damage to all characters or containers within a two-meter radius of the primary target.	Complete
2.3	The game server shall broadcast a summary of combat results to all connected players.	Complete
2.4	The system shall provide a Combat Results toggle that allows players to opt out of seeing the detailed combat summaries at the conclusion of each combat interaction.	Complete
2.5	The user interface shall display a combat summary screen when combat results are received from the game server IFF the Combat Results option is turned on.	Complete
2.6	The system shall provide an Auto Defense option that players may activate if they would rather have the game select their tokens for them automatically when their units are attacked.	Complete
2.7	The system shall display an event log on the HUD which records the actions taken by all units in the game.	Complete
2.8	AI players shall be able to defend against attacks subject to the same rules as the human players.	Complete

Milestone 2: A New Hope

I'm feeling better about things now. The project is recovering, though it's still at risk because the Milestone 2 effort has consumed about one-third of the Milestone 3 budget so far, with more to come.  My goal for the remainder of this week is to finish testing all of the Power Tokens, fix the Auto Defense and Combat Results toggles, and correct any other issues discovered in the meantime.

If I cannot get all of Milestone 2 accomplished by the end of the week, I'm going to shelve it temporarily and move on to Milestone 3.  I figure that it's better to have all three milestones mostly complete than to have one that's entirely absent.

Below is an updated status of the Milestone 2 requirements as they stand right now. In summary, here are the stats:

• All 18 requirements of Milestone 2 have been verified.
• 11 requirements have been validated successfully.
• 3 requirements had inconclusive test results.
• 4 requirements are defective.

Milestone 2: Combat Resolution
Requirement ID	Description	Status
2.1	When a unit is attacked, the system shall notify the player controlling the unit by presenting a Defend UI which allows selection of a defensive combat token from the player’s inventory.	Complete
2.2	The game server shall resolve combat interactions by evaluating the stats of the characters and their selected combat tokens and updating the data model accordingly.	Complete
2.2.1	The combat evaluator shall process Combat Tokens for their basic attack and defense values.	Complete
2.2.2	The combat evaluator shall process the Vampire Power Token | If the attack does damage, the attacker heals one hit point per unit of damage dealt.	Inconclusive
2.2.3	The combat evaluator shall process the Lucky Shot Power Token | If the attack does damage, the damage amount is doubled.	Complete
2.2.4	The combat evaluator shall process the Desperation Power Token | The attack value is normally 4, but if the attacker is the only remaining member of the team, then the attack value is 10.	Complete
2.2.5	The combat evaluator shall process the Blaze of Glory Power Token | If the attack does damage, the damage amount is doubled, but if the attack is blocked, the attacker takes 5 points of damage.	Complete
2.2.6	The combat evaluator shall process the Reflection Power Token | Any attack, regardless of power, is reflected back at the attacker. The defender takes no damage.	Defective
2.2.7	The combat evaluator shall process the Resolve Power Token | Defense value goes up as the character health goes down. DF = maxHP - currentHP	Inconclusive
2.2.8	The combat evaluator shall process the Lucky Break Power Token | If the attack is blocked, any excess defense points are converted to health points for your unit.	Inconclusive
2.2.9	The combat evaluator shall process the Shatter and Scatter Power Token | If the attack is blocked, each member of the attacking team takes two points of damage.	Defective
2.2.10	The combat evaluator shall process Grenade Tokens | The attack functions like a Combat Token but cannot be blocked, has no defense value, and does two points of damage to all characters or containers within a two-meter radius of the primary target.	Complete
2.3	The game server shall broadcast a summary of combat results to all connected players.	Complete
2.4	The system shall provide a Combat Results toggle that allows players to opt out of seeing the detailed combat summaries at the conclusion of each combat interaction.	Defective
2.5	The user interface shall display a combat summary screen when combat results are received from the game server IFF the Combat Results option is turned on.	Complete
2.6	The system shall provide an Auto Defense option that players may activate if they would rather have the game select their tokens for them automatically when their units are attacked.	Defective
2.7	The system shall display an event log on the HUD which records the actions taken by all units in the game.	Complete
2.8	AI players shall be able to defend against attacks subject to the same rules as the human players.	Complete

It just occurred to me as I was updating the requirements status list that the inconclusive Power Token tests all involve a specialized modification or referencing of a unit's health in a way that is beyond the basic processing of a combat interaction. I wonder if that's a coincidence or if there's a common root cause of a defect. More testing will happen ASAP to find out.

Combat Results Screen

I'm trying hard to catch up to the project timeline, and though I'm making some decent progress, I'm not there yet.  Tonight I implemented the Combat Summary screen, though it's not 100% finished yet.

Specifically, the things that are not finished are:

• The "Close" and "Don't Show Again" buttons are still missing.
• The Power Token descriptions are not yet being populated.
• The Combat Results toggle is currently being ignored.

Once these things are finished, then Requirements 2.3, 2.4, and 2.5 will be complete.  Aside from these, the screen is working beautifully! Here are two examples:

Timeline Threatened!

I have no more time today to work on TLC. I must stop and get back to my job.  I made some progress and did some testing, but the milestone has not yet been reached.

This unavoidably impacts the timeline by eating into the Milestone 3 budget.  My only hope is to get through my work as quickly as I can this week so I can spend as much time as possible on the completion of Milestone 2...and, of course, the subsequent start on Milestone 3.

Here's a status report of all Milestone 2 requirements as I'm leaving them today.

Milestone 2: Combat Resolution
Requirement ID	Description	Status
2.1	When a unit is attacked, the system shall notify the player controlling the unit by presenting a Defend UI which allows selection of a defensive combat token from the player’s inventory.	Complete
2.2	The game server shall resolve combat interactions by evaluating the stats of the characters and their selected combat tokens and updating the data model accordingly.	Complete
2.2.1	The combat evaluator shall process Combat Tokens for their basic attack and defense values.	Complete
2.2.2	The combat evaluator shall process the Vampire Power Token | If the attack does damage, the attacker heals one hit point per unit of damage dealt.	Test inconclusive
2.2.3	The combat evaluator shall process the Lucky Shot Power Token | If the attack does damage, the damage amount is doubled.	Complete
2.2.4	The combat evaluator shall process the Desperation Power Token | The attack value is normally 4, but if the attacker is the only remaining member of the team, then the attack value is 10.	Untested
2.2.5	The combat evaluator shall process the Blaze of Glory Power Token | If the attack does damage, the damage amount is doubled, but if the attack is blocked, the attacker takes 5 points of damage.	Complete
2.2.6	The combat evaluator shall process the Reflection Power Token | Any attack, regardless of power, is reflected back at the attacker. The defender takes no damage.	Test inconclusive
2.2.7	The combat evaluator shall process the Resolve Power Token | Defense value goes up as the character health goes down. DF = maxHP - currentHP	Complete
2.2.8	The combat evaluator shall process the Lucky Break Power Token | If the attack is blocked, any excess defense points are converted to health points for your unit.	Test inconclusive
2.2.9	The combat evaluator shall process the Shatter and Scatter Power Token | If the attack is blocked, each member of the attacking team takes two points of damage.	Test inconclusive
2.2.10	The combat evaluator shall process Grenade Tokens | The attack functions like a Combat Token but cannot be blocked, has no defense value, and does two points of damage to all characters or containers within a two-meter radius of the primary target.	Complete
2.3	The game server shall broadcast a summary of combat results to all connected players.	In progress
2.4	The system shall provide a Combat Results toggle that allows players to opt out of seeing the detailed combat summaries at the conclusion of each combat interaction.	In progress
2.5	The user interface shall display a combat summary screen when combat results are received from the game server IFF the Combat Results option is turned on.	Designed; not implemented
2.6	The system shall provide an Auto Defense option that players may activate if they would rather have the game select their tokens for them automatically when their units are attacked.	Test failed
2.7	The system shall display an event log on the HUD which records the actions taken by all units in the game.	Complete
2.8	AI players shall be able to defend against attacks subject to the same rules as the human players.	Complete

Milestone 2 Target is Today

My fears may be coming true. Today was the target completion date for Milestone 2 and I didn't quite make it. The day's not over, but I also have a considerable task list of things to do for my job today, so I'm going to work on Milestone 2 this afternoon and see how far I can get before switching over to work-related tasks this evening.  It was, in fact, my oppressive work load that has keep me from progressing on Team Laser Combat in these last two weeks, so I desperately need to catch up to the project timeline.

There was a huge breakthrough this morning, however.  I spent all day yesterday working on a series of horrible bugs that seemed invincible.  From the time I woke up until the time I went back to bed, it was nothing but troubleshooting (intermixed with taking care of my baby son, of course).  But this morning, I had an epiphany that included multiple solutions to multiple bugs.  I tried the ideas, and they worked on the first try!

Details will follow in the next official progress report, after I get a chance to try my hand at those last remaining requirements in Milestone 2.

Grenades Work!

I'm having a teeny tiny little celebration here because I now have proof that GRENADES WORK!

Look at the screen shot below.  The Blue Team was lucky enough to have a grenade in the troopers' inventory from the initial token draw before the match began.  The Pink Team had not yet moved, so all of their members were standing together in a group.  Trooper Lucien had a clear shot at them, so he launched a grenade over there and voila!  All Pink Team members took damage!

One attack by Trooper Lucien of the Blue Team damaged every member of the Pink Team. Grenades FTW!