Sens Essentials

Server administration tools for Space Engineers dedicated servers. Based on Torch Essentials: the same command set, many fixes, smarter cleanup, new tools, and the tools of Senxs Utilities. The plugin does not patch the game.

What's new compared with Essentials

• Rebuilt settings tab: tabs instead of one long property list, warnings on items that need attention, Undo after removing anything, hints and a full Instructions tab.
• Cleanup Presets and Block Presets: save named cleanups and block actions, run them with !admin runcleanup or !admin runpreset, or from an auto command. !blocks on/off/remove also accept cleanup conditions, and !blocks count is new.
• Command Permissions: allow or deny single commands for single players without changing their rank.
• Sim speed triggers: only run when sim speed stays low (or high) for a whole duration, with a cooldown and optional hysteresis, so lag spikes never trigger anything.
• Discord Logging (from Senxs Utilities): log entries to Discord webhooks by level and logger, with pings, rate limits and long errors attached as a file.
• Suit Refill (from Senxs Utilities): for admins, everyone in lobby worlds, or one player for a while.

Smarter cleanup

• Ships are judged together with everything attached by rotors, hinges and pistons: block and PCU counts are totals, the name is taken from the largest grid, and a ship is never half-deleted.
• Ownership is worked out from the blocks, so NPC, player and abandoned ships are recognised reliably. OwnedBy checks any block on a ship, and HasOwnerType checks the majority owner. Both accept npc, nobody, player and pirates.
• Player distance only counts players who are alive in the world.
• An unknown condition, a value that cannot be read, or a block or player that does not exist stops the cleanup before anything is deleted.
• !cleanup delete needs a condition. Use !cleanup delete all to delete every grid without a pilot.

Fixes and safety

• Errors in game callbacks and events are logged instead of crashing the server.
• The backpack limit counts per player.
• Replies and failed steps from auto commands and presets are written to the log.
• A config that cannot be read is kept as a .bad copy instead of being overwritten, and a failed save can no longer stop the server.
• !kick, !ban and similar commands work on your own rank and below, never above.
• !grids export/import can no longer read or write files outside their folder.
• Economy commands reject negative amounts and balances can no longer overflow; !economy pay updates balances on screen.
• !admin setrank can no longer change an Owner's rank; !admin give checks the item exists.
• !tp moves whole ships with their subgrids and keeps pilots seated; !entities poweroff/poweron cover every power block.
• Many smaller fixes: see the changelog.

Changes to know before switching

• !econ is now !economy, and !blocks takes the selector as an argument: !blocks on type Reactor.
• !identity clean/purge/clear reset inactive players to a brand-new state (grids they mostly own are deleted, their faction, GPS, reputation and credits are cleared); NPCs are skipped unless asked for. Test on a copy first.
• Every command is either open to all players or needs Admin. SpaceMaster and Moderator have no admin commands.
• Saved backpacks count toward the limit, so players over it lose their oldest bags on the first start, even with items in them. Set the limit to -1 for no limit.
• Time fields are HH:MM:SS or D:HH:MM:SS, so 24:00:00 is 24 hours.
• Not included: homes (!home), the ranks and permissions system (!pr) and the default toolbar. Use Command Permissions for per-player command access.
• Your Essentials config and known Steam IDs are copied on first start; Senxs Utilities settings are imported once. Remove Essentials and Senxs Utilities afterwards. Move old grid exports to ExportedGrids in the instance folder.

Links

• Source, guide and full changelog
• Original project: Torch Essentials
• Also available for Magnetar, with shared configs for Quasar.

License

New code is released under the Unlicense. Code from Torch Essentials stays under its authors' terms.