Mods / Meteoric Expansion

Category: #Other
Author: Taska
Side: Both
Created: Feb 16th 2021 at 12:26 AM
Last modified: Sep 10th 2022 at 10:16 PM
Downloads: 14689
Follow Unfollow 154

Meteoric Expansion

The skies burn with balls of fire barrelling towards the planet at cosmic speeds....Is this the apocalypse?


Welcome to Meteoric Expansion!

This mod aims to bring the cosmos to Vintage Story in a very literal sense. In vanilla Vintage Story it's possible to stumble across small surface deposits of meteoric iron...but where did it come from? Meteors don't exist in vanilla!

Meteoric Expansion fills this space. This mod will spawn occasional randomized meteors that will streak through the skies, burning up or exploding like a real meteor would. There's also a small chance that they'll crash to the ground, depositing their riches into the world...!

Additionally, cosmetic meteor showers are an uncommon occurance. Day or night, you may see bands of glittering trails as meteors burn up high in the atmosphere.



Meteoric Expansion ships with configurable options!

The falling meteor system and cosmetic meteor shower system are independant of one another. Each can be disabled in the Meteoric Expansion config if you'd prefer to just have one of the systems active.

By default, falling meteors are NOT destructive and will NOT damage the world or player structures. With the destructive option set to false Meteoric Expansion is mostly cosmetic. You may find a few scattered bits at the collision site, but no meteorite embedded in the ground. Risk vs reward...  

To change your config, load up a game with the mod installed and enabled. After the mod runs once, a MeteoricExpansionConfig.json file will be available for edit in...

'C:\Users\{Your Username}\AppData\Roaming\VintagestoryData\ModConfig'

Exit to menu, edit this file, then load your save to see the changes!

Further config details can be found by opening the mod ZIP and reading the readme in 'assets\meteoricexpansion\config\'


Enjoying my mods? Please do consider supporting me on Patreon, it'd be a great help!

Version For Game version Downloads Release date Changelog Download
v1.2.2 4905 Sep 10th 2022 at 10:16 PM Show
v1.2.1 880 Aug 7th 2022 at 10:25 PM Show
v1.2.0 2719 May 23rd 2022 at 6:51 PM Show
v1.1.1 2549 Feb 7th 2022 at 4:06 AM Show
v1.1.0 180 Feb 6th 2022 at 9:56 PM Show
v1.0.6 1177 Jan 1st 2022 at 8:11 PM Show
v1.0.5 1286 Jul 16th 2021 at 7:17 PM Show
v1.0.4 993 Feb 16th 2021 at 12:28 AM Show

41 Comments (oldest first | newest first)

💬 Taska, Jan 3rd at 1:18 AM

Ketrai You already can pick and choose what spawns you want if you feel like diving into the assets of the mod and removing entries from one of the arrays. It may or may not work for multiplayer servers... not too sure. But for single player, it should be fine. In 'assets/meteoricexpansion/entities/air/meteor.json' there's an allowedVariants section. Deleting any of those lines between the [] brackets will prevent it from spawning in. I may or may not get around to implementing a proper config for custom spawns for quite a while.

As for meteoric iron... it's unique compared to all the other minable resources in the game. Although it's found in seuvite, the actual meteoric iron resource is a block composed of a single material. Everything else is 'metal in stone'. I've not been able to do single-resource meteors yet. I want to...just not enough time in a day.

Thanks so much for checking out the mod, and your feedback ^.^

💬 Ketrai, Dec 31st 2022 at 7:17 PM

Heyhey, amazing mod! If you've ever got interest to do so in the future, a config option to be able to set what ore types can spawn with meteors would be great. I'd love to be able to just set them to be meteoric iron. (Aka the unique ones with suevite impacts) But that one doesn't even seem to be an option at all.

💬 Taska, Dec 28th 2022 at 5:31 PM

SteAStro88 The mod was balanced with the default world height of 256 in mind. I'm not surprised that they don't hit often in a 384 height world.

The 'Destructive' config variable only affects whether or not blocks will be destroyed when hit by a meteor. It does not adjust meteor trajectory. For that, you'll want to increase the min/max horizontal and min/max vertical speeds of the meteors. Of course, you can use these to get a more natural speed, too.

💬 SteAStro88, Dec 28th 2022 at 10:02 AM

I'm playing on 1.17.9 and meteors can't seem to impact on the ground ever. In 100+ hours never occurred once, or found anything. The only bangs I hear, and hear quite frequently are high in the sky. For reference my world is 384 blocks high.

I've tried disabling meteor altogether, then enabling them but not destructive, then making them destructive again, nothing changed.

One detail is that I tweacked the speed of meteors to make them quicker and "more natural". 

💬 Thranos, Dec 3rd 2022 at 7:55 PM

Perhaps as something that can be toggled in config like meteor impacts as a whole are?

💬 Taska, Dec 3rd 2022 at 4:32 PM

Yanazake Depending on terrain features nearby... maybe every 3-5 irl hours?

Thranos Hmmm... I dunno about that, honestly. That would then force all players to play by that system. At least with the claims system players can choose to protect themselves or not, and really, it doesn't take much time to set them up. 

💬 Thranos, Nov 30th 2022 at 9:01 PM

Any chance of tweaking meteor impacts so they only blast soil and smooth stone? I've been eying the "actual meteor impacts" toggle in the config, but I know players on my server don't want to wrestle with land claims just to be sure a space rock doesn't say hello to their hut house. 
Amazing mod regardless, very atmospheric.

💬 Yanazake, Nov 30th 2022 at 8:01 PM

How often do meteors actually crash down when the configuration is changed to allow it? I mostly see them blowing up or the meteor showers.

💬 _Mason, Oct 25th 2022 at 10:47 AM

Ooh, I'd hate if my house were hit by a meteor... I'm lying. "I WAS CHOSEN BY THE STARS!"

💬 Taska, Oct 8th 2022 at 5:56 PM

LordOri Oh excellent! Will certainly include your translation in the next release. Thanks so much for translating Meteoric :D

💬 LordOri, Oct 4th 2022 at 3:39 PM


Hello, please add russian translate ->


💬 Taska, Sep 28th 2022 at 11:52 PM

OmegaHaxors There's no consideration for reinforcement. If the block is within the explosion radius it'll be destroyed.

💬 OmegaHaxors, Sep 26th 2022 at 7:47 AM

If a meteor strikes your house and it's reinforced, how much durability will it take away from the structure? Or will it just destory the block outright?

💬 Taska, Sep 18th 2022 at 8:48 PM

Kyks Oh no! At least the last thing you saw in that life was a pretty sight x3

💬 Kyks, Sep 17th 2022 at 3:33 PM

@Taska Just started a new game yesteerday. I had completely forgot your mod was installed. On the way back from gathering seed got caught by the dark and all of a sudden i hear a boom ! Looked up and see a meteor shower. Stayed in place completely distracted.   ....... Then i got killed by wolves.

BUT you mod was really NICE !


Thanks for keeping this one going. It adds so lil but yeah SO MUCH

💬 Taska, Aug 7th 2022 at 10:27 PM

Kirona It should hopefully be all set now ^.^

💬 Kirona, Aug 5th 2022 at 4:32 AM

Fair enough! Once you've got an update posted I'll be happy to get this mod back, the meteors are fun and the meteor showers are SO PRETTY xD

💬 Taska, Aug 5th 2022 at 12:37 AM

Kirona Yep xD

The means of accessing blocks in the world was changed in 1.17. There's a further change to that coming in the next release candidate that will possibly affect Meteoric Expansion, so I'm just waiting for that before putting out an update here.

💬 Kirona, Aug 4th 2022 at 8:19 AM

Hey, I know you haven't put out a 1.17 update yet, but I tried running the current version on it anyway because I'm a nut. It mostly works, but when a meteor hits the ground it crashes the internal server (singleplayer) and plays the impact sound every tick for like 10 seconds. x)

💬 Kirona, Jul 23rd 2022 at 11:29 PM

Taska Sweet, thanks! I kinda wanted a vaguely more dangerous, apocalyptic feel to things, and I figure meteor strikes can add to that but a few dozen hours of gameplay hadn't seen a single one yet x)

💬 Taska, Jul 23rd 2022 at 1:47 PM

Kirona Yea, in the mod config file you can increase the minimum and maximum vertical speed to make their trajectory more perpendicular to the ground and you can also configure how long a meteor exists before doing an airburst explosion with the meteor lifespan options

💬 Kirona, Jul 23rd 2022 at 9:16 AM

Is there any way to specifically make meteors more likely to hit the ground, without actually increasing their overall frequency by a ton?

💬 Taska, May 28th 2022 at 3:34 PM

ate0ate Thank you! 😄

💬 ate0ate, May 28th 2022 at 8:10 AM

Taska I must say that those new and improved meteor showers are absolutely gorgeous. I must have gotten lucky because as I was rushing to start a fire as the sun set on my first night in a new world I was very pleasantly greeted by a beautiful display in the skies as I was doing so. Beyond atmospheric:) You do amazing work.

💬 Taska, May 24th 2022 at 1:17 PM

1Joachim1 The config file should automatically update with all your old settings in tact. Both systems are on by default, so should make landfall just like you had it before updating ^.^

💬 1Joachim1, May 24th 2022 at 8:38 AM

if i update the mod i should delete the old config file then, right? or does it auto-update it with the extra options? i'm playing with a Friend in a server hosted in my own machine. the meteors will land again in the ground? (if the option to break the world is active)

💬 Taska, May 23rd 2022 at 9:57 PM

Kyks The new version of the mod has some config options to adjust vertical speed for falling meteors and showers now, too! Found a proper solution that works for single player games and servers.

💬 Taska, May 13th 2022 at 2:09 PM

Shion Kinda normal yes... a meteorite spawns at the edge of the crater along the trajectory vector of the meteor. So, in instances where the meteor strikes shallow, it can sometimes be level with the ground.

💬 Shion, May 13th 2022 at 3:00 AM

Is it normal that meteorite spawns slightly outside of the crater? Maybe it should be in the middle, or at least 3 blocks lower or something?

💬 Kyks, May 7th 2022 at 1:09 AM

@Taska Thanks for the quick response. I am playing Singleplayer at the moment Ill give 1.1.0 a try.


Great job ! 

💬 Taska, May 3rd 2022 at 3:24 AM

Kyks I had to remove those config options in version 1.1.1 and haven't found a solution since :/

  The problem is that those config values are serverside only. The motion behavior, which determines the trajectory and rotation of meteors, is calculated on both the client and the server. This means that the clientside won't have access to critical data it needs to remain synced with the server, since a remote client can't access the server config values(that I'm aware of).

I would love to find a way to offer that customization for everyone. If I do think of something, it'll happen.

In the meantime, you could download the 1.1.0 version and run that if you're playing a single-player world for that functionality. The only thing 1.1.1 does is remove that functionality which was causing crashes on public servers.

Thanks for checking out the mod! I'm glad you enjoy it ^.^

💬 Kyks, May 3rd 2022 at 12:58 AM

Just installed and tweaked the config to see them every minute just to have a look at them. watch about 30 streak in the sky. But i did not see any hit the ground. Based on your picture and description it is possible.

Is there a config for how often they make landfall ?


Really liking the mod. ! Great job !

💬 Taska, Feb 7th 2022 at 4:05 AM

Madman2429 Thanks for the report! This does only affect servers, and not single player instances. I have a fix coming out in a moment that'll address this. Unfortunately, this means I need to cut the speed and scale configuration options unless I can find another way around the problem.

💬 Madman2429, Feb 7th 2022 at 1:55 AM

Reporting a crash related to the mod. On non-dedicated server, clients aside from host crash when certain meteorites appear. Was unable to identify specific cause and logs were in native languages. It appeared to be related with the meteorite's model, as it crashed when in render distance only. Wish I had more details but that is all we've found so far. 

💬 Taska, Feb 6th 2022 at 9:14 PM

Kirona I'm actually just in the process of overhauling crater sites. I'll share some images of those ones shortly ^.^

I think at most, with default settings, you'll see craters with a diameter of 9 blocks?

💬 Kirona, Feb 6th 2022 at 8:32 PM

Any chance of adding in a picture or two of a collision site with destruction enabled? I'm curious about enabling that option, but there's not anything I can find to tell me if I'm risking losing a few blocks, or like a 200-block-wide super-crater ;p

💬 Taska, Jan 15th 2022 at 5:51 AM


It should, version 1.0.6  was an update to make it compatible with 1.16 O.o

I've had it running on a new single player world but that's a super small sample size.

💬 Shion, Jan 14th 2022 at 9:56 AM

Does it work with 1.16.0? I stopped hearing any meteorites falling down lately...

💬 Taska, Apr 18th 2021 at 5:38 AM

1.0.4 was my sound update =c

Others have asked about further change to the sounds too so I will consider it. I quite like how they sound at the moment, honestly, so it'd have to be something truly epic to take its place. 

💬 WickedSchnitzel, Apr 9th 2021 at 7:04 PM

Any chance that you're overhauling the sounds? In my humble opinion, they do sound a little unfitting. But maybe thats just me.

💬 DearFox, Feb 17th 2021 at 1:13 PM

I made a video showing the work of the mod from a visual point of view in the form of a time-lapse.

(edit comment delete)