Build a little corner of the network.
The Lantern handbook. From your first page to a published Lua application, with examples you can copy and run.
On this page
Your first website starts here.
Lantern is a terminal browser and website platform for CC:Tweaked. Websites contain structured JSON pages and, optionally, a server-side Lua handler. They are not HTML pages. Visitors never execute your downloaded Lua on their own computers.
You can create files on a Minecraft computer, preview them locally, then either serve them over a modem or upload them to Lantern Hub. The same page format and builder API work in both paths.
Choose where your site lives.
| Local modem site | Lantern Hub site | |
|---|---|---|
| Address | ln://my-site/ | hub://my-site/ |
| Server | Your Minecraft computer | Cloud hosting |
| Needs loaded chunk | Yes, while serving | No, after upload and publication |
| Networking | Modems and seeded identities | HTTPS allowed by the Minecraft server |
| Creator account | Not required | GitHub sign-in |
| Lua authority | Locally installed code has computer privileges | Restricted context in a fresh isolated VM |
A path through the handbook.
- 1Install Lantern and create a site from a template.
- 2Learn JSON pages, layouts and links.
- 3Add a Lua handler for dynamic responses.
- 4Build forms and store data on POST requests.
- 5Validate, preview and publish.
Written for the development preview.
The target is CC:Tweaked 1.120.2. CCEmuX testing has used 1.120.0; real Minecraft acceptance on the target version is still required.
Found a mismatch? Include the exact error, runtime version and a small example with secrets removed.