Naughty Platypus Memorabilia

    altvrd

    1.1.1 • Public • Published

    Download resources like it's 2019.

    Introduction

    To install new alt:V resources into your project nowadays is a 100% manual process that can give you a lot of headaches if done incorrectly. alt:V Resource Downloader comes with the mission to bridge the gap between developers and server owners to make collaboration in our community easier, and help with this process.

    alt:V Resource Downloader is NOT maintained, affiliated or sponsored by alt:V team. Any requests or bugs should be addressed in this repository's issues section or talking directly to vanessa#7275, and nowhere else.

    (Always in) Beta

    This tool has some improvements to be done and wasn't tested in all possible platforms. If you want to help this project to develop further, suggestions and bug reports on the Issues section are appreciated!

    Installation

    Use it with npx (doesn't get installed on your computer):

    npx altvrd --help
    npx altvrd i altmp/ls-gangwar

    Or, if you wish, install it globally:

    npm i -g altvrd
    altvrd --help

    Usage

    altvrd install altmp/ls-gangwar
    # or altvrd i altmp/ls-gangwar 
     
    altvrd uninstall altmp/ls-gangwar
    # or altvrd u altmp/ls-gangwar 

    Available commands

    Use altvrd [command] -h to check what options each command has.

    • install <author/repo> - Installs a resource using the author username and repository slug.
    • uninstall <author/repo> - Uninstalls a resource.

    How to publish my resource?

    1. Publish your resource on GitHub (GitLab and Bitbucket support coming soon!)

    2. Use releases and semantic versioning for the tool to detect updates correctly (optional, but if you don't the tool will always download from master branch)

    3. Keep your resource at root level (don't nest it)

      We have plans to implement a way for developers to specify what folder to install

    4. Add this badge to your resource's README to show some support! (optional, obviously)

      altvrd friendly

      [![altvrd friendly](https://img.shields.io/badge/altvrd-friendly-50753A)](https://github.com/altvrd/cli)
    5. Add it to our awesome-altv-resources list ✨ (optional)

    What is altvrd.json?

    It's the file we use to keep your resources updated. Every time you install a new resource, we will check if it's already installed and tell you if it's needed to be updated or not. Here's an example:

    {
      "resources": {
        // This resource uses releases (it has `version` filled)
        "john-doe/my-awesome-resource": {
            // useful to determine if it needs to be updated
            "version": "1.2.1",
            // the folder name, useful to make sure a given resource isn't installed twice
            "folder": "john-doe@my-awesome-resource",
            // the latest version url
            "url": "https://api.github.com/repos/john-doe/my-awesome-resource/zipball/v1.2.1"
        },
        // This resource doesn't use releases, so it will always be downloaded from master
        "team-stuyk-alt-v/altv-extended": {
            "folder": "team-stuyk-alt-v@altv-extended",
            "url": "https://github.com/team-stuyk-alt-v/altV-Extended/archive/master.zip"
        }
      }
    }

    Credits

    alt:V Resource Downloader is inspired by fvm-installer, a resource installer for FiveM.

    Install

    npm i altvrd

    DownloadsWeekly Downloads

    9

    Version

    1.1.1

    License

    MIT

    Unpacked Size

    26.7 kB

    Total Files

    15

    Last publish

    Collaborators

    • vanessabarreiros