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.
With npm
npm install @pmarp/creditor --globalIn 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.jsonSimply add appropriate manifest entries to your resource's fxmanifest.lua.
These entries will be read by the creditor and added to the credits.
-- 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'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.
# manifest.yaml
name: Idea & Concept
author: glitchdetector
description: Special thanks to glitchdetector.
repository: https://github.com/glitchdetector/fx-credits| 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' |
private |
Whether this resource is closed-source. | |
false |
'true' |
| 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 |
Special thanks to glitchdetector for the idea, concept and his original fx-credits.
