Skip to content

Component Authoring Guide

Oge Nnadi edited this page Jun 7, 2017 · 5 revisions

Component Authoring Guide

Contained within will be some tips and tricks as well as solutions for common "gotchas" that might afflict the inexperienced Artisan.

Your First Component

Component Setup

  1. Under the Hero Placeholder, go to programming.Programmable and add the method name under programmableProperties
  2. Go to the Components Tab
  3. Under the inventory.Item component (in the list) add the name of the method to the plannableMethods array
  4. Under the programming.Plans component (also in the list,) add the name of the method to the plannableMethods array, too
  5. Select any component. Select the arrow of the smaller box and choose 'Create New Component'
  6. Assign it to a system and give it a name.
  7. Go back to the Thangs Tab and add this component to the Hero Placeholder
  8. Test run the level and try using the method! (The hero should attack themselves, as that is the default code)

Making it an action

  1. Go to the combat.Bashes component, copy paste everything, and put it in your new component commented out (surround it by ### ### which is like /* */ in JS)
  2. Observe the 'attach', and 'bash' methods.

General Tips


The following is a broad overview of what occurs under the hood:


World Base Class
The world contains a set of Systems, Thangs and their Components.


System Base Class
Systems are a set of actions that are performed on applicable Thangs.

  • The Collision System ensures collision objects don't overlap.
  • The AI System controls the logic for the NPCs, such as Yaks or Ogres.


Thang Base Class
Thangs are individual entities which contain Components.

  • An Arrow is a Thang.
  • An Ogre is a Thang.


Component Base Class Components are parts which sum to make an entire Thang.

  • A common Peasant is made up of the following:
  • Acts
  • FindsPaths
  • Allied
  • Sees


Describe how to efficiently make a spell here.


Describe how to make an ability.


Casting Spells

  • Enemies consist of very rudimentary intelligence. Spell-based enemies (such as Shaman,) employ the component 'ai.AutoCasts' for their spell repertoire, which automatically cycles through all their available spells and attempts to cast them if they are off cooldown.
  • Note that the actual logic (who they are casting on, when to cast,) is locked in the individual function defined inside the spell.


  • If your Thang spawns another Thang (such as shooting or summoning,) you must include a "requiredThangTypes" in the config schema, as this preloads the assets required.
  • If spawning in a location, be sure to check to see if the position to spawn is actually 'clear' of obstacles.

Common Gotchas

  • When creating a programmable action (such as bash or summon,) it needs to be added to the programming.Plans PlannableMethods array.
Clone this wiki locally
You can’t perform that action at this time.