Storm Veil Framework

StormVeil Framework is the shared foundation behind the StormVeil mods for Eco. Other StormVeil mods need it installed, but it also adds a few independent features of its own for server owners, and modders can build their own mods on top of it.

Features for server owners

• Removable upgrade modules (optional, off by default). In vanilla Eco, putting an upgrade module in a crafting table is permanent. With this on, players who have full access to a table can drag its installed modules back out. You can turn it on or off from Mods/StormVeilFramework.json or from the Framework tab in the server console, and changes apply straight away with no restart. Turning it off again makes modules permanent again, including on tables that are already placed. It has two extra options, both off by default:
  • Refund stars on removal: players get back the stars they spent installing a module when they take it out.
  • Free upgrade installs: installing an upgrade module costs no stars.
• Game-version safety check. The first time the server runs on an untested Eco version, StormVeil mods log a warning and keep running as normal. If that version turns out to be fine, it's remembered and later boots stay quiet. If a previous start on that version never finished loading, the mods skip themselves on the next boot so the server doesn't crash over and over.
• Server console tab. Shows the framework's status and lets you change its settings while the server is running.

For modders

You can use the framework as a dependency in your own Eco mods. It includes per-mod JSON config files, permission checks, a version guard with your own list of supported versions, helpers for running code on every world object, helpers for finding other objects in the same room and splitting bonuses between them, storage ranking, and your own tab in the server console with live-editable settings. It can also serve web content from Eco's built-in web server. Full instructions for using it in your own mods, including a complete API reference and a minimal example mod, are included in the download as StormVeilMods/StormVeilFramework_README.md.

Installation: extract the zip into your server's Mods folder. The framework has no dependencies of its own.

Support @ buymeacoffee.com/StormVeilGaming