PHPackages                             deivao06/merchant-cli - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Framework](/categories/framework)
4. /
5. deivao06/merchant-cli

ActiveProject[Framework](/categories/framework)

deivao06/merchant-cli
=====================

A CLI merchant game

v0.5.1(3mo ago)12MITPHPPHP ^8.2

Since Jan 27Pushed 3mo agoCompare

[ Source](https://github.com/deivao06/merchant-cli)[ Packagist](https://packagist.org/packages/deivao06/merchant-cli)[ Docs](https://github.com/deivao06/merchant-cli)[ RSS](/packages/deivao06-merchant-cli/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (2)Dependencies (4)Versions (4)Used By (0)

 [![merchant-cli-logo](docs/merchant-cli-logo.png)](docs/merchant-cli-logo.png)

 [![Total Downloads](https://camo.githubusercontent.com/67ba559fa38875a3a31bf623fa12150145d48b1198c9f843372502c528fea44a/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f64656976616f30362f6d65726368616e742d636c692e737667)](https://packagist.org/packages/deivao06/merchant-cli) [![Latest Stable Version](https://camo.githubusercontent.com/f80d122c146aa5514f00f0d35acc275d91e66bd040910fe025d4e577f638f3bf/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f64656976616f30362f6d65726368616e742d636c692e7376673f6c6162656c3d737461626c65)](https://packagist.org/packages/deivao06/merchant-cli) [![License](https://camo.githubusercontent.com/716ddecf1a7105680b37bae6b459859046b23b0ea89f6b2fe0653b41c6267cd6/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f64656976616f30362f6d65726368616e742d636c692e737667)](https://packagist.org/packages/deivao06/merchant-cli)

A command-line trading game where you play as a merchant, trading with other players on the same network to grow your city.

About the Game
--------------

[](#about-the-game)

Merchant CLI is a multiplayer game that runs in your terminal. The core gameplay revolves around trading resources with other players to acquire the materials needed to upgrade your city. Each player manages their own city, and the goal is to become the most prosperous merchant.

Features
--------

[](#features)

- **Multiplayer Trading:** Trade resources with other players on the same LAN (Coming Soon).
- **City Management:** Build and upgrade your city to increase your production and unlock new abilities.
- **Resources production:** All resources are produced per minute.
- **Biomes:** Random selected on city creation and directly affects resource production.
- **Resources:**
    - **Gold:** Universal currency used for trade.
    - **Food:** Keeps your population fed an is required for some upgrades.
    - **Wood:** Basic building material.
    - **Stone:** Used for strong structures and upgrades.
- **Buildings:**
    - **Farm:** Produces food.
    - **Sawmill:** Produces wood.
    - **Quarry:** Produces stone.

Installation
------------

[](#installation)

You can install the merchant-cli globally using Composer:

```
composer global require deivao06/merchant-cli
```

Alternatively, you can clone the repository and install dependencies:

1. Clone the repository: ```
    git clone https://github.com/your-username/merchant-cli.git
    ```
2. Install the dependencies: ```
    composer install
    ```
3. Run the game: ```
    php merchant-cli
    ```

How to Play
-----------

[](#how-to-play)

### Initialize a new game

[](#initialize-a-new-game)

To start a new game, run the `game:init` command. This will create a new game world and save file.

```
merchant-cli game:init
```

### Check your game status

[](#check-your-game-status)

To see the current status of your city, resources, and buildings, use the `game:status` command.

```
merchant-cli game:status
```

### Trading

[](#trading)

*(Coming soon)*

Development
-----------

[](#development)

This project is built with PHP and the Laravel Zero framework.

### Running tests

[](#running-tests)

To run the test suite, use the following command:

```
./vendor/bin/pest
```

Contributing
------------

[](#contributing)

Contributions are welcome! Please feel free to submit a pull request or open an issue. Before contributing, please read our development guide.

**[Development Guide](docs/DEVELOPMENT.md)** - Essential reading for contributors

#### Quick start for Contributors:

[](#quick-start-for-contributors)

1. Fork the project
2. Create your Feature Branch from `dev` (never from `master`)
3. Ensure all tests pass and add tests for new features
4. Commit your changes using conventional commit format
5. Push to the Branch
6. Open a Pull Request to the `dev` branch

**Important:** Never commit directly to the `master` branch. All changes must go through the `dev` branch first.

Authors
-------

[](#authors)

[@deivao06](https://github.com/deivao06)

###  Health Score

34

—

LowBetter than 77% of packages

Maintenance79

Regular maintenance activity

Popularity4

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity39

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~0 days

Total

2

Last Release

111d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/10aff3e9cf5af4ed871ca3a23b22394e315e8e0772b2261a75c90be7e3ca2468?d=identicon)[deivao06](/maintainers/deivao06)

---

Top Contributors

[![deivao06](https://avatars.githubusercontent.com/u/36829552?v=4)](https://github.com/deivao06 "deivao06 (27 commits)")

---

Tags

cligamelaravellaravel-frameworklaravel-zerolaravel-zero-frameworkphpcliconsoleframeworklaravellaravel-zerogame

###  Code Quality

TestsPest

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/deivao06-merchant-cli/health.svg)

```
[![Health](https://phpackages.com/badges/deivao06-merchant-cli/health.svg)](https://phpackages.com/packages/deivao06-merchant-cli)
```

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)