@pmarp/creditor

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 <[e-mail]>'
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	'[e-mail]'
author	The author's name. May also contain an email address encased in fat brackets.		nil	'Hagen Hyena <[e-mail]>'
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.