SANDBOX — this is a test environment. No servers are actually deployed and no real payments are charged.
Source-checkedAdmin & protection

MemCheck

by Bobcat00 · for Minecraft

Output CraftBukkit/Spigot memory statistics

4.6KDownloads
4 yr agoLast updated
Spigot · PaperLoaders
1.19Latest game version

About MemCheck

From SpigotMC

Output CraftBukkit/Spigot memory statistics

Description

Want to find out how much heap space your server really needs? Want to check that your hosting provider is giving you what you paid for? Other plugins, such as Essentials, will provided memory statistics, but they're probably not what you really want to know. MemCheck provides the amount of heap used and the total amount of free heap space in real time.

MemCheck adds a /mem command which outputs the amount of used heap in MB and as a percentage of the maximum heap size, and the total free heap in MB. It also provides statistics about the Java "Metaspace" use. As a bonus, the server's current TPS as calculated by Essentials, the CPU load, the average garbage collection time in the previous minute, and the total number of loaded chunks are shown.

At startup, the number of processors (threads), total physical memory, maximum heap, server view distance, server simulation distance, Java garbage collector name(s), and Java command line options are written to the server log file.

This allows the server owner to see how much memory is being used and if the memory available for additional objects is too small, too big, or just right.

Details

I discovered that the memory values reported by Essentials come directly from Java, and don't really show what a server owner needs to know. The explanation will be easier with the help of the following diagram I stole from Stackoverflow:

java_memory2.png

Java provides, and Essentials reports, the three values shown in red. This is not really what a server owner needs. The more relevant values are the two shown in blue at the bottom: used, which is the amount of the heap currently used by the program, and totalFree, which is the amount of memory available for additional objects on the heap. More information is shown below.

Commands

/mem - This outputs the current memory statistics. Note that the heap is constantly changing, so you'll see the values change from second to second, as more objects are allocated or the Java garbage collector runs.

mem_sample2.png

The output includes the following:

  • General:
    • TPS - If you're also running Essentials, the current TPS will be output.
    • CPU - The current CPU load as a percentage of all available cores.
    • GC - The average time needed to run the garbage collector, updated once per minute.
    • Chunks - The total number of loaded chunks from all worlds.
  • Heap:
    • Heap used - The current amount of heap space used by your server.
    • Free - The amount of additional heap space available, up to the maximum allowed.
    • Alloc - The amount of heap space currently allocated. This is useful if you specify an -Xms values that is less than -Xmx. It tells you how much heap space Java thinks is necessary.
  • Metaspace:
    • Metaspace used - The current amount of Metaspace used by your server.
    • Free - If a maximum value for the Metaspace has been given, this shows the amount which is free.
    • Alloc - The amount of Metaspace currently allocated.
Permissions

memcheck.mem - Required to use the mem command. Defaults to op.

Configuration

None.

Miscellaneous

This plugin uses the bStats metrics system to provide anonymous usage data. You may opt-out globally by changing plugins/bStats/config.yml. The metrics are available at https://bstats.org/plugin/bukkit/MemCheck

[​IMG]

Highlights

From source data

Game versions

Supports 8 Minecraft versions, the newest being 1.19.

Loaders

Runs on Spigot and Paper.

Footprint

Rated a light load on a server.

MemCheck on Nxeon

From our catalogue
One-click install
Supported on Nxeon Minecraft servers, for Paper servers. We download it from SpigotMC, place it, and restart the server.
Server side
Required on the server
Server type needed
Spigot, Paper
Server load
light
Smallest plan we suggest
Minecraft — 1.5 GB (2 GB RAM). This follows our own load rating above, not a benchmark.
Latest build
1.03, released 2022-10-01

Game versions by loader

LoaderGame versionsNewest
Paper1.12 to 1.19 (8 versions)1.19
Spigot1.12 to 1.19 (8 versions)1.19

From 4 recorded builds of MemCheck.

Recent builds

BuildReleasedGame versionsLoaders
1.032022-10-011.12 to 1.19 (8 versions)Spigot, Paper
1.022021-10-22n/aSpigot, Paper
1.012019-10-10n/aSpigot, Paper
1.002019-06-30n/aSpigot, Paper

Run MemCheck on a Minecraft server

Pick a server or deploy a new one above; it is installed in one click.

What kind of mod it is

From the catalog
Listed on SpigotMC as “Admin”

Admin & protection

Permissions, moderation, anti-cheat and land protection for the people running the server.

Runs on your server

From source side support

SpigotMC lists MemCheck as required on the server. Check its SpigotMC page to see whether players need it too.

Compatibility

Game
Minecraft
Loaders
SpigotPaper
Runs on
Serverrequired on the server
Game versions
1.19 and 7 earlier
Requires
One-click install needs a Paper server.

Verified at the source

  • ✓SpigotMCOfficial listing, checked 2026-10-16Open ↗
  • ✓AuthorBobcat00, as published on SpigotMC
  • ✓LicenseNot published by the sourceFree

MemCheck, answered

Generated from the mod’s own source data.

Do my players need to install MemCheck?

SpigotMC lists MemCheck as required on the server. Check its SpigotMC page to see whether players need it too.

Which loaders does it support?

Spigot and Paper.

Is it free?

Yes. MemCheck is free to download from SpigotMC.

How do I add it to my Nxeon server?

Use “Add to a server” on this page, or open NxLabs from your dashboard. We install it, restart your server and switch it on.

NxLabs

Run MemCheck on a Minecraft server.

Deploy in about a minute from $4.20 a month, then add MemCheck in one click.