# @reldens/items-system

> Reldens - Items System

Latest version **0.53.0** (published 2026-09-07) · MIT license · 0 weekly downloads

## Install

```sh
npm install @reldens/items-system
pnpm add @reldens/items-system
yarn add @reldens/items-system
bun add @reldens/items-system
```

## Health

**Score 55/100 (C)** — status: active.

Positive: no vulnerabilities; recently updated; high maintenance score.

Warnings: low downloads; no types; no esm support; pre 1.0.

## Facts

| | |
|---|---|
| Version | 0.53.0 |
| Published | 2026-09-07 |
| First published | 2020-05-08 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 2 |
| Unpacked size | 230.8 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 9 |
| Author | Damian A. Pastorini |
| Maintainers | dpastorini |
| Keywords | reldens, items, system, item, shop, trade, exchange, game, mmorpg, rpg, dwd, colyseus, phaser, parcel, nodejs, mmo, multiplayer, rol, platform, framework |

## Links

- npm: https://www.npmjs.com/package/@reldens/items-system
- Repository: https://github.com/damian-pastorini/reldens-items
- Issues: https://github.com/damian-pastorini/reldens-items/issues
- npm.io page: https://npm.io/package/@reldens/items-system

## Dependencies (2)

- [@reldens/utils](https://npm.io/package/@reldens/utils.md) ^0.58.0
- [@reldens/modifiers](https://npm.io/package/@reldens/modifiers.md) ^0.38.0

## Alternatives

- [raw-loader](https://npm.io/package/raw-loader.md) — 4.3M weekly downloads
- [plop](https://npm.io/package/plop.md) — 1.4M weekly downloads
- [webpack-deadcode-plugin](https://npm.io/package/webpack-deadcode-plugin.md) — 80.3K weekly downloads
- [@storybook/preact-vite](https://npm.io/package/@storybook/preact-vite.md) — 54.2K weekly downloads
- [vite-plugin-transform](https://npm.io/package/vite-plugin-transform.md) — 2.4K weekly downloads

## Recent versions

- 0.53.0 (latest) — 2026-09-07
- 0.19.0 (beta) — 2023-06-15
- 0.52.0 — 2026-06-22
- 0.51.0 — 2026-04-22
- 0.50.0 — 2026-03-10
- 0.49.0 — 2026-02-11
- 0.48.0 — 2025-12-29
- 0.47.0 — 2025-12-21
- 0.46.0 — 2025-12-20
- 0.45.0 — 2025-11-20
- 0.44.0 — 2025-10-22
- 0.43.0 — 2025-10-08
- 0.42.0 — 2025-09-17
- 0.41.0 — 2025-09-03
- 0.40.0 — 2025-08-29
- … 127 more at https://npm.io/package/@reldens/items-system/versions

## README

[![Reldens - GitHub - Release](https://www.dwdeveloper.com/media/reldens/reldens-mmorpg-platform.png)](https://github.com/damian-pastorini/reldens)

# Reldens - Items System

## About

**@reldens/items-system** is the items and inventory management system for Reldens. This package provides a comprehensive set of features for managing items, inventories, equipment, and item exchanges in game environments.

### Core Features

**Item Management:**
- Create and manage different item types (weapons, armor, consumables, quest items, etc.)
- Item modifiers and stats system
- Item properties (durability, quantity, requirements)
- Trade and sell values

**Inventory System:**
- Player inventory management
- Item storage and retrieval
- Inventory limits and organization
- Add / set / remove items
- Item quantity management
- Item groups with customizable limits

**Equipment System:**
- Equip/unequip items functionality
- Equipment validation
- Stat calculations with equipped items
- Multiple equipment slots support

**Item Types:**
- **ItemBase**: Base item class with core properties
- **ItemEquipment**: Items that can be equipped to provide stat bonuses
- **ItemUsable**: Consumable items with usage limits that apply modifiers
- **ItemSingle**: Single instance items (non-stackable)
- **ItemSingleEquipment**: Single instance equippable items
- **ItemSingleUsable**: Single instance usable items

**Exchange System:**
- Item trading between inventories
- Shop/merchant system
- Exchange requirements and validation
- Exchange rewards processing
- Requirements and rewards collections

**Advanced Features:**
- Event-driven architecture for inventory actions
- Client/server architecture with receiver and sender components
- Modifiers system (using @reldens/modifiers) for item effects
- Server authoritative validation
- Database-driven configuration
- Extensible architecture for custom item types

## Installation

```bash
npm install @reldens/items-system
```

## Usage

```javascript
const {
    ItemsManager,
    Inventory,
    ItemGroup,
    ItemBase,
    ItemEquipment,
    ItemUsable,
    ExchangePlatform
} = require('@reldens/items-system');

// Create an inventory
const inventory = new Inventory();

// Create items
const item = new ItemBase({ id: 1, key: 'potion', qty: 5 });

// Add items to inventory
inventory.addItem(item);

// Create item groups with limits
const weaponsGroup = new ItemGroup({ id: 1, key: 'weapons', limit: 10 });

// Use exchange platform for trading
const exchange = new ExchangePlatform();
```

## API

### Main Exports

- **ItemsServer**: Server-side items management
- **ItemsManager**: Core item management system
- **Inventory**: Inventory management
- **ItemGroup**: Item grouping and organization
- **ItemBase**: Base item class
- **ItemEquipment**: Equippable items
- **ItemUsable**: Usable/consumable items
- **ItemSingle**: Single instance items
- **ItemSingleEquipment**: Single instance equippable items
- **ItemSingleUsable**: Single instance usable items
- **ExchangePlatform**: Trading and exchange system
- **Receiver**: Client-side receiver for item updates
- **ItemsConst**: Constants used throughout the system
- **ItemsEvents**: Event types for item system
- **ItemsError**: Error handling

## Testing

```bash
npm test
```

---

Need something specific?

[Request a feature here: https://www.reldens.com/features-request](https://www.reldens.com/features-request)

## Documentation

[https://www.reldens.com/documentation/items-system](https://www.reldens.com/documentation/items-system)

---

### [Reldens](https://github.com/damian-pastorini/reldens/ "Reldens")

##### [By DwDeveloper](https://www.dwdeveloper.com/ "DwDeveloper")

---
_Source: https://npm.io/package/@reldens/items-system · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._