Skip to content

🐱 My template for the VPM project (for VRChat worlds creation); since 2024.2

License

Notifications You must be signed in to change notification settings

kurone-kito/vpm-project-template

Repository files navigation

🐱 VPM Project template for VRChat World

My template for the VPM project (for VRChat worlds creation)

💭 Difference from original template

  • Added some linters e.g. CSpell, EditorConfig, Markdownlint
  • Added some actions e.g. CodeQL, CodeRabbit.AI, Dependabot
  • Auto invoke the VPM registry update when the package is updated
  • Improved a deployment process with GPG signing
  • Improved a GitHub Actions for testing and building
  • Improved the git attributes and ignore files
  • and more...

▶ Getting Started

1. Import the registry via the VRChat Creator Companion (VCC)

Visit the VPM Catalogue page and click on the Add to VCC button.

2. Import the package to your project

  1. Click on the "Manage Project" button in the VCC
  2. Find the "VRChat Example Package" package and click on the "(+) Add package" button

3. Use the package, enjoy :D

🤖 Setting up the Automation

Create a repository variable with the name and value described below. For details on how to create repository variables, see Creating Configuration Variables for a Repository. Make sure you are creating a repository variable, and not a repository secret.

  • PACKAGE_NAME: the name of your package, like com.vrchat.demo-template.

Finally, go to the "Settings" page for your repo, then choose "Pages", and look for the heading "Build and deployment". Change the "Source" dropdown from "Deploy from a branch" to "GitHub Actions".

That's it! Some other notes:

  • We highly recommend you keep the existing folder structure of this template.
    • The root of the project should be a Unity project.
    • Your packages should be in the "Packages" directory.
    • If you deviate from this folder structure, you'll need to update the paths that assume your package is in the "Packages" directory on lines 24, 38, 41 and 57.
  • If you want to store and generate your web files in a folder other than "Website" in the root, you can change the listPublicDirectory item here in build-listing.yml.

Contributing

Welcome to contribute to this repository! For more details, please refer to CONTRIBUTING.md.

License

This repository is licensed under the MIT License.