Repository navigation
Kiln 0.2.0-dev.27
Pre-releaseKiln 0.2.0-dev.27
NoClip as a rule of its own, asked for on GitHub (issue 25), and the calls mods were missing: take a buff off, see where a player looks, kick and ban, hear only the hits you care about, put an item on a player, choose the weather, show a value of one item in players' games, roll affixes onto an item. EMF mods built for EMF 0.6.3 and later start again. All of it works on a test server with no player; what a player's own game shows waits for the guided client pass, which has a check for each.
Mod authors
- The mod API is 0.2.2. Everything new is additive: no public member of 0.2.0-dev.26 was removed or changed.
- One call shape no longer compiles:
Events.On<T>(handler, default). The second argument can now be a priority or a filter, so the compiler cannot choose; writeEventPriority.Normal(or leave it out). A built mod is not affected.
NoClip
PlayerRules.NoClipis a new rule: the player's character flies through terrain, building blocks and props. It flies as in character flight (jump climbs, sneak sinks, sprint is faster), takes off at once, also from the ground and from water, and never lands. It is separate from creative mode and from character flight, and it grants nothing else: no invulnerability.NoClip.Set(player, on)is Kiln's own switch for a player and returns a result withOk,On, aReasonand a message;NoClip.Of(player)says how it stands (On,Active,LastFree,Restoring);NoClip.Availableand the capabilityrules.noclipsay whether the running game build can do it. A rule set of your own can carryNoClip = trueas well.- A death or a teleport of the player ends it, and it has to be asked for again:
NoClip.Set(player, true), orUpdateon your rule set.PlayerNoClipEndedEventsays why it ended (RuleEnded,Death,Teleport). - When NoClip ends while the character is inside something, Kiln first moves the character back to the last place where it was in open space and only then lets collision return; the event's
RestoredTosays where. A move that fails is tried again, and until the character is in open space it keeps flying without collision (NoClipState.Restoring). The game itself does not push a character out of solid ground: on a test server one whose rule ended inside rock fell through the world. RuleSet.Updatenow counts at once:Rules.Of(player)can be read right after it, as afterRules.Apply. Before, the change took effect at the next server step.
Buffs
Abilities.RemoveBuff(target, buff)takes a buff off a player, a creature or an NPC through the game's own removeBuff, by the buff's GUID or its id (GameBuffs.Ids). The result is the game's answer:Okis false, with a reason, when the entity did not have the buff.BuffRemovedEventfollows a removal.Abilities.BuffsOf(entity)lists the buffs on any entity (EntityBuff: id, slot, time left, level). The game keeps buffs on the server: a joined client gets an empty list.- The capability
abilities.buffsis pending while no server world runs (a client in its menu) and available once one does;abilities.buff_listsays whether the list can be read.
Players
PlayerStates.AimOf(player)says where a player's camera is and where it looks (PlayerAim:Origin,Direction,At(metres)), read on the server from what the player's game sends. The camera is behind the character: a ray for "what is the player looking at" starts at the camera.Players.Kick(player, reason)andNetwork.Kick(peer, reason)refuse a connection with a reason; a player with Kiln reads the reason, one without gets the game's own "could not join" message.PlayerKickedEventfollows.Bansis Kiln's own ban list (Add,Remove,Find,All; by player or Steam id, with an optional duration), kept in the server's Kiln data and enforced whenever a connection names its account.PlayerBannedEventandPlayerUnbannedEventreport changes.PlayerLoginEventis posted once for each connection when it first names its player. Cancel it, with aReason, to refuse the player (a whitelist is three lines).
Events
Events.On<T>(handler, EventFilter.ForEntity(entity))delivers only the events about that entity (orForEntities). It works for every event that names its entities (IEntityEvent: the combat events do).- For hits it also saves work: Kiln holds a hit for mods only when a handler could want it. A mod that watches one training dummy no longer has every hit in the world held for it. A handler without a filter gets every hit, as before.
- A hit is about an entity when the entity is its target, the part hit, its attacker or its source. So
ForEntity(creature)also delivers the hits the creature deals: its attack on a player comes with the player asTargetand the creature asAttacker. Teste.Target == creaturefor only the hits it takes.
Data on one item
InstanceData.Claim(parked, item)puts a value that Kiln had set aside onto an item you name;InstanceData.Discard(parked)drops it. Both may be called from a handler of the item data events.InstanceDatavalues can reach players' games. Give a keySync = InstanceSync.Holder(the player who holds the item) orNearby, declare the same key in the mod's client side, and read it there withInstanceData.SyncedorInstanceDataSyncedEvent. A value never goes to a player the key does not name.- What is sent is acknowledged: an update lost on the network is made good within about a second, or within ten seconds when nothing follows it. A game is sent at most 256 KiB a second and never more than the 4,096 items it keeps, its own first. A game that keeps reporting losses is started over less and less often (up to a minute apart), so a player's game cannot make the server send more by claiming them.
Items
Items.Equip(player, from, slot)puts an item from the player's backpack on, in the slot you name or the item's own;Items.Unequip(player, slot)takes one off into a free backpack slot. Both run the game's own equip on the server, with all its checks. The result (EquipResult) says what moved where, or why not;EquipOptions.DryRunasks without changing anything;EquipChangedEventfollows each change Kiln made. Capabilityitems.equip.- A mod item with a model of its own now lies on the ground as that model. Before, it took the ground model of the item it was made like, also when that looked nothing like it.
Droppednames another model. Items written for earlier releases change their look on the ground with this release unless they setDropped.
Affixes
- Bonuses rolled onto one item: define affix kinds and pools as blocks (
Blocks.Define, or theaffixesandaffixPoolssections ofblocks/*.json;Affixes.Define,DefinePoolandAffixes.Loadare the same registration), roll them onto an item, and Kiln applies them while the item is in hand or worn. All 39 stats of the game work. affixes.md has the whole of it, the sampleAffixSworda sword with one of three. - An affix or an affix pool cannot share its name with a block of another kind in its mod; such a definition is refused with a
BlockError. The same name and the same kind defined again replaces the earlier one, and afterOnLoada data file's definition is the mod's. - A section of a
blocks/*.jsonfile that is not an object (a list where the blocks should be) is that file's error naming the section; the file's other sections and the mod's other files still load. Before, it stopped the reading of the mod's block files. - A pool that can never reach its minimum is refused when it is defined, and a roll that cannot reach it is refused with a reason. A rolled item keeps the stat it shows when its affix is defined anew.
- An affix value is at most 1,000,000 either way (a tier,
Affixes.Set,Affixes.Add). Within that an item gives what it shows, also a value no tier rolls. - What is stored on an item is not trusted (a save edited by hand): data that does not read as rolls is left out, at most 8 rolls of an item act, a value beyond the limit does not act, and one item's bad data never stops anybody else's bonuses. kiln.log says it once per item, and the item's data stays as it was.
- A change made by a handler of
AffixesChangedEventis announced at the start of the next step, never inside the handler, as for the other change events. - A block that fails in a way nobody foresaw (
"effects": nullwhere a list belongs) is that block's error; the file's other blocks and the mod's later files still load. Before, it stopped the reading of the mod's block files. - Not yet: flat damage on a hit, a share of a pool, lines in the game's own tooltip, rolls by themselves on a drop or a craft.
World
-
World.Write,World.Update,World.WriteFieldandWorld.WriteAtchange a component of an entity through the game's own write tracking: the change is saved with the world and is still there after a restart. List the component types your mod writes under"writes"in kiln.mod.json (Kiln.Sdk adds the types your code writes). The write runs in the next sim step, and the result says what became of it. Capabilityworld.tracked_writes;ComponentWrittenEventfollows a change. -
A tracked write goes to the entity its id named at the call, never to another entity that got the id since (the next player in a slot). For an entity without a spawn time it is not kept waiting behind a full step: it answers
Droppedand the mod asks again the next step. 512 writes run per step; all mods together share 91 component types. -
World.TryWritestill works and is obsolete: it isWorld.WriteRawnow, a raw store the game neither saves nor sends, for inputs the game reads in the coming step. -
World.Querygives entity sets, and world programs take the generated component types (TryGet,TrySet,TryGetOther,TrySetOther). -
Kiln.TestKit has a fake world (
kiln.Entities): this world code runs underdotnet test, and the fake's limits are tested against the native service's. -
A tracked write that a Kiln water refill writes over (
Items.Fuel.Refill,KeepFull, or a player's Water rule such as Creative's) names the refill inWorldWriteResult.WrittenOverByinstead of blaming the game. End or narrow the refill before you write a container'sFuel. Without a refill, a can a player carries keeps the write.
Weather
Time.SetWeather("rain", TimeSpan.FromMinutes(10))starts a weather phenomenon by its name, on every weather layer that has one of that name or on one layer; without a duration it is held untilTime.ReleaseWeather()."none"is a clear sky. The game itself runs the change, with its fades, and tells every player's game.Time.Weatherlists the layers (what runs, what Kiln holds, when the game rolls next),Time.WeatherPhenomenathe names, andWeatherChangedEventreports every change, the game's own rolls too (ByKilntells them apart). Capabilitytime.weather_choose.
Definitions baked at build
- Kiln.Sdk now writes the quests (with their NPCs and dialogues),
GameTree.Definenodes, VFX and materials that a mod defines in code into the mod when it is built. They are there at the first start, on the server and in every player's game. Before, the first start after an install did not have them.KilnBake=falseturns it off; baked.md says what is baked and what is not. - A build bakes again when a file the mod copies to its output changed (every
NoneorContentitem copied withPreserveNewestorAlways). A baked file over 4 MiB, more than Kiln reads, is not written: the build warns, and those definitions are there from the next start, as without baking.blocks/*.JSONcounts as a data file on every system, as Kiln reads it.
Cooked files
- Each cook Kiln runs records what it wrote, in the game's
kiln/state/cook-receipts. A cooked file that no receipt of the game lists was not made there: it was shipped inside a mod, copied in or changed afterwards. By default ("cooked": "warn"inkiln.json) such a file still loads, and kiln.log names it and says how to cook it. A later release will refuse such files;"cooked": "local"does so now, and"any"asks nothing (for a development server). - So ship recipes and sources, never
assets/cooked.kiln cook --forcecooks every recipe again. - A mod's assets are read from its own folder only: a link that leads out of it, or to another mod's cooked file, is an error.
- What the rule is for: it keeps shipped, copied or altered cooked files (content that a mod's identity does not cover) from loading as part of a mod. It is not a barrier against code that already runs under the player's account.
One contract in every service
- Every service now answers the same way (contract.md). A call whose capability is off throws
KilnUnavailableExceptionnaming the row. It is still aNotSupportedException, so an existingcatchkeeps working; the message starts with " is not available:". - Capability rows are there from the first tick and say what the call will do: session rows are pending until a server world runs, and a service whose native part is missing lowers its features (
rules.*,world.*,saves.*,net.*, the players' rows,time.speed,combat.attributesand the others) and takes that back when the part appears later (it is looked for again about once a second). - Results are kiln results (
IKilnResultwithOkandReason):HitResult,CastResult,FuelResult,QuestResult,ConversationResult,ProgressionResult,CreativeResult,SaveResult,TeleportResult. New membersSaveResult.OkandTeleportResult.Ok. - A change Kiln makes has an event. New:
CombatChangedEvent(also for god mode ending when its mod unloads, and forAbilities.Attributes.Add),TimeSpeedChangedEvent,ImpactVariableChangedEvent,PlayerProgressionChangedEvent. A change made inside the handler of its own event arrives first thing in the next step instead of looping. It is never dropped for room; a newer write of the same value takes its place, and it is dropped when the entity or the player it names is gone.PlayerProgressionChangedEventsays only what the request itself changed, not what the game changed in the same steps. - Entry points that take a person or a living thing, under names of their own:
Spawn.DestroyIfAlive,Chat.TellIfOnline,Permissions.PersonHas,PermissionSubject.ForPerson,Players.FindPerson(PlayerRef). - Members carry what they need:
[RequiresCapability],[ServerOnly],[TickThreadOnly],[AnyThread]. The analyzers read them.
Analyzers
- New warning KILN120: a Kiln result (
IKilnResult, for example fromItems.EquiporNoClip.Set) that nobody reads. Checkresult.Ok, or write_ = ...to drop it on purpose; the code fix offers both. - New warning KILN121: a member marked
[RequiresCapability("row")]used with nothing askingCapabilities.Is("row")(or the service's own guard property) first and nocatchofKilnUnavailableException. A helper of your own that does the check is not followed: catch at the command, or mark the caller[RequiresCapability]. Either rule is switched off withdotnet_diagnostic.KILN121.severity = none. analyzers.md has what each rule sees and does not see. - A project that names its features in
<KilnFeatures>instead of a kiln.mod.json has them counted as asked.
Tests without the game
- Kiln.TestKit fakes spawning, chat, items, combat and time: your mod's own calls run under
dotnet test, and the test reads what the mod did (kiln.Spawned,player.Chat,player.Say,player.Inventory,kiln.Combat.Hit,kiln.Time). The fakes answer as the native services do, also for a refusal and for a mod that unloads with work queued. - Quests and talent trees your mod defines run in unit tests on fake players. What the kit does not model (weather, equip, item moves between inventories, the game's journal and skill tree) says offline instead of pretending. unit-tests.md lists it.
- A test that registered a command no longer needs
AllowUnavailable = ["kiln.chat"].
Samples and templates
- New samples, each for one topic and each holding to the contract (the capability asked first, a refusal read and passed on):
SavedData(world, player and entity data),AdminTools(strikes, kick, ban, NoClip for an admin),CalmBell(an interaction offer and a game setting changed for a while),QuietServer(pacing an empty server),Loadouts(Items.EquipandItems.Unequip),SkyControl(the weather),AffixSword,ItemData, and for the advanced tierEngineRoom(the game's systems listed, profiled and hooked; one field of a game resource changed as a claim). - New
dotnet newtemplates, one topic each:kiln-events,kiln-saved-data,kiln-rules,kiln-network,kiln-screen-effect, and for the advanced tierkiln-hooks,kiln-shaderandkiln-world-program(a program of your own in the game's scheduler).
Key bindings
KeyBindings.RegisterandKeyChordtakeMouse4,Mouse5,MouseMiddle,WheelUp,WheelDown,WheelLeftandWheelRight, with Ctrl, Shift and Alt (VirtualKey0x04 to 0x06 for the buttons, 0x100 to 0x103 for the wheel). A wheel notch is a press without a release, and it fires nothing while a Kiln screen has the mouse. The left and right buttons cannot be bound. On a Kiln older than this release these names do not parse: check withKeyChord.TryParseif your mod should still load there.- Native plugins:
kiln.uiis version 7 and addssubscribe_key_ex(owner, fn, user, flags, &handle). WithKILN_UI_KEYS_MOUSEa key callback also gets the middle and side mouse buttons (VK_MBUTTON,VK_XBUTTON1,VK_XBUTTON2) and one press per wheel notch (KILN_UI_VK_WHEEL_UP,DOWN,LEFT,RIGHT: 0x100 to 0x103), and returning true keeps that press from the game. The smaller steps of a high-resolution wheel that complete no notch come as repeats (repeat1): return true to keep them too.subscribe_keyis unchanged, keyboard keys only: a plugin built against an earlier header gets what it got before.
The game's menus
- An entry added with
Ui.Menus.Addkeeps working as it is. With many entries the pause menu scrolls (the game's own scroll view around its entries); where a menu cannot scroll (the main menu, a game build without the signatures) and has more than 3 mods' entries, they are not drawn there and the player chooses them on Kiln's Mods page, whereOnClickruns the same way. The player's settingmodEntriesdecides. - Native plugins:
kiln.uihasmenu_shown,menu_entries,menu_activate(version 6), andmenu_scrollin a slot of its own behind them (check the table's size for it). The capabilityui.menu_scrollsays whether the pause menu scrolls. kilnctl library take-over kind:id[@version]takes over a mod changed in its Library folder from the command line;kilnctl library listmarks such entries.
EMF mods
- kiln-emf serves EmfApi v40 (EMF 0.6.8).
chat_tell_ex,chat_broadcast_exandworld_to_screenwork. The other functions EMF added since 0.6.0 answer "not available" for now, as EMF does on a game build it does not know: player events, item names, character names, hits and hit rules, buffs, markers, map actions, canvases,remove_building, paths, doors, enemy orders and move orders. emf-parity.md has each answer.
Players
- Several mods at once. Tick a box in the mods list (Shift+click for a range, Ctrl+A for every mod the list shows) and switch them on, off, or remove them in one go: one confirmation names them all and which other profiles list them, and a mod that cannot go (a running server uses it) stays with the reason while the others go. On the Steam Deck, L2 selects and R2 acts on the selection.
- Play shows what the start is doing. Pressing Play now shows a progress bar with the step that runs (cooking a mod, Steam, each of Kiln's own steps, loading the mods and their content) until the game's main menu, in the window, in the top bar and on the Steam Deck. From the second start with the same mods it says how long is left, learned from your own earlier starts on this PC; the first start says that it is timing itself instead of guessing, and a step that takes much longer than usual says so. "Running" now waits for the main menu. The times are kept in the launcher's data folder (
state/start-times.json); deleting the file only resets the estimates. A game that still has an older Kiln shows what it showed before. /noclip(admins): fly through the ground and walls./noclipswitches it for yourself,/noclip on|off <player>for someone else,/noclip statussays whether it works here. Your game needs this release too. It ends when you die or teleport; when you turn it off inside something, you are put back at the last place where you were free.- Key bindings can use the mouse: the side buttons (Mouse4, Mouse5), the middle button and the wheel, with Ctrl, Shift or Alt, for example Ctrl+WheelUp or Shift+Mouse4 (GitHub issue 29). Set them on the Keys page of the Kiln menu by pressing the button or turning the wheel. One notch is one press, and a bound Ctrl+wheel no longer zooms the camera as well.
- EMF mods made for EMF 0.6.3 to 0.6.8 start on Kiln again, EMF's Lua mods among them (Beastmaster, Necromancer, Bounty Board and the others). Since EMF 0.6.3 they stayed off unless EMF itself was installed.
- A Kiln game now answers an EMF server's mod check, so a server that refuses games without its mods no longer kicks a Kiln player after a minute. When your game lacks a mod the server needs, one note tells you which.
- When ShroudForge's own loader runs next to Kiln and cannot write its mods into the game data, the launcher says so: on the Steam Deck's Home, in the desktop's engine list and in the support report. It names the mods that did not load and what to change. This happens with ShroudForge 1.7.9 on Linux and the Steam Deck while the launch options still have
dbghelp=n,bandwinmm=n,b; take those two out and Kiln's own ShroudForge runs the mods. - Mods can give single items their own rolled bonuses and show you values that belong to one item. Nothing changes when you play without such a mod.
- The save editor works on the Steam Deck: a new Editor tab you use with the controller alone, with a number pad for amounts and levels. Not on the Deck yet: "Open a save file…".
- Your changes in the save editor stay when you leave the page, and the editor asks before it drops them: for another character, and for Discard. (The desktop window can still be closed with unsaved editor changes without a question.)
- The save editor no longer overwrites a save the game wrote after you opened it: it offers "Read again". When you have changed nothing, it reads the save again by itself after you played.
- A save with items from a mod that is gone opens read-only in the editor, and the backups list says which backups are the game's and which are Kiln's.
- The launcher cooks the mods that need it. A mod with a cook recipe (models, animations or sounds made from your own game's files) is cooked when you press Play: the launcher says "Cooking" with the mod's name, shows the cook tool's lines and starts the game after. Cook again in a mod's menu repeats it (Y on a mod in the Steam Deck's Mods screen). A cook tool that hangs or never stops printing is stopped, Cancel stops it, and a mod that could not be cooked keeps running on the files it has.
- Mods with a cook recipe no longer need the Kiln source.
kilnand the launcher carry the cook tools and unpack them on first use. On Windows the launcher brings its own Python (python.org's embeddable 3.14, in the launcher's own folder: nothing is installed and a Python you have is not touched). On Linux the system'spython3is used (3.10 or newer; one older than 3.14 reads the game's archives through the system's zstd library). When something is missing, the message says what to install. - A mod that is being cooked is no longer replaced or removed when you change its version or switch it off in a profile: Kiln asks you to wait until the cook has ended. Pressing Play again right after a start no longer cooks the mods while Steam starts the game.
- From your reports on the mod page (13 Nov):
- Add mods shows .7z and .rar files as well as .zip and .dll. Dropping them on the window already worked; a .rar needs WinRAR, 7-Zip or Windows' own tar on the PC.
- All on and All off above the mods list switch every mod the list shows (narrow it with the filter or Kind first), in one go, with Undo. Undo leaves a mod you switched yourself since, and says so when the profile was changed or another one loaded in between.
- A mod you edit in its own folder (a mod's menu, Open folder, its mod.json) shows "Changed on disk" with "Use the changed files": one click takes your edit over as the mod's files, and the list shows its new name. Play and Load name the changed mod and offer the same; before, they said "library hash mismatch" and the mod had to be zipped and added again. Extra files you put in the folder (a settings file beside a plugin) come along; when the Library already holds a file of the same name with other contents, it stops and deletes nothing; and when it could not delete all of the old folder, it says where the rest is.
- The pause menu scrolls when mods add more entries than fit, so Quit stays reachable with the mouse wheel, the arrow keys and a gamepad. Every mod's menu entry is also on Kiln's Mods page under "Menu entries", each doing what its row did, and Kiln settings has the choice (
modEntries: Auto, Few, Always, Never). The main menu does not scroll: there, and wherever the pause menu cannot scroll on a game build, a menu shows mods' entries while there are 3 or fewer and leaves the rest to the Mods page. The scrolling is new and was tried in one real game on one PC before this release; should it ever end the game, Kiln switches it off for that Kiln version and game build by itself and says so at the next start (kiln/state/menu-scroll.off; delete the file to try again). - A ShroudForge mod that shows Waiting says what it waits for in its details on Kiln's Mods page. SF Unlimited Flight, for one, waits whenever you are not gliding, and works only in a world your own game hosts.
- An EML mod you put into the game's mods folder yourself, while ShroudForge runs the EML mods: the launcher no longer tells you to activate the profile again. It says the mod runs from your own folder, and when ShroudForge has it switched off, where to switch it on (Kiln's in-game menu, Mods, ShroudForge, or ShroudForge's own Modloader). Kiln does not write into folders you installed.
Server operators
- What a slow start is doing: while it starts, Kiln writes the step it is in, with a detail, counts and what each finished step took, to
kiln/state/progress.json(jq '.steps[]' kiln/state/progress.json). It ends inready,idle(safe idle) orfailed, with the reason. dedicated-servers.md has the fields. - NoClip is off until you allow it. Set
"allowNoClip": trueinkiln/config/rules.json(edits apply within a second)./noclipneeds the Admin level or the permission nodekiln.command.noclip. A player whose game has no Kiln, or an older Kiln, never gets it. /kick <player> [reason],/ban <player|steamid> [30m|12h|7d] [reason],/unban <id>,/bansare Kiln's own commands (Admin level, or the nodeskiln.command.kick,.ban,.unban,.bans). The ban list iskiln/data/kiln-players/bans.json, apart from the game's own list. A ban that cannot be written to disk is refused instead of holding until the next restart./instances claim <record> <holder> <slot>and/instances discard <record>put a set-aside item value on an item or drop it, for every mod.- A mod whose
"writes"list Kiln cannot read still loads, with a warning; only its tracked writes are refused. A server whose mods list no"writes"gets no extra program. - A Kiln server answers an EMF game's mod list with its own and logs the difference (
EMF mods check: player ...). It does not refuse joins. - The greeting line to games without EMF or Kiln follows EMF 0.6.8: 10 s after a player connects and once more 35 s later (before: up to four times).
- Cooked mods after the update: you do not have to do anything, files cooked by an older Kiln keep loading, with a warning in kiln.log. Run
kiln cook <server folder>/kiln/mods/<mod> --game <server folder>once for each mod with a recipe: it writes the missing receipts and the warnings go. A later release will refuse cooked files without a receipt. kiln cook <server folder>/kiln/mods/<mod> --game <server folder>works with thekilnfrom a release'ssdk/folder alone:KILN_REPOis no longer needed (a checkout still wins when it is set). It needs Python 3.10 or newer on the machine.- Kiln.Gameplay and Kiln.Combat no longer start their game-event listeners on a server whose mods never use them, so a mod that listens to every event cannot delay or cancel hits and crafting there.
- Kiln's sample mods answer "not on this server" instead of failing when a feature is off on that game build.
Fixed
- The proxy and the launcher read quoted DLL names and a comment after a name in
dinput8-chain.ini, as EMF's shared chain spec describes. Before, such a line was dropped without a word. A DLL path that itself contains " #" or " ;" is now cut there, as EMF's loader cuts it. - A page of the launcher opened while a change to the profile was still being saved showed the profile from before the change (a mod that All off had just switched off showed as on). The Undo of All on and All off now stays on screen for 20 seconds.
- Starts with many mod materials are much faster. Kiln no longer builds every unchanged material's textures a second time while the mods load (in a real start with one mod of 85 materials that step went from about 22 seconds to under 2), and from the second start with the same mods it takes the materials as the last start built them instead of decoding every texture again (in a test outside the game that part went from about 13 seconds to 2; in a game it took 22 and has not been timed since). A changed texture, a changed definition, a new Kiln or a game update builds what it concerns again. kiln.log says how many materials were taken and how many built.
- The launcher's save editor stopped an item's amount at the game's stack size, also when a mod raises stack sizes (GitHub issue 23). An item that stacks now takes any amount up to 65,535, which is what the save holds, with a note when it is above the game's stack size.
- A mod whose kiln.mod.json holds a string that is not text (half of a surrogate pair written as an escape) stopped the scan of all mods at the start. It is that mod's error now, and the others load.
- The game's main menu had no MODS entry in any start in which Kiln ran ShroudForge (a ShroudForge mod on in the profile). ShroudForge changes two calls in the main menu before Kiln looks for its own place there, and Kiln did not recognise that change. The entry is back, with Kiln's ShroudForge and with "Use my installed ShroudForge". The Mods entry of the pause menu was not affected.
- The game no longer hangs at its start when other mod loaders load their libraries while the game loads its own: Kiln's overlay made every library load in the game wait for the one in progress. Found and fixed by rifters (GitHub pull request 27).
- When another loader has changed the game's code in a way Kiln does not recognise, Kiln still finds the simulation step, the program registrations, the savegame load and the main menu entry: the tick, items, world programs and saves stay on. Second signatures by rifters (GitHub pull request 27).
- The Mods page no longer puts its details over the mods list at 250 % or 300 % Windows scaling on a 4K display (and on other displays with a high UI scale). On a 4K display at 200 % the page is slightly smaller than before. Reported by rifters (GitHub pull request 27).
- In a mod's settings in the game (pause menu, Mods), Apply made the table show the old values again until the page was opened the next time, although the change was saved. The table now shows what was applied at once (GitHub issue 28).
- A slider in a mod's settings has a number field beside it: type the value. On a wide range (
[Range(0.01, 1000)]) a value such as 2.5 could hardly be set by dragging (GitHub issue 28). - Kiln's character flight follows a character through a teleport. The game moves a character's data when it teleports, and Kiln then lost track of the flight it had started, which could leave the character hanging in the flight state, unable to walk or animate.
- Kiln's own screens scrolled two steps for one notch of the mouse wheel (the notch reached them twice). One notch is one step.
- The
EntityHurtEventandEntityKnockbackEventthatCombat.Damageposts inside the call named the attacker asSourcealso whenDamageOptions.Sourcewas given. They name the given source, as the held hit does. - Kiln's mods load again next to mods that hook the game before Kiln, such as Auto Doors, also when Greeneye Loader (Find's own
dbgcore.dll) or ShroudForge runs beside them. In 0.2.0-dev.26 that combination could make Kiln miss the game's simulation step, program registrations and savegame load: no tick, no world programs, and Kiln's mods did nothing. This release's two changes to how Kiln finds the game's functions (the redirected calls it now recognises, and the second signatures of pull request 27) cover it; a hook as long as Greeneye Loader's longest is recognised too. - Adding a mod whose zip also carries its own loader (Find with Greeneye Loader's
dbgcore.dll, Creative Mode with Flame's) said "1 Kiln can't load yet". It says the loader is not needed. - A profile deleted and made again under the same name refused every change with "profile ... changed meanwhile (generation ... on disk, ... here)": the launcher still held the deleted profile. It takes the new one now.
- Two loads of a profile in one game could overlap (a slow load from Settings and a second click elsewhere), and the earlier click could win. The second is refused until the first is done.
- After dropping a mod while no profile was loaded, "Add to a profile" put the mod into a profile that was not loaded, so nothing seemed to happen. The dialog can now make a new profile ("New profile…"), and the message after it has "Load it".
- With ShroudForge's mods folder set to another drive under Proton (
paths.mods, for exampleC:\sfmods), Kiln copied the profile's EML mods into the game's ownmodsfolder, where ShroudForge did not look. The launcher now finds that folder the way ShroudForge does (through the game's Wine prefix, without regard to letter case), also for a dedicated server's own prefix. - With ShroudForge drop-ins on, a start in which Kiln ran ShroudForge because of an earlier ShroudForge startup patch left the profile's EML mods switched off in ShroudForge. The launcher now switches its copies on for that start too.
- The support report called it a problem, and named "EML's own loader", when kiln-eml had stood aside for the ShroudForge that Kiln runs, which is how the two work together. It is a note now, and a warning that names the mods when ShroudForge has some of the profile's EML mods switched off or not in its folder.
- The launcher's log has a line for each changed setting (for Kiln's own settings with the new value, for a mod's settings with the name of the setting only), so a support report shows when a switch was changed.
- Saving in the save editor made two backups of the save; it makes one.
- Typing in the save editor's "Add item" search stuttered; the letters now appear as you type (the list itself appears no faster than before).
- In Deck mode, L1 and R1 pressed quickly in a row skipped presses; every press counts now.
- In Deck mode, several errors at once could make the bar of messages stop working on a slow machine (the messages measured themselves again and again). Each message is measured once.
- A quest whose completion a mod cancelled (
QuestCompletedEvent) ran the last step's "when done" actions anyway, and ran them again at every retry: a reward could be given more than once. The completion is asked for first now, and the actions run once, when it goes through. (0.2.0-dev.26 had this too.) - An asset manifest whose patch offset was a negative number made Kiln write a few bytes in front of the resource it was patching, in the game's memory (0.2.0-dev.26 had this too). The offset is refused now.
- The Deck (the launcher's gamepad view) showed a long error as a line that ran off the screen. A long error now opens as a dialog, also when the long text is its title, and stays until it is read.
- Two launchers open on the same data folder could drop each other's "do not show again" notices.
- A release build now uses one fixed Rust version for everything it builds (the release of 0.2.0-dev.26 stopped halfway when the toolchain moved under it).
- The check of the material cook rules read a game archive that a texture mod had patched and reported the game's own materials as broken; it reads the game's unpatched archive.
Known limits
- NoClip was tried in one real game (13 Nov, a hosting game on Linux and Proton): switching it on and off as a player worked. Ending it with a teleport left the character stuck in the flight, unable to walk or animate; that is fixed and proven on a test server (a character walks 8.3 m in 40 steps after the teleport, as before NoClip) and has not been tried again in a real game. Not tried at all in a real game: turning it off inside the ground, death, what other players see, a dedicated server.
- Kiln's flight and NoClip can take another mod's flight for their own in two rare cases, both only when another mod puts a character into the game's flying state itself: on a host, right after Kiln's own flight of that character ended in the server's copy while the host's own copy was paused; and for a player who got the id of a player who left while flying. Kiln then ends that flight. The Creative Mode mod is not affected (Kiln's flight steps aside for it).
- NoClip judges open space from terrain and building blocks. Inside a prop (a rock, a chest, a door) the game's own collision decides when NoClip ends; it pushes a character out of small overlaps.
- NoClip does not work while the Creative Mode mod runs: that mod flies the character itself, and Kiln's flight steps aside for it.
/noclip statussays so. - A player who leaves the game while inside the ground is saved there. The game's Unstuck (in its menu) frees a character.
- Kicking, banning and the login event were tested with test connections on a test server, not with a real player's game.
Abilities.RemoveBuffon a real player (the buff icon disappearing in the HUD) is a check of the guided client pass.- The Windows launcher's own Python cooking a mod on Windows was not run by any test of this release: the tools and their unpacking are tested on Linux, and the Windows build is compile-checked.
- The cook on Windows (the tool run inside a job so that Cancel takes its child processes with it, and the check that a mod's files lie in its own folder) is compile-checked and was never run on Windows.
- The launcher does not cook mods you put into the game folder by hand, nor the mods of a local server it runs:
kiln cookdoes that. - The index files a cook writes next to its outputs (
audio.jsonand the lists the Blocks compilers read) are not covered by a receipt. - Equip, the chosen weather, tracked world writes, item data in players' games and affixes were proven on a test server with stand-ins for players. What a player sees is a check of the guided client pass for each.
- A weather hold does not outlast a server restart.
- On a target in god mode (
Combat.SetInvulnerable) a swing that stays on the target is reported once for every step it touches it. Count byImpactId. - Key bindings on the mouse were proven in a test window under Wine and in unit tests, not in a real game: that a bound Ctrl+wheel leaves the camera's zoom alone, and that the Keys page takes the wheel and the side buttons, are checks of the guided client pass (
ui.mouse-bindings). Also unproven there: how far apart in time a raw mouse record and its window message arrive under Proton and on Windows (Kiln takes them for one press within 50 ms; Wine's source gives them the same time, and kiln.log says once when a pair was that far apart), that a quick turn of a real wheel counts every notch (Wine merges wheel messages), and that the game's own read of raw input is found (kiln.log says "GetRawInputData hooked" at the start; without it a record that holds a taken press and mouse movement reaches the game whole). - Tracked writes work in a server world only (a dedicated server or a hosting game). A hook callback that writes in the middle of a step to an entity without a spawn time can have its write run after that step's structural changes; whether a player's entity has a spawn time is not known yet (if not, its writes behind a full step answer
Droppedand are asked again). - A tracked write to a value that something else writes every step is written over one step later; the result says so (
Keptis false) and names a Kiln water refill when one did it (WrittenOverBy). The first try in a real game (13 Nov, a hosting game) was that case: Creative's water rule kept the watering can full, and the can on screen did not change. On a test server a can carried by a test character keeps the write when no refill covers it. What a player sees on a carried can is a check of the guided client pass, to be run with Creative off. - Item data in players' games: a game that acknowledges nothing gets nothing new (removals included) until the ten-second recovery, and then at its backed-off pace.
- Affixes: while the game refuses to end a player's stat change, that player gets no new affix bonus; with 64 such changes stuck on a server, nobody gets a new one until they clear (kiln.log says so).
- Baked definitions: statuses, effects, items, spells and talent blocks are not baked yet (the build prints "not baked" for them), so most Blocks mods still get them from the second start. When a baked file and the code differ, the baked file wins at every start until the mod is rebuilt; kiln.log warns.
- Kiln does not take over from a ShroudForge loader that the launch options start; it tells you.
- EMF: minimap draws nothing; Beastmaster's markers, buff reads and move reads do nothing; teleports has no map action.
- An EMF server set to refuse that also requires content mods still refuses a Kiln game: Kiln's list has no content entries yet.
- On Kiln an EMF mod's chat line always shows without a speaker's name, also a plain
chat_tell(EMF shows that one under the player's own name). - After leaving a server and joining another one without restarting the game, an EMF server's greeting is answered only when it arrives after the world has loaded (EMF greets 10 s and 45 s after you connect). When both come earlier, that session has no EMF mod messages and no mod check; rejoining fixes it.
- The services' new capability rows and change events were proven on test tables and on a test server with six test mods, not in a real player's game.
- KILN121 trusts the marks and reads one member at a time: a check in a helper of your own, in a field, or in another class's property is not seen, and a guard that is true for more than one reason (the service is there, or the mod is being baked) does not count as asking.
- The recording fakes were checked against the services' code and headers, never against a running game.
- The save editor's Deck tab and its new checks ran in the browser test bench only (Chromium), not in a real launcher window, on a real Deck or against a real save.
- A native service that appears only after Kiln's services started is found within about a second, except by Kiln.Hooks, Kiln.Build, the content service's link to the asset service, and the menu's craft-menu and render tables: those keep their first look for the whole process.
- If the launcher crashes or is killed while it cooks a mod, nothing is lost, but the mod can be left half-cooked. Its last good cooked files are set aside and come back at its next cook; until then they load only once a cook of the mod ends well. The mod's own
assets/assets.json,assets/cook.jsonandblocks/*.materials.jsonstay as the stopped cook left them, which can make the mod read as changed. Press Play or "Cook again" to cook it afresh; in Copy mode, activating the profile again also copies a clean version from the Library. - On Linux, if the launcher itself crashes during a cook, the cook tool it started keeps running until it finishes. It writes only into that mod's
assets/cookedfolder, and the next cook starts that folder from scratch. - The cook tools check where they write, not what they read. A mod's recipe can name a source file outside the mod's folder, which the cook then reads with your rights; what it reads stays on your PC, and a stuck read is stopped by the cook's time limits. Install mods only from sources you trust, as with any mod that runs code.
- Kiln.Combat and Kiln.Gameplay start listening to the game when a mod subscribes to one of their events or calls into them from its own code on the tick thread. A mod whose only handler is a catch-all (
KilnEvent) and whose first call comes from a thread of its own (Task.Run) gets none of their events until one of the two happens. - The fix for the hang at the start beside other loaders was proven in a test process, not in a real game with the stack of loaders that showed it; the second signatures were checked against the recorded game files, never used by a running game here; the Mods page at high scaling was computed, not seen on a 4K display.
- Auto Doors (a mod of another author that loads through its own
powrprof.dll) checks the game's code itself and turns itself off when Kiln has hooked the same functions first; its log then says "function bytes do not match". Which of the two is first is not fixed. That Kiln keeps working beside it was shown on the game's file with Auto Doors' hooks laid over it, not in a running game. - Find (a Greeneye Loader mod) was checked against the game's file and against what Kiln gives Greeneye mods, and nothing was found that would stop it; it has never been run in a real game under Kiln.
- The scrolling pause menu was tried in one real game (Linux and Proton, 3440x1440, mouse wheel and keyboard, 10 mods' entries): it fills the menu's column, draws the game's scrollbar and follows the highlighted entry. Other resolutions, UI scales and a gamepad were not tried; it is built on reading the game's code, so on another game build it may not fit. It starts at more than 3 mods' entries (the height of a menu row is not measured); kiln.log's line "the pause menu scrolls: ..." has the sizes, and a view much shorter than its column switches scrolling off with a line that says so. When Kiln cannot put the menu's layout back in order after a fault, it ends the game on purpose (the game would stop with a layout error a moment later), writes why to
kiln/state/menu-scroll.gave-up, and the next start keeps scrolling off. - "Changed on disk", All on and All off, the new profile from a drop and the menu entries on the Mods page ran in tests and in the browser test bench only, not in an installed launcher or a real game.
- A mod edited in its Library folder that is already copied into the game (an EML mod in the game's mods folder) keeps running with the old files until it is placed again; the list shows "Changed on disk" at once.
- A handler's change that still waits for the next step when the same mod resets or reverts many values at once (a creature's whole state, a mod's content changes) is announced after that reset.