FiveM resource manager.
Explore the docs »

View Demo · Report Bug · Request Feature

Table of Contents

1. About The Project
2. Getting Started
   • Installation
3. Usage
   • Creating a new project
   • Adding resources to the project
4. Roadmap
   • For server
   • For resource creation
5. Contributing
6. Support me
7. License
8. Contact
9. Acknowledgments

About The Project

fiverm is a FiveM resource manager for your server. It allows you to manage your FiveM resources in a simple and easy way. It is written in Go for performance and size, and built with Cobra.

(back to top)

Getting Started

This is an example of how you may give instructions on setting up your project locally. To get a local copy up and running follow these simple example steps.

Installation

For now the only way to install fiverm is from the actions page or by downloading it from the release list.

(back to top)

Usage

Creating a new project

To create a project (resources.json file) you should run the next command in your server folder (along with the server.cfg file):

user@host:~$ fiverm init

If you want to create the project again where one already exists, you can use the --force flag to overwrite the project. This will delete the project you have created in that folder, but WILL NOT DELETE ANY INSTALLED RESOURCES.

user@host:~$ fiverm init --force

Adding resources to the project

You need to run the commands in the folder where the project is created with the fiverm init command

To install resources in a created project, use the install command followed by the username and the repository name as in the example:

user@host:~$ fiverm install eschiclers/zrp_demo

If you want the resource to be installed in a custom folder you can use the --folder flag and the folder name without [ ] as in the example:

user@host:~$ fiverm install eschiclers/zrp_demo --folder zrp

And this will install the resource in the [zrp] folder.

(back to top)

Roadmap

For server

• Project creation
• Install resources
  • In custom folder
  • Install from folder without download
• Delete resources
• Update resources

For resource creation

• Resource creation

I also want to create a web page as a directory that collects the public resources and thus be able to list them all and create pages such as "the most installed resources".

But for that you need to have servers. Which means spending money. That's why there is a section to support the project through ko-fi.

See the open issues for a full list of proposed features (and known issues).

(back to top)

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

(back to top)

Support me

You can support me and this project through ko-fi

License

Distributed under the GPL 3.0 license. See LICENSE for more information.

(back to top)

Contact

Chicle - @Eschiclers - hola@chicle.dev - Telegram: @Eschiclers

Project Link: https://github.com/Eschiclers/fiverm

(back to top)

Acknowledgments

• @othneildrew for the README template

(back to top)