PHPackages                             modulargaming/modulargaming - 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. modulargaming/modulargaming

AbandonedArchivedProject[Framework](/categories/framework)

modulargaming/modulargaming
===========================

Basic Modular Gaming application.

v1.1.1(11y ago)22478[22 issues](https://github.com/modulargaming/modulargaming/issues)[9 PRs](https://github.com/modulargaming/modulargaming/pulls)BSD-3-ClausePHPPHP >=5.3.3

Since Apr 29Pushed 5y ago2 watchersCompare

[ Source](https://github.com/modulargaming/modulargaming)[ Packagist](https://packagist.org/packages/modulargaming/modulargaming)[ RSS](/packages/modulargaming-modulargaming/feed)WikiDiscussions master Synced 4w ago

READMEChangelog (1)Dependencies (36)Versions (17)Used By (0)

[Modular Gaming](http://www.modulargaming.com)
==============================================

[](#modular-gaming)

Modular Gaming is a open source [persistent browser based game](http://www.pbbg.org) framework built upon [Kohana 3.3](https://github.com/kohana/core) with modules such as [ORM](https://github.com/kohana/orm) and [KOstache](https://github.com/zombor/KOstache).

Released under a [BSD license](http://www.modulargaming.com/license), Modular Gaming can be used legally for any open source, commercial, or personal project.

Requirements
------------

[](#requirements)

- PHP 5.3.3+
- MySQL
- [Composer](http://getcomposer.org) (Dependency Manager)

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

[](#installation)

### Step 1: Download

[](#step-1-download)

Download Modular Gaming from Github and install composer dependencies.

```
    $ git clone https://github.com/modulargaming/modulargaming.git
    $ cd modulargaming

    $ curl -s https://getcomposer.org/installer | php
    $ php ./composer.phar install --dev

```

Alternatively you can also use composer create-project to download the project and the dependencies.

```
    $ composer create-project modulargaming/modulargaming modulargaming dev-master

```

If you cannot use Composer you can download a packaged copy of Modular Gaming from

### Step 2: File Permissions

[](#step-2-file-permissions)

```
$ chmod 0777 application/{cache,logs}
$ chmod 0777 assets
$ chmod 0777 media

```

### Step 3: Run the installer

[](#step-3-run-the-installer)

Open `.htaccess` and make the following changes:

- Set the correct RewriteBase

Start the installer and follow the instructions by browsing to the Modular Gaming install with your web browser.

- Once you have completed install, delete the install.php file.

### Step 4: Admin

[](#step-4-admin)

Register your admin account at /user/register. Promote your newly created account to admin by using the minion task:

```
$ php minion User:Promote --username=admin

```

You should now verify that you have admin access by accessing the administration panel at /admin/.

### Step 5: Cron jobs

[](#step-5-cron-jobs)

```
$ php ./minion Pet:Decrease
$ php ./minion Item:Restock

```

### Step 6: Configuration of modulargaming

[](#step-6-configuration-of-modulargaming)

Open `.htaccess` and make the following changes:

- Set the correct environment, either development or production.

Open `application/bootstrap.php` and make the following changes:

- Set the default directory for your application if it does not automatically work
- Set the default cookie salt
- Set the default [timezone](http://php.net/timezones) for your application

Open `application/config/auth.php` and make the following changes:

- Set the default hash key

Open `application/config/email.php` and make the following changes:

- Set the default from address

Testing
-------

[](#testing)

We use BDD, with 2 different tools, phpspec and behat.

```
$ curl -s https://getcomposer.org/installer | php
$ ./composer.phar install --dev

```

Documentation
-------------

[](#documentation)

The userguide module included in all Modular Gaming releases also allows you to view the documentation locally. It is accessible from your site via `/guide`

Reporting bugs
--------------

[](#reporting-bugs)

If you've stumbled across a bug, please help us out by [reporting the bug](https://github.com/modulargaming/modulargaming/issues?state=open) you have found. Simply log in or register and submit a new issue, leaving as much information about the bug as possible, e.g.

- Steps to reproduce
- Expected result
- Actual result

This will help us to fix the bug as quickly as possible, and if you'd like to fix it yourself feel free to fork us on GitHub and submit a pull request!

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

[](#contributing)

Contributions are encouraged and welcome; however, please review the Developer Certificate of Origin in the LICENSE.md file included in the repository. All commits must be signed off using the -s switch.

###  Health Score

27

—

LowBetter than 47% of packages

Maintenance0

Infrequent updates — may be unmaintained

Popularity19

Limited adoption so far

Community13

Small or concentrated contributor base

Maturity66

Established project with proven stability

 Bus Factor1

Top contributor holds 81.4% 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 ~92 days

Total

5

Last Release

4350d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/11527?v=4)[Modular Gaming](/maintainers/modulargaming)[@modulargaming](https://github.com/modulargaming)

---

Top Contributors

[![Hinton](https://avatars.githubusercontent.com/u/137855?v=4)](https://github.com/Hinton "Hinton (506 commits)")[![Lewis](https://avatars.githubusercontent.com/u/179250?v=4)](https://github.com/Lewis "Lewis (116 commits)")

###  Code Quality

TestsBehat

Code StylePHP\_CodeSniffer

### Embed Badge

![Health badge](/badges/modulargaming-modulargaming/health.svg)

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

###  Alternatives

[silverstripe/framework

The SilverStripe framework

7223.7M2.7k](/packages/silverstripe-framework)[prestashop/prestashop

PrestaShop is an Open Source e-commerce platform, committed to providing the best shopping cart experience for both merchants and customers.

9.1k16.8k](/packages/prestashop-prestashop)[october/rain

October Rain Library

1581.7M73](/packages/october-rain)[helsingborg-stad/municipio

A bootstrap theme for creating municipality sites.

4028.3k10](/packages/helsingborg-stad-municipio)[drupal/recommended-project

Project template for Drupal projects with a relocated document root

1492.8M1](/packages/drupal-recommended-project)[elgg/elgg

Elgg is an award-winning social networking engine, delivering the building blocks that enable businesses, schools, universities and associations to create their own fully-featured social networks and applications.

1.7k16.2k47](/packages/elgg-elgg)

PHPackages © 2026

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