Building Skin & Wallpapers

Building Skin & Wallpapers. Apply DLC skins to buildings, without having to purchase DLC.
Apply all Walpaper to buildings, without having to purchase DLC.

Custom Wallpapers!
This plugin also allows you to import new wallpapers created by the community and downloadable from Steam or create new wallpapers that you want.

You can choose from all the skins/wallpaper currently available.

You can upgrade a block with a hammer blow, upgrade all the building you are looking at or upgrade all buildings (Must have building privileges)

Downloading new wallpapers from steam or creating new ones is really very easy.

If you have administrator permissions, you can change the skin/wallpapers of other players using their steamID

Permissions:

• buildingskin.use – Allows you to use the plugin
• buildingskin.build – Allows the player to upgrade the building they are looking at (must have building permits)
• buildingskin.all – Allows the player to upgrade all of his buildings (must have building permits), and to use the gui and commands to change the color of the building skin and/or wallpapers
• buildingskin.wallpaper.nocost – Allows the player to change Wallpapers without cost.
• buildingskin.admin — Allows you to edit all of a player’s buildings, via their steam ID. (Important: this permission should only be given to admins!)
• buildingskin.wallpaper.useskinfromsteam: With this role, you can use skins that are not present in the configuration, and which can be taken directly from Steam.

Usage

In case you are using the containers skin, use the sppary can to change color.

When you use the /bskin build or /bskin all command and you are using the Container skin, all blocks are colored in different colors.

But you just need to change the color with the spray can and repeat the command, and all the blocks will have the color of your choice.

Once you save your favorite color, the plugin will also use it for future uses, you can always change color with the spray can.

/bskin build: It allows you to change the skin of the entire building with the selected skin

Or you can use a shortcut with the hammer.

By pressing the SHIFT key and hitting with the hammer, the skin of the entire building will be changed to the selected skin

BUILDING COLOR

You can change the color of the building, only on skins that have colors, such as Container skins, with just 1 command

1. You can change the color of the building via a convenient gui, by typing the command in chat:
   /bskin c or /bskin color
   
   Or through the button (/bskin command)
   
2. Or you can pass the color id directly:
   /bskin c <color> or /bskin color <color>: For the color you can pass a number from 0 to 16. If you use 0 as the color, each wall will have a different color

Auto apply color

If enabled it immediately changes the color of the skin, if the skin supports color changing. Otherwise the color will be saved as a favorite color for future uses.

Auto apply skin

If enabled and you have selected a skin that supports color change, in addition to updating the skin color, the skin is also updated. For example, if you have a metal base and you have selected the Container skin as your skin, if the button is enabled, both the color and the skin will be changed to the Container skin.

WALLPAPER

You can change the Wallpapers of the building, with just 1 command

1. You can change the color of the building via a convenient gui, by typing the command in chat:
   /bskin wp or /bskin wallpaper
   Or through the button (/bskin command)
   

Wallpaper apply mode

1. BUILDING: Wallpapers will be automatically applied to the entire building you are looking at.
   This icon must be enabled:
   
2. MANUAL: Wallpapers will be applied to the single wall using the hammer. You will first have to select a wallpaper from the list and then with the hammer in your hand, you must hold R (RELOAD) button and give a hammer hit.
   This icon must be enabled:
   

WALLPAPER – WALL SIDE

Wallpaper can be placed on both sides of the wall.
You can choose whether to place the wallpaper on the inside of the wall, on the outside or on both sides, just select one of the 3 buttons

• Internal: The wallpaper will be placed and/or removed on the internal side of the wall
• External: The wallpaper will be placed and/or removed on the external side of the wall
• Both: Wallpaper will be placed and/or removed on both sides of the wall

FREE MOVE

If enabled, it allows you to move freely and try the various Wallpapers without having to type the command every time

REPLACE

When changing wallpapers, if this option is enabled, existing wallpapers will be replaced, otherwise existing wallpapers will not be replaced.

COST

Applying Wallpapers to walls has a cost, which can be changed in the configurations.
To change the cost, open the file /config/BuildingSkin.json and change the property:

1. "Wallpaper place Cost (Cloth). Default: 5 Cloth x Wall": 5
2. The default cost for placing Wallpapers is 5 Cloths for each wall.
3. If the player has buildingskin.wallpaper.nocost permission, he will not need cloth to place Wallpapers

WALLPAPER CUSTOMIZED

You can import new wallpapers created from community directly from Steam or you can create your own wallpapers.

You can find new wallpapers to import via Steam from the following link: Steam Custom Wallpaper

Or you can create your own wallpapers.

To create your own wallpapers, just use this tool (thanks to bmgjet for creating this tool):
https://github.com/bmgjet/Spray_Wallpaper_Creator
and follow the instructions, a really simple and fast process.
You just need to choose an image and a new wallpaper will be created, which will be inserted into your Steam Workshop and you can import it later using its ID.

To import wallpapers you need permission: buildingskin.admin

These are the commands to import or remove custom wallpapers:

• buildingskin.wp.addskin <wallpaperID>: Allows you to import a new wallpaper from Steam
• buildingskin.wp.removeskin <wallpaperID>: Allows you to remove a wallpaper you’ve previously imported from Steam

Instead of <wallpaperID> you need to insert the ID of the wallpaper to import.
The id is present in the url, here is an example:

• https://steamcommunity.com/sharedfiles/filedetails/?id=3349844435
• The url contains the id parameter, you just need to use this number as the id, in this case the id is: 3349844435

Alternatively, you can also use wallpapers through Steam without having to import them first, which is useful for testing wallpapers before importing them or for experimenting.

To be able to use wallpapers directly from steam without importing them, you must have permission: buildingskin.wallpaper.useskinfromsteam

1. /bskin wp <wallpaperID> or /bskin wallpaper <wallpaperID>: Instead of <wallpaperID> you need to enter the id of the wallpaper you want to use
2. NB: If the wallpaper is already present in the configuration, then permission buildingskin.wallpaper.useskinfromsteam is not necessary.

CLAN/TEAM

All members of the clan/team can change the skins or the color of the skins and/or wallpapers set by other players who are part of the clan/team

MESSAGE

To remind your players of the existence of this plugin, every time they pick up a hammer, they will receive a message in the chat, advising them that they can use /bskin to change the skin/wallpapers. The message can be disabled via the /bskin GUI. All this only if the player has permission: buildingsskin.use

DISABLE

From the /bskin GUI any player can disable or enable the plugin. This is for players who have bought the various DLCs.

GRANT PERMISSION

To assign a permission, use oxide.grant <user or group> <Steam name or ID> buildingskin.use.
To remove a permission, use oxide.revoke <user or group> <Steam name or ID> buildingskin.use.

Commands:

• /bskin – Opens the GUI for choosing the skin.
• /bskin b or /bskin build — Upgrade the building you are looking at (Must have building permission)
• /bskin a or /bskin all – Upgrade all your buildings (Must have building permits).
• /bskin a <steam id> or /bskin all <steam id> – Upgrade all your buildings of a player without having building permits, just pass the steamID, ex: /bskin all 76561100000000000
• ——————–
• /bskin color or /bskin color: Open gui for changing building color
• /bskin color <color> or /bskin color <color>: Change skin color. For the color you can pass a number from 0 to 16. If you use 0 as the color, each wall will have a different color
• ——————–
• /bskin wp or /bskin wallpaper: Open gui for changing building wallpapers
• /bskin wp <wallpaperID> or /bskin wallpaper <wallpaperID>: Instead of <wallpaperID> you need to enter the id of the wallpaper you want to use.
• —————————————-
• By pressing the SHIFT key and hitting with the hammer, the skin of the entire building will be changed to the selected skin
• By hold R (RELOAD) button and give a hammer hit, the wallpapers of the entire building will be changed to the selected wallpaper

Configuration:

• Chat steamID icon – Icon ID to use in messages sent by the plugin to the player
• Block building skin in building blocked – Prevents players from changing skins for buildings they don’t have building permits for. You can bypass this limitation with permission:buildingskin.admin
• Number of blocks updated per tick – How many blocks to refresh per tick. Setting the value too high can cause performance problems and server lag.
• Apply selected paint color to all building blocks -Enables the ability to automatically apply your chosen skin color via spray can when you upgrade a building block.
• —————————————-
• WALLPAPER SETTINGS
• Wallpaper: Prevents Rust from removing wallpaper on external walls at base: Rust allows you to place wallpapers on the external side of walls, but only for walls inside the base. This plugin allows you to place wallpapers on all walls, even those outside the base, but Rust removes them after a while.
  Setting this to TRUE prevents Rust from removing wallpapers placed on the external side of walls outside the base. Default TRUE
• Wallpaper: Disable damage against wallpapers: Prevents wallpapers from being damaged and removed. They can still be removed with a hammer. Default TRUE
• Wallpaper place Cost (Cloth). Default: 5 Cloth x Wall side: The cost in cloth to apply the wallpaper for each wall side.

Localization

The plugin, therefore the automatic messages and statistics, are translated into the following languages:

• English
• Italian
• Spanish
• Russian

Translation files are located in the /oxide/lang folder, here is an example of a /oxide/lang/en/BuildingSkin.json translation file.

You can add translations for other languages by adding them to the folder: /oxide/lang