eco2d/foundation.md

## Foundation:
 * platform
 * viewer system ??
 * camera
 * game
 * debug ui
 * packet utils
 * arch
 * input
 * profiler
 * renderer
 * signal handling
 * zpl options
 * gen/textgen -> assets
 * items
 * inventory
 * crafting
 * notifications
 * tooltips
 * chunk
 * blocks
 * tiles (and chunk baker)
 * systems (core systems)
 * components
 * net
 * packets (but add custom messaging, and security)
 * compression
 * world
 * wrold_view
 * entity_view


## Components
-------
* app - thing that runs game
* game - the game stuff, includes client and server
* packet - structure that has data written/read by client/server
* asset - structure that describes tile/block/object/entity, something that can be visualized
* module - a thing that uses a set of ecs components and systems to create a self-contained ecs module
------------
* world - a map of chunks within the game world
* world-view - a representation of the world recreated by the client
----------
* chunk - entity that contains set of tiles and blocks
* tile - basic thing that makes up the chunks
* block - 2nd level of things that make up the chunk
* entity - an grid-independant static or dynamic entity that can exist in the world and has some systems controlling it
    primary archetypes:
    * item - an entity in the world, that can have a different state when its picked up
    * object - an item that can be placed in the world
    * device - an object that can be interacted with
    * mob - an entity that can be controlled by ai
    * player - an entity that can be controlled by a player
    * vehicle - an entity that can be used to transport other entities
* craft - a recipe that can be used to craft an item


## Naming

* zpl.eco
    * foundation
    * sandbox
    * survival
* prefix: efd_

## Concepts
    * tile
    * block
    * entity
        * item
        * object
        * device
        * mob
        * player
        * vehicle
    * craft

## Transitions
* item -> tile (item destroyed, tile replaced)
* item -> block (item destroyed, block created)
* item -> entity (item hidden and untracked, entity component added) // item becomes entity, just changes state
* item -> item (crafting) (item destroyed, item created)
* tile -> item (tile replaced, item created)
* block -> item (block destroyed, item created)
* block -> block (crafting) (block destroyed, block created)
* entity -> item (entity component removed, item shown and tracked) // entity becomes item, just changes state

## Features
* In-memory lists
    * assets
    * items
    * crafting recepies
    * prafabs for entities (pipeline for entities)
* built in server->client RPC
* 



// // register game specific input bindings
// // pre-defined bindings and controlsets
// efd_controlset_apply(EFD_ACTION_MOVE, EFD_CONTROLSET_WASD | EFD_CONTROLSET_ARROWS | EFD_CONTROLSET_GAMEPAD_LEFT);
// efd_controlset_apply(EFD_ACTION_POINT, EFD_CONTROLSET_MOUSE | EFD_CONTROLSET_GAMEPAD_RIGHT);

// // custom bindings and controlsets
// efd_controlset_keyboard(CONTROLSET_ACCELERATE, EFD_KEY_DOWN, EFD_KEY_SHIFT_LEFT | EFD_KEY_SHIFT_RIGHT);
// efd_controlset_gamepad(CONTROLSET_ACCELERATE, EFD_GAMEPAD_LEFT_TRIGGER, 0.5f);
// efd_controlset_apply(EFD_ACTION_SPRINT, CONTROLSET_ACCERLATE);

// // custom input bindings for custom actions
// efd_controlset_register(ACTION_USE);
// efd_controlset_keyboard(CONTROLSET_USE, EFD_KEY_DOWN, EFD_KEY_E);
// efd_controlset_gamepad(CONTROLSET_USE, EFD_GAMEPAD_BUTTON_A, 0.5f);
// efd_controlset_apply(ACTION_USE, CONTROLSET_USE);