Automatic Packaging
Configuring the Repository Webhook
Generate a CurseForge API token
First, you’ll need to generate an API token. To do this, navigate to your API tokens page. From here, give the token a descriptive name such as "Webhooks." Once the token has been generated, move to Step 2 in order to configure the webhook on GitHub or Bitbucket.
Configuring the Repository Webhook on GitHub or Bitbucket
First, go to “Webhooks & Services” under settings for your repository and click the “Add Webhook“ button.
For the Payload URL, use the following value: https://wildstar.curseforge.com/api/projects/{projectID}/package?token={token}
Replace {projectID} with the ID from your project’s URL on CurseForge, and {token} with the token we just generated above.
Example: https://wildstar.curseforge.com/api/projects/204592/package?token=21ec57a7-7bc0-454f-ae80-627fb5722df1
Leave all other settings at their defaults.
Automatically Marking Your Files as Alpha, Beta, or Release
When packaging is triggered on your repository, the generated file’s release type will automatically be set based on two factors:
- If configured to package all commits, the latest untagged commit will be packaged and will be marked as an alpha.
- Otherwise, when a tagged commit is pushed, it will be flagged as either alpha, beta, or release depending on the tag itself:
- If the tag contains the word “alpha”, for example “1.0-alpha” or “1.0.alpha7”, it will be marked as an alpha file.
- If instead the tag contains the word “beta,” it will be marked as a beta file.
File Packaging Configuration
You can optionally configure the way your file is packaged by including a YAML file named "pkgmeta.yaml" in the root of your repository. Each of these behaviors are optional:
- Specify the name of the packaged file. If omitted, the packaged file will be named after the project's URL slug.
- Inclusion of libraries or code from other projects.
- Move files and folders.
- Ignore files and folders.
- Specify dependencies on other projects, if they are available on the site.
- Specify tools used in the development of your project, if they are available on the site.
- Override compilation of repository commit messages with a manually-written change log.
- Inclusion of the project license in the packaged file.
An example, with all of the options utilized:
package-as: KillerCupcakes
enable-nolib-creation: no
externals:
libs/LibDialog:
url: https://github.com/wildstarnasa/LibDialog.git
tag: latest # if this line is left out, the latest version (even if it's not a tag) is assumed
libs/GeminiAddon:
url: https://github.com/wildstarnasa/GeminiAddon.git
tag: 1337.0.10 # This is an example. Please use an actual tag if you are targeting a specific version.
move-folders:
KillerCupcakes/Modules/Fire: KillerCupcakesOnFire # This moves KillerCupcakes/Modules/Fire to the same level as KillerCupcakes, as KillerCupCakesOnFire
KillerCupcakes/Modules/Sky: KillerCupcakesInTheSky
ignore: # Files and directories beginning with a dot (such as .git) are automatically ignored, as is the pgkmeta file itself.
- Scripts
- Some/File.txt
required-dependencies:
- 221710-dear-cupcake
optional-dependencies:
- 220002-junkit
manual-changelog: CHANGELOG.txt
license-output: LICENSE.txt
tools-used:
- data-tools
Replacement Tokens
When repositories are packaged, certain keyword substitutions take place on text files.
Simple replacements
- @file-revision@
- @file-hash@
- The current revision/hash of the file. For example: 106c634df4b3dd4691bf24e148a23e9af35165ea
- @project-revision@
- @project-hash@
- The hash of the entire project in hex form. e.g.
106c634df4b3dd4691bf24e148a23e9af35165ea
- @file-abbreviated-hash@
- The abbreviated hash of the file in hex form. e.g.
106c63
- @project-abbreviated-hash@
- The abbreviated hash of the entire project in hex form. e.g.
106c63
- @file-author@
- The name of the last author of the file.
- @project-author@
- The name of the last author of the entire project.
- @file-date-iso@
- The last changed date (by UTC) of the file in ISO 8601. e.g.
2014-05-01T12:34:56Z
- @project-date-iso@
- The last changed date (by UTC) of the entire project in ISO 8601. e.g.
2014-05-01T12:34:56Z
- @file-date-integer@
- The last changed date (by UTC) of the file in a readable integer fashion. e.g.
20140501123456
- @project-date-integer@
- The last changed date (by UTC) of the entire project in a readable integer fashion. e.g.
2014050123456
- @file-timestamp@
- The last changed date (by UTC) of the file in POSIX timestamp. e.g.
1209663296
- @project-timestamp@
- Turns into the last changed date (by UTC) of the entire project in POSIX timestamp. e.g.
1209663296
- @project-version@
- An approximate version of the project. The tag name if on a tag, otherwise the short revision.
Debug replacements
These occur based on filetype, as they tend to tie into the comment system for the file.
The insides aren't removed so that line numbers stay the same, they just cause them to be commented out.
Lua
--@debug@
and --@end-debug@
- Turns into
--[===[@debug
and--@end-debug]===]
. --[===[@non-debug@
and--@end-non-debug@]===]
.- Turns into
--@non-debug@
and--@end-non-debug@
.
XML
<!--@debug@-->
and <!--@end-debug@-->
- Turns into
<!--@debug
and@end-debug@-->
. <!--@non-debug@
and@end-non-debug@-->
.- Turns into
<!--@non-debug@-->
and<!--@end-non-debug@-->
.
TOC
#@debug@
and #@end-debug@
- Turns into
#@debug@
and#@end-debug@
, as well as adding a # to the beginning of each line in-between.
Exclude from packaging
These occur based on filetype, as they tend to tie into the comment system for the file.
--@do-not-package@
and--@end-do-not-package@
(for Lua)<!--@do-not-package@-->
and<!--@end-do-not-package@-->
(for XML)- #@do-not-package@ and #@end-do-not-package@ (for TOC)
- Removes everything between the @do-not-package@ and @end-do-not-package@ tags including the 2 tags themselves. This may cause line numbers of subsequent lines to change. The typical usage is at the end of Lua files surrounding debugging functions and other code that end users should never see/execute.
You will still need to comment out the @do-not-package@ and @end-do-not-package@ tags for the relevant file types.
Alpha replacements
Occurs for packaged files that are Alpha release status. The transformations are filetype-based, as they tend to tie into the comment style for the file. The text between tokens isn't removed so, that line numbers stay the same; it is simply commented out.
This is useful for inserting extra debugging information that you want your alpha testers to have, but don't want to appear in release versions.
Lua
--@alpha@
and --@end-alpha@
- Turns into
--[===[@alpha
and--@end-alpha]===]
. --[===[@non-alpha@
and--@end-non-alpha@]===]
.- Turns into
--@non-alpha@
and--@end-non-alpha@
.
Example:
--@alpha@ assert(everythingIsOkay()) --@end-alpha@
This would make the assert take place in development mode and alpha zips, but not for release and beta.
XML
<!--@alpha@-->
and <!--@end-alpha@-->
- Turns into
<!--@alpha
and@end-alpha@-->
. <!--@non-alpha@
and@end-non-alpha@-->
.- Turns into
<!--@non-alpha@-->
and<!--@end-non-alpha@-->
.
TOC
#@alpha@
and #@end-alpha@
- Turns into
#@alpha@
and#@end-alpha@
, as well as adding a # to the beginning of each line in-between.