Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/williamvenner/fastgmad
⚡ An extremely fast reimplementation of gmad.exe and gmpublish.exe
https://github.com/williamvenner/fastgmad
garry garrys garrys-mod garrysmod gma gmad gmod gmpublish gmpublisher mod steam steam-workshop steamworkshop workshop
Last synced: 3 months ago
JSON representation
⚡ An extremely fast reimplementation of gmad.exe and gmpublish.exe
- Host: GitHub
- URL: https://github.com/williamvenner/fastgmad
- Owner: WilliamVenner
- License: apache-2.0
- Created: 2023-09-02T18:51:58.000Z (over 1 year ago)
- Default Branch: master
- Last Pushed: 2023-10-01T18:38:00.000Z (over 1 year ago)
- Last Synced: 2024-10-11T11:34:33.933Z (3 months ago)
- Topics: garry, garrys, garrys-mod, garrysmod, gma, gmad, gmod, gmpublish, gmpublisher, mod, steam, steam-workshop, steamworkshop, workshop
- Language: Rust
- Homepage:
- Size: 659 KB
- Stars: 32
- Watchers: 2
- Forks: 4
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE-APACHE
Awesome Lists containing this project
README
⚡ fastgmad
An extremely fast reimplementation of gmad.exe and gmpublish.exe.
###### Prefer to use a GUI? Check out [gmpublisher](https://github.com/WilliamVenner/gmpublisher)!
## Features
* Up to **x100 faster** than gmad.exe
* Publish/update Workshop addons **without creating a .GMA**
* Create, extract and publish GMAs **all in one tool**
* Upload addon icons in PNG, JPG or **even GIF format**
* Drop-in replacement for gmad.exe and gmpublish.exe - **usage is identical**
* Publish without specifying an icon if you're feeling lazy
* `-stdin` and `-stdout` support for piping data between tools
## Requirements
Windows, macOS or Linux
## Usage
```
https://wiki.facepunch.com/gmod/Workshop_Addon_Creation
https://wiki.facepunch.com/gmod/Workshop_Addon_Updating
Drag & Drop
-----------
Drag & drop a .gma onto fastgmad to extract it
Drag & drop a folder onto fastgmad to convert it to .gma
Creating GMAs
-------------
fastgmad create -folder path/to/folder -out path/to/gma.gma
fastgmad create -folder path/to/folder -out path/to/gma.gma
fastgmad create -folder path/to/folder
fastgmad create -folder path/to/folder -stdout
Extracting GMAs
---------------
fastgmad extract -file path/to/gma.gma -out path/to/folder
fastgmad extract -file path/to/gma.gma
fastgmad extract -stdin -out path/to/folder
Publishing GMAs
---------------
>> You can publish .GMAs OR addon directories (a .GMA will be automatically created for you) <<
>> Adding an icon is OPTIONAL for publishing a new Workshop addon. A default icon will be provided for you if you don't add one. <<
Accepted Icon Formats: JPG, PNG, GIF
Icon Max Size: 1 MB
Recommended Icon Dimensions: 512x512
fastgmad publish -addon path/to/addon -icon path/to/icon
fastgmad update -id 1337 -addon path/to/addon
fastgmad update -id 1337 -addon path/to/addon -icon path/to/icon
fastgmad update -id 1337 -addon path/to/addon -changes "fixed something"
fastgmad update -id 1337 -addon path/to/addon -changes "fixed something" -icon path/to/icon
Additional flags
----------------
-max-io-threads - The maximum number of threads to use for reading and writing files. Defaults to the number of logical cores on the system.
-max-io-memory-usage - The maximum amount of memory to use for reading and writing files in parallel. Defaults to 2 GiB.
-warninvalid - Warns rather than errors if the GMA contains invalid files. Off by default.
-noprogress - Turns off progress bars.
Notes
-----
- CRC checking and computation is not a feature. Implementing this would slow down the program for no benefit and it is virtually unused and redundant in Garry's Mod.
```
