Install

This section explains the installation process. Follow the instructions step-by-step.

❱ Requirements

Ensure that you download and install a copy of rlib on your server. If you have not yet done this, please follow these instructions:

  • Go to https://get.rlib.io/ and download the latest version of rlib.

  • Extract the downloaded zip to your computer

  • Create a new folder on your gmod server called rlib

    • Example: garrysmod/addons/rlib/

  • Upload the extracted rlib zip files to the newly created folder.

    • Ensure you are uploading the files to match the following file structure:

📁 garrysmod 📁 addons 📁 rlib 📁 lua 📁 materials

  • Restart server

  • As the server restarts, view console for errors.

    • If you see errors: contact the developer with a list of them.

    • If you do not see errors: proceed forward

  • In the server console, type rlib.version and it should display the running version on your server. If you it display the version, proceed to the Download & Extraction section of this tutorial.

❱ Download & Extraction

  • Download a copy of Jasper to your computer. Downloads will come as a .zip file which needs to then be extracted to your computer.

  • Create a new folder on your Desktop and name it jasper.

  • Extract the addon zip file into this new folder you have created.

  • Locate the addons folder of your gmod server and create a sub-folder for your addon. Ensure that the new folder you create conforms with the following rules:

    • must not contain spaces

    • must not contain special characters ( $ % ^ & )

    • must not contain uppercase ( capitalized ) characters

    • must only contain alphanumerical characters ( a-z, 0-9 ) OR underscores ( _ )

Examples of acceptable paths / folder names are provided below:

garrysmod/addons/name_of_addon
garrysmod/addons/nameofaddon

Not following these folder name rules may result in your server skipping the addon folder all-together and not loading it. Different server operating systems accept ways of naming folders/files.

  • After creating the new server folder; open the folder you created on your desktop and upload everything within the folder to your new addons folder. Do not upload the desktop jasper folder itself otherwise you'll have the addon too many folders deep.

    • Desktop/jasper => garrysmod/addons/jasper

  • After upload is complete, your server should have the following structure:

📁 garrysmod 📁 addons 📁 jasper 📁 lua 📁 materials 📁 resource

  • Restart server

  • As the server restarts, view console for errors.

    • If you see errors: contact the developer with a list of them.

    • If you do not see errors: proceed to Initialization

❱ Initialization

After you've confirmed the addon is installed, you may now connect to your server and test that it is working. How your addon activates depends on what type of addon you have installed.

You can proceed to the Configuration page to learn more about how you can customize your addon.

Last updated