Since i’m preparing for thy ship… the new demo i’ve been working on is now in the templates directory, so anyone can use it and try it, And i also published a new demo release for it!

It is a short game with a small fetch quest and enemies where you have to help a guy get his car working…

https://github.com/torkelicious/obliberry/releases/tag/demo_0.0.9

audio cleanup and persistent sounds

mostly audio , also got around to cleaning up the audio engine, added persistent sounds across scene changes, and fixed some ui stuff.

changes

audio

• the old AudioEngine had raw ma_sound*s and a whole separate map just to keep decoders and their buffers alive. cleanup was duplicated everywhere, so i moved it all into SoundInstance with RAII. sound, decoder and VFS bytes all get cleaned up together now
• music and sfx use the same type, stored as unique_ptr. StopMusicUnlocked went from a bunch of manual cleanup to basically m_CurrentMusic.reset()
• PlaySound2D takes an optional persist flag. scene changes now stop normal audio, while persistent sounds keep playing until they finish
• before this, audio just kept playing across scene switches whether you wanted it to or not. that’s fixed now w. the persistent flag

scripting and packaging

• added IsEditor() so scripts can tell if they’re running in the editor or editor play mode (im using this for debugging stuff in the demo im working on :P )
• PlaySound2D in ObSL accepts the new persist argument !!!
• bumped the ObSL submodule, ( which needed a fix in the script asset analyzer )
• packaged scripts now initialize with the correct path for imports. this was hardcoded to assets/scripts before, which doesn’t work in packaged builds

editor

• the Project Browser has an Audio section now for .mp3 and .wav files
• generalized the file-listing helper to accept multiple extensions, which the Scripts section uses too
• swapped the UI Hierarchy and Registry tab order. tiny change but it’s the order i actually use…

ui

• fixed button hit-testing for nested UI elements. Update() wasn’t accounting for the position accumulated through the element hierarchy, even though Draw() already was

the demo…

ive been working on a new demo project, most of my time has been spent just messing around in that (and is how i’ve been discovering these issues)

---

audio is in a much better place now… and the demo is looking pretty good….

rahhhh

been working on the new… demo… and well, it found some things. mhm

changes

gizmos and transforms

• rewrote the entity gizmo so moving things under rotated or scaled parents actually works properly
• transforms now handle custom matrices and shear much better, including when reparenting
• made hierarchy updates more robust, added matrix support to scene files, and stopped rounding transform data on save
• gizmo undo is more consistent now, and the editor warns when a transform has shear

pathing

• movement can now re-plan around blockers, and picks a nearby free hex if the destination is blocked
• scripts can set paths without drawing the path overlay, which is useful for enemies

script messaging

• added Send, Broadcast and on_message so scripts can communicate with each other
• messages support basic values and are delivered through a queue on the main thread

scripting and components

• SetTimeout now can forward arguments to callbacks
• point lights can be disabled, and particle emitters remember whether they’re active when saved
• added a bunch of smaller fixes around scene saving, prefab parenting and serialization

obsl

• some separate ObSL updates too: variadic native functions, multiline comments, a formatter and fixes for nested calls. (not tracked here though)

DEMO!!!!!

• im working on a new demo :0

---

oh and it is my birthday woaw

script properties & UUID types

scripts can now declare properties that show up in the inspector and get saved per entity. also ripped std::string UUIDs out of most of the engine in favor of an actual Core::UUID type, plus some scripting additions and a few tests.

changes

script properties

• Prop("SpeedOrSomething", 2.5), PropEntity("TargetEntity") and PropUI("MyRect") for regular values, entities and UI elements
• properties show up under each script slot in the inspector, with appropriate controls and per-slot values
• values are only readable during top-level script execution, so store them in variables for use in hooks. Prop in a hook just returns the fallback
• saved as scriptProperties in scene JSON, omitted when empty
• property edits support undo, including live number/string editing. unused saved properties can be pruned with undo too..
• ScriptSlot is move-only now

Core::UUID

• replaced string UUIDs across the registry, UI, editor commands, project config, save directories and scripting with a 16-byte Core::UUID
• registry UUID lookups now use an index instead of looping through entities
• malformed UUIDs in files fall back to generated or nil UUIDs
• UI UUIDs are saved and restored, including nested elements. duplicate UI UUIDs are handled without crashing the loader
• savegame directories etc take a UUID directly

scripting & UI

• script objects now have identity values and wrappers are readonly, along with various scripting result objects. came with an ObSL bump
• UI wrappers get SetParent(parent) and a uuid field. null reparents an element to the root
• UISystem::Reparent preserves ownership and prevents parenting an element under its own descendant
• new created scripts use fn on_update(dt) (I wrote on_update() last time …oops…)

smaller stuff

• UndoManager::Execute returns whether the command applied
• script list shows filenames with Remove beside them

tests and docs

more tests and docs updated ofc…

so u can reference entities in scripts without using Find() now!!!

uuid-bound script wrappers…, logger sinks…., and a pile of small editor stuff….

mostly scripting + logging plumbing this time, plus a couple of editor things I’d been wanting…

changes

script wrappers are uuid-bound now

entity wrappers used to capture the raw runtime id, which is a problem if ids get recycled or the registry gets rebuilt. now every wrapper holds the entity’s uuid and resolves the live id on each call, so it keeps pointing at the right entity (or does nothing if it’s gone).

• new FindEntityByUUID(uuid) global and GetUUID() / .uuid on entity objects
• SetParent matches an entity object by uuid, a plain number is still a runtime id
• same treatment for UI wrappers: they resolve by uuid instead of name, so renaming or duplicate names don’t break them
• added FindUIByUUID, GetUUID() and Destroy() on UI elements, and SetImage / GetImage on images (acquires the texture through the scene asset scope like fonts do)
• still by name: FindUI, DestroyUI and the button state queries (WasClicked / IsHovered / IsHeld). UI scripting is still weird… work in progress i guess…

logger sinks

the old way was swapping the logger’s std::ostream for a stringstream that the UI panel also read from, which was a data race waiting to happen (logger thread writes, main thread reads). replaced it with actual sinks:

• ILogSink with ConsoleSink (stdout/stderr like before) and UILogSink (mutex -ed pending buffer the panel drains each frame)
• the editor and runtime both register a ConsoleSink, and the editor adds the UI sink on top, so the Logs panel is always there now instead of only when there’s no tty
• console panels color lines by severity now
• interpreter output goes through a small UiStream ostream into the ObSL panel, with stdout and stderr split (needed the bumped obsl, Interpreter takes both streams now…)
• ObSL panel clears when you enter play mode

editor

• F focuses the camera on the selected entity, press it again to go back to the origin. its smooth…., ..panning cancels the focus
• keyboard pan only gets called when there’s actually input now..
• editing a material in the inspector no longer mutates shared runtime-only materials. if it isn’t a catalog asset it gets cloned into assets.json first, and edits to catalog materials get “upserted” back to the catalog. “Clone Material” writes to the catalog too
• new scripts from the project browser come with an on_update stub instead of just a comment

scripting runtime

• script top-level code now runs with the command buffer in “immediate” mode (BeginImmediate/EndImmediate), so registry writes at the top of a script apply right away instead of waiting for a flush that hasn’t been set up yet during init
• Hex_GetNeighbors wasn’t GC protecting its array while filling it, fixed….

grid tile textures

a tile type with no texture used to fall back to hex_tex both when collecting dependencies and when loading scenes, which would pull in a texture that might not exist. now no texture means no texture… as it should…

misc

• bumped obsl (new using alias feature, and err output stream settings)
• docs for all the uuid stuff, the F key, and the new UI/image methods… of course…

oh also … new demo scene testin thingamabob im messing with…

map edit kinda overhauled

changes

map edit stuff

• the brush size is now 1 to 8 instead of 1 to 5. size 1 is one hex, size 2 is 7, size 3 is 19, etc. Ctrl+scroll also changes the size
• added Rect and Circle shapes alongside the brush. they work with Paint, Erase and Select. Rect uses opposite corners, Circle goes from a center out to the hex you release on. both apply on release
• paint previews are green, erase previews are red, and selection previews are yellow. selected tiles get a blue overlay
• added tool hotkeys: B for Paint, E for Erase and Q for Select
• Esc cancels a drag. Rect and Circle do nothing if cancelled, while a brush stroke gets reverted instead of leaving half the changes behind
• loading a map now prompts before discarding a dirty map, and successfully creating or loading a map clears the old undo history

selecting and editing multiple tiles

• Select now supports click and drag, Shift+drag to add to the selection and Ctrl+drag to remove from it
• the toolbar shows the selection count and has Clear and Delete buttons. Delete removes all selected tiles in one undo step
• the Tile Editor can edit the type and walkability of the whole selection at once. when selected tiles differ, the controls show mixed values etc.
• material editing only appears when every selected tile shares a type. Override Current Type changes the material for every tile using that type, while Save as New Type assigns a matching type to the selection without changing every other tile using the old type
• brush strokes, Rect/Circle fills, deletes and bulk type or walkability changes are each grouped into one undo step. changing a type’s material itself is still not undoable….

the console….

• logging now has a sink system, so the same formatted log messages can go to different outputs
• the editor now has separate Logs and ObSL panels. engine/application logs go to Logs now, and script stdout goes to ObSL
• the panels have Clear and Copy buttons and keep the latest 2000 lines. the UI sink buffers incoming logs under a mutex before the editor consumes them

closing the editor

• closing the window now goes through a callback, so unsaved scene or project changes trigger the save/discard prompt instead of immediately closing
• removed the old global Esc-to-quit shortcut.
• ObSL’s CloseWindow() no longer closes the editor while in Editor mode. it logs that it was called instead. in the runtime, it still closes the window

windows and smaller fixes

• enabled /MP for MSVC builds, and the editor/runtime targets use the Windows GUI subsystem so they don’t launch with a console window attached
• atomic file writes now write the byte buffer explicitly and retry Windows file replacement when it fails with access-denied or sharing-violation errors, for up to about 2 seconds
• a bit of cleanup around collision pair sorting, const-correctness and naming

docs

updated the editor guide and screenshot to cover the new tools, shapes, selection controls, shortcuts and undo behavior. blah blah

---

…map editing is finally a lot less barebones…

uhhh

changes

dont nuke scene on failed load

• scene deserialization moved out of Scene::OnEnter into SceneManager::LoadScene, and now runs before the old scene gets torn down. if the new one fails, you stay in the old scene (LoadSceneByPath returns a bool now)
• loading is stricter. missing map files, bad/out-of-range/cyclic parent values and broken UI sections fail the load instead of logging an error and limping on
• persistent entity migration happens before the swap too, so a failed asset acquire can’t leave you half in the new scene
• the editor’s LoadScene used to clear the current project before trying to load. now undo history and selection only get cleared once the load actually worked
• saving: map write failures now propagate instead of reporting success, and files get closed before the error check

destroying entities

• DestroyEntity was recursive, now it’s iterative with a visited set. deep hierarchies, cycles and duplicate child entries no longer kaboom the stack or double delete, and children go first (wow that sounds dark)
• Reparent and SetParentDirect go through CanSetParent, which rejects cycles and stale parents, even if the existing hierarchy is already cyclic
• script DestroyEntity / entity.Destroy() now use RequestDestroy to tag the entity and its whole subtree instead of deleting immediately, so on_destroy runs before deletion. scene exit drains the destroy queue too, including entities tagged by exit hooks
• the script wrapper cache evicts an entity when it’s destroyed
• a dumb one…: the hot-reload cleanup list had on_exit in it twice and no on_destroy, so on_destroy GC roots never got released …
• the script system was holding raw ScriptComponent* across initialization, which dangles if a script spawns enough entities to grow the pool. it looks components up by entity ID now
• script runtime reinitialization after a scene change uses the VFS path and reruns setup, so using imports keep working from the mounted project

ui undo

UI elements have UUIDs now, and undo commands resolve them by UUID instead of holding raw pointers. removing an element captures the whole subtree plus its sibling position, so undo restores the hierarchy and order. renaming also updates the name index live.

smaller fixes

• collision broadphase is a “spatial hash grid” now instead of checking every pair
• lightmap rebakes when ambient changes, and handles maps with no tiles
• atomic file writes use unique temp names so concurrent writers don’t trip over each other
• project changes wait for background asset loads to finish
• timeout timers are mutex-protected, and callbacks can schedule more timers without deadlocking
• SmallTask over-aligned captures fall back to the heap
• VFS::Resolve("..") had UB from a std::mismatch that wasn’t bounded on the second range…
• PlayMusic stops, swaps and starts under the lock now instead of racing!!!

tests

wrote a pile of tests alongside all this: atomic writes, wrapper cache, hierarchy safety, map serialization, save concurrency, scene loading failures, script lifecycle, script modules, SmallTask and timeouts. expanded to the editor command, save game and VFS tests.

---

so EVEN LESS explosions !!! Woo!

undo stuff + render lifetime fixes

undo / redo

the undo system relied way too much on runtime entity IDs and direct pointers into components.

that works until an entity gets deleted, an ECS slot gets recycled, or a dense component pool moves stuff around…

entity commands now store the entity UUID and resolve the current runtime entity when they execute / undo instead.

this now applies to transforms, renaming, adding / removing components, script changes, component field edits and map painting.

so older commands can still find the right entity even if it was deleted and later restored with a completely different runtime ID.

deleting things is actually undoable now

finally added proper undo for deleting entities. !!!!!!

deleting an entity snapshots the whole subtree first, including components, UUIDs, names, hierarchy + sibling order, scripts, custom data and asset references.

undo rebuilds the tree, reloads required assets, restores the UUIDs and puts everything back where it was.

this also means edits from before the deletion still work afterwards, since those commands just resolve the restored entity by UUID.

paste uses the same snapshot system now too, so undo / redo keeps the same pasted entity identities instead of creating unrelated ones every time.

there are checks for conflicting UUIDs, missing parents, invalid hierarchies, missing assets etc. failed restores shouldn’t leave half-created entities behind.

failed commands also no longer get added to undo history or wipe an existing redo chain.

custom ObSL data

custom script data needed special handling too.

arrays / objects can share references or even be cyclic, so just copying ObSL::Values wasn’t enough.

there’s now a snapshot format that captures the object graph and rebuilds it through the interpreter + GC when an entity is restored.

CustomDataComponent also roots stored ObSL values properly so GC-managed objects stay alive.

runtime functions aren’t snapshotable though, so deletion just fails instead of restoring garbage.

render thread lifetime stuff

also did a pretty big pass over renderer resource lifetime, mostly because scene switching could unload resources while an already submitted frame was still using them.

(this started because someone mightve pointed out a lil crash for me…)

render commands now pin the meshes, materials, shaders and textures they need until that frame is done.

same idea for UI textures and the editor viewport framebuffer.

OpenGL objects also don’t call glDelete* from whichever thread destroys the C++ object anymore. textures, shaders, buffers, VAOs and framebuffers queue deletion for the render thread, while it actually owns the GL context.

less bugs yay

frame state + shutdown

renderer state that can change while the render thread is behind is captured per frame now too, including clear color, post-processing and UI resolution / projection state.

shutdown is also more deliberate now: worker threads stop first, background font loads finish, scripts stop, scenes/resources are cleared, renderer/UI resources shut down, then the remaining GL delete queue is processed while a context still exists.

font loading uses tracked jthreads now too instead of detached threads.

small things

exporting now reports success / failure back to the editor and shows a little result popup instead of silently relying on the console.

also added tests around delete / restore, UUID reuse, hierarchy restoration, script components, map edits, pasting, command failures and repeated undo / redo without leaking entities or asset references.

---

so. .. . less explosions hopefully

sorry if wording is weird.. character limit..

export dependencies + prefab asset loading

redid how exporting figures out what needs to go into the package

previously editor export was basically much closer to just packing the project directory. now it builds a dependency manifest first

figuring out what to export

export starts from the project + scenes and follows the things they reference:

• catalog assets used by entities, maps, UI and post processing
• map files
• attached ObSL scripts
• script using imports
• scenes loaded from scripts
• prefabs instantiated from scripts
• music / sound files
• material textures + shaders
• animation sheets
• shader #includes

referenced scenes and prefabs get scanned too, dependencies keep chaining from there.

it then generates a new filtered assets.json specifically for the package instead of sticking the entire project catalog in there.

the actual project’s catalog is untouched.

script analysis

added a ScriptAssetAnalyzer which walks the ObSL AST without actually running anything.

literal stuff can be narrowed down properly, including things like:

PlayMusic("assets/audio/music.ogg", 1.0)

or even constant string concatenation…

asset setters like SetTexture / SetFont get tracked too.

if a texture or font ID is dynamic, export keeps that entire asset category.
if a runtime file path for stuff like LoadScene, Instantiate, PlayMusic or PlaySound2D can’t be figured out, it falls back to keeping the eligible project files + full asset catalog.
unknown / indirect calls are done the same too

so simple projects get smaller exports, while weird dynamic scripting should still work…

.pakignore still applies, and required files being missing or ignored is now an export error

prefab assets

also fixed prefabs properly interacting with the lazy asset system.

instantiating a prefab now scans its components, acquires whatever catalog assets it needs, resolves their dependencies, and retains them in the scene before creating the entity.

so a prefab can use an asset that wasn’t already referenced by the scene and it should just work.

scene asset scopes got changed a bit for this too. instead of accumulating a new scope every time something acquires assets, they’re merged into one scene scope and duplicate asset references are ignored.

also made prefab revert a little safer so the old entity isn’t destroyed unless the replacement prefab actually instantiated successfully.

packaging / ci things

editor packaging is stricter in general now. script dependency validation can fail the export, missing dependencies stop it, and PackageCurrentProject reports failure so the rest of the export doesn’t continue pretending everything is fine.

shader includes are followed during dependency collection too, while the engine shader helpers still get bundled for runtime includes.

also cleaned up CI a decent bit…

also some more tests too for the packaging and script analysis

lowk sorry for just posting an image of the logs idk how else to show it since it’s mostly backend / file stuff 😭

more tests (more bugs)

kept going with the unit tests

the test suite now covers most of the important stuff, including:

• ECS / entity IDs / UUIDs
• serialization + hierarchies
• collision geometry, events and movement
• maps
• animation
• saves
• ObSL + some EngineLib bindings
• assets / asset lifetime
• VFS + packaged projects
• configuration
• editor undo commands

also added a couple integration tests for audio and rendering (OpenGL tests are optional)

finding things

unsurprisingly this found some actual problems too.

stale entity handles can no longer remove / access components from an entity that reused the same slot, and editor undo commands are a bit safer around entities or components disappearing.

also fixed some hierarchy rotation decomposition weirdness, cleaned up VFS / package mounting state so old package data can’t leak into the next mount, and added a few other small null / cleanup checks around scenes and rendering resources.

unit tests (& some fixes)

uhhhh started adding actual unit tests… i was kinda putting it off but i gotta have it…

set up GoogleTest + CTest and started covering some stuff

• ECS registry / generational IDs
• entity UUIDs
• entity serialization
• hierarchy / parenting
• collision events + movement blocking
• save games
• maps

bugs bugs bugs…

and unsurprisingly, writing tests immediately started exposing some smaller issues.

fixed stale entity handles being able to mess with components belonging to a recycled entity slot, and cleaned up some hierarchy transform / rotation handling that wasn’t preserving transforms correctly in certain parenting cases.

also tightened up a couple math helpers while testing them.

im still gonna write even more tests.. its very needed at this point and will prolly help me find some more bugs i missed before…

uuids, collision layers, save settings, and other stuff

bit of a mixed bag this time. mostly cleaning up some systems that were already there and filling in stuff I’d need…

entity UUIDs

entities have proper UUIDs now, separate from their normal runtime entity IDs.

the regular generational ID still does all the normal ECS stuff, while the UUID is a stable identity that gets serialized with the entity.

this mostly fixes how persistent entities work between scenes.

previously I was deduplicating persistent entities by name, which was obviously not ideal since names aren’t actually identities.

persistent entities + their children now keep their UUIDs when moving between scenes, and if the destination already has an entity with the same UUID it gets replaced by the carried-over one.

two things can have the exact same name now without persistence randomly deciding they’re the same thing.

normal prefab instances / newly created entities still get new UUIDs.

collision layers

colliders now have proper layers + masks.

there are 32 collision layers, and every collider has:

• a layer
• a 32-bit mask of layers it accepts

both colliders have to accept each other’s layer for the pair to interact.

the same filtering is used for normal overlap events and movement blocking, so there isn’t a separate set of collision rules depending on which system happens to be asking.

added editor controls for this too, including the layer selector, all 32 mask toggles, and select all / deselect all buttons because clicking 32 checkboxes individually sounds incredibly fun.

scripts can also read / change the layer and mask now.

collision-aware script movement

also added Transform.TryMoveTo(x, y, z) to ObSL.

unlike SetPosition, this checks whether the entity can actually occupy the destination before moving it.

the normal hex movement system uses the same helper now too, so script-controlled collision-aware movement and normal movement go through the same path.

direct SetPosition is still basically teleporting, which is intentional.

also fixed on_collision_stay actually looking up the collision stay callback instead of the trigger stay callback.

whoops.

more save settings

did some more work around the save system from the last update.

saving can now be enabled / disabled per project, and projects can choose where save files go:

• Data Home, the normal OS application-data location
• Portable, relative to the executable

both still use the project UUID underneath so different projects don’t start sharing save files because somebody named both of them game.

these are editable from Project Settings now.

also added a confirmation dialog when regenerating the project UUID since doing that changes which save directory the project looks at. the old saves aren’t deleted, the project just gets a new identity and stops finding them automatically.

graphics config stuff

changed packaged builds so graphics.json can live beside the executable and override the version inside the package. (i.e if someone decides to unignore the graphics config and package it)

couple random fixes

particle emitters now keep their actual live particle count, so GetAliveCount() in ObSL finally returns the real value instead of the completely useless placeholder it had before.

fixed a prefab revert issue where the code was reading the prefab path from the component after destroying the entity. very intelligent.

also made theme font loading a bit less fragile. missing / broken font files get logged and skipped instead of potentially taking the whole theme load down with them, plus some parsing cleanup.

and updated another mountain of docs to match all the collision, persistence, save, prefab, post-processing and export changes.

save system

i wanted this to be pretty generic instead of the engine having some hardcoded idea of what a “player save” or whatever is, so the actual save data is ba sically just key/value storage that scripts can use for whatever they want!!!

save data

there’s now a SaveGameManager which keeps one active save in memory.

save values can currently be:

• booleans
• numbers
• strings

the file format is versioned and also stores a display name + created / updated timestamps.

the actual save data itself doesn’t really care what the values mean. it is any key value pair that persists.

there’s also locking around the active save since scripts can be running across multiple workers…..

project UUIDs

projects also have their own UUID now.

it’s generated when the project is created or when a project that does not already have one is opened
right now it’s mainly used to give each project its own save-data directory without name collisions but im sure its good to have outside that!!!

save files

the basic save file operations too

• create a new save
• write the current active save
• load a save
• delete a save
• list existing saves
• start a fresh unsaved “game”

save filenames are generated from timestamps. the human-readable name stays inside the file, display names don’t need to also be valid / unique filenames.

save_list() also gives creation + update timestamps, and saves are sorted by most recently updated.

writes are atomic too, so it writes through a temporary file before replacing the real save instead of directly nuking the existing one and hoping for the best

per-project save directories

save data is stored outside the project itself in the normal OS application data home

each project gets its own directory based on its UUID

<data home>/obliberry/<project uuid>/saves/

projects with the same name don’t fight over the same saves.. (i have several projects just called “UntitledProject” lol)

this is LocalAppData on Windows, Application Support on macOS, and XDG_DATA_HOME / ~/.local/share on Linux.

both the editor and runtime configure the save manager when the project is loaded, and it gets reset again when the editor closes the project !

ObSL

ObSL savedata enginelib intergration:

basic data stuff:

• save_set(key, value)
• save_get(key)
• save_has(key)
• save_remove(key)
• save_clear()
• save_new()

save file management:

• save_create(name)
• save_write()
• save_load(filename)
• save_delete(filename)
• save_list()

save_list() returns an array with the filename, display name, creation time and last update time

some cleanup

also pulled the atomic file writing stuff into a shared OS file utility, so assets.json can use the same code instead of having its own implementation.

bunch of formatting stuff too

---

i still have to document this and do some more testingf but yeahhh

asset system refactor + some editor stuff

been wanting to redo how assets work for a while now.

until now scenes carried the asset definitions with them, and loading scenes would keep throwing resources into the global resource manager. worked fine enough , but it also meant resources could kinda just accumulate forever..

i seperated them now!!

assets.json

projects now have a project-wide assets.json catalog.

textures, shaders, meshes, materials, fonts, animation sets, etc. live there instead of getting serialized into every single scene.

scenes / prefabs / UI / animations etc. just store resource IDs and the definitions live in one place

besides making scene files considerably less bloated, this means saving a scene no longer serializes whatever random collection of resources happens to currently exist in the resource manager

lazy asset loading

having one project-wide catalog does not mean loading the entire project into memory.

scene loading now scans for the resources that scene actually references and loads those from the catalog

this includes stuff referenced by:

• entities
• maps / tile types
• UI
• post processing
• spritesheets / animators

dependencies get resolved too

so if something needs a material, its shader + texture get pulled in first. animation sets pull in their spritesheet texture, etc. etc.

now the the resource manager should only contain what is actually being used

asset lifetime stuff

added SceneAssetScope for keeping track of what assets a scene has acquired.

assets are retained while something needs them and can actually be unloaded once the last scope using them disappears

so changing scenes repeatedly should no longer turn the resource manager into

yummy more objects :O

forever….

persistent entities reacquire the resources they need when moving between scenes too.

there’s also handling for catalog entries being replaced / deleted while their old resource is still loaded. those can be marked stale and discarded safely once the old scene lets go of them instead of leaving weird zombie resources around.

engine assets still stay around like normal.

editor asset workflow

the editor now goes through the asset catalog too.

creating / importing / replacing / deleting things like:

• textures
• shaders
• meshes
• materials
• fonts
• animation sets

updates assets.json instead of depending on scene serialization to preserve them….

supported editor selections / script setters can also acquire catalog assets on demand and attach them to the current scene’s asset scope

old projects

old projects obviously still have all their assets embedded inside their scene files, so I added an ob_asset_migrator tool.

it can scan the old scenes and merge all of those definitions into a project-level assets.json.

there’s:

• dry-run validation
• conflict detection
• optional removal of the old scene assets sections
• backups before it starts rewriting stuff

uses backups because i dont trust myself enough .. might vaporize projects who knows…

docs docs docs

also updated a stupid amount of documentation for the new asset model … since of course..

there’s now a full assets.json format page covering the different asset types, dependencies, lazy loading, asset scopes, editor behavior and migration.

updated the scene / prefab / animation / post-processing docs too since all of those previously described assets as being stored directly in scenes.

also cleaned up the main README + docs index a bit and updated the feature list because quite a lot of it was outdated at this point….

theme presets

also did some work on editor themes.

split the built-in theme definitions out and added some interesting presets:

• Obliberry Dark
• ImGui Classic Dark
• Obliberry Light

ew imagine using light themes…

• High Contrast Dark
• Haxxorman Green

editable and all…

tldr: resourcemanager is now longer an infintly growing landfill…

I will not elaborate

animation editor

continued working on the animation system and made the editor UI….

animation editor

there’s now a Sprite Animation Editor

you can:

• choose the spritesheet texture
• edit rows / columns / spacing
• create, rename and delete clips
• toggle looping per clip
• edit individual frame indices + durations
• move frames up / down
• duplicate / remove frames
• expand / collapse the frame list

also added range generation so adding a normal animation doesn’t make you manually enter every frame one by one…..

theres also an Apply FPS to All Frames button !

preview

added a live preview for the selected clip.

you can play, pause and restart it woaw

it shows the current clip frame and spritesheet index while it runs….

project browser integration

animation assets are properly integrated into the project browser now too

there’s an Animations section where you can create, import, edit and delete animation assets

creating a new one lets you choose its path then opens it in the animation editor.

the animation asset workflow is mostly usable from inside the editor :D

erm even more

enginelib changes for the new systen that i still have to document…
(Play() Restart() etc)

some cleanup

working on… some mostly const-correctness, explicit casts, ranges, include cleanup and some other small stuff etc etc.. god bless resharper c++

also cleaned up some EngineLib entity wrapper code around registry locking so it can create wrappers safely when the registry mutex is already held

---

spritesheet used in video attached for testing is : https://opengameart.org/content/animated-butterfly

btw pls star on girhub

animation clips / refactoring spritesheets

…kinda refactoring the whole spritesheet animation thing already

the first version worked, but having FPS / looping / frame ranges etc directly on the SpriteSheetComponent was gonna get pretty limiting cuz what if I wanted multiple animations for one sprite.

it might sound stupid but for me it’s always worked to get a prototype working, then refactor/reimplement it. thats even what i did for this entire project early on, before it deleoped into a full on engine :D

so now the spritesheet is mostly just the sheet + currently displayed frame, and animation playback is seperate

animation clips

working on proper animation sets + clips.

an animation asset can have one spritesheet and multiple named clips, with each clip containing its own list of frames :D

each frame also has its own duration now instead of the whole animation just sharing one FPS value, so stuff like holding a frame longer or doing irregular timing is possible without

clips can loop independently too

animator component

added a separate SpriteAnimatorComponent which handles the actual playback state:

• animation asset
• initial clip
• autoplay
• current clip
• current frame inside that clip
• elapsed time
• playing state

the normal SpriteSheetComponent is way simpler now…
it just says what sheet + frame should currently be rendered
(the animator updates that for it)

animation assets

animation sets are assets now under assets/animations/

they serialize separately and contain the spritesheet setup plus all the clips / frames / durations

they are loaded through the normal asset system and registered in the ResourceManager

scene serialization now keeps the animator config like the selected animation asset, initial clip, and autoplay

editor stuff

the sprite sheet inspector got reworked for the current thing but whole UI stuff isnt finished

once an animator is attached it owns the sheet/frame instead of both systems trying to edit the same thing.

I still need a proper UI for actually making / editing animation assets and clips though. i shall work on this next!!!

(right now the backend is pretty much all ive done but its taken a lil longer than i thought…
who wouldve thought adding cips cleanly would take this whole aah refactor)

scripting

EngineLib updates too

SpriteAnimator in scripts can now do:

• Play("walk")
• Restart("walk")
• Pause()
• Resume()
• Stop()
• IsPlaying()
• GetClip()

it is now based on named clips

so i guess not anything flashy to show but… its stuff :)

spritesheets / animation

finally … spritesheet support

spritesheets

added a new SpriteSheetComponent with:

• texture
• rows / columns
• optional row + column spacing
• start frame
• animation length
• FPS
• looping
• playing / paused state
• current frame

basically the renderer can now render only a specific UV region of a texture

animation

also added a small sprite animation system that advances frames based on FPS and handles looping / stopping at the end etc etc

animations also update while in the editor… might be annoying for some, might be less annoying for others.. but thats how i like it

editor stuff

you can pick the texture, set rows / columns and spacing, choose the start frame + animation length, change FPS, toggle looping / playback, scrub the current frame, restart the animation, etc. etc

EngineLib

scripts can inspect stuff like the current frame, frame count, FPS, rows / columns and texture, and can also change the texture/grid/animation, set frames, play, pause, restart and stop animations.

Collider also has a proper EngineLib component wrapper instead of collision only being accessible through the callback hooks. right now that’s just getting / setting whether it’s a trigger, but it’s there.

also added both Collider and SpriteSheet to the normal GetComponent, AddComponent, RemoveComponent, HasComponent, etc. obviously.

some cleanup

did a bit of registry / EngineLib locking cleanup while I was in there too, mostly around entity wrappers being created while the registry lock is already held.

also fixed one very stupid collision callback typo where on_collision_stay was looking up the wrong hook… oops…..

im also starting on documenting this stuff…. yep.. pain…

spritesheet used in video attached for testing is : https://opengameart.org/content/animated-butterfly

collision callbacks

scripts can do collision things now….!!!

script collision callbacks

ObSL scripts can now define collision hooks:

• on_collision_enter(other)
• on_collision_stay(other)
• on_collision_exit(other)
• on_trigger_enter(other)
• on_trigger_stay(other)
• on_trigger_exit(other)

the other argument is a normal EngineLib entity wrapper, scripts can do stuff like check its name, components, etc.

collision events get collected by the CollisionWorld, then dispatched to the relevant script instances afterwards. they’re also run through the existing script command buffer ofc

2D collider shapes are back too…

added explicit 2D shapes alongside the 3D ones:

• Rectangle
• Circle

so the full set is now:

• Box
• Sphere
• Cylinder
• Rectangle
• Circle

rectangle / circle are flat shapes. which is nicer for sprites and other 2d things

movement actually respects colliders

hex movement now checks whether an entity can actually occupy its next tile before moving there.

added a CanOccupy() collision query which builds the entity’s collider at the target position, it blocks the move if something solid is in the way.

triggers don’t block movement.

collision robustness stuff

also did a bunch of smaller fixes around the collision

• added a shared collision tolerance instead of random 1e-6s in different places
• AABB overlap now uses that tolerance too
• improved collider validation depending on the actual shape
• fixed gizmo world-to-local conversion to use the proper inverse transform
• more finite-value / clipping checks in the collider gizmo
• GJK Indeterminate results preserve the previous collision state instead of automatically counting as a collision

---

p.s, heres a lil photo of my attempt at making syntax highlighting for obsl using textmate grammar… :D