> For the complete documentation index, see [llms.txt](https://unknown-56-works.gitbook.io/luigiscreen/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://unknown-56-works.gitbook.io/luigiscreen/getting-started/requirements.md).

# Requirements

Check every requirement before installing LuigiScreen.

## Minecraft server

| Requirement       | Supported value  |
| ----------------- | ---------------- |
| Server software   | Paper            |
| Minecraft version | `1.21.11`        |
| Java              | `21`             |
| CPU architecture  | x86\_64 / amd64  |
| Operating system  | Windows or Linux |

LuigiScreen is distributed as a Paper/Bukkit plugin, but its current build targets Paper APIs. Plain Spigot and CraftBukkit servers, Folia, macOS, ARM64 and older Minecraft versions are not currently supported.

## Required plugin

Install MapEngine `1.8.12` before starting the server.

LuigiScreen declares MapEngine as a required dependency. If MapEngine is missing or incompatible, Paper will not enable LuigiScreen correctly.

## Optional RTMP software

You only need these applications when using an RTMP source:

* [MediaMTX](https://mediamtx.org/) as the media server
* [OBS Studio](https://obsproject.com/) or another RTMP publisher

Local videos, images and GIFs do not require OBS or MediaMTX. MJPEG only requires a reachable MJPEG endpoint.

MediaMTX can run:

* On the Minecraft server computer
* On another computer in the same LAN
* On a computer reachable through a public IP
* Across a VPN such as Tailscale or ZeroTier
* On an external VPS

## RTMP network requirements

The default LuigiScreen MediaMTX port is TCP `55556`.

Only the machine that runs MediaMTX listens on this port. Do not open or forward the port on unrelated computers.

## Hosting-provider warning

Minecraft hosting panels usually allow only plugin JAR files and Minecraft ports. They often do not allow running `mediamtx` or Docker beside the server.

In that situation:

1. Run MediaMTX on a VPS or another computer.
2. Use `/screen mediamtx hosting`.
3. Configure LuigiScreen to read the remote RTMP stream.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://unknown-56-works.gitbook.io/luigiscreen/getting-started/requirements.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.