Need something to decorate your server? Tired of building player statues by hand? A tad bit conceited? If you answered yes to any of these questions, this plugin is perfect for you!
Installation
- Download the .jar below (For spigot versions 1.19 and prior, use this version of the plugin: https://github.com/SkyTechBytes/PlayerStatueBuilder/releases/tag/1.13 )
- Move the .jar to your "plugins" folder in your spigot server folder
- Restart your spigot/paper/etc. server
- Type "/statue USERNAME" to generate a statue for the specified USERNAME
- Config file is in the plugin data folder (in the "plugins folder" > PlayerStatueBuilderX)
Features
- Usage: "/statue USERNAME [glass|concrete|terracotta|planks|gray|wool] [default|slim|legacy] [xy|xz|yz] [iron_armor|diamond_armor|chainmail_armor|golden_armor] [left_leg|right_leg|body|head|left_arm|right_arm] [hue:0-1|saturation:0-1|brightness:0-1|contrast:0-1|posterize:LEVEL] [converter:<rgb|lab|absrgb|hsl|hsb>]"
- Usage: "/undostatue" (Admin) You can now UNDO more than just your last statue!
- CONSOLE Usage: "/statue USERNAME x:[x coord] y:[y coord] z:[z coord] direction:[North|South|East|West] world:[world] [glass|concrete|terracotta|planks|gray|wool] [default|slim|legacy] [xy|xz|yz] [iron_armor|diamond_armor|chainmail_armor|golden_armor] [left_leg|right_leg|body|head|left_arm|right_arm] [hue:0-1|saturation:0-1|brightness:0-1|contrast:0-1|posterize:LEVEL] [converter:<rgb|lab|absrgb|hsl|hsb>]"
- The x: y: z: direction: and world: parameters are not allowed when a player executes a player statue command
- For the full feature list, please see the official github README
How to create a statue with a skin image directly from your computer
NOTE: If you are getting a "blacked out" skin statue, try opening the skin up in an image editor that supports transparency, saving it to overwrite the file, and then trying again.
- 1. Obtain your skin's .png file and copy it
- 2. Go to your "plugins" folder in your server folder
- 3. Go to the "PlayerStatueBuilderX" folder
- 4. Paste your skin's .png file here. Remember the name of the file!!! (Like "bestskin.png" or "bestskin")
- 5. Start your server
- 6. Type "/statue .FILENAME" Make sure you ADD the period BEFORE you write the name of the file. REMOVE ".png" at the end of your filename when you type it into the command if you have it. Ex: Your file is named "bestSkinEver.png" so you would type "/statue .bestSkinEver"
- 7. You can add "glass" "diamond_armor" etc. after it just like a normal skin statue to customize it!
Permissions
Code (Text):
playerstatuebuilderx.createStatue:
description: Allow creation of a statue
default: true
playerstatuebuilderx.bypass:
description: Create a statue, bypassing material requirements
default: op
playerstatuebuilderx.specialOrientation:
description: Allows creation of statues in the xz and yz plane. Orientation unpredictable so Admin only!
default: op
playerstatuebuilderx.override:
description: Player statue is created and overwrites blocks (usually just skips if not air)
default: op
playerstatuebuilderx.noWait:
description: The player does not need to wait out the cooldown to make the statue - 5 minutes is default
default: op
playerstatuebuilderx.undo:
description: The player is allowed to undo the last statue created by ANYONE on the server (no material refunds). You must have "override" permissions for this to work
default: op
playerstatuebuilderx.custom:
description: The player can put a '.' in front to create a custom statue from the plugin's data folder
default: true
Configuration File Details:
Code (Text):
# PlayerStatueBuilderX Configuration File
# For the number of blocks below inside the statue total, add one of the "charge" item to the total
# So if rate is 16 and the total blocks in the statue is 512, the player would need 512/16 = 32 of the "charge" item (in this case, Diamond)
rate: 16
# Cooldown time for using the command in MINUTES (No decimals, set to zero for no cooldown). So 1 means 1 minute between SUCCESSFUL statue CREATIONS (or statue parts).
cooldown: 1
# The "rate" determines how many extra of this "charge" item a player will need. Ex: EMERALD, REDSTONE, DIAMOND, etc.
charge: DIAMOND
# Whether the plugin requires exact materials (ex: 10 blue_concrete and 7 red_concrete INSTEAD of 17 white_concrete)
exact: false
# Cost (in $ - EssentialsX/Vault support) per block that will be placed (ex: 1000 block statue adds $2500 to the cost if priceRate is 2.5)
priceRate: 0.0
How to Update:
Remember: If you'd like to update from an earlier version, simply delete the old .jar file from your plugins folder and insert the new one!
Bugs
Please report any bugs on the plugin's
github page ASAP so I can fix them.
Releases
All plugin releases for all supported minecraft versions can be found on the
github releases page.
Video Showcase/Tutorial by Barbercraft
My video (documentation)
Gallery
https://imgur.com/a/m3HXHHj
1.17 Update RGB vs. LAB Comparison:
https://imgur.com/a/XPShZlO
If you're enjoying the plugin consider leaving a review!
Please direct any help or feature requests to the discussion page or github issues.