Releases: itsFrankV22/tShock-LiveMap_MapPNG
Release list
v1.3.0
🎉 LiveMap_MapPNG v1.3.0
New major release featuring a real-time WebSocket map viewer, modular code structure, chunked streaming, and more configuration options for your Terraria server world PNG exporter!
🚀 Main Features
- Generate a PNG map of the current world using
/genmap. - Colors for tiles, walls, and liquids based on type, paint, and height.
- Background gradient to visually distinguish altitude.
- Automatic export every X minutes (now configurable in
tshock/livemap/config.json). - Auto-update checking with notifications in the console.
- Full telemetry for statistics and error reporting (can be disabled or adapted in code).
- REST API endpoints
/map/base64: Get the latest PNG map encoded as base64 (requirestshock.rest.mappermission)./map/report: Report errors manually to telemetry (requirestshock.rest.adminpermission).
- NEW: WebSocket server for real-time map visualization
- Live map updates, chunked streaming for browsers or apps.
- See
browserConsoleTest.mdfor a ready-to-use JavaScript viewer example!
- NEW: Modular project structure
- Logic split into folders:
Export/,Colors/,Extras/,REST/,WebSocket/,Config/.
- Logic split into folders:
- NEW: Configurable options
- All main options (auto-save interval, WebSocket port) are now in
tshock/livemap/config.json.
- All main options (auto-save interval, WebSocket port) are now in
🆕 What’s new in v1.3.0
- WebSocket support: Stream the map in real time to browsers or custom tools.
- Chunked map updates: Efficient, partial updates instead of sending the whole map each time.
- JavaScript browser viewer: See
browserConsoleTest.mdfor a working example. - Modularized code: Plugin is now easier to extend and maintain.
- Improved config management: Easily change export interval or WebSocket port without editing C# code.
- Better error handling and telemetry: Robust reporting (can be disabled).
- English code comments and docs: Improved code readability and maintainability.
- Bugfixes and performance improvements.
🛠️ Installation
- Download the attached
.dllfile. - Place it in your server’s
/ServerPluginsfolder. - Restart your server.
- Run
/genmapin chat (requiresmap.exportpermission). - (Optional) Open your browser and use the script in
browserConsoleTest.mdto view your map in real time!
📸 Example Output
The map includes a background gradient for better visualization and now can be streamed live!
ℹ️ Notes
- The generated file will be at
/Map/worldMap.pngin your server root. - All main settings are now in
tshock/livemap/config.json. - See READMEes.md for detailed instructions in Spanish, or README.md for English.
- Now you can access the map programmatically via REST API or in real time via WebSocket.
- The plugin is a work in progress – contributions and improvements are welcome!
- Fork the repo if you want to build your own map viewer frontend!
Author: FrankV22
Repository: https://github.com/itsFrankV22/tShock-LiveMap_MapPNG
Note
I use Telemetry in all my plugins. By using them you agree to send development information. No information will be public.
v1.2.0
🎉 LiveMap_MapPNG v1.2.0
New stable release with REST API support and improved telemetry for exporting your Terraria server world as a PNG map, quickly and easily.
🚀 Main Features
- Generate a PNG map of the current world using
/genmap. - Colors for tiles, walls, and liquids based on type, paint, and height.
- Background gradient to distinguish altitude visually.
- Automatic export every 5 minutes (modifiable in the code).
- Auto-update checking with notifications in the console.
- Full telemetry for statistics and error reporting (can be disabled or adapted in code).
- NEW: REST API endpoints
/map/base64: Get the latest PNG map encoded as base64 (requirestshock.rest.mappermission)./map/report: Report errors manually to telemetry (requirestshock.rest.adminpermission).
🛠️ Installation
- Download the attached
.dllfile. - Place it in your server’s
/ServerPluginsfolder. - Restart your server.
- Run
/genmapin chat (requiresmap.exportpermission).
📸 Example Output
The map includes a background gradient for better visualization.
ℹ️ Notes
- The generated file will be at
/Map/worldMap.pngin your server root. - See READMEes.md for detailed instructions in Spanish, or README.md for English.
- Now you can access the map programmatically via the REST API.
- The plugin is a work in progress – contributions and improvements are welcome!
Author: FrankV22
Repository: https://github.com/itsFrankV22/tShock-LiveMap_MapPNG
Note
I use Telemetry in all my plugins, by using them you agree to send development information, no information will be public
v1.1.0
🎉 LiveMap_MapPNG v1.1.0
New stable release of the plugin to export your Terraria server world as a PNG map, quickly and easily.
🚀 Main Features
- Generate a PNG map of the current world using
/genmap. - Colors for tiles, walls, and liquids based on type, paint, and height.
- Background gradient to distinguish altitude visually.
- Automatic export every 5 minutes (modifiable in the code).
- Auto-update checking with notifications in the console.
- Optional telemetry for statistics and error reporting (can be disabled in code).
🛠️ Installation
- Download the attached
.dllfile. - Place it in your server’s
/ServerPluginsfolder. - Restart your server.
- Run
/genmapin chat (requiresmap.exportpermission).
📸 Example Output
The map includes a background gradient for better visualization.
ℹ️ Notes
- The generated file will be at
/Map/worldMap.pngin your server root. - See READMEes.md for detailed instructions in Spanish, or README.md for English.
- The plugin is a work in progress – contributions and improvements are welcome!
Author: FrankV22
Repository: https://github.com/itsFrankV22/tShock-LiveMap_MapPNG
Note
I use Telemetry in all my plugins, by using them you agree to send development information, no information will be public
v1.0.0
v1.0.0
/genmap
Generate a png map at /Map/worldMap.png
This is still quite ugly, I'm working on this, if you want to help please I would accept it, the map is generated correctly, it's just that the dictionaries are unfinished
