Skip to content

Releases: itsFrankV22/tShock-LiveMap_MapPNG

v1.3.0

Choose a tag to compare

@itsFrankV22 itsFrankV22 released this 31 May 01:18

🎉 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 (requires tshock.rest.map permission).
    • /map/report: Report errors manually to telemetry (requires tshock.rest.admin permission).
  • NEW: WebSocket server for real-time map visualization
    • Live map updates, chunked streaming for browsers or apps.
    • See browserConsoleTest.md for a ready-to-use JavaScript viewer example!
  • NEW: Modular project structure
    • Logic split into folders: Export/, Colors/, Extras/, REST/, WebSocket/, Config/.
  • NEW: Configurable options
    • All main options (auto-save interval, WebSocket port) are now in tshock/livemap/config.json.

🆕 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.md for 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

  1. Download the attached .dll file.
  2. Place it in your server’s /ServerPlugins folder.
  3. Restart your server.
  4. Run /genmap in chat (requires map.export permission).
  5. (Optional) Open your browser and use the script in browserConsoleTest.md to view your map in real time!

📸 Example Output

The map includes a background gradient for better visualization and now can be streamed live!

worldMap


ℹ️ Notes

  • The generated file will be at /Map/worldMap.png in 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

Choose a tag to compare

@itsFrankV22 itsFrankV22 released this 28 May 22:43

🎉 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 (requires tshock.rest.map permission).
    • /map/report: Report errors manually to telemetry (requires tshock.rest.admin permission).

🛠️ Installation

  1. Download the attached .dll file.
  2. Place it in your server’s /ServerPlugins folder.
  3. Restart your server.
  4. Run /genmap in chat (requires map.export permission).

📸 Example Output

The map includes a background gradient for better visualization.

worldMap


ℹ️ Notes

  • The generated file will be at /Map/worldMap.png in 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

Choose a tag to compare

@itsFrankV22 itsFrankV22 released this 27 May 21:42
eb67644

🎉 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

  1. Download the attached .dll file.
  2. Place it in your server’s /ServerPlugins folder.
  3. Restart your server.
  4. Run /genmap in chat (requires map.export permission).

📸 Example Output

The map includes a background gradient for better visualization.

worldMap


ℹ️ Notes

  • The generated file will be at /Map/worldMap.png in 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

Choose a tag to compare

@itsFrankV22 itsFrankV22 released this 27 May 15:42

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