mistralys / cyberpunk-mod-db-php
PHP classes to work with the Cyberpunk 2077 DB.
Requires
- php: >=8.2
- brick/event: >=0.1.1
- loupe/loupe: >=0.7.0
- mistralys/application-utils-collections: >=1.1.2
- mistralys/application-utils-core: >=2.3.1
- mistralys/changelog-parser: >=1.0.2
- mistralys/cyberpunk-mod-db: >=2.0.10
Requires (Dev)
- phpstan/phpstan: >=1.12.3
- phpstan/phpstan-phpunit: >=1.4.0
- phpunit/phpunit: >=11.3.5
- roave/security-advisories: dev-latest
README
PHP Classes to access the Cyberpunk 2077 Clothing Mod DB.
Features
- Classes used to access the mod database
- Get mod information, including screenshot paths and URLs
- Filter mods by search terms and tags
- Constants for all known tags used in the mod DB
- Minimum configuration required
Requirements
- PHP 8.2 or higher
- Composer
- Webserver with PHP support
Installation
- Require the package using Composer
- Ensure that the
vendor
directory is accessible via the webserver.
composer require mistralys/cyberpunk-mod-db-php
NOTE: The database is included as a dependency, so there is no need to require it separately, unless you want a specific version to be installed.
Usage
Accessing mods
The mod collection class is the main entry point to the mod database. It provides methods to access all mods, as well as the filtering capabilities.
use CPMDB\Mods\Collection\ModCollection; // Create a collection instance $collection = ModCollection::create( __DIR__.'/vendor', // Absolute path to the composer vendor directory __DIR__.'/cache', // Path to a writable directory to store cache files 'http://127.0.0.1/your-app/vendor' // Absolute URL to the composer vendor directory ); // Get all mods $mods = $collection->getAll(); // Get only clothing mods $clothing = $collection->categoryClothing()->getAll(); // Get a mod by its UUID (unique identifier, category ID + mod ID) $catsuit = $collection->getByID('clothing.catsuit'); // Get the screenshot URL for a mod $images = $catsuit->getScreenshotCollection(); if($images->hasScreenshots()) { $default = $images->getDefault(); ?> <img src"<?php php echo $default->getURL() ?>" alt="<?php echo $default->getTitle() ?>"> <?php }
Accessing items
Each mod can contain multiple items, such as clothing items. While each mod has a collection of items, there is also a global item collection that contains all items from all mods.
use CPMDB\Mods\Collection\ModCollection; // Create a collection instance $collection = ModCollection::create( __DIR__.'/vendor', // Absolute path to the composer vendor directory __DIR__.'/cache', // Path to a writable directory to store cache files 'http://127.0.0.1/your-app/vendor' // Absolute URL to the composer vendor directory ); // Get the item collection $itemsCollection = $collection->getItemCollection(); // Get an item by its CET code $dress = $itemsCollection->getByID('nd_michiko_dress_black'); // Get the CET command to add the item in-game $dress->getCETCommand();
Searching for mods
Use the mod filter to search for specific mods by search terms and/or tags.
use CPMDB\Mods\Collection\ModCollection; use \CPMDB\Mods\Tags\Types\Outfit; // Create a collection instance $collection = ModCollection::create( __DIR__.'/vendor', // Absolute path to the composer vendor directory __DIR__.'/cache', // Path to a writable directory to store cache files 'http://127.0.0.1/your-app/vendor' // Absolute URL to the composer vendor directory ); // Search for "catsuit" and only get mods with the "Outfit" tag $mods = $collection->createFilter() ->selectSearchTerm('catsuit') ->selectTag(Outfit::TAG_NAME) ->getMods();
Searching for items
Use the item filter to search for specific items by search terms and/or tags.
use CPMDB\Mods\Collection\ModCollection; use CPMDB\Mods\Tags\Types\Jewelry; // Create a collection instance $collection = ModCollection::create( __DIR__.'/vendor', // Absolute path to the composer vendor directory __DIR__.'/cache', // Path to a writable directory to store cache files 'http://127.0.0.1/your-app/vendor' // Absolute URL to the composer vendor directory ); // Search for the Jewelry tag to get all jewelry mod items $mods = $collection->createItemFilter() ->selectTag(Jewelry::TAG_NAME) ->getItems(); // Use the item collection for helper methods like getting // items by their CET code $mods = $collection->createItemFilter() ->selectTag(Jewelry::TAG_NAME) ->getItemsAsCollection() ->getByItemCode('earrings_08_basic_04_kwek'); // Combine as many filter criteria as needed $mods = $collection->createItemFilter() ->selectSearchTerm('earrings') ->selectTag(Jewelry::TAG_NAME) ->selectTag(Physics::TAG_NAME) ->getItemsAsCollection();
NOTE: Items inherit their tags from the mod they belong to. Since a mod can have items that belong to different tags, searching for a specific tag may return unrelated items.
Tags
Tags are used to categorize mods, using simple strings defined in the mod files
(e.g. CET
for the Cyber Engine Tweaks mod). All known tags used in the mod DB
are included in the package.
Tags also have additional meta-data, such as a label and a category.
Tag name constants
Tags can be referenced in code using the matching tag classes, which all have a constant with the tag's name. This makes it easier to avoid typos.
$cetTag = \CPMDB\Mods\Tags\Types\CyberEngineTweaks::TAG_NAME; $clothingTag = \CPMDB\Mods\Tags\Types\Clothing::TAG_NAME;
Getting all known tags
All known tags are available via the TagCollection
class, which has methods
to access them.
use CPMDB\Mods\Tags\TagCollection; use CPMDB\Mods\Tags\Types\CyberEngineTweaks; $collection = TagCollection::getInstance(); // Get all tags $all = $collection->getAll(); // Get a specific tag $cet = $collection->getByID(CyberEngineTweaks::TAG_NAME); // Additional tag meta data echo 'Full label: '.$cet->getLabel(); echo 'Tag category: '.$cet->getCategory();
Caching
By default, the collection will cache the mod data in the specified cache directory. This is done for performance reasons, as the mod data is read from my individual files in the filesystem.
The cache is created and updated automatically following the version of the mod database.
Turning off caching
The caching can be turned off if needed:
use CPMDB\Mods\Collection\DataWriter\CacheDataWriter; CacheDataWriter::setCacheEnabled(false);
Performance tests
To check the performance of the caching on your system, you can run the performance tests:
php tests/performance/performance-test.php