@sharpee/world-model

Entity system, traits, and behaviors for the Sharpee Interactive Fiction platform.

Installation

npm install @sharpee/world-model

Overview

The world model provides the foundation for game state:

• Entities - Rooms, objects, NPCs, and the player
• Traits - Composable properties (Openable, Lockable, Container, etc.)
• Behaviors - Reusable logic (LightSource, Wearable, Edible, etc.)
• State Management - Immutable world state with entity relationships

Usage

import {
  WorldModel,
  IFEntity,
  OpenableTrait,
  ContainerTrait
} from '@sharpee/world-model';

// Create entities with traits
const chest = world.createEntity('object', {
  id: 'treasure-chest',
  name: 'treasure chest',
  traits: [OpenableTrait, ContainerTrait]
});

// Query relationships
const contents = world.getContents(chest);
const location = world.getLocation(player);

Traits

Related Packages

• @sharpee/stdlib - Standard actions
• @sharpee/sharpee - Full platform bundle

License

MIT