Rastrum: Trails & Waypoints

Rastrum: Trails & Waypoints

Never get lost again. Craft the Waymark Lantern, set it down at home, and go explore. A line of sparks on the ground shows you the way back to it, or to where you died, to a marker on your map or to any coordinate. Only you see your sparks.

Rastrum is a server plugin: players install nothing.

How it works

1. Craft the Waymark Lantern at the Workbench: 2 wood trunks, 2 iron ingots and 1 yellow crystal shard.
2. Set it down where you want to come back to (crouch + right click). From there, your path is recorded as you walk.
3. Hold it and right click to open the Rastrum screen and pick where to go. The sparks follow the ground to your destination, and a pulse marks the spot once it is in range.

The Waymark Lantern

• On the ground, it is your way back. The sparks lead you home along the path you walked, and cut straight across where the ground allows.
• Only you can pick it up. If you place more than one, the latest one guides you.
• It is a real light. It lights up on the ground (F to light or put out). Unlit, it still marks the spot but does not guide.
• In your hand, right click opens the screen and Q lights it or puts it out. Lit, it shows your sparks; unlit, it hides them. In the Z slot it works like a torch.

Destinations

Destination	Where the sparks lead
Your lantern	Back to the lantern you placed in this world, along your path
Where I died	The spot of your last death in this world, since you joined
Map markers	Any marker you placed on your world map, by name
Coordinate	Any x and z you type (height does not matter)
Your destinations	Places you saved, for yourself ("Only me") or for your group ("My group")
Server destinations	Places the admin created, in the admin's own sections
Sections from other mods	Places other mods add, like the Oficium workshops (Oficium 0.3.0), nearest first

One destination at a time. The sparks run along the ground toward it. They point the way, they do not find a route: the arrow stops at the first obstacle, so walls and cliffs are up to you.

The Rastrum screen

Hold the lantern and right click, or type /trail:

• Go to: one click on a destination starts the guide. The current one is highlighted, with a Stop button next to it.
• Your lantern: where it is, how far, and a button to light it or put it out.
• More options: go to a coordinate, or clear your recorded path.
• My destinations: save the place where you stand, with a name and an icon, for yourself or for your group.
• Group: add players who are online; they stay in the group when they log off. Your group's destinations show up for every member as "From <name>".
• Language: each player picks English, Portuguese or the game's language for Rastrum.

Admin panel

/trail admin opens the server settings, in three tabs. Nothing is saved until you press Save, and changes apply right away, without a restart.

• Settings: the options below, plus the limits for players: destinations per player (default 5) and members per group (default 6).
• Sections: turn each section from other mods on or off, and create map sections.
• Destinations: create server destinations where you stand, with a name and an icon, grouped in your own sections.

Setting	Default	Range
Require lantern in hand to see the sparks	Off	On or off
Default language	Game	Game, English, Portuguese
Point spacing	1.5 blocks	0.75 to 4
Maximum path length	1200 points	100 to 5000
Line radius (how far around you the line shows)	32 blocks	8 to 64
Arrow length	32 blocks	8 to 64
Arrival distance	4 blocks	2 to 10

The panel shows the cost of each choice: a larger radius means more particles per player. The line is capped at 120 points per second per player.

Commands

Command	Who	What it does
/trail (or /rastrum)	Everyone	Opens the Rastrum screen
/trail back	Everyone	Follow your path back to your lantern
/trail death	Everyone	Follow the sparks to where you died
/trail mark <name>	Everyone	Follow the sparks to a map marker
/trail goto <x> <z>	Everyone	Follow the sparks to a coordinate
/trail stop	Everyone	Clear the current destination
/trail clear	Everyone	Erase your recorded path
/trail status	Everyone	Shows in chat whether your path is recording and where you are going
/trail admin	Admin	Opens the admin panel

Admin permission: flintdl.rastrum.command.trail.admin. OPs already have it.

Installation

1. Put Rastrum-<version>.jar in your server's mods folder.
2. Start the server. Rastrum keeps its files in mods/Flintdl_Rastrum/.

Updating is just replacing the jar.

What is saved

File	What it keeps
settings.json	The admin panel settings
languages.json	Each player's language choice
lanterns.json	Each lantern on the ground and who owns it
server.json	The admin's sections and server destinations
places.json	Each player's own destinations
groups.json	The groups and their members

The recorded path and the death spot live only in memory, and are erased when the player leaves the server. The lantern stays: when the player comes back, "To your lantern" leads straight to it, and the path starts recording again from there.

Known limits

• The path and the death spot are not saved: leaving the server or a restart erases them. The lantern is saved, and it is what brings you back.
• The sparks follow the ground but do not plan a route around walls, cliffs or water.
• The translations have not been reviewed by native speakers yet.

For mod makers

Your mod can add a section to Go to. Ship a JSON file in your own jar at Server/Rastrum/Sections/<Name>.json (file name: 1 to 48 of A-Z a-z 0-9 _ -). Rastrum reads it when the server starts; without Rastrum, the file is simply ignored. Nothing in it runs code.

Field	What it is
Name	The section title, up to 24 characters. About 20 fit on the screen. Letters, digits, Latin-1 accents and · only: other symbols show as "?" in the game
NameKey	Optional. A translation key from your own .lang files; without it, Name is used
Icon	Marker or Workshop
MarkerProvider	The id of a world map marker provider your mod registers. Rastrum lists what it shows each player, so players only see what their map shows them. The game's own providers are not allowed
Points	Or a fixed list of 1 to 50 places, each with World, X, Y (optional), Z and Name

Use exactly one of MarkerProvider or Points. An unknown field rejects the whole file. Limits: 64 KB per file, 16 files per mod and 64 sections in total. Each section shows the 20 nearest places.

This is how Oficium adds its workshops:

{
  "Name": "Workshops",
  "NameKey": "oficium.ui.rastrumWorkshops",
  "Icon": "Workshop",
  "MarkerProvider": "oficium_workshops"
}

Versions

Rastrum	Hytale
0.3.0	0.7.x (tested on 0.7.7)
0.2.0	0.7.x (tested on 0.7.6)
0.1.0	0.7.x (tested on 0.7.6)

Each file is marked with the Hytale update it was tested on. Hytale's server API changes between updates, so use the file that matches your update.

Português

O Rastrum é um plugin de servidor para Hytale: os jogadores não instalam nada.

• Faça a Luminária-marco na bancada de trabalho: 2 troncos, 2 barras de ferro e 1 fragmento de cristal amarelo.
• Ponha a luminária no chão onde quer voltar (agachado + botão direito). Dali em diante o seu caminho é gravado, e uma linha de faíscas no chão mostra a volta até ela. Só você vê as suas faíscas e só você pega a sua luminária.
• Com a luminária na mão, o botão direito abre a tela: ir até a luminária, até onde você morreu, até um marcador do mapa, até uma coordenada ou até os lugares que outros mods acrescentam, como as oficinas do Oficium.
• A luminária é uma luz de verdade: F acende e apaga no chão, Q na mão. Apagada no chão, ela marca o lugar mas não guia.
• Cada jogador salva os próprios destinos ("Só eu" ou "Meu grupo") e monta um grupo com quem está online.
• O administrador ajusta tudo no painel do jogo (/trail admin), sem reiniciar, e cria seções e destinos do servidor.
• Outros mods podem pôr seções no "Ir para" com um arquivo JSON no próprio jar (o formato está em "For mod makers").
• Os textos estão em português e inglês, e cada jogador escolhe o idioma do Rastrum na tela.

License

Free to use on any number of servers, including monetized ones. You may not republish, redistribute, sell or distribute modified versions of Rastrum. The full text is in the license on this page.

Support

If Rastrum makes your server better, you can support its development on Ko-fi.

Rastrum is not affiliated with or endorsed by Hypixel Studios.