RegionSpawnMobs 2.0.3

Version 2.0.3 introduces native patrol-route management, complete RegionSpawnMobs region support in BuilderTools prefabs, configurable region visualization styles, and reliable NPC portrait resolution through Hytale's actual role and model assets.

Patrol Routes

• Added patrol routes stored directly as part of each Region.
• Added a route creation screen to the creation tool, allowing administrators to create a route and append points using their current position and facing direction.
• Added the Circular, Ping-pong, and Random route modes.
• Route points must be inside the selected Region, and consecutive duplicate positions are rejected.
• Added a complete Routes tab to the Region configuration interface.
• Routes can be selected, renamed, reconfigured, deleted, and have individual points removed.
• Added per-route mob filters using the mobs configured in the Region.
• Route data, point rotations, mode, UUID, and allowed mobs are persisted in the Region JSON.
• Route points use Hytale's native PatrolPathMarkerEntity and Path system instead of a separate custom marker implementation.
• Native route markers display the route name and point number and can be interacted with to open the corresponding Region route configuration.
• Region visualization now also displays route-point volumes.
• Loaded route markers are periodically synchronized and recreated when required.

Route Lifecycle and Cleanup

• Deleting a route immediately removes all of its native marker entities.
• Deleting a Region immediately removes the markers belonging to all of its routes before deleting the Region JSON.
• Removing a Region through prefab Undo follows the same complete cleanup path.
• Added a loaded-chunk integrity fallback that removes old orphaned RSM route markers whose route UUID no longer exists.
• The fallback identifies markers through the RSM interaction ID and does not remove Path markers owned by Hytale or other plugins.

Regions in BuilderTools Prefabs

• Regions completely contained inside a BuilderTools selection are now embedded when the selection is saved as a prefab or copied to the clipboard.
• The saved snapshot includes the Region boundary, entities, spawn settings, spawn conditions, preset, Zones, Cuts, SpawnPoints, patrol routes, route-point rotations, and mob filters.
• Inherited Region settings are flattened into the snapshot so the prefab remains self-contained and does not depend on the original parent Region.
• Pasting the prefab automatically creates a complete independent Region in the destination world.
• New instances receive unique names using the format RegionName-Prefab#1, RegionName-Prefab#2, and so on, allowing any number of copies.
• Every pasted Region, SpawnPoint, Zone, Cut, and route receives a new deterministic UUID, preventing conflicts with the source or other instances.
• Region geometry, SpawnPoints, Zones, Cuts, routes, and route-point facing are transformed with the prefab position, rotation, and reflection.
• The original Region folder is retained while parent-Region links are removed from the independent instance.
• Added persistent invisible metadata anchors to associate every generated Region with its prefab instance.
• BuilderTools Undo removes the generated Region and its route markers; Redo recreates the same prefab Region instance.

Prefab Region Preview

• Added an RSM-aware extension to BuilderTools' native clipboard/prefab preview.
• The preview displays Region boundaries, Zone boundaries, route points, and the existing RSM_SpawnPoint model before placement.
• Boundary, Zone, and route markers use BuilderTools' Editor_Empty block style.
• Preview markers are added only to empty preview positions and never replace or hide real prefab blocks.
• The preview is client-side only and does not place marker blocks in the world.
• Added the global prefabRegionPreviewEnabled setting to the administrator configuration screen.
• Prefab Region preview is enabled by default and can be changed globally for the server.
• Saving the global configuration refreshes active BuilderTools previews immediately.

Region Visualization

• Added visualizationRangeChunks to control how far Region visualization is sent to administrators.
• Added regionBoxVisualizationStyle with two modes:
  • DEBUG_SHAPES keeps the traditional Region and Zone outlines.
  • TRIGGER_VOLUME uses Hytale's translucent Trigger Volume display for Region and Zone boxes.
• Trigger Volume visualization is display-only: it does not create gameplay trigger volumes and is not persisted in the world.
• SpawnPoints, route points, chunk density, and live-mob information continue using their appropriate existing visualizers.
• Visualization state is cleaned correctly when disabled, when changing modes, when changing worlds, and when a player disconnects.

Correct NPC Icons

• Replaced icon-name guessing based on the NPC role ID.
• NPC portraits now follow Hytale's real asset chain: NPC Role -> resolved Appearance -> Model -> ModelAsset -> Icon.
• Variants such as Skeleton_Archer_Patrol now correctly reuse the icon declared by Skeleton_Archer.
• Tamed roles and differently named roles can correctly reuse another model's icon without special normalizers.
• Custom NPC roles and models supplied by asset packs or other plugins are supported through the registered Hytale assets.
• Region and Marker configuration screens now share the same centralized icon resolver.
• Missing or invalid role, model, or icon assets safely use the standard missing-icon image.

Configuration and Compatibility

• Added safe defaults and persistence for visualizationRangeChunks, regionBoxVisualizationStyle, and prefabRegionPreviewEnabled.
• Existing global and Region configuration files remain compatible.
• The plugin manifest now explicitly declares the plugin main class.
• Added explicit dependencies on Hytale:Path and Hytale:BuilderTools, required by native patrol routes and prefab integration.
• Updated English, Brazilian Portuguese, Russian, and Ukrainian interface strings for the new global options.
• Updated the English and Brazilian Portuguese data-storage guides with the new visualization settings.

Verification

• Java compilation completed successfully.
• The complete plugin JAR was generated successfully.

Version: 2.0.3