Jump to content

[1.12.x] Waterfall - a framework for continuous, mesh-driven engine effects (October 9)


Nertea

Recommended Posts

3 hours ago, Nertea said:

I can't actually reproduce this RCS thing (the poodle thing is known). What versions of these mods are you using, with what KSP?

KSP version 1.11.2.3077,  and version 0.2.1 of WaterfallRestock. The 3-horn version had it the worst - but honestly, I've got a plethora of other visual mods that could be fiddling with it somehow, and I've got my hotfix, so if it's fine from the dev end I think we're settled there.

Link to comment
Share on other sites

Can I just modify the provided templates in the waterfall folder instead of creating new ones for each engine part?  The only change I want is for Scale X in some engines ... I am not sure how to go about doing that...

Link to comment
Share on other sites

53 minutes ago, pp3d said:

Can I just modify the provided templates in the waterfall folder instead of creating new ones for each engine part?  The only change I want is for Scale X in some engines ... I am not sure how to go about doing that...

Just use the templates and scale them appropriately. Absolutely no need to make a new one. 

https://github.com/post-kerbin-mining-corporation/Waterfall/wiki/Templates

Link to comment
Share on other sites

1 hour ago, Nertea said:

Just use the templates and scale them appropriately. Absolutely no need to make a new one. 

https://github.com/post-kerbin-mining-corporation/Waterfall/wiki/Templates

1 hour ago, Nertea said:

Just use the templates and scale them appropriately. Absolutely no need to make a new one. 

https://github.com/post-kerbin-mining-corporation/Waterfall/wiki/Templates

thanks -- still confused so let me give you a specific example that will help me. understand ... The specific engine is one of yours in NearFuturePropulsion which has it's own WaterFall folder in Patches:NearFuturePropulsion/Patches/Waterfall/template-nfp-ion-gridded-xenon-1.cfg 

When the ship is loaded, the waterfall editor gives me values for the offsets shown in the inlined image below under templates. I want to edit those for the scale but I can't match them to anything in the template file above. What I see, are the values shown below (just an excerpt) -- which. don't match the values in the editor. I am certainly  missing something...  waterfall mod is the newest release... the. NFT maybe one subversion behind current... 

   MODEL

    {

      path = Waterfall/FX/fx-cylinder

      positionOffset = 0,0,-0.119999997

      rotationOffset = -90,0,0

      scaleOffset = 0.159999996,2,0.159999996

hGut4XN.png

 

 

Edited by pp3d
Link to comment
Share on other sites

Those values correspond to the ones seen in the waterfall module in the config file of the engine. You should see something like

TEMPLATE
    {
      // This is the name of the template to use
      templateName = waterfall-hydrolox-lower-2
      // This field allows you to override the parentTransform name in the EFFECTS contained in the template
      overrideParentTransform = thrustTransform
      position = 0,0,0
      rotation = 0, 0, 0
      scale = 0.73, 0.73, 0.8
    }

(this is from the WaterfallRestock Skipper)

13 minutes ago, pp3d said:

The specific engine is one of yours in NearFuturePropulsion which has it's own WaterFall folder in Patches:NearFuturePropulsion/Patches/Waterfall/template-nfp-ion-gridded-xenon-1.cfg 

ah, there's your problem, that's not the engine, thats the template

From what I can tell of the file structure and what is selected in that pic, what you are looking for is the second engine in this file: NearFuturePropulsionWaterfallXenon.cfg

although you should look through the configs to find out what the internal name of the engine you want is

Edited by EnderKid2
Link to comment
Share on other sites

56 minutes ago, EnderKid2 said:

Those values correspond to the ones seen in the waterfall module in the config file of the engine. You should see something like

TEMPLATE
    {
      // This is the name of the template to use
      templateName = waterfall-hydrolox-lower-2
      // This field allows you to override the parentTransform name in the EFFECTS contained in the template
      overrideParentTransform = thrustTransform
      position = 0,0,0
      rotation = 0, 0, 0
      scale = 0.73, 0.73, 0.8
    }

(this is from the WaterfallRestock Skipper)

ah, there's your problem, that's not the engine, thats the template

From what I can tell of the file structure and what is selected in that pic, what you are looking for is the second engine in this file: NearFuturePropulsionWaterfallXenon.cfg

although you should look through the configs to find out what the internal name of the engine you want is

@EnderKid2 you have ided the issue accurately. It is the second engine there.  The take away is that the template-nfp-ion-gridded-xenon-1.cfg is called inside NearFuturePropulsionWaterfallXenon.cfg  which sets properties of each of the engine that uses that template. Thanks again. 

Link to comment
Share on other sites

27 minutes ago, pp3d said:

@EnderKid2 you have ided the issue accurately. It is the second engine there.  The take away is that the template-nfp-ion-gridded-xenon-1.cfg is called inside NearFuturePropulsionWaterfallXenon.cfg  which sets properties of each of the engine that uses that template. Thanks again. 

yes, and you don't necessarily have to put all the engines that use that template in the same file. For the most part, each engine gets its own config patch file.

Link to comment
Share on other sites

On 8/14/2020 at 8:04 PM, Nertea said:

 

KSP 1.11.x  

Waterfall [0.6.3] 
Last Updated March 26, 2021

screenshot42.png?width=2380&height=1339

I make a lot of engine effects, particularly for vacuum engines, which are really poorly handled by a traditional particle system, much less the gnarly butchered version of that system that KSP provides. Smokescreen helps, but when we're talking about really large, fast moving plumes, the number of particles you need to create high fidelity effects is really high. Performance gets low. To that end, I and some others (primarily @Nessus_ and some porcine aviator dude who shall not be named) have created a cool new way to create and drive engine effects. 

Project Goals

  • Design a framework to create mesh-driven engine effects for smooth rocket plumes
  • Support for atmospheric expansion and all kinds of dynamic effects
  • Cross-compatible with SmokeScreen for adding smoke effects
  • Ingame editor to create and drive effects. 
  • Provide a set of template effects for modders to use on their engines. 

Please note that this mod is a framework  it doesn't change anything or provide anything by itself, but provides the ability for you to do things.

Screenshots/Videos

Here's a few screenshots and videos from development over the last few months (credits to @Nessus_ and @DylanSemrau )

DmqTh5W.png

bmVHvwb.png

gr1THyD.png

For more, check out this Imgur album or look through the thread

 

Templates

A lot of preconfigured templates are available for anyone to use. These should cover most chemical engines in most mods. 

How to Use

Documentation

I wrote documentation. Read it! This is a work in progress and I have a bit of trouble keeping it up to date with new features that are added weekly. If you're having issues please review the thread and ask here.

Ingame Editor

To design plumes, you'll have a pretty fully featured editor to work with. Here are a few screenshots of it.

screenshot15.png

screenshot246.png

 

Downloads

 

Frequently Asked Questions

Q: I installed this and nothing happened, what gives?
A: Make sure you have mods installed that actually use the plugin.

Dependencies (Required and Bundled)

  • Module Manager 

Licensing

  • All content is distributed under a CC-BY-SA-NC-4 License.
  • All bundled mods are distributed under their own licenses.

Download
Mirrors


Tertiary (GitHub)

Issue Tracking and Source

 

Supported Mods

You need configuration packs for this to do anything. Currently there are only one; other mods will likely ship configs for this. If you release a mod that supports Waterfall you can let me know and I'll add it here. 

 

Incredible, but is it compatible with restock?

Link to comment
Share on other sites

Hi there, I have a problem with Waterfall.

The editor window for the mod isn't working for me.

It looks like this: https://imgur.com/kTrg808

On the left is what happens when I click the Waterfall icon in the toolbar and on the right is cheat menu console, which is showing a lot of errors.

Pleas let me know if this is not enough information.

Link to comment
Share on other sites

3 hours ago, Ozzy.R said:

The editor window for the mod isn't working for me.

go read the full documentation. Then come back if you still can't figure it out.
TL;DR: you need to create engine configuration files (and maybe templates) for your engine manually, before the editor will recognize it.

Link to comment
Share on other sites

@Nertea Always appreciate your mod and thanks for your masterpiece.  I think I found a bug related to Waterfall.

When an atomic engine was switched to LH2 + Ox augmented mode, the plume just disappeared.  There is only glowing light and final flame blip when fuel run-out. So far, I found this issue with NV-50 Stubber, NV-500 Poseidon, and NV-DC Scylla. Not sure if it is the issue for other engines or not.

Somehow I can't post the image. Here is the link.

image of the engine

This is the list of mods.

Spoiler

[x] Science! Continued (xScienceContinued 5.26)
AT Utils (AT-Utils v1.9.6)
B9 Part Switch (B9PartSwitch v2.18.0)
Background Resources (BackgroundResources 1:V0.17.0.0)
BonVoyage (BonVoyage 1:1.3.1)
Breaking Ground (BreakingGround-DLC 1.6.0)
BurstAtomicThrustModule (BurstAtomicThrust 0.1.0.1)
Chatterer (Chatterer 0.9.99)
Chatterer Extended (ChattererExtended 0.6.2)
ClickThrough Blocker (ClickThroughBlocker 1:0.1.10.15)
Community Category Kit (CommunityCategoryKit v5.2.0.0)
Community Resource Pack (CommunityResourcePack 1.4.2)
Community Tech Tree (CommunityTechTree 1:3.4.3)
Cryo Tanks (CryoTanks 1.6.0)
Cryo Tanks Core (CryoTanks-Core 1.6.0)
Cryogenic Engines (CryoEngines 1:2.0.1)
DeepFreeze Continued... (DeepFreeze V0.30.0.0)
Deployable Engines Plugin (DeployableEngines 1.3.0)
Distant Object Enhancement Continued (DistantObject v2.0.2.0)
Distant Object Enhancement Continued default config (DistantObject-default v2.0.2.0)
Docking Port Alignment Indicator (DockingPortAlignmentIndicator 6.9.2.2)
Dynamic Battery Storage (DynamicBatteryStorage 2:2.2.2.0)
Easy Vessel Switch (EVS) (EasyVesselSwitch 2.2)
Engine Lighting Relit (EngineLightRelit 1.6.3)
Environmental Visual Enhancements Redux (EnvironmentalVisualEnhancements 3:1.11.2.1)
Far Future Technologies (FarFutureTechnologies 1.1.3)
Final Frontier (FinalFrontier 1.10.0-3485)
Global Construction (GroundConstruction 2.6.4.1)
Global Construction Core (GroundConstruction-Core 2.6.4.1)
HeapPadder (HeapPadder 0.0.2)
Heat Control (HeatControl 0.6.0)
JSI Advanced Transparent Pods (JSIAdvancedTransparentPods V0.1.23.0)
Kerbal Alarm Clock (KerbalAlarmClock v3.13.0.0)
Kerbal Atomics (KerbalAtomics 1:1.2.1)
Kerbal Attachment System (KAS 1.7)
Kerbal Engineer Redux (KerbalEngineerRedux 1.1.8.3)
Kerbal Inventory System (KIS 1.28)
Kerbal Inventory System - No Fun (KerbalInventorySystemNoFun v0.1.10)
Kerbal Planetary Base Systems (KerbalPlanetaryBaseSystems v1.6.12)
KSPRC city lights (KSPRC-CityLights 0.7_PreRelease_3)
Magpie Mods (MagpieMods 1.5.9)
Making History (MakingHistory-DLC 1.11.0)
MechJeb 2 (MechJeb2 2.12.0.0)
Module Manager (ModuleManager 4.1.4)
Near Future Construction (NearFutureConstruction 1.3.1)
Near Future Electrical (NearFutureElectrical 1.2.2)
Near Future Electrical Core (NearFutureElectrical-Core 1.2.2)
Near Future Exploration (NearFutureExploration 1.1.1)
Near Future IVA Props (NearFutureProps 1:0.6.4)
Near Future Launch Vehicles (NearFutureLaunchVehicles 2.1.3)
Near Future Propulsion (NearFuturePropulsion 1.3.2)
Near Future Solar (NearFutureSolar 1.3.1)
Near Future Solar Core (NearFutureSolar-Core 1.3.1)
Near Future Spacecraft (NearFutureSpacecraft 1.4.1)
PlanetShine (PlanetShine 0.2.6.3)
PlanetShine - Default configuration (PlanetShine-Config-Default 0.2.6.3)
RasterPropMonitor (RasterPropMonitor 1:v0.31.4)
RasterPropMonitor Core (RasterPropMonitor-Core 1:v0.31.4)
RealChute Parachute Systems (RealChute v1.4.8.2)
REPOSoftTech-Agencies (REPOSoftTech-Agencies V1.5.9.0)
ReStock (ReStock 1.3.1)
ReStock+ (ReStockPlus 1.3.1)
SCANsat (SCANsat v20.4)
scatterer (Scatterer 3:v0.0723)
Scatterer Default Config (Scatterer-config 3:v0.0723)
Scatterer Sunflare (Scatterer-sunflare 3:v0.0723)
Space Dust (SpaceDust 0.4.1)
Spectra (Spectra v1.4.0)
Stockalike Station Parts Expansion Redux (StationPartsExpansionRedux 1.4.0)
Stockalike Station Parts Expansion Redux - Metal Surfaces (StationPartsExpansionRedux-Metal 1.4.0)
Surface Mounted Lights (surfacelights 1.18)
System Heat (SystemHeat 0.4.0)
System Heat - Nuclear Reactor Configuration (SystemHeat-FissionReactors 0.4.0)
Textures Unlimited (TexturesUnlimited 1.5.10.25)
Toolbar Controller (ToolbarController 1:0.1.9.4)
Trajectories (Trajectories v2.4.0)
TriggerAu Flags (TriggerAu-Flags v2.10.0.0)
USI Life Support (USI-LS 1.4.0)
USI Tools (USITools 1.4.0)
Waterfall - Restock (WaterfallRestock 0.2.1)
Waterfall Core (Waterfall 0.6.3)
Zero MiniAVC (ZeroMiniAVC 1:1.1.0.1)

 

Edited by Cosmonaut15
Link to comment
Share on other sites

had a similar issue with my rapier plume, The way mode-switching engines were implementyed was changed a bit ago, perhaps the atomic engine's waterfall patch is outdated

edit: if this is true, both plumes will show up in one of the modes, and in the plume GUI, both plumes will respond to the throttle when the engine is in one mode, and neither will if the engine is in the other mode

Edited by EnderKid2
Link to comment
Share on other sites

13 hours ago, Cosmonaut15 said:

@Nertea Always appreciate your mod and thanks for your masterpiece.  I think I found a bug related to Waterfall.

When an atomic engine was switched to LH2 + Ox augmented mode, the plume just disappeared.  There is only glowing light and final flame blip when fuel run-out. So far, I found this issue with NV-50 Stubber, NV-500 Poseidon, and NV-DC Scylla. Not sure if it is the issue for other engines or not.

Somehow I can't post the image. Here is the link.

image of the engine

This is the list of mods.

  Reveal hidden contents

[x] Science! Continued (xScienceContinued 5.26)
AT Utils (AT-Utils v1.9.6)
B9 Part Switch (B9PartSwitch v2.18.0)
Background Resources (BackgroundResources 1:V0.17.0.0)
BonVoyage (BonVoyage 1:1.3.1)
Breaking Ground (BreakingGround-DLC 1.6.0)
BurstAtomicThrustModule (BurstAtomicThrust 0.1.0.1)
Chatterer (Chatterer 0.9.99)
Chatterer Extended (ChattererExtended 0.6.2)
ClickThrough Blocker (ClickThroughBlocker 1:0.1.10.15)
Community Category Kit (CommunityCategoryKit v5.2.0.0)
Community Resource Pack (CommunityResourcePack 1.4.2)
Community Tech Tree (CommunityTechTree 1:3.4.3)
Cryo Tanks (CryoTanks 1.6.0)
Cryo Tanks Core (CryoTanks-Core 1.6.0)
Cryogenic Engines (CryoEngines 1:2.0.1)
DeepFreeze Continued... (DeepFreeze V0.30.0.0)
Deployable Engines Plugin (DeployableEngines 1.3.0)
Distant Object Enhancement Continued (DistantObject v2.0.2.0)
Distant Object Enhancement Continued default config (DistantObject-default v2.0.2.0)
Docking Port Alignment Indicator (DockingPortAlignmentIndicator 6.9.2.2)
Dynamic Battery Storage (DynamicBatteryStorage 2:2.2.2.0)
Easy Vessel Switch (EVS) (EasyVesselSwitch 2.2)
Engine Lighting Relit (EngineLightRelit 1.6.3)
Environmental Visual Enhancements Redux (EnvironmentalVisualEnhancements 3:1.11.2.1)
Far Future Technologies (FarFutureTechnologies 1.1.3)
Final Frontier (FinalFrontier 1.10.0-3485)
Global Construction (GroundConstruction 2.6.4.1)
Global Construction Core (GroundConstruction-Core 2.6.4.1)
HeapPadder (HeapPadder 0.0.2)
Heat Control (HeatControl 0.6.0)
JSI Advanced Transparent Pods (JSIAdvancedTransparentPods V0.1.23.0)
Kerbal Alarm Clock (KerbalAlarmClock v3.13.0.0)
Kerbal Atomics (KerbalAtomics 1:1.2.1)
Kerbal Attachment System (KAS 1.7)
Kerbal Engineer Redux (KerbalEngineerRedux 1.1.8.3)
Kerbal Inventory System (KIS 1.28)
Kerbal Inventory System - No Fun (KerbalInventorySystemNoFun v0.1.10)
Kerbal Planetary Base Systems (KerbalPlanetaryBaseSystems v1.6.12)
KSPRC city lights (KSPRC-CityLights 0.7_PreRelease_3)
Magpie Mods (MagpieMods 1.5.9)
Making History (MakingHistory-DLC 1.11.0)
MechJeb 2 (MechJeb2 2.12.0.0)
Module Manager (ModuleManager 4.1.4)
Near Future Construction (NearFutureConstruction 1.3.1)
Near Future Electrical (NearFutureElectrical 1.2.2)
Near Future Electrical Core (NearFutureElectrical-Core 1.2.2)
Near Future Exploration (NearFutureExploration 1.1.1)
Near Future IVA Props (NearFutureProps 1:0.6.4)
Near Future Launch Vehicles (NearFutureLaunchVehicles 2.1.3)
Near Future Propulsion (NearFuturePropulsion 1.3.2)
Near Future Solar (NearFutureSolar 1.3.1)
Near Future Solar Core (NearFutureSolar-Core 1.3.1)
Near Future Spacecraft (NearFutureSpacecraft 1.4.1)
PlanetShine (PlanetShine 0.2.6.3)
PlanetShine - Default configuration (PlanetShine-Config-Default 0.2.6.3)
RasterPropMonitor (RasterPropMonitor 1:v0.31.4)
RasterPropMonitor Core (RasterPropMonitor-Core 1:v0.31.4)
RealChute Parachute Systems (RealChute v1.4.8.2)
REPOSoftTech-Agencies (REPOSoftTech-Agencies V1.5.9.0)
ReStock (ReStock 1.3.1)
ReStock+ (ReStockPlus 1.3.1)
SCANsat (SCANsat v20.4)
scatterer (Scatterer 3:v0.0723)
Scatterer Default Config (Scatterer-config 3:v0.0723)
Scatterer Sunflare (Scatterer-sunflare 3:v0.0723)
Space Dust (SpaceDust 0.4.1)
Spectra (Spectra v1.4.0)
Stockalike Station Parts Expansion Redux (StationPartsExpansionRedux 1.4.0)
Stockalike Station Parts Expansion Redux - Metal Surfaces (StationPartsExpansionRedux-Metal 1.4.0)
Surface Mounted Lights (surfacelights 1.18)
System Heat (SystemHeat 0.4.0)
System Heat - Nuclear Reactor Configuration (SystemHeat-FissionReactors 0.4.0)
Textures Unlimited (TexturesUnlimited 1.5.10.25)
Toolbar Controller (ToolbarController 1:0.1.9.4)
Trajectories (Trajectories v2.4.0)
TriggerAu Flags (TriggerAu-Flags v2.10.0.0)
USI Life Support (USI-LS 1.4.0)
USI Tools (USITools 1.4.0)
Waterfall - Restock (WaterfallRestock 0.2.1)
Waterfall Core (Waterfall 0.6.3)
Zero MiniAVC (ZeroMiniAVC 1:1.1.0.1)

 

You should ensure you look in the mod's thread, not here - this thread is more for the plugin support. 

The KA thread indicates that this is a known issue that requires a KA update which I am procrastinating. 

Link to comment
Share on other sites

2 hours ago, alberro+ said:

Been using Realplume for a very long time, but I think that now Waterfall is starting to grow on me. When installing Waterfall, do I have to configure each engine in order to make it have a plume?

There are separate mods (Stock Waterfall Effects for stock, WaterfallRestock for Restock) which you can install alongside Waterfall Core to give engine effects. Some other mods (Near Future and BDB) also support Waterfall now and if you have those installed then the engines from those mods should also have new plumes.

Link to comment
Share on other sites

  • 2 weeks later...

Is is possible to modify Waterfall templates using ModuleManager? I wrote a patch like the following:

Spoiler

@EFFECTTEMPLATE:HAS[#templateName[waterfall-kerolox-*]]:FIRST
{
    @EFFECT:HAS[@MODEL:HAS[#path[Waterfall/FX/fx-point-light]]],*
    {
        LIGHTFLOATMODIFIER
        {
            name = intensityBoost
            controllerName = throttle
            transformName = Light
            combinationType = MULTIPLY
            useRandomness = False
            randomnessController = random
            randomnessScale = 1
            floatName = Intensity
            floatCurve
            {
                key = 0 2 0 0
                key = 1 2 0 0
            }
        }
    }
}

 

The changes do show up in ModuleManager, but they don't seem to get applied to the actual plume.

Link to comment
Share on other sites

12 hours ago, Nertea said:

It should be doable. Have you checked that the final config as shown in the MM cache has your change, and that the final config works fine outside of an MM patch?

I have indeed verified that the patch shows up in ModuleManager.ConfigCache -- that's what I meant by "show up in ModuleManager," hence why I'm puzzled.

I tried copy-pasted the template out of the cache into its own file, and it does seem to work that way.

Link to comment
Share on other sites

Got this error:

[ERR 20:51:57.379] Module ModuleWaterfallFX threw during OnLoad: System.NullReferenceException: Object reference not set to an instance of an object
  at FloatCurve.Load (ConfigNode node) [0x00021] in <06f13185617646e5bc801baeab53ab75>:0 
  at Waterfall.EffectLightColorModifier.Load (ConfigNode node) [0x00056] in <c5eba498661f4da59db6540c617ee9c7>:0 
  at Waterfall.EffectLightColorModifier..ctor (ConfigNode node) [0x00011] in <c5eba498661f4da59db6540c617ee9c7>:0 
  at Waterfall.WaterfallEffect.Load (ConfigNode node) [0x0025c] in <c5eba498661f4da59db6540c617ee9c7>:0 
  at Waterfall.WaterfallEffect..ctor (ConfigNode node) [0x00044] in <c5eba498661f4da59db6540c617ee9c7>:0 
  at Waterfall.ModuleWaterfallFX.OnLoad (ConfigNode node) [0x003b3] in <c5eba498661f4da59db6540c617ee9c7>:0 
  at PartModule.Load (ConfigNode node) [0x001ab] in <06f13185617646e5bc801baeab53ab75>:0 

KSP.log: https://www.dropbox.com/s/t0kmcb5gqugxlqp/KSP.log?dl=0

Link to comment
Share on other sites

40 minutes ago, peridoot said:

so BDB worked for a bit but has stoped working. wate rfall core seems to have been removed. dont know what the hell CKAN is doing

Maybe manually update and install if you're having issues. Also, CKAN issues go in CKAN thread.

Link to comment
Share on other sites

Join the conversation

You can post now and register later. If you have an account, sign in now to post with your account.
Note: Your post will require moderator approval before it will be visible.

Guest
Reply to this topic...

×   Pasted as rich text.   Paste as plain text instead

  Only 75 emoji are allowed.

×   Your link has been automatically embedded.   Display as a link instead

×   Your previous content has been restored.   Clear editor

×   You cannot paste images directly. Upload or insert images from URL.

×
×
  • Create New...