Note: The code that handles the resizing requires gdiplus.dll. This should be present on Windows machines. But, on Linux, you will most likely have to install the package libgdiplus. Because this library depends on mono you will also have to add the mono repository to your system. Please refer to the
to see how to do this.
This plugin allows players with the appropriate permission to use images from the internet to display on signs.
A few notes about some configuration values:
Load from local file/sil file:///C:/Windows/test.png/sil file:///c:\img\test.png (might work better). On Windows, be sure to work in a directory that's not restricted for some reason, e.g. C:\Windows.
This plugin allows players with the appropriate permission to use images from the internet to display on signs.
Configuration
The settings and options can be configured in the SignArtist file under the config directory. The use of an editor and validator is recommended to avoid formatting issues and syntax errors.A few notes about some configuration values:
- Maximum concurrent downloads is also used for a separate restore queue, so the plugin will never try to restore more signs at the same time than the value entered here.
- JPG image quality is a numeric value between 0 and 100 (inclusive) that defines the jpeg image quality when the image is saved to storage.
Permissions
This plugin uses the permission system. To assign a permission, use oxide.grant <user or group> <name or steam id> <permission>. To remove a permission, use oxide.revoke <user or group> <name or steam id> <permission>.- signartist.url
Allows the player to use the /sil command - signartist.text
Allows the player to use the /silt command - signartist.restore
Allows the player to use the /silrestore command - signartist.ignoreowner
Allows the player to use the /sil and /silt commands when he does not have building permissions - signartist.ignorecd
Allows the player to use the /sil and /silt commands without trigger a cooldown. - signartist.raw
Allows the player to specify the raw argument to ignore the jpeg enforcement when it is enabled in the config - signartist.restoreall
Allows the player to specify the all argument for /silrestore to restore all signs at once.
Commands
This plugin provides both chat and console commands using the same syntax. When using a command in chat, prefix it with a forward slash: `/`.Chat Commands
- /sil <url> [raw]
Download the image from the url to the server and display it on the sign you are currently looking at. Specifying the `raw` argument allows you to ignore jpeg enforcement if that is enabled in the config file. - /silt <message> [<fontsize: number>] [<color: hex value>] [<bgcolor: hex value>] [raw]
Downloads a generated image with the given text and optional fontsize, color, bgcolor to be displayed on the sign you are currently looking at. Specifying the raw argument allows you to ignore jpeg enforcement if that is enabled in the configuration file. - /silrestore [all] [raw]
Restores an image on the sign that was broken during the last Rust update. Specifying the all argument will restore all signs on the server. Specifying the raw argument allows you to ignore jpeg enforcement if that is enabled in the configuration file. - /sili
Adds currently held item icon to sign or frame. Use /sili default to add that items default skin. Note that un-approved workshop skins will upload the first image in the workshop preview.
Console Commands
These console commands do the exact same thing as the chat commands and can only be executed from the ingame console. They were added to allow input (long urls and such) that can't be send through chat.- sil <url> [raw]
- silt <message> [<fontsize: number>] [<color: hex value>] [<bgcolor: hex value>] [raw]
Examples
Load from URL/silLoad from local file/sil file:///C:/Windows/test.png/sil file:///c:\img\test.png (might work better). On Windows, be sure to work in a directory that's not restricted for some reason, e.g. C:\Windows.