HomeJavaMods[Unmaintained] aEssentials
[Unmaintained] aEssentials
aEssentials - A little Essentials!

aEssentials was made for smaller servers that may want to grow, such as the plugin itself. aEssentials wants to be the Essentials of the Feature.​


This resource has been replaced by zEssentials.
Please report bugs here.

Translations
German/Deutsch (here)

Version 4+ -> MC 1.15

Version 3.1.X.X -> MC 1.14.1
Version 3.0.X.X -> MC 1.13.2


Why should I use this plugin?
Features
Easy to use
Nice colored InGame-Help
Enable/Disable Events like PlayerJoin/Quit, ItemDrop, ...
File-System
Variables
100% uuid support
API
Hard tested
Many features are in development
FREE!
Every message compatible with ColorCodes (&)
Captcha mode
You can edit every message (100% editable, over 200 lines!)

------------------------------[INFORMATIONAL]------------------------------

Wiki: http://rengobli.at/mediawiki/index.php/AEssentials

Things marked as GREEN are the latest changes.
Things marked as RED are not implemented yet or getting removed!

Things marked as PURPLE are going to be implemented into the next version.
Upcoming next:

You can report issues, get help and send-in things here.

------------------------------[INFORMATIONAL]------------------------------


Commands

<> - Needed argument
[] - Optional
{} - Aliases
Administrative
/essentials [reloadconfig] - Shows help ingame
/maintenance <on/off/whitelist> [add/remove] [Player] - Maintenance Administration
/censor <add/remove> <Word>

/antiad <add/remove> <Domain> [removed]
Moderative
/broadcast <Message> - Sends a message to all online players
/cc - Clears the chat [alias /chatclear added]
/giveall {/ga} <Item ID> <Amount> - Gives every player online a certain item
/globalmute {/gmute} <on/off> - Toggles globalmute
/invsee [Player] - Opens a players inventory
/spec <Player/off> - Toggles spectate mode
/tp <Player> [Player] - Teleports to a player
/tpall - Teleports all online players to you
/setwarp <Warp> - Sets a warp​
Cheat
/addlore <Text> - Adds a lore to your item
/burn <Player> <Seconds> - Sets a player on FIREEE! :D
/day [World] - Sets the time to day
/enderchest {/ec} [Player] - Opens a player's EnderChest
/feed [Player] - Fills a player's hunger
/fix - Repairs the tool/armor/weapon in your hand
/fly [Player] - Toggles fly mode
/gamemode {/gm} <GameMode> [Player] - Changes your gamemode
/hat - Sets the item in your hand as your hat
/heal [Player] - Heals a player
/night [World] - Sets the time to night
/rename <Name> - Renames the item in your hand
/skull <Player> - Gives you a player's head [translation added]
/tpa <Player> - Sends a player a TPA request
/tpaccept - Accepts a TPA request
/tpdeny - Denies a TPA request
/workbench {/wb} - Opens a virtual workbench
/warp <Warp> - Teleports you to a warp​
General
/afk - Toggles AFK mode
/clear [Player] - Clears a player's inventory
/delhome [Home] - Delets a home
/home [Home] - Teleports to a home of yours
/homes - List your homes
/list - Shows how many people are online
/msg <Player> <Message> - Sends a player a private message
/ping [Player] - Shows a player's ping
/sethome [Home] - Sets a home

/warps - Lists all warps available​
Permissions
Commands
Every permission is Essentials.cmd.<Command>
This is how it may look like: Essentials.cmd.day
Essentials.cmd.addlore
Essentials.cmd.afk
Essentials.cmd.broadcast
Essentials.cmd.burn
Essentials.cmd.cc
Essentials.cmd.clear
Essentials.cmd.clear.others
Essentials.cmd.day
Essentials.cmd.day.others
Essentials.cmd.delhome
Essentials.cmd.enderchest
Essentials.cmd.enderchest.others
Essentials.cmd.feed
Essentials.cmd.feed.others
Essentials.cmd.fix
Essentials.cmd.fly
Essentials.cmd.fly.others
Essentials.cmd.giveall
Essentials.cmd.globalmute
Essentials.cmd.gamemode
Essentials.cmd.gamemode.others
Essentials.cmd.hat
Essentials.cmd.heal
Essentials.cmd.heal.others
Essentials.cmd.home
Essentials.cmd.invsee
Essentials.cmd.list
Essentials.cmd.msg
Essentials.cmd.night
Essentials.cmd.night.others
Essentials.cmd.sun
Essentials.cmd.sun.others
Essentials.cmd.ping
Essentials.cmd.ping.others
Essentials.cmd.rename
Essentials.cmd.sethome
Essentials.cmd.skull
Essentials.cmd.spec
Essentials.cmd.tp
Essentials.cmd.tp.others
Essentials.cmd.tpa
Essentials.cmd.tpaccept
Essentials.cmd.tpdeny
Essentials.cmd.tpall
Essentials.cmd.workbench
Essentials.cmd.maintenance
Essentials.cmd.censor
Essentials.cmd.antiad
Essentials.cmd.setwarp
Essentials.cmd.warp
Essentials.cmd.warps
Bypasses
Essentials.bypass.* - Bypass everything
Essentials.bypass.cc - Does not clear a players chat
Essentials.bypass.gmute - Bypass GlobalMute
Essentials.bypass.cooldown.home - Bypass home teleport cooldown
Essentials.bypass.cooldown.spawn - Bypass spawn teleport cooldown
Essentials.bypass.cooldown.warp - Bypass warp teleport cooldown
Essentials.bypass.censor - Bypass censored words
Essentials.bypass.antiad - Bypass antiad

Essentials.bypass.antispam - Bypass antispam​
Arguments
To be able to use arguments you need the following:
The permission to use a command (Maybe /day)
If you want to be able to use /day [World] you need the Essentials.cmd.day permission AND the Essentials.cmd.day.others permission.
This are the same for every other permission, just add .others
Like: Essentials.cmd.day.others
Notifys
Essentials.notify - Access to most notifys
Essentials.spy - Receive private messages by other players
Essentials.notify.globalmute - Get a message when joining, if globalmute is enabled
Essentials.notify.censor - Get a message when a player is trying to type sth censored
Essentials.notify.antiad - Get a message when a player is trying to type a blocked domain

Essentials.notify.doubleaccountdetection - Get a message if a player's IP is already connected, but the same IP tries to connect.​
Toggle
The command /toggle allowes you to toggle the following:
TP - Enable/Disable that other players can teleport to you.
CommandNotify - Be able to see the commands players are using.​
Other Stuff
Essentials.sign.color - Be able to write colored on signs
Essentials.disable.fall - Prevent fall damage
Essentials.disable.poison - Prevent poison damage
Essentials.disable.drown - Prevent drowning damage
Essentials.disable.fire - Prevent fire/lava/melting damage


Quick information: If you are an operator and do want to get fall damage, just add yourself the "-Essentials.disable.fall" permission. This will NEGATE this permission for you, meaning that you don't own it.

Essentials.look - Be able to look up the plugins
Essentials.cmd.sethome.vip - Allows to set more homes

Essentials.cmd.sethome.* - Allows to set unlimited homes​
Files
aEssentials//config.yml
aEssentials//players//<UUID>.yml

aEssentials//locs.yml
aEssentials//events.yml
aEssentials//maintenance.yml
aEssentials//warps.yml
aEssentials//titles.yml
aEssentials//actionbar.yml
aEssentials//censor.yml
aEssentials//warps.yml
aEssentials//messages.yml​
Files (Advanced)
config.yml
The plugin saves here features like the PlayerCount.
This file CAN be edited, but it's not recommended.
[​IMG]
//players//<UUID>.yml
Here are all stats of registered players.
You can find stats like kills/deaths/cash here.​
locs.yml
Locations set with the "/set" Command can be found here.​
events.yml
Here you can enable/disable features like..
Broadcast message on PlayerJoin?
Should players be allowed to drop items?
maintenance.yml
Maintenance management
warps.yml
Here are all the warps saved that you've set.
titles.yml
Here you can edit the header and footer.
actionbar.yml
Here you can set informational messages that every player who's online can see.
censor.yml
Here are all the blocked words saved at. You are also able to manage the messages sent here.


[​IMG]

Spoiler: Methods
Location: EMethods.<>
Spoiler: Configuration files
Code (Text):
# Get the path of a file
EMethods.getConfiguration(String fileName, String path);
Code (Text):
# Get the message set in a language
EMethods.getConfiguration(String path);

Spoiler: Maintenance
Code (Text):
isMaintenanceActive()
Code (Text):
isWhitelisted(UUID uuid)
Code (Text):
addToWhitelist(CommandSender cs, OfflinePlayer target)
Code (Text):
removeFromWhitelist(CommandSender cs, OfflinePlayer target)
Code (Text):
setWhitelist(boolean value)

Spoiler: Censor
Code (Text):
addCensor(String word)
Code (Text):
removeCensor(String word)
Code (Text):
isCensored(String word)

Spoiler: AntiAd
Code (Text):
isAdBlocked(String word)
Code (Text):
blockAd(String word)
Code (Text):
unblockAd(String word)

Spoiler: GlobalMute
Code (Text):
# Get the globalmute state - boolean
EMethods.isGlobalMuteActive()
 

Spoiler: PlayTime
# Get the playtime data - integer
EMethods.getPlayTimeDAYS(Player p)
EMethods.getPlayTimeHOURS(Player p)
EMethods.getPlayTimeMINUTES(Player p)

Spoiler: Else
Code (Text):
# Get the registered players - integer
EMethods.getRegisteredPlayers()
Code (Text):
# Check if a event is enabled in events.yml - boolean
EMethods.isEventEnabled(Enum<EVENTS> Event)

Spoiler: Events
Spoiler: PlayTimeLevelUPEvent
Code (Text):
#Gets called whenever a players playtime increases by 1 hour

Player p - The player that is getting a level up
e.setCancelled(boolean value);
 

Spoiler: PlayerFirstJoinEvent
Code (Text):
#Gets called when the player joins the server for the first time

Player p - The player trying to chat
int id - Get the ID of the player
 

Spoiler: ChatCancelEvent
Code (Text):
#Gets called when the chat event gets cancelled

Player p - The player joining for the first time
Enum<CHAT_TYPE> Type (Censor, AntiAd)
 

Informational
Servers running this plugin:
Dev's Localhost :p
Rengobli.at (Test network [/server freebuild])​
PLEASE DO NOT REPORT BUGS IN THE COMMENTS, THEY WILL BE IGNORED.

Terms of Service
You agree with these by downloading.
You are not allowed to modify this plugin's code
You are not allowed to sell this plugin
You are not allowed to set yourself as the author of this plugin

Commands

Plugin details

Read from the plugin's own plugin.yml.

Quick facts

Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.

[Unmaintained] aEssentials is a free Minecraft Java mod. Compatible with Minecraft 1.12, 1.13, 1.14, 1.15 and newer. Downloaded 6,390 times (via Spigot). Download it and open it directly in the game.

Explore more