Back to mods

CurseForge · Minecraft mod

JSON-Manage

A Forge-compatible take on the JSONAPI Bukkit plugin

Choose a version Pick your version below, then grab the matching file.

Quick answer

Which JSON-Manage release should I use?

Updated 12 years ago
Latest stable file JSONManage-1.7.2-1.0.0.jar
Game version 1.7.4, 1.7.2
Loader Not required

JSON-Manage JSONManage-1.7.2-1.0.0.jar targets 1.7.4, 1.7.2. The project page does not say whether this file belongs on the client, dedicated server, or both. No extra mods listed for this file.

Where it goes

Is JSON-Manage required on the client, server, or both?

The project page does not say whether this file belongs on the client, dedicated server, or both.

Client Source doesn’t say
Dedicated server Source doesn’t say
Loader for this release No loader listed
Required install it here Optional supported, not mandatory Not supported do not install here Source doesn’t say do not assume

The source does not explicitly classify this release as client-only or server-only.

What else does JSON-Manage JSONManage-1.7.2-1.0.0.jar need?

JSONManage-1.7.2-1.0.0.jar. Change the file and its required mods may change too.

No extra mods listed for this file

This file does not list any required mods. Do not add a library just because a different file uses it.

This file does not list any required or optional mods.

Before you install it

Add JSON-Manage without breaking your instance.

Built for JSON-Manage JSONManage-1.7.2-1.0.0.jar. Pick another file and the loader, install side or required mods may change.

  1. 01

    Stick to this file

    Use JSONManage-1.7.2-1.0.0.jar. It targets 1.7.4, 1.7.2; another release may have different loader, side or dependency requirements.

  2. 02

    Bring the mods it needs

    This file does not list any required mods. Do not add a library just because a different file uses it.

  3. 03

    Put it on the correct side

    The project page does not say whether this file belongs on the client, dedicated server, or both.

  4. 04

    Pick the file you checked

    Use the “Get this file” button beside JSONManage-1.7.2-1.0.0.jar. It opens that exact file at the source.

About this project

What does JSON-Manage add?

JSON-Manage

As a server owner myself, I know how difficult it can be when there are sever issues while you're not at your computer, or how difficult it is to manage a server from a mobile device (i.e. impossible). I decided to write this mod up as a way to help ease some of the pain of managing a server on the go. Through a JSON API, any end client can connect to the server and preform some of the day to day management tasks that normally would require something more arduous like ssh+screen or a VNC connection to achieve.

My hope is that this mod will help all the server owners out there alleviate some of the stress we've all felt before when something's gone wrong with the server and we just left home to go shopping.

Documentation:

No API is complete without documentation, and this one is certainly no different. The JSON format is as follows:

{"command":"[command]","args":{[args]}}

The args field is where data is passed to/from the server backend as well as return codes and additional information.

Currently Supported Commands

  1. Sending a message to a specific player (SINGLE_MESSAGE)
  2. Broadcasting a message to the entire server (BROADCAST_MESSAGE)
  3. Getting a list of currently connected players (GET_PLAYERS)
  4. Get memory usage statistics from the server (USAGE)
  5. Get TPS data from all dimensions (GET_TPS)
  6. Get a list of installed mods (GET_MODS)
  7. Stop the server (STOP_SERVER)
  8. Start the server (START_SERVER)
  9. Restart the server (RESTART_SERVER)
  10. Get the command line arguments (GET_CMD_ARGS)
  11. Set the command line arguments (SET_CMD_ARGS)
  12. Set the initial stack size (-Xms option) (SET_INIT_STACK_SIZE)
  13. Set the maximum stack size (-Xmx option) (SET_MAX_STACK_SIZE)
  14. Get Minecraft property from server.properties (GET_MC_PROP)
  15. Set Minecraft property from server.properties (SET_MC_PROP)

Table 1: English descriptions of commands and arguments

Command English Description Arguments Returns
USAGE Returns maximum available memory, currently allocated memory, and free memory for the current Java VM in bytes None Three strings: "maxMemory", "allocatedMemory", and "freeMemory"
GET_PLAYERS Returns a list of currently connected players None List of strings: "players"
STOP_SERVER Stops the server None Success/Failure : "ret_code"
START_SERVER Starts the server None Success/Failure : "ret_code"
RESTART_SERVER Restarts the server None Success/Failure : "ret_code"
SINGLE_MESSAGE Sends a message to a specific player "to" and "msg" Success/Failure : "ret_code"
BROADCAST_MESSAGE Broadcasts a message to the whole server "msg" Success/Failure : "ret_code"
GET_MODS Returns the list of currently installed mods None List of strings: "mods"
GET_TPS Returns TPS data for all loaded dimensions None Map of ints to strings: "tps_data"
GET_CMD_ARGS Returns current command line arguments None String: "cmd_args"
SET_CMD_ARGS Sets command line arguments (does not take effect until after server restart) "cmd_args" Success/Failure : "ret_code"
SET_MAX_STACK_SIZE Sets the maximum stack size (-Xmx VM arg, does not take effect until after server restart) "max_stack_size" (Value is string to go after -Xmx, ex: "max_stack_size":"1024M") Success/Failure : "ret_code"
SET_INIT_STACK_SIZE Sets the initial stack size (-Xms VM arg, does not take effect until after server restart) "init_stack_size" (Value is string to go after -Xms, ex: "max_stack_size":"1024M") Success/Failure : "ret_code"
GET_MC_PROP Gets a Minecraft property from the server.properties file "mc_property" String: "property_value"
SET_MC_PROP Sets a Minecraft property (does not take effect until after server restart) "mc_property" and "property_value" Success/Failure : "ret_code"

Table 2: Sample JSON for currently supported commands

Command Sample Input Sample Return
USAGE {"command":"USAGE"} {"command":"USAGE","args":{"ret_code":"SUCCESS"}}
GET_PLAYERS {"command":"GET_PLAYERS"} {"command":"GET_PLAYERS","args":{"players":["conman2305"],"ret_code":"SUCCESS"}}
STOP_SERVER {"command":"STOP_SERVER"} {"command":"STOP_SERVER","args":{"ret_code":"SUCCESS"}}
START_SERVER {"command":"START_SERVER"} {"command":"START_SERVER","args":{"ret_code":"SUCCESS"}}
RESTART_SERVER {"command":"RESTART_SERVER"} {"command":"RESTART_SERVER"}
SINGLE_MESSAGE {"command":"SINGLE_MESSAGE","args":{"to":"conman2305","message":"Hello World!"}} {"command":"SINGLE_MESSAGE","args":{"ret_code":"SUCCESS"}}
BROADCAST_MESSAGE {"command":"BROADCAST_MESSAGE","args":{"message":"Hello World!"}} {"command":"BROADCAST_MESSAGE","args":{"ret_code":"SUCCESS"}}
GET_MODS {"command":"GET_MODS"} {"command":"GET_MODS","args":{"mods":["Minecraft Coder Pack","Forge Mod Loader","Minecraft Forge","JSONManage"],"ret_code":"SUCCESS"}}
GET_TPS {"command":"GET_TPS"} {"command":"GET_TPS","args":{"tps_data":{"0":"2.565826812878905","1":"20.0","-1":"20.0"},"ret_code":"SUCCESS"}}
GET_CMD_ARGS {"command":"GET_CMD_ARGS"} {"command":"GET_CMD_ARGS","args":{"ret_code":"SUCCESS","cmd_args":"-Xincgc -Dfml.ignoreInvalidMinecraftCertificates\u003dtrue "}}
SET_CMD_ARGS {"command":"SET_CMD_ARGS","args":{"cmd_args":"-Xmx512M -Xms512M -Xincgc -Dfml.ignoreInvalidMinecraftCertificates\u003dtrue"}} {"command":"SET_CMD_ARGS","args":{"ret_code":"SUCCESS"}}
SET_MAX_STACK_SIZE {"command":"SET_MAX_STACK_SIZE","args":{"max_stack_size":"1024M"}} {"command":"SET_MAX_STACK_SIZE","args":{"ret_code":"SUCCESS"}}
SET_INIT_STACK_SIZE {"command":"SET_INIT_STACK_SIZE","args":{"init_stack_size":"1024M"}} {"command":"SET_INIT_STACK_SIZE","args":{"ret_code":"SUCCESS"}}
GET_MC_PROP {"command":"GET_MC_PROP","args":{"mc_property":"server-port"}} {"command":"GET_MC_PROP","args":{"property_value":"25565","ret_code":"SUCCESS"}}
SET_MC_PROP {"command":"SET_MC_PROP","args":{"mc_property":"server-port", "property_value":"25566"}} {"command":"SET_MC_PROP","args":{"ret_code":"SUCCESS"}}

More Information:

This is an open source mod, and is available on github at: https://github.com/conman2305/JSON-Manage

Any issues and feature requests should also be made on that same GitHub.

Project description from CurseForge.

Pick your setup

JSON-Manage by Minecraft version and loader

Choose the version and loader you play, then open the matching release.

2 available setups

Check the dependencies, then try the file in a copied instance before changing a world you care about.

Recent files

JSON-Manage versions and loaders

2 of 2 releases match

Looking for an older file? The official CurseForge project page is in Resources.