Skip to content

ConflictingTheories/calliope-pixos

Repository files navigation

PixoSpritz

A WebGL-based game engine and editor ecosystem for creating pixel-art games.

📦 Packages

This monorepo contains the following packages:

Package Description
pixospritz-core Core WebGL game engine
pixoscript Lua-inspired scripting language
pixospritz-math Math utilities (vectors, matrices)
pixospritz-editor Visual development tools
pixospritz-console Web game player
pixospritz-server WebSocket multiplayer server
pixospritz-website Documentation website
pixospritz-assets Shared game assets

🚀 Quick Start

Prerequisites

  • Node.js >= 18.0.0
  • npm >= 9.0.0

Installation

# Clone the repository
git clone https://github.com/ConflictingTheories/calliope-pixos.git
cd calliope-pixos

# Install all dependencies
npm install

Development

# Start the editor
npm run dev:editor

# Start the console player
npm run dev:console

# Start the multiplayer server
npm run start:server

Building

# Build all packages
npm run build

# Build individual packages
npm run build:core
npm run build:script
npm run build:editor
npm run build:console

🏗️ Project Structure

calliope-pixos/
├── packages/
│   ├── core/           # pixospritz-core - Game engine
│   ├── script/         # pixoscript - Scripting language
│   ├── math/           # pixospritz-math - Math utilities
│   ├── editor/         # pixospritz-editor - Development tools
│   ├── console/        # pixospritz-console - Game player
│   ├── server/         # pixospritz-server - Multiplayer server
│   ├── website/        # pixospritz-website - Documentation
│   └── assets/         # pixospritz-assets - Shared assets
├── package.json        # Root workspace configuration
└── README.md

🎮 Features

Core Engine

  • WebGL2 rendering with custom shaders
  • Sprite and tileset management
  • Isometric and 2D map support
  • Entity/Actor system with pathfinding
  • Event system (keyboard, mouse, touch, gamepad)
  • Audio engine with BPM analysis
  • Cutscene player with DSL

Editor

  • Sprite Editor with animation support
  • Tile Editor with collision data
  • Map Editor with multiple layers
  • Cutscene scripting tools
  • 3D model viewer (OBJ/MTL)
  • Monaco-based script editor

Scripting

  • Lua-compatible syntax
  • Game-specific extensions
  • Hot-reloading support

📝 License

CC-BY-NC-SA-4.0

🔗 Links

About

PixoSpritz - Virtual Game Console and Engine - Browser based WebGL 2.0 Game Engine that plays Pixospritz game packages.

Topics

Resources

License

Stars

1 star

Watchers

1 watching

Forks

Releases

No releases published

Sponsor this project

Packages

 
 
 

Contributors