{"id":42194551,"url":"https://github.com/klightspeed/seringasteroids","last_synced_at":"2026-01-27T00:01:31.262Z","repository":{"id":210302180,"uuid":"726239776","full_name":"klightspeed/SERingAsteroids","owner":"klightspeed","description":"Space Engineers mod to generate asteroids in planetary rings","archived":false,"fork":false,"pushed_at":"2023-12-19T16:08:07.000Z","size":214,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2023-12-19T16:51:20.774Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/klightspeed.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2023-12-01T20:55:42.000Z","updated_at":"2023-12-31T15:28:11.221Z","dependencies_parsed_at":"2023-12-01T22:25:52.081Z","dependency_job_id":"3a9e9848-de38-48f5-be23-a53d54c1ff5c","html_url":"https://github.com/klightspeed/SERingAsteroids","commit_stats":null,"previous_names":["klightspeed/seringasteroids"],"tags_count":0,"template":null,"template_full_name":null,"purl":"pkg:github/klightspeed/SERingAsteroids","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/klightspeed%2FSERingAsteroids","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/klightspeed%2FSERingAsteroids/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/klightspeed%2FSERingAsteroids/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/klightspeed%2FSERingAsteroids/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/klightspeed","download_url":"https://codeload.github.com/klightspeed/SERingAsteroids/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/klightspeed%2FSERingAsteroids/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28792638,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-26T21:49:50.245Z","status":"ssl_error","status_checked_at":"2026-01-26T21:48:29.455Z","response_time":59,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-01-27T00:01:22.637Z","updated_at":"2026-01-27T00:01:31.257Z","avatar_url":"https://github.com/klightspeed.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"## Overview\n\nThis is a mod to add procedural asteroids to the rings of planets.\n\nInitially it was only for Bylen in the Paradiso system, but other planets\nshould now be able to be configured to have asteroid rings.\n\nAsteroids are generated within about 50km of players and grids, and will\npersist after the mod is removed. Voxel cleanup will likely delete\nasteroids beyond a certain distance, but this mod should re-generate them\nin the same place after a reload or after sufficient player or grid\nmovement.\n\n## Configuration\n\nRings are configured using xml files in the mod storage directory in\nthe world save directory. The settings from these files are also stored\nin the world Sandbox.sbc file, with the future idea of being able to\nconfigure these settings from within the game.\n\nDefault settings are stored in `ringDefaults.xml`, and individual planet\nring settings are stored in xml files named by the planet's `StorageName` -\ne.g. for `Bylen-12345d120000.vx2` will be stored in\n`Bylen-12345d120000.xml`.\n\nDefault settings exist for the following planets:\n* Bylen (from e.g. Paradise)\n* Bylen as it is in Ares at War\n* Demus\n\nThese are disabled by default, and need to be enabled by editing and\nrenaming the `.xml.example` configuration file(s) that are written in\nthe mod storage directory.\n\n### Example XML\n\n```xml\n\u003c?xml version=\"1.0\" encoding=\"utf-16\"?\u003e\n\u003cRingConfig xmlns:xsd=\"http://www.w3.org/2001/XMLSchema\" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\u003e\n  \u003cPlanetName\u003eBylen-396150125d120000\u003c/PlanetName\u003e\n  \u003cModId\u003e1669459989.sbm\u003c/ModId\u003e\n  \u003cVanilla\u003efalse\u003c/Vanilla\u003e\n  \u003cRingOuterRadius\u003e1100000\u003c/RingOuterRadius\u003e\n  \u003cRingInnerRadius\u003e650000\u003c/RingInnerRadius\u003e\n  \u003cRingHeight\u003e3500\u003c/RingHeight\u003e\n  \u003cSectorSize\u003e10000\u003c/SectorSize\u003e\n  \u003cMaxAsteroidsPerSector\u003e500\u003c/MaxAsteroidsPerSector\u003e\n  \u003cRingLongitudeAscendingNode\u003e-2.85\u003c/RingLongitudeAscendingNode\u003e\n  \u003cRingInclination\u003e22.42\u003c/RingInclination\u003e\n  \u003cMinAsteroidSize\u003e128\u003c/MinAsteroidSize\u003e\n  \u003cMaxAsteroidSize\u003e2048\u003c/MaxAsteroidSize\u003e\n  \u003cEntityMovementThreshold\u003e512\u003c/EntityMovementThreshold\u003e\n  \u003cSizeExponent\u003e2\u003c/SizeExponent\u003e\n  \u003cVoxelGeneratorVersion\u003e4\u003c/VoxelGeneratorVersion\u003e\n  \u003cExclusionZoneSize xsi:nil=\"true\" /\u003e\n  \u003cExclusionZoneSizeMult xsi:nil=\"true\" /\u003e\n  \u003cRingZones\u003e\n    \u003cRingZone\u003e\n      \u003cInnerRadius\u003e880000\u003c/InnerRadius\u003e\n      \u003cOuterRadius\u003e920000\u003c/OuterRadius\u003e\n      \u003cRingHeight xsi:nil=\"true\" /\u003e\n      \u003cInnerRingHeight xsi:nil=\"true\" /\u003e\n      \u003cOuterRingHeight xsi:nil=\"true\" /\u003e\n      \u003cMaxAsteroidsPerSector\u003e10\u003c/MaxAsteroidsPerSector\u003e\n      \u003cMinAsteroidSize xsi:nil=\"true\" /\u003e\n      \u003cMaxAsteroidSize xsi:nil=\"true\" /\u003e\n      \u003cTaperEdges xsi:nil=\"true\" /\u003e\n    \u003c/RingZone\u003e\n  \u003c/RingZones\u003e\n  \u003cTaperRingEdge xsi:nil=\"true\" /\u003e\n  \u003cEnabled\u003etrue\u003c/Enabled\u003e\n  \u003cEarlyLog\u003efalse\u003c/EarlyLog\u003e\n  \u003cLogDebug xsi:nil=\"true\" /\u003e\n\u003c/RingConfig\u003e\n```\n\n### Ring configuration options\n\n| Option name | Global Default | Bylen Default | Description |\n|-------------|----------------|---------------|-------------|\n| PlanetName  | -              | -             | Planet storage name (from config file basename) |\n| ModId       | -              | -             | Used to anchor the config to a specific mod (i.e. not apply if the planet comes from a different mod) |\n| Vanilla     | -              | false         | Set to true if putting rings around a base-game planet |\n| PlanetRadius | -             | 500000        | Planet radius for which the below values are defined |\n| RingOuterRadius | -          | 1100000       | Ring outer radius in metres |\n| RingInnerRadius | -          | 650000        | Ring inner radius in metres |\n| RingHeight      | -          | 3500          | Distance between ring plane and upper / lower limit of ring |\n| SectorSize      | -          | 10000         | Ring sector size in metres |\n| MaxAsteroidsPerSector | -    | 50            | Maximum asteroids per sector |\n| RingLongitudeAscendingNode | - | -2.67       | Longitude where the ring crosses the planet's equator going northwards (ascending node) |\n| RingInclination | -          | 22.44         | Inclination of ring to planet's equator |\n| MinAsteroidSize | 128        | -             | Minimum asteroid size in metres |\n| MaxAsteroidSize | 2048       | -             | Maximum asteroid size in metres |\n| EntityMovementThreshold | 512 | -            | Distance any grid or player needs to move before new sectors are considered for population with asteroids |\n| ExclusionZoneSize | 64       | -             | Minimum space around asteroid in metres to exclude other asteroids |\n| ExclusionZoneSizeMult | 1.5  | -             | Minimum space around asteroid as a multiple of its size to exclude other asteroids |\n| TaperRingEdge | true         | -             | Taper inner and outer edges of ring |\n| SizeExponent  | 2.0          | -             | Size weighting exponent. Values larger than 1 prefer smaller sizes, while values smaller than 1 prefer larger sizes |\n| VoxelGeneratorVersion | -    | -             | Space Engineers voxel generator version - defaults to value in `VoxelGeneratorVersion` in `Sandbox.sbc` |\n| Enabled       | -            | -             | Set to true to enable the ring |\n| LogDebug      | -            | -             | Used for logging; log debugging information into a file per planet in local storage directory (by default in `AppData\\Roaming\\SpaceEngineers\\Storage\\{ModId}_{ClassName}`) |\n| EarlyLog      | -            | -             | Used for logging; start logging before planet is ring enable check |\n| DebugDrawRingBounds | -      | -             | Draw ring bounds with equatorial, ascending node, and maximum latitude planes |\n| RingZones     | -            | 1 zone        | Array of zero or more RingZone elements |\n\n### Ring zone options\n\n| OptionName   | Bylen zone 1 Default | Description |\n|--------------|----------------------|-------------|\n| InnerRadius  | 880000               | Inner radius of ring zone |\n| OuterRadius  | 920000               | Outer radius of ring zone |\n| RingHeight   | -                    | Override ring height for this zone |\n| InnerRingHeight | -                 | Override ring height for inner edge of this zone |\n| OuterRingHeight | -                 | Override ring height for outer edge of this zone |\n| MaxAsteroidsPerSector | 10          | Override maximum asteroids per sector in this zone |\n| MinAsteroidSize | -                 | Override minimum asteroid size for this zone |\n| MaxAsteroidSize | -                 | Override maximum asteroid size for this zone |\n| TaperEdges      | -                 | True to taper inner and outer edges toward the normal ring height |\n\n### Voxel Generator Versions\n\n| Version | Description |\n|---------|-------------|\n| 0       | Original procedural generator without ice (before 01.074) |\n| 1       | Default version before about September 2015 (introduced 01.074) |\n| 2       | Generation identical to version 1 (introduced somewhere between 01.079 and 01.083) |\n| 3       | New-style procedural generation (introduced 1.188) |\n| 4       | \"No Uranium on planets and tweaks in distribution of ore on asteroids\" (introduced 1.189) |\n\n## Future ideas\n\n* Add the ability to define and enable rings using chat commands.\n* Add the ability to boost the chance of ice asteroids from the default 1% (probably using a GeneratorSeed based on the number of material kinds)\n  - Note that adding or removing a mod that changes the ores that can appear in asteroids would make this an ice asteroid debuff for already-generated asteroids\n* Allow edge taper to span more than one ring sector\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fklightspeed%2Fseringasteroids","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fklightspeed%2Fseringasteroids","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fklightspeed%2Fseringasteroids/lists"}