scarpet-webserver

Webservers are defined in a scarpet-webserver.json config file, which the mod creates with a sample on first load. Each webserver is set up with its own unique id and port, and the example config shows how several servers can be listed together. The routes of a server are created by the script that starts it, and the server runs for as long as the script handles it.

Route callbacks receive a request parameter that carries the request values and details. A response is a value returned from the callback, and in most cases the body is an HTML page sent back to the browser. The mod adds two new value types: a map of header names to values, where a header with several values is returned as a list of strings, and a connection value that exposes the protocol, HTTP version, scheme, whether the connection is persistent or secure over HTTPS, and a unique id for the connection within the server lifetime. Values from a request are read with the query operator, since some of them are maps.

Carpet is a required dependency. The mod runs on the server only, so players join without installing it. It is published for Fabric alone, with files for 1.17 – 26.3 under the Apache License 2.0, and its source code and issue tracker are public. Snapshot builds are published as well.