Category Archives: Clockwork Empires

I’ve been volunteered to write a development post, so here I stand begrudgingly, not unlike bauxite which eternally begrudges its treasure: sweet aluminum that bright and tawdry metal it is. And me? I bear only concept art for the Meat Tree as a sort of consolation for a lack of thematic unity herein. But wait- there are unifying elements to what I’ve been doing the past week that aren’t immediately apparent from “implementing and improving a ton of random tiny things to make a better overall game experience” and “going slowly, thoroughly mad”. We’ll get to it. First, that meat tree:

Why does the vegan draw so much meat?

How does it grow? I’m not saying. What do you get if you cut it down? Meat, obviously.

Now that I’ve reeled you in on a highway littered with the sodden giblets of the Meat Tree’s broken promise, let’s make this post, as threatened, about the importance of animation timing or, more properly, all the complex moving parts that revolve around them. And if fit together just right they form something very much greater than the whole. Like Voltron.

Take the case of a soldier firing a musket at a menacing fishperson. (A shudder courses through my coffee-withered body; Komodo Edit flashes searing white light etched in courier new a record of torment.)

A soldier is a “citizen”* type gameobject. A fishperson is a “fishperson” type gameobject. Each will, if not otherwise occupied, query a global blackboard of jobs to find something appropriate to do based on a variety of conditions, then carry that job out. If hostilities exist between human and fishperson then one attacking each other is a valid job that each will attempt carry out (though only a citizen tagged “military” is allowed to execute attacks at this point). With the attack job acquired, a soldier will rush to grab a firearm if they’re not already carrying one, then will move until they’re in range of a target fishperson and open fire.

It’s good to have a sergeant that watches your back – Fishpeople are everywhere!

(* Every time the word “citizen” is mentioned I will put forward my argument that the people of the Clockwork Empires are more properly labeled subjects because, if we are being Historically Accurate about this (and we are), that although the topic concerns citizenship, British subjects became allowed to be referred to as  “Commonwealth citizens” only with the passage of the British Nationality Act of 1948. So by Jove, all this “citizen” talk sounds like the work of La République Mécanique agitators seeking to undermine the monarchy or, worse, Communist infiltrators carrying out the diktats of their Novyrusian masters!)

Let’s break down how the moment of firing works.

Every “job” a character can carry out is broken down into FSMs – finite state machines – which execute a series of operations in a given order. If you get shot while, say, attempting to chug a bottle of whisky, your job’s FSM sequence can execute an “abort” call which could (say) cause the bottle of whisky to be dropped. Here’s the FSM sequence for shooting a fishperson (or other malevolent eldritch entity):

1. <attack_ranged input=”entity” name=”run”/>

Yeah, that’s it. The attack_ranged FSM probably holds more logic than it needs inside of itself, everything for moving into range of a target, repositioning oneself if the target moves, and finally entering the firing sequence if both the subject and target are in the range that the firearm being held by the subject says it has.

Phew. Let’s look at the firing animation:

Don’t be alarmed by what appears to happen to the soldier running to the left with the splash of blood and all– this is from the same video the above shot was captured from, so that’s totally fish blood spraying all over.

The particles (by Mr. Triolo) and a lovely sound effect (by Mr. Steele) are attached to the appropriate frames of the animation (by Mr. Triolo) running on the NCO model (by Mr. Nejat). With all of that work done and packaged by all those guys, back on the scripting side of things we just have to concern ourselves with running the animation and triggering scripts at appropriate points. The sequence is essentially this:

1. Load & execute pistol firing animation on to character
2. Wait X gameticks until the point in the animation where the pistol has appeared to fire, then send the target a “damageMessage”.
3. When firing animation length in gameticks is hit, load & execute the default do-nothing animation and find a new “job”=

Anyhow, the next character job is probably going to be “shoot the fishperson” again unless the soldier’s morale breaks or they’re set on fire or something, so the system works pretty well. The timing and functioning at stage 2 is the tricky part – sending information to objects being interacted with. Aesthetically the value of X here is interesting because if it’s off by just a little, the entire interaction of each animated character, sound effects, and particles will intuitively feel wrong. So let’s get it right.

So that’s great and the timing is visceral and lovely, but how about that “damageMessage”? This is a collection of information that the FSM pulls from the character’s item about what type and amount of damage it does which is sent over to the receiver of the damage to decide how they’re going to take it. A Steam Knight for instance will shrug off most damage types and simply play a metallic “ping” sound. A fishperson, however, is soft and fleshy and will shoot out blood (triggered via a script command) and take injuries (via decrementing hitpoint integers and possibly adding special afflictions).

At that point, you say, shouldn’t we play a “get hurt” animation? Why yes! But this is where it gets more complex: We’re in a position where one game object is pushing animations, usually covered by the “job” system, onto another game object. What if the target of attack is in the middle of walking between tiles? What if they’re having a conversation? Everyone needs to know how to abort properly, what to do next, and figure out at what point they’re allowed to query their status to figure out what job they should be doing next. I’ve been considering the idea of animation interrupts detached from the job/FSM system, but anything inspired by one of the more confusing Magic: The Gathering mechanics is probably not a good idea. Maybe I’ll pass this to Nicholas to figure out. [Note: We know how to solve this and just had a big talk which ending up with all the partners agreeing that this was relevant to the discussion.]

I’ve got an icon for this.

(Related: we have a “Run Because I Am On Fire” job which becomes unbearably important to execute if you have the “on_fire” tag, but I talked about that already.)

In conclusion, there are lots of little pieces of art and code that need to fit very cleanly together to allow systems (ie. a character) and their meta-systems (ie. a workcrew), and their meta-meta-systems (ie. a colony) to execute in a technically smooth and aesthetically pleasing manner. They also need to interrupt each other in similarly pleasing manners when things go terribly wrong in your colony and characters rather impolitely interrupt one another.

This is where, as I’ll always insist, it gets complex.