SimpleReport (tf)

*** Due to unwise and scummy decisions by Curse, my Bukkit Dev account will be inaccessible starting March 1st, 2018. Thus, I can no longer update any of my plugins here on the Bukkit Dev site. Please find the new repo for this plugin at the excellent SpigotMC site: https://www.spigotmc.org/resources/simplereport-tf.53324/ ***

What is it?

SimpleReport is a plugin that provides useful, simple server information in an instant. Minecraft/Bukkit/Spigot has no ingame command for listing info about entities on the server - that problem is what this plugin grew out of. Filling this gap, SimpleReport will provide handy info on the entities, players, and worlds of your server.

SimpleReport in action:

------------------------

Built for CraftBukkit/Spigot 1.12.X. It should be compatible with all 1.9+ versions.

------------------------

Setup

• Download the JAR to your plugins directory. Self explanatory for GUIs. For those using an Ubuntu/Debian terminal, use "wget jarurl" with the url to the jar file (go to the Files tab) in quotes. If you don't have access to the terminal the host is managing, you can try to use an FTP program to connect via SFTP and upload the jar file.

Configuration

• The only file in the data folder is the standard config.yml
• Config is very basic because it is virtually unneeded. You can use it to enable or disable certain types of information reporting.

Commands/How to Use

How to use the /srep command:

There are 3 distinct parts to the /srep command: /srep (1: choice of info) (2: object selector) (3: flags & filters). The (2) and (3) parts are optional, used to narrow down the information reported.

(1) Choice of Info:

SimpleReport can inform you of entities, players, and worlds. Thus, the options here are entities (or ents), players, and worlds.

(2) Object Choice:

Select a more specific target for information. You can select a world or player by name.

(3) Flags & Filters:

Flags add more information to your report and filters limit what is reported so that you can focus in on the data you need. Only the players and ents choices allow flags. Only the ents choice allow filters.

To use a flag, add it to the end of your command with a dash, like so: /srep players -all
To use a filter, add it to the end of your command with a plus, like so: /srep ents world +villager

You can use as many flags and filter in a single command as you want, in any order (it does not matter), but they all must be at the end of the command!

List of flags:

List of filters:

Example usages:

• /srep worlds   gives a summary of all worlds
• /srep worlds world   gives details on the world named "world"
• /srep ents   gives a summary of all entities
• /srep ents world   gives a summary of entities in the world "world"
• /srep ents world +zombie +skeleton -all -vitals   gives information on each individual zombie and skeleton in world "world", including health info
• /srep players world_nether   gives a summary of all players in the world "world_nether"
• /srep players -all -dist   gives individual details on all players across all worlds, including their distance to the command executor
• /srep ents world +cow +pig +sheep +rabbit +chicken -all -vitals -dist -extra   gives individual details on every cow, pig, sheep, rabbit, and chicken, including their health, distance to the command executor, and extra entity properties