paweljarosz / crit

Battle-tested collection of un-opinionated modules for Defold games

Crit - Building blocks for Defold games

A battle-tested collection of un-opinionated modules we use at Critique Gaming to make games with Defold.

The modules are self-contained and depend on each other as little as possible, each designed to solve one specific problem. Use as much or as little as you need.

Links:

• GitHub repo
• Documentation
• Starter project

Modules

• UI
  • Buttons
  • Tooltips
  • Responsive layout
  • Drag and drop
  • Scroll views
  • Scroll bars
  • Sprite picking
  • Panning inertia
• Architecture
  • The message dispatcher
  • Coroutine progression system
  • Observables
• Input
  • Keyboard/gamepad focus
  • Keyboard/gamepad focus state
  • Analog to digital thumb stick conversion
  • Mouse cursor hiding manager
  • Screen corner hotspots
  • Cheatcodes
• Internationalisation
• Utilities
  • Color manipulation utilities
  • Table manipulation utilities
  • Function utilities
  • Low-pass and high-pass filters
  • The environment file
  • System configuration constants
  • Switch between script contexts
• Editor scripts
  • Layers from fonts

Examples

You can find usage examples in this repo. Alternatively, if you need a ready-to-go starter project based on Crit and Monarch, check out crit-boilerplate.

Default input map

These modules make little assumptions about your environment, but come with a few sensible defaults. You can configure each module to use different action IDs for its input, but the default input map is the following:

Input	Action ID
MOUSE_BUTTON_1	touch
MOUSE_WHEEL_UP	wheel_up
MOUSE_WHEEL_DOWN	wheel_down
KEY_UP	key_up
KEY_DOWN	key_down
KEY_LEFT	key_left
KEY_RIGHT	key_right
KEY_ENTER	key_enter
KEY_SPACE	key_space
GAMEPAD_LPAD_LEFT	gamepad_lpad_left
GAMEPAD_LPAD_RIGHT	gamepad_lpad_right
GAMEPAD_LPAD_UP	gamepad_lpad_up
GAMEPAD_LPAD_DOWN	gamepad_lpad_down
GAMEPAD_RPAD_LEFT	gamepad_rpad_left
GAMEPAD_RPAD_RIGHT	gamepad_rpad_right
GAMEPAD_RPAD_UP	gamepad_rpad_up
GAMEPAD_RPAD_DOWN	gamepad_rpad_down
GAMEPAD_START	gamepad_start
GAMEPAD_BACK	gamepad_back
GAMEPAD_GUIDE	gamepad_guide
GAMEPAD_RSHOULDER	gamepad_rshoulder
GAMEPAD_LSHOULDER	gamepad_lshoulder
GAMEPAD_LTRIGGER	gamepad_ltrigger
GAMEPAD_RTRIGGER	gamepad_rtrigger
GAMEPAD_LSTICK_LEFT	gamepad_lstick_left
GAMEPAD_LSTICK_RIGHT	gamepad_lstick_right
GAMEPAD_LSTICK_UP	gamepad_lstick_up
GAMEPAD_LSTICK_DOWN	gamepad_lstick_down
GAMEPAD_RSTICK_LEFT	gamepad_rstick_left
GAMEPAD_RSTICK_RIGHT	gamepad_rstick_right
GAMEPAD_RSTICK_UP	gamepad_rstick_up
GAMEPAD_RSTICK_DOWN	gamepad_rstick_down
GAMEPAD_LSTICK_CLICK	gamepad_lstick_click
GAMEPAD_RSTICK_CLICK	gamepad_rstick_click

Synthetic digital thumbstick actions:

Input	Digital action ID
GAMEPAD_LSTICK_LEFT	gamepad_lstick_digital_left
GAMEPAD_LSTICK_RIGHT	gamepad_lstick_digital_right
GAMEPAD_LSTICK_UP	gamepad_lstick_digital_up
GAMEPAD_LSTICK_DOWN	gamepad_lstick_digital_down
GAMEPAD_RSTICK_LEFT	gamepad_rstick_digital_left
GAMEPAD_RSTICK_RIGHT	gamepad_rstick_digital_right
GAMEPAD_RSTICK_UP	gamepad_rstick_digital_up
GAMEPAD_RSTICK_DOWN	gamepad_rstick_digital_down