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]"
- 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]"
- The x: y: z: direction: and world: parameters are not allowed when a player executes a player statue command
- EXAMPLE 1: "/statue [USERNAME] glass" creates a statue made of glass only
- EXAMPLE 2: "/statue [USERNAME] concrete" creates a statue made of concrete only
- EXAMPLE 3: "/statue [USERNAME] terracotta planks" creates a statue made of only terracotta and wood planks
- EXAMPLE 4: "/statue [USERNAME] gray" creates a grayscale statue
- EXAMPLE 5: "/statue [USERNAME] slim gray" creates a grayscale statue that has the "slim" skin format (3px arms)
- EXAMPLE 6: "/statue [USERNAME] wool xz" creates a statue made of only wool. The statue is lying down because of the "xz" parameter.
- EXAMPLE 7: "/statue [USERNAME] diamond_armor concrete" creates a statue with diamond armor made only out of concrete
- EXAMPLE 8: "/statue [USERNAME] wool glass chainmail_helmet iron_chestplate golden_boots" creates a statue with a chainmail helmet, iron chestplate, and golden boots, made only out of wool and glass.
- EXAMPLE 9: "/statue [USERNAME] head right_arm slim" creates the head and right arm components of the statue only with slim arms (Use this to build a statue in parts)
- EXAMPLE 10: "/statue [USERNAME] hue:.2 contrast:.3 posterize:3 saturation:.4 brightness:.5" shifts the hue of the image by .2, sets contrast at .3 (decreases contrast), posterizes the image with 3 levels (more levels = more colors), saturation reduced to .4, brightness reduced to .5
- CONSOLE EXAMPLE 11 "/statue [USERNAME] x:-593 y:32 z:269 direction:North world:world" console/command block only; builds a statue with the specified coordinates and world
- Supports the following NEW block types: glass, concrete, terracotta, planks, gray-colored blocks, wool (you can combine them too!)
- You can now read a skin from the plugin data folder by typing "/statue .FILENAME" Do not forget to include the period in front of the filename. Do not include .png when you type the filename in the command.
- You can add armor to your player statues (chainmail, golden, diamond, iron)! You can select a piece of armor by stating what type of armor and then adding "_helmet" , "_chestplate" , or "_boots" (ex: diamond_boots).
- The plugin now uses bStats for plugin metrics; no personal information is stored and if you use worldedit/essentialsX you likely already use bStats. You may opt out by going to the configuration file under the "bStats" folder in your plugins folder.
- You can undo multiple statues! If you made 4 statues, you can /undostatue all of them away by running the command 4 times!
- Supports the new skin type (sleeves, pantlegs, jacket, etc.)
- Supports the "slim" skin format with 3 pixel arms
- Supports the older skin type without sleeves, pantlegs, or a jacket
- So it basically supports all skins!
- The default setting is "default"
- Also supports different skin orientations (lying down, lying on side, standing up)
- So you would type "/statue USERNAME slim xz" if you would like to generate a skin with the user USERNAME, with a skin format of "slim", and having the statue laying down.
- WorldGuard Support (also works without WorldGuard)!!!
- Spawns the statue two blocks above the player to prevent suffocation.
- You can choose to require players to have EXACT blocks (see config)
- You can build statues in parts (i.e. left_leg only)
- EssentialsX Economy AND Vault Support!
- If used by a survival/normal player, the plugin won't delete blocks- only modifies air. This prevents accidental modification of the terrain, and eliminates the possibility that the statue will destroy bedrock or other stuff it shouldn't destroy.
- Rotates the statue so that it faces you (Supports 4 directions + the aforementioned xy,xz,yz, so 12 orientations in total!)
- Multithreaded so it shouldn't lag your server
- Allows building of a statue ONLY if the uncolored/undyed blocks are in inventory (Admins bypass this) w/ Terracotta, Wood, Wool, Concrete, and Diamonds (Diamond Cost = number of blocks divided by 16) - for survival/normal players. Configurable!
- Informs the player of what blocks/items are needed to build the statue
- Cooldowns between statue creations
- Undo-ing a statue affects only the last statue created by ANY player (Admin only)
- Config file supports cooldowns (min), extra items required, and # of extra items required
- The plugin attempts to connect to a fallback API to grab skins if the Mojang API is down
- Now automatically creates a slim statue if the arms are less than 4 pixels wide (instead of having to type "slim")
- Plugin API: https://github.com/SkyTechBytes/PlayerStatueBuilder/wiki/API
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
If you're enjoying the plugin consider leaving a review!
Please direct any help or feature requests to the discussion page or github issues.