Web-API
A RESTful web API & admin panel for Minecraft Sponge
About
This plugin provides a RESTful web API to manage a Sponge server. This can be used to perform various administrative tasks through the web, or provide dynamic content for users.
It also adds an admin panel with which a minecraft server can easily be managed, including running commands, chatting, managing players, destroying entities, a map & much more.
Features
Provides an AdminPanel to manage your minecraft server and a RESTful webserver with:
- General information about the server
- History for
- Chat
- Commands
- WebHooks that execute
- on minecraft events (like players joining, chat, death, etc.)
- when calling certain command (supports parameters)
- on custom events (e.g. from other plugins)
- List, get details about and manipulate
- Players
- Worlds
- Entities
- Tile entities
- Plugins
- Blocks
- Information about loaded classes
- Arbitrary command execution (like using the server console)
- Custom serializers to determine how data is turned into JSON
- Permissions for each endpoint
- An API for other plugins to expose their own endpoints easily
Installation
- Setup a Sponge server (Sponge Vanilla & SpongeForge supported)
- Add this mod to the mods folder
- Start the server
- Configure the config files to your needs.
- Use
sponge plugins reloadto import your config changes to the server without restarting. (see the docs below for more information)
Tutorials & Documentation
Go here to see a list of various documentations and tutorials
To use the Web-API, you will most likely be writing some form of client or server that interacts with it. Client libraries for various languages are available at:
Request / Response types
The Web-API supports JSON and XML data formats for requests and responses.
Specify the Content-Type header to explain what content type you are sending, and
use the accept header to tell the Web-API what content type to return to you.
Yes, you can send XML and get JSON in response, or the other way around if you want.
Routes
When accessing the docs site (by default http://localhost:8080/docs) a documentation of all the methods will show up. This can be used as a starting point to explore the supported routes. You can also find the same documentation here.