Essential Userdata Cleaner
What is this plugin?
What is this plugin?
Essential userdata cleaner is, as the name suggests, a plugin that can clean your userdata files. It was originally designed to remove “fake” userdata files, that occurred when Leaderheads tried to create and teleport NPC’s.
Read md678685 from the EssentialsX team reason to why this is happening here:
Spoiler: md678685
![[IMG]](//proxy.spigotmc.org/39552c5662b5d3c6f40cb815c518b844d3ac0b68?url=http%3A%2F%2Fi.imgur.com%2Fc3DfD9V.png)
![[IMG]](http://proxy.spigotmc.org/39552c5662b5d3c6f40cb815c518b844d3ac0b68?url=http%3A%2F%2Fi.imgur.com%2Fc3DfD9V.png)
If this is not what you were looking for, but just simply a plugin to delete userdata files which are older than X days, this plugin can just as easily do that. Simply disable all other checks than lastModified in the config.
Why should you use it
This plugin efficiently cleans up old/invalid files.
The most notable gain is when you use /baltop or /seen <ip>, where Essentials looks through every file. As you can guess, the more files, the slower the search.
This also gives you more free space.
When tested, this plugin deleted files for around 35 MB. This may not sound like much, but this was files generated in a few months. Imagine a server running on the second or third year. After this, then add multiple servers, as most networks have. It can easily run up in gigabytes.
How does it work?
If you are interested in the source code, it can be found
here.
If you just want a quick resume of how it works, take a look at the flowchart below. Here every step in the progress is explained.
Spoiler: Flowchart
![[IMG]](//proxy.spigotmc.org/bbdda0e3c8e28d8bc71975e054d41c6093e38c66?url=https%3A%2F%2Fi.gyazo.com%2F6f7fb52ffd5b98d5f14a290b44ffa6a4.png)
![[IMG]](http://proxy.spigotmc.org/bbdda0e3c8e28d8bc71975e054d41c6093e38c66?url=https%3A%2F%2Fi.gyazo.com%2F6f7fb52ffd5b98d5f14a290b44ffa6a4.png)
There are some other features that aren't shown in the flowchart.
You can take a look at the default config here
Spoiler: Config.yml
Code (Text):
# Commands:
# /essclean purge - Starts to purge all userdata files (move or delete, depends on settings)
# /essclean confirm - Confirms your purge request, and actually starts.
# /essclean cancel - Cancels your purge request, and the purge wont start!!
# /essclean debug - Enables/disable debug messages to the console
# /essclean reload - Reloads the config.yml, and applies changes.
# Permissions:
# EssUserDataCleaner.use - Allow user to use the plugin.
# Message to send players with no permission. (Standard is default Minecraft unknown command)
# To use color codes, use § and not &. (Example: "§eMessage" instead of "&eMessage")
noPermMsg: '§fUnknown command. Type "/help" for help'
# Max file size in bytes. If the file is bigger it can't be affected in no way.
# To disable, set to -1
maxSize: 100
# Words or sentences the config CAN'T contain. If they contain anything listed below, it won't be affected
# NB: Is case sensitive
# To 'disable', add ’disabled’ as the only entry
cantContain:
- 'homes'
- 'ipAddress'
- 'lastAccountName'
- 'timestamps'
- 'money'
# When should the plugin effect files
# start: When the server starts
# command: When admins run a command to manually do it (The command will always work, no matter the selection below)
# stop: When the server shuts down.
when: 'command'
# If you have set "when" to start, you can specify how many seconds delay from when
# the plugin is enabled, to it starts purging the files here
delay: 10
# Number of days that must have been passed since the file last was modified
# To disable, set to -1
lastModified: 30
# Compare files to usermap.csv - If usermap.csv contains filename, it won't be deleted
# To disable, set to false
compareUsermap: true
# What should happen to the affected files
# move: The folders are moved to "EssUserDataCleaner/backup/" and zipped. (Default)
# delete: The files are permanently deleted, and can't be recovered (DANGEROUS)
todo: 'move'
# Log to the console every file moved/deleted
inform: true
# Only accept commands from console
consoleOnly: false
# /essclean purge - Starts to purge all userdata files (move or delete, depends on settings)
# /essclean confirm - Confirms your purge request, and actually starts.
# /essclean cancel - Cancels your purge request, and the purge wont start!!
# /essclean debug - Enables/disable debug messages to the console
# /essclean reload - Reloads the config.yml, and applies changes.
# Permissions:
# EssUserDataCleaner.use - Allow user to use the plugin.
# Message to send players with no permission. (Standard is default Minecraft unknown command)
# To use color codes, use § and not &. (Example: "§eMessage" instead of "&eMessage")
noPermMsg: '§fUnknown command. Type "/help" for help'
# Max file size in bytes. If the file is bigger it can't be affected in no way.
# To disable, set to -1
maxSize: 100
# Words or sentences the config CAN'T contain. If they contain anything listed below, it won't be affected
# NB: Is case sensitive
# To 'disable', add ’disabled’ as the only entry
cantContain:
- 'homes'
- 'ipAddress'
- 'lastAccountName'
- 'timestamps'
- 'money'
# When should the plugin effect files
# start: When the server starts
# command: When admins run a command to manually do it (The command will always work, no matter the selection below)
# stop: When the server shuts down.
when: 'command'
# If you have set "when" to start, you can specify how many seconds delay from when
# the plugin is enabled, to it starts purging the files here
delay: 10
# Number of days that must have been passed since the file last was modified
# To disable, set to -1
lastModified: 30
# Compare files to usermap.csv - If usermap.csv contains filename, it won't be deleted
# To disable, set to false
compareUsermap: true
# What should happen to the affected files
# move: The folders are moved to "EssUserDataCleaner/backup/" and zipped. (Default)
# delete: The files are permanently deleted, and can't be recovered (DANGEROUS)
todo: 'move'
# Log to the console every file moved/deleted
inform: true
# Only accept commands from console
consoleOnly: false
Commands and permissions
There aren’t many commands or permissions.
But the few there exist, you can see here
![[IMG]](http://proxy.spigotmc.org/dbd83957e6ac2a2d6a195c37ad89e997e7d94b7d?url=https%3A%2F%2Fi.gyazo.com%2Fa95dd18151ab4df81684904fc4aabdf8.png)
Dependencies
This plugin doesn’t require any dependencies, but of course, you can’t delete files that don’t exist. Therefore you must previously have had Essentials(X) installed if you don’t already have it.Quick facts
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 1.8, 1.9, 1.10
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Spigot — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
Essential Userdata Files Cleaner is a free Minecraft Java mod. Compatible with Minecraft 1.8, 1.9, 1.10, 1.11 and newer. Downloaded 596 times (via Spigot). Download it and open it directly in the game.