Server Essentials for Bukkit
Description:
Server Essentials is a plugin which opens up the ability for upcoming Server Owners to get a head start into creating a highly customisable server with most settings and messages having the ability to be changed, making the plugin extremely versatile.
Features:
- A fully customisable Broadcasting system which utilises Placeholder API and has the ability to change messages, add unlimited broadcast messages and even change the delay. On top of this it can be enabled and disabled from the ease of typing either true or false.
- PlayerJoin and PlayerLeave symbols which shows either a '+' or '-' depending on whether they join or leave. The symbol is also fully customisable with colours and text.
- Discord command giving the ability to paste your discord link easily in the Minecraft chat, able to be customised with a custom message and colours!
- Website command allowing you to paste your server's website within the Minecraft chat, able to also be customised with custom messages and colours too!
- Rules command that pastes the entire file contents of rules.yml allowing you to build a list of rules to your hearts content!
- Playtime command which shows executing player's (person executing the command) playtime.
- Features a plugin only reload command which allows you to instantly reload all the config files present with the plugin simply by typing /se reload. Which makes all changes come to fruition.
- Completely functional 'Setspawn' system which allows you to change and set the spawn point with the ease of one command. Also extremely configurable as the spawn coordinate will be saved into an individual config file which can be changed to alter the spawn location, without a restart with the /se reload command!
- Fully fledged Home system which features a unique and custom file saving system which will save each and every player's home name and location including: X, Y, Z and Yaw. Alongside this to avoid confusion each location coordinates will be assigned to a sub node with the Player's UUID minimalizing confusion.
- Functional Teleport system which can be extremely useful for Administrators as it gives permission to teleport to players, teleport players to anyone, or even teleport all online players to your location! On top of this the TPPos command also allows the executing player to teleport to any given coordinates! Plus to suite regular players on the server they can use the Teleport Request system where they can send Teleport Requests to any online player and the targeted player can accept or deny that request with /tpaccept or /tpdeny.
- Announcement feature which allows players with the permssion to send broadcasted messages to every single online player on the Server. Not only does this come with color support, but also Placeholder API support!
- Fully Functional Messaging System which allows you to Privately Message the targeted player in the command, which also comes with ability for ChatColor Support!
- Fully Fledged out Warp System which will allow you to make, delete and warp to an unlimited amount of warps which are all accessible alongside their location coordinates via the warp.yml file. You can also give players individual permissions for each warp using the following format. 'se.warps.warpname'.
- MOTD System which supports ChatColor and also PlaceholderAPI which will send the Text Block as defined in the config.yml file.
- Customisable, adaptive and intuitive GUI's for the Warp and Home systems. Which is toggleable on and off. Size of GUI is configurable, as well as text colour and display item.
Commands:
- /se reload - Reloads all Files within the Plugin.
- /se version - Will display the Plugin version in the chat.
- /se - Will display all commands within in-game chat.
- /discord - Pastes the contents within the 'discord-command' path in lang.yml.
- /website - Pastes the contents within the 'website-command; path in lang.yml.
- /youtube - Pastes the contents within the 'youtube-command; path in lang.yml.
- /twitch - Pastes the contents within the 'twitch-command; path in in lang.yml.
- /rules - Pastes all contents within the rules.yml file.
- /playtime - Displays the players total playtime.
- /playtime (name) - Displays the total playtime for the Targeted Player.
- /hurt - Can take away players hearts with the value being determined by whatever numeric value the player enters.
- /setspawn - Sets the World Spawn
- /deletespawn - Deletes the Spawn
- /spawn - Teleports you to the Spawn
- /se silentjoin - Disables join and leave message for the executing player.
- /sethome (name) - Sets a home with the specified name.
- /home (name) - Teleports you to the specified home.
- /home (target) (home name) - Teleports you to the Target's Home
- /deletehome (name) - Deletes the specified home.
- /sendhome (target) (homename) - Sends the Target to the specified Home.
- /listhomes (target) - Lists all of the Target's Homes
- /deletehome (name) - Deletes the specified home.
- /teleport - Primary Force Teleport Command.
- /tphere - Teleports the Target player to you.
- /tpall - Teleports all online players to your location.
- /tpa - Sends a Teleport Request.
- /tpacancel - Cancels a Teleport Request
- /tpahere - Request someone to Teleport to you
- /tpaccept - Accepts a Teleport Request.
- /tpdeny - Denies a Teleport Request.
- /tptoggle - Toggles whether you should receive Teleport Requests or not.
- /heal - Heals the Target Player to full Health.
- /feed- Completely fills the Player's Hunger Bar.
- /announce - Announces messages to the entire Server.
- /invsee - Opens the Target's Inventory.
- /gamemode creative - Changes gamemode to Creative.
- /gamemode survival - Changes gamemode to Survival.
- /gamemode adventure - Changes gamemode to Adventure.
- /gamemode spectator - Changes gamemode to Spectator.
- /fly - Enables and Disables Flight.
- /kill (name) - Kills the Target Player
- /message (name) - Messages the Targeted Player
- /reply (message) - Reply to the last person who Messaged you
- /msgtoggle - Disables the ability for people to message you.
- /craft - Opens the Crafting GUI
- /enderchest (name) - Opens up your own, or the Target's Enderchest.
- /setwarp (name) - Sets a warp with the Following Name.
- /deletewarp (name) - Deletes the Following Warp.
- /warp (name) - Warps to the following name.
- /repair - Repairs the item you are currently holding.
- /repair all - Repairs all items in your Inventory.
- /sunrise - Changes Time to Sunrise.
- /day - Changes Time to Day.
- /sunset - Changes Time to Sunset.
- /midnight - Changes Time to Midnight.
- /sun - Changes Weather to Clear.
- /thunder - Changes Time to Thunder.
- /storm - Changes Time to Thunder.
- /vanish - Vanish Command.
- /test permission - Pastes the 'no-permission-message' String in game.
- /test join - Pastes the 'join-symbol' String in game.
- /test leave - Pastes the 'leave-symbol' String in game.
- /test welcome - Pastes the 'first-time-join' String in game.
- /test motd - Pastes the 'motd-message' String List in game.
- /clear - Clears your own, or the Targeted Player's inventory.
- /god - Toggles Godmode for yourself, or the Targeted Player.
- /hat - Puts the item in your hand onto your head.
- /rename - Renames the item you are holding.
- /lore - Adds a line of Lore for the item you are holding.
- /speed (value) - Changes your Walk/Flight speed.
- /report (user) (reason) - Reports the Specified User to Admins.
- /reportbug (bug) - Reports the Specified Bug to Admins.
- /clearchat - Clears the Chat.
- /sendwarp (player) (warp) - Sends the Targeted Player to the specified Warp
- /socialspy - Toggles the Social Spy feature on and off
- /staffchat - Toggles the Staff Chat command on and off
- /trash - Opens the Trash Chute GUI
- /back - Teleports to previous location
- /convert - Converts Held Item to it's Block Form
- /convert all - Converts Inventory Items to their Block Form
- /sudo (player) - Executes a Command as the Targeted Player
- /sudo (player) <command> - Executes a Command as the Targeted Player
- /sudo %console% <command> - Executes a Command as Console
- /whois <player> - Displays a list of useful information about a Player
- /ping <player> - Displays the Ping of the Targeted Player
Permissions:
- se.all - Grants a player access to use all ServerEssentials commands.
- se.reload - Allows a player to use /se reload
- se.discord- Allows a player to use /discord
- se.website- Allows a player to use /website
- se.youtube - Allows a player to use /youtube
- se.twitch - Allows a player to use /twitch
- se.rules - Allows a player to use /rules
- se.playtime- Allows a player to use /playtime
- se.hurt - Allows a player to use /hurt
- se.version - Allows a player to use /se version
- se.setspawn - Allows a player to use /setspawn
- se.deletespawn - Allows a player to use /deletespawn
- se.spawn - Allows a player to use /spawn
- se.spawn.others - Allows a player to teleport another player to spawn
- se.alert - Allows the permission to receive update alerts upon logging in.
- se.silentjoin - Gives permission to the silentjoin command
- se.sethome - Gives permission to the sethome command
- se.sethome.[number] - Gives permission for players to set specified amount of homes
- se.sethome.unlimited - Gives permission to set unlimited homes
- se.home - Gives permission to the home command
- se.home.others - Gives permission to teleport to other player's homes
- se.deletehome - Gives permission to the deletehome command
- se.sendhome - Send Home Command
- se.listhomes - List Homes command
- se.info - Gives permission to the se command
- se.silenttp - Stops the person you teleported to from receiving a message.
- se.teleport - Gives permission to the teleport and teleport here command
- se.teleport.coords - Gives permission to teleport to coordinates
- se.teleport.bypass - Bypasses the TPA and TPAHere command cooldowns
- se.tpall - Gives permission to the tpall command
- se.tpa - Gives permission for the tpa command
- se.tpacancel - Gives permission for the tpacancel command
- se.tpahere - Gives permission for the tpahere command
- se.tpaccept - Gives permission for the tpaccept command
- se.tpdeny - Gives permission for the tpdeny command
- se.tptoggle - Gives permission for the tptoggle command
- se.heal - Gives permission for the heal command
- se.feed - Gives permission for the feed command
- se.announce - Gives permission for the announce command
- se.invsee - Gives permission for viewing other player's inventories
- se.invsee.others - Gives permission for changing other player's inventories
- se.gamemode.creative - Creative Gamemode
- se.gamemode.survival - Survival Gamemode
- se.gamemode.adventure - Adventure Gamemode
- se.gamemode.spectator - Spectator Gamemode
- se.fly - Toggle Fly for yourself
- se.fly.others - Toggly Fly for other player's
- se.kill - Kill Command
- se.message - Message Command
- se.reply - Reply Command
- se.msgtoggle - MSG Toggle Command
- se.craft - Craft Command
- se.enderchest - Enderchest Command
- se.enderchest.others - Allow Players to open a Target's Enderchest
- se.setwarp - Setwarp Command
- se.setwarp.block - SetWarp Block Command
- se.deletewarp - Delete Warp Command
- se.warp - Warp Command
- se.warps.[warpname] - Permission to teleport to a specific warp
- se.repair - Repair and Repair All Commands.
- se.time - All Time Related Commands.
- se.vanish - Vanish Command.
- se.test - All Test Commands
- se.clear - Clear Command
- se.god - God Command
- se.hat - Hat Command
- se.rename - Rename Command
- se.lore - Lore Command
- se.speed - Speed Command
- se.speed.others - Speed Others Command
- se.reportuser - Report User Command
- se.reportbug - Report Bug Command
- se.reportnotification - Sends Reports from the Report Command
- se.clearchat - Clear Chat Command
- se.sendwarp - Send Warp Command
- se.warps.all - Grants Player Access To All Warps
- se.socialspy - Social Spy Command
- se.staffchat - Staff Chat Command
- se.trash - Trash Command
- se.back - Back Command
- se.back.bypass - Bypass all Back Command related Variables
- se.convert - Convert Command
- se.sudo - Sudo Command
- se.whois - Whois Command
- se.ping - Ping Command
Default Config:
############################################################ # +------------------------------------------------------+ # # | Introduction | # # +------------------------------------------------------+ # ############################################################ # This is the config file for Server Essentials. # This config was generated for version 1.82.6 # If you experience any issues please make sure that:- # - Numeric values don't include any quotation marks or apostrophes. # - All words that change text in game include quotation marks. # - Don't change any words present before the ':'. ############################################################ # +------------------------------------------------------+ # # + Server Essentials (Global) + # # +------------------------------------------------------+ # ############################################################ # Changes the prefix that appears at the start of every message and command. prefix: "[Server Essentials]" # Enable or Disable the Update Checker Messages that appear in-game # Default: true update-checker: true # Enable or Disable the Join Message enable-join-message: true # Enable or Disable the Leave Message enable-leave-message: true # Enable or Disable the First Time Join Message enable-first-time-join-message: true # Enable or Disable the Staff Join Message enable-staff-join-message: true # Enable or Disable the Staff Leave Message enable-staff-leave-message: true # Enable to send players to the Newbie Spawn upon Joining for the First Time # If a Newbie Spawn isn't set, this will send players to the main Spawn spawn-on-first-join: false # Enable to send players to the Spawn upon Joining spawn-on-join: false # Enable to send players to the Spawn upon Dying spawn-on-death: false # Remove all Potion Effects when using /heal remove-effects-on-heal: false # Vanish On Join vanish-on-join: false # Enter a name in between the quotations to enable or leave empty to disable # This will be used to send a message in the 'staff-chat-channel-name', 'report-user-channel-name' and 'report-bug-channel-name' on Discord server-name: "" # How long Players have to wait until they can use the Repair Command again # Set to 0 to Disable # Restart Required repair-cooldown: 30 # How long Players have to wait until they can use the Heal Command again # Set to 0 to Disable # Restart Required heal-cooldown: 30 # How long Players have to wait until they can use the Feed Command again # Set to 0 to Disable # Restart Required feed-cooldown: 30 ############################################################ # +------------------------------------------------------+ # # + Server Essentials (Broadcast) + # # +------------------------------------------------------+ # ############################################################ # Enable the Broadcasting function. broadcast: false # Add Broadcast Messages Here # Make sure to use the Format [- "(messagehere)"] on each line to add a new message into the cycle. broadcast-messages: - "Test Broadcast" - "Test Broadcast 2" # Ticks Between Each Message # 20 Ticks = 1 Second broadcast-delay: 1000 # Change the Minimum Amount Of Players Online for the Broadcast System to run # Can be useful to reduce spamming console with no one online broadcast-min-players: 1 ############################################################ # +------------------------------------------------------+ # # + Server Essentials (MOTD) + # # +------------------------------------------------------+ # ############################################################ # Enable the MOTD Message Upon Joining enable-motd: true # How long the Plugin will wait until the MOTD is sent to the player after joining (in Seconds) motd-delay: 5 # Change the Messaging for the MOTD motd-message: - "-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-" - "&bThis Server uses Server Essentials!" - "&aDownload the Plugin Today!" - "-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-" ############################################################ # +------------------------------------------------------+ # # + Server Essentials (Discord) + # # +------------------------------------------------------+ # ############################################################ # Enable Discord Integration for the Report Commands. enable-report-discord-integration: false # Enable Discord Integration for Staff Chat. enable-staff-discord-integration: false # Change the name of the Discord Channel where staff chat messages are sent. # This name will have to be entered into the DiscordSRV config.yml File. # ["staff-chat": "000000000000000000"] as an example. staff-chat-channel-name: staff-chat # Change the name of the Discord Channel where report notifications are sent. # This name will have to be entered into the DiscordSRV config.yml File. # ["report-user": "000000000000000000"] as an example. report-user-channel-name: report-user # Change the name of the Discord Channel where report notifications are sent. # This name will have to be entered into the DiscordSRV config.yml File. # ["report-bug": "000000000000000000"] as an example. report-bug-channel-name: report-bug # Adds a message that is pasted before the Report Command Embed Message is sent # Useful for pinging a group with all Staff Members inside when a Report is sent # Please make sure to paste the Group ID into the quotations for this to work correctly # To disable this leave the contents within the "" blank # Make sure to go to the DiscordSRV config.yml file and change 'DiscordChatChannelAllowedMentions' to include 'role' within the [] group-id: "" ############################################################ # +------------------------------------------------------+ # # + Server Essentials (Spawn) + # # +------------------------------------------------------+ # ############################################################ # How many Seconds the Player has to wait before they are teleported to Spawn # Set to '0' to Disable spawn-teleport: 5 # Enable or Disable the ability to stop Teleportation when the Player Moves # Only works if 'spawn-teleport' is higher than 0 # Default: true spawn-movement-cancel: true ############################################################ # +------------------------------------------------------+ # # + Server Essentials (Warp) + # # +------------------------------------------------------+ # ############################################################ # Enable or Disable the Warp GUI enable-warp-gui: true # Determine the amount of slots inside the Warp GUI # Minimum: '9' warp-gui-size: 9 # Change the Item that shows for Warps in the Warp GUI warp-item: DIAMOND_BLOCK # Change the Colour of Warp Names in the Warp GUI # Please use Colour Codes warp-name-colour: "&a" # Enable Subtitle Text on screen when teleporting to a Warp enable-warp-subtitle: false # How many Seconds the Player has to wait before they are teleported to a Warp # Set to '0' to Disable warp-teleport: 5 # Enable or Disable the ability to stop Warping when the Player Moves # Only works if 'warp-teleport' is higher than 0 # Default: true warp-movement-cancel: true # Enable Blacklisted World Feature for Warps # Default: False enable-warp-blacklist: false # Blacklist Worlds where Player's cannot create Warps warp-blacklist: - world ############################################################ # +------------------------------------------------------+ # # + Server Essentials (Home) + # # +------------------------------------------------------+ # ############################################################ # Enable or Disable the Home GUI enable-home-gui: true # Determine the amount of slots inside the Home GUI # Minimum: '9' home-gui-size: 9 # Change the Item that shows for Homes in the Home GUI home-item: RED_BED # Change the Colour of Home Names in the Home GUI # Please use Colour Codes home-name-colour: "&a" # Enable Subtitle Text on screen when teleporting to Home enable-home-subtitle: false # Default Home Count default-home-count: 3 # How many Seconds the Player has to wait before they are teleported to Home # Set to '0' to Disable home-teleport: 5 # Enable or Disable the ability to stop Teleportation when the Player Moves # Only works if 'home-teleport' is higher than 0 # Default: true home-movement-cancel: true # Enable Blacklisted World Feature for Homes enable-home-blacklist: false # Blacklist Worlds where Player's cannot set homes # Default: False home-blacklist: - world ############################################################ # +------------------------------------------------------+ # # + Server Essentials (Teleport) + # # +------------------------------------------------------+ # ############################################################ # Enable Blacklisted World Feature for Teleporting to Players # Default: False enable-teleport-blacklist: false # Blacklist Worlds where Player's cannot teleport to other Players teleport-blacklist: - world # Enable Teleporting in Blacklisted World if both players are in the world # Default: False enable-teleport-in-world: false # How long until Teleport Requests Timeout (in Seconds) teleport-cancel: 30 # How many Seconds the Player has to wait before they are teleported to someone # Set to '0' to Disable teleport-wait: 5 # Enable or Disable the ability to stop Teleportation when the Player Moves # Only works if 'teleport-wait' is higher than 0 # Default: true teleport-movement-cancel: true # How long Players have to wait until they can use the Teleport Command again # Set to 0 to Disable # Restart Required tp-cooldown: 30 ############################################################ # +------------------------------------------------------+ # # + Server Essentials (Back) + # # +------------------------------------------------------+ # ############################################################ # Enable or Disable Saving Location when teleporting to someone teleport-save: true # Enable or Disable Saving Location when teleport to your Home home-save: true # Enable or Disable Saving Location when warping to a Warp warp-save: true # Enable or Disable Saving Location when teleporting to Spawn spawn-save: true # Enable or Disable Saving Location upon Death death-save: true # Enable or Disable Saving Location upon changing World world-save: true # Enable Blacklisted World Feature for the Back Command # Default: False enable-back-blacklist: false # Blacklist Worlds where Player's cannot use /back back-blacklist: - world # How long Players have to wait until they can use the Back Command again # Set to 0 to Disable # Restart Required back-cooldown: 30 # How many Seconds the Player has to wait before they are returned to their previous location # Set to '0' to Disable back-teleport: 5 # Enable or Disable the ability to stop Teleportation when the Player Moves # Only works if 'back-teleport' is higher than 0 # Default: true back-movement-cancel: true
Data Collection:
This plugin uses bStats to collect some statistics about usage of the plugin and sends them to https://bstats.org/. This can be disabled by changing 'stats' in the directory 'bStats/config.yml' to false. The statistics sent include Version Demographics, Server/Player Statistics, Server Location, Operating System etc. The stats available to the public are Version Demographics, Server Location, Rank, Java Version and Global Statistics. These are viewable at https://bstats.org/plugin/bukkit/Server Essentials/9633.
PlaceholderAPI:
This plugin supports full PlaceholderAPI support which means in every customisable message you can use placeholders to replace text or add on to text in anyway you wish!
We also (in the future) plan to add custom Placeholders too!
Support Discord:
Join the Support Discord here! https://discord.gg/U6TtFzpZtT
Featured Videos:
If you want to feature your Tutorial please DM me!
Rating:
If you like the plugin, don't forget give it a rating. Every rating is much appreciated and extremely helpful to the longevity of the plugin's production development.
Hello,
Sorry to ask, but why not joining the essentialsX dev group and creating another plugin?
I'd like to use this plugin and I apologize cuz i'm a noob when it comes to severs. But when I download it and place it into my plugins folder... (if i click on any other plugin i have downloaded it does nothing and there's a folder for each jar file that corresponds to each that does nothing when I click on the jar file and the folders were made after running the bat. however when I put this plugin in the plugins folder and run the bat no folder for this plugin is made and if i click on the jar file for this plugin i get an error message that says "invalid or corrupt jar file" how do I fix this?
In reply to Vlarr:
Do not click a Plugin Jar. Put the Plugin Jar into the Plugins folder, start your Server and it will make a folder representing to that specific Plugin. I recommend watching some videos on YouTube
This plugin keeps switching me out of creative mode everytime I go through a portal or join the game and I can't figure out how to change this in the config.
In reply to ReddRowBoat:
Do you have Multiverse installed by any chance?
I'm getting an error on server restart which says that rules.yml will not load. ~~Unexspected error on one of the lines. I thought it just read it as a text file.
Also I've deleted your discord channel from my account. Can I join it again please?
In reply to Colwood:
Join the Support Discord here! https://discord.gg/U6TtFzpZtT
Hey i have a question
so when i try to look at non oped players inventories and set homes
it says they are offline can i fix this?
In reply to ne0n3ananza:
When trying to check an offline players inventory this is unfortunately impossible without having to link directly in with the Player Data file in the World Folder, you can do this manually using an NBT Editor. As for homes, you should be able to view all homes that they have set.
Ive tested this plugin and love it. It gives me a ton of options however one thing I am lacking is finding how to set X amount of homes per rank. For example although my Members rank is default at 3 I want my VIP to be able to set 5, VIP+ to set 7 and so on. Is there a way to do this? All Ive found is they can set the default or unlimited.
In reply to THCFrosD:
Hi there!
This is currently a HIGHLY requested feature and I really want to get it implemented ASAP. But unfortunately in it's current state this is not possible. If you would like to install another plugin for the Sethome Features feel free, as due to the lack of full customisation it is currently set to low priority, allowing other plugins to take over.
In reply to THCFrosD:
Hey there! I'm happy to provide an update on this, the feature has now been added and is available to download right now on Spigot, and hopefully shortly here on Bukkit after the review process has concluded.
In reply to RocketManKian:
Where can I find the command or how can I change the amount?
I haven't started using this plugin yet, but I wanted to know what the command for getting the chest GUI for warps and homes is, I can't find it in the command list unless it's the /home list command. Also, does the chest GUI support several pages of homes or warps? Thanks!
In reply to laugexd:
To open the Home List GUI you just type /home.
To open the Warp List GUI you just type /warp.
Warps and Homes only support one page right now but you can change how many to fit on that one page in increments of 9. Max being 27 I believe, but haven't tested that as it's a Minecraft restriction.
Multiple pages for Warps and Homes will most probably be supported/added in a future update :)
Hello! I use PowerRanks for me to manage the permissions for other players on my server. I have 4 ranks right now and all of them work, but one, which is the biggest. I put in the ranks.yml file "se.all" pemission to have "admin" rights on my biggest rank, but it doesn't work. In the end I put all of the permissions from your website manually and it works. So, please update it to put only se.all to have "admin" rights. Let me know what to do if I did something wrong.
In reply to andypebit:
Ahh thank you for this. I may have removed this accidentally during the magnitude that is the last update. I will work on this and get it out ASAP!
Plugin announces an update, but there's not one here ?
In reply to DjSpecialK:
Currently waiting for Bukkit to review and accept the updates. They're available right now on Spigot
Love the plugin, just one issue. When I try to run commands that pull up a gui such as ec or inv it crashes my server. This is the only plugin on my server apart from a discordsrv.