📦 Installation

# Install this templatedotnet add package  Chickensoft.GameTools --prerelease

⏳ Multithreaded Loading

usingGodot;usingChickensoft.GameTools;publicpartialclassMyNode:Node{publicLoaderLoader{get;set;}=default!;publicMeshMyMesh{get;set;}=default!;publicPackedSceneMyScene{get;set;}=default!;publicoverridevoid_Ready(){Loader=new();// Add a job for everything you want to load. The callback will be// invoked with your loaded resource, allowing you to hang onto it.Loader.AddJob<Mesh>("res://my_mesh.tscn",(resource)=>MyMesh=resource);Loader.AddJob<PackedScene>("res://my_scene.tscn",(resource)=>MyScene=resource);// Subscribe to events to track progress and completion.Loader.Progress+=OnLoaderProgress;// There are other loading events you can subscribe to, if needed:// Loader.Started += () => GD.Print("Loader started!");// Loader.Completed += () => GD.Print("Loader completed!");// Start loading everything.Loader.Load();}publicoverridevoid_Process(doubledelta){// Call Update every frame to track progress and ensure events are invoked.if(!Loader.IsCompleted){Loader.Update();}}publicoverridevoid_ExitTree(){Loader.Progress-=OnLoaderProgress;}publicvoidOnLoaderProgress(floatprogress){GD.Print($"Total loading percent:{progress}");}}

Tip

To facilitate simple UI construction, the loader guarantees that you will receive progress updates for 0.0 and 1.0. The progress amount is the progress of all jobs as a percentage between 0 and 1.

🏝️ Godot Feature Tags & Application Environment

if(Features.OperatingSystemisOSFamily.macOS orOSFamily.Linux){GD.Print("Unix-based system");}// Whenever you need to test a specific environment, you can override the// feature tags to simulate that environment.Features.FakeOperatingSystem(OSFamily.Linux);// Reset overridden features back to the system's actual environment.Features.Reset();

🖥️ Display Scaling & DPI Awareness

High-Level Scaling Behaviors

✅ Proportional UI Scaling

varinfo=GetWindow().LookGood(WindowScaleBehavior.UIProportional,BaseResolution,isFullscreen:false// or true);

✅ Fixed UI Scaling

varinfo=GetWindow().LookGood(WindowScaleBehavior.UIFixed,BaseResolution,isFullscreen:true// or false);

Tip

For more on display scaling, check out Chickensoft's blog article titledDisplay Scaling in Godot 4.

Manual Scaling

usingChickensoft.GameTools;publicoverridevoid_Ready(){varwindow=GetWindow();varwindow=GetWindow();varscaleInfo=window.GetWindowScaleInfo(Display.UHD4k);varsizeInfo=Display.GetWindowSizeInfo(scaleInfo.LogicalResolution);window.ContentScaleFactor=scaleInfo.ContentScaleFactor;// There are many other properties on scaleInfo, such as// SystemScale, LogicalResolution, NativeResolution, DisplayScale, etc.// sizeInfo has a recommended size for the window and a recommended min and// max size for the window. In case you can't be bothered to do all that.}