WhatsUp
by lukebemish
WhatsUp lets datapacks query a web endpoint at a set interval and run functions based on the returned result, on servers running Forge or Quilt.
What it does
Datapacks define listeners in data files under whatsup/listeners/. Each listener holds a URL to query and an integer for the number of seconds between queries. Based on the response, a listener can list actions and run a function whose resource location is given in the listener, with a predicate that checks the endpoint's result before the function executes. Listeners can also chain to other listeners, and a listener's functions run in the overworld by default unless a list of dimensions is provided.
Predicates are Groovy scripts stored under whatsup/predicates/. The script environment gives access to a context object that exposes the unprocessed response text, the response parsed as JSON or a map, and the data storages the listener may read or mutate. The optional property names map to resource locations for command data storage access. A whatsup command allows testing datapacks and running a listener immediately. The environment is server-side only, so players join without installing anything, and the mod is released under the GNU Lesser General Public License v3.0 or later as open source. Builds cover 1.19.4 – 1.20.1, with 1.2.0 for 1.20.1 as the latest file on both Forge and Quilt.
Key features
Scheduled web queries
Listeners poll a configured URL at an interval given in seconds, so datapacks react to outside data over time.
Result-based functions
A predicate is checked against the endpoint's response, and the listed function runs only when the predicate passes.
Chained listeners
A listener can list other listeners to run after it, letting one query trigger a sequence of follow-up checks.
Groovy predicates
Predicates are Groovy scripts with a context object that exposes the raw response, parsed JSON and optional storage access.
Testing command
A command runs a listener immediately, so datapack authors can check their setup without waiting for the interval.
Compatibility
Latest build for each game version and loader.
Only full game releases are shown. This mod publishes no snapshot builds.
Requirements
Dependencies declared by the latest file for each loader.
Required 1
Use cases
Live data in a world
Server owners can tie a datapack to an external web service, such as a status page or a feed, and reflect its values in game.
Who it’s for: Datapack authors and server owners who want game events to depend on the result of a web request. Players on the server need nothing extra.
Questions
Does WhatsUp need to be installed on the client?
Which loader does WhatsUp support?
Does WhatsUp work with Fabric?
In the catalog
WhatsUp is one of 3,514 Library mods on ModsFinder, and one of 1,576 Library mods for Forge. 34,764 mods support Minecraft 1.20.1.
More from lukebemish
Similar mods
What the author says
WhatsUp is a tool for datapacks that allows servers to query a provided web endpoint at a given frequency, and execute functions (the normal.mcfunction type) based on the results returned by that endpoint. Predicates are stored at data/ /whatsup/predicates/.groovy, and are groovy scripts. The groovy environment the…
Official listing
- Modrinth page
- modrinth.com/mod/whatsup
- Owner
- lukebemish
- Published
- 2023-06-13
- Updated on Modrinth
- 2023-08-21
- Facts verified
- 2026-10-15
