PMARP Creditor

An easy to use command-line interface for building creditory information from resource manifests, with the added feature of custom manifest.yaml files that can be ignored by the fxserver.
You can see a preview here.

Installation

With npm

npm install @pmarp/creditor --global

Usage

In shell at the directory of your server's resources, search through all directories for fxmanifest.lua, __resource.lua and custom manifest.yaml files and output the result to a file credits.json.

creditor --output ./credits.json

Example

Fx Manifest

Simply add appropriate manifest entries to your resource's fxmanifest.lua.
These entries will be read by the creditor and added to the credits.

Example Preview

-- fxmanifest.lua
fx_version 'cerulean'
game 'gta5'

repository 'https://github.com/TFNRP/holster'
version '0.1.0'
author 'Reece Stokes <[email protected]>'
description 'Holster resource for FiveM'

Custom YAML

The creditor is not limited to just fxmanifest.luas and will also read any YAML file with the name manifest.yaml.
This allows you to place credit files in places that should not be registered by your fxserver.
A particular good use-case can be for resources containing multiple resources, and can be added to the resource's meta directory for crediting of individual files & folders.

Example
Preview

# manifest.yaml
name: Idea & Concept
author: glitchdetector
description: Special thanks to glitchdetector.
repository: https://github.com/glitchdetector/fx-credits

Manifest Entries

Entry | Description | Optional | Default | Example -- | -- | -- | :--: | -- id | This resource's name / id of this credit. | | Resource's name | 'mrpd' name | The name to display this credit as. | | id | 'Mission Row PD' contact | An email address to contact the author. This field will be autofilled if an email is supplied in author. | | nil | '[email protected]' author | The author's name. May also contain an email address encased in fat brackets. | | nil | 'Hagen Hyena <[email protected]>' version | The version of this software, if any. | | nil | '1.0.0' description | The description of this resource/credit. | | nil | 'This resource populates dynamic vehicles in ped traffic.' gta5mods | The resource's gta5-mods post. | | nil | 'https://www.gta5-mods.com/vehicles/brute-mr-tasty-gta-iv-style-add-on-liveries-template-sound-custom-shards' repository | The resource's GitHub or GitLab repository. | | nil | 'https://github.com/TFNRP/axonbody3' download | Miscellaneous download URL if no repository or gta5mods is available. | | nil | 'https://forum.cfx.re/t/release-modern-seatbelt/4779995'

Command-Line Arguments

Argument | Shorthand | Optional | Default | Description | Example -- | -- | -- | -- | -- | -- --output | -o | | | Where the output credits json file should go. | --output ./generated or --output ./credits.json --directory | -d | | Current directory | The directory to recursively scan for manifests. | --directory ./resources

Credits

Special thanks to glitchdetector for the idea, concept and his original fx-credits.