What's New
What changed in Shell Editor, the newest first. A Project gets each change the next time its Sandbox starts.
Shell Editor 0.6.0
- The Inspector draws every component alike: its name, with ⋯ on the right, and its fields under it, also one with a single field or none. Every component is under a heading: the gizmos under Debug, and a Project’s own that has none under Other, the last.
- Project Settings (File › Project Settings…, Ctrl/Cmd+,) sets what the whole game shares, one of each kind in a Project, such as Physics, UI Scaling and the Splash Scene, and the kinds your scripts make. Search finds a field, Reset to defaults puts a kind back, and each change is one undo step, also while the game plays. Preferences are now Shift+Ctrl/Cmd+,.
- A kind with many files, each one an entity or a terrain points at, is a preset: New › Preset… in the Assets panel makes one. The Assets panel does not show Project Settings’ own files.
- Physics in Project Settings sets the gravity, the contact passes and the layers. Each layer keeps its bit for good: a new one takes the lowest free bit, removing one leaves its gap, and removing one the open scene uses asks first. A layer mask field names the layers and opens Project Settings at Physics.
- New Camera Pan Zoom, for a camera the player moves: drag the map, move it with the arrows or WASD, and zoom with the wheel, a pinch or two fingers, between its least and most zoom and inside the Camera Bounds. With a Camera Target the camera follows until the player drags or moves it.
- The Agent reads and changes Project Settings and presets, and makes presets.
- This release prepares Shell Editor for a future domain move. Keep using your current address.
- Files are not converted. In a Project made before 0.6.0, set a settings file of a kind that is one in a Project again in Project Settings (or move it to the name shown there), and rename a file of a kind with many to end in .preset.json. Scenes and prefabs are still format 3.
- Physics layer names are not carried over: in a Project made before 0.6.0, make them again in Project Settings › Physics › Layers at the bit numbers they had (Layer N at bit N), so the layers and masks its scenes already use keep their meaning. Add takes the lowest free bit and a bit cannot be typed, so add a stand-in layer for each unnamed bit before a named one, until every named layer has its old bit, then remove the stand-ins: their bits stay free.
For a Project's scripts:
- PhysicsLayers (physics:layers) is gone, and its file is not read. A layer is now { name, bit } in the layers list of PhysicsSettings (physics:settings), the Project’s one physics settings file, bit N being the layer 1 << (N - 1). Code that read PhysicsLayers uses layerBit(world, name) for a layer’s bit, layerNames(world) for every name by bit, or settings.get(PhysicsSettings).layers.
- A .settings() type is one file in a Project, at Settings.fileOf(its serial key), the name Project Settings gives it (example:gameSettings is settings/example.game-settings.settings.json), read with settings.get(Type) and no key: get(Type, key) and all(Type) on it now throw, and its files anywhere else are not read. A type with many files by key is marked .presets() instead, read with get(Type, key) or all(Type), its files ending in .preset.json; a tileset terrain’s data type is one.
- Where the Project’s physics settings set gravity or contact passes, they win over the gravity and iterations given to CorePlugin and CollidersPlugin in code. They are written to physicsGravity and physicsContacts before any Startup system, and a script’s own later change to either stays.
Shell Editor 0.5.0
- A collider with no RigidBody on its entity or any of its parents is now a solid wall that stands still and pushes, where it used to be a zone that only noticed. For a zone, switch on the collider’s Trigger: it then notices what it touches and stops nothing.
- Saved scenes and prefabs are not converted: any zone made before 0.5.0 from a collider without a RigidBody of its own now pushes, as a wall or, on a child, with its parent’s body, until you switch its Trigger on.
- A collider on a child belongs to the nearest RigidBody up its parents, so it moves and pushes with that body; before, a child’s collider with no RigidBody of its own was a zone.
- The Collider tool draws a solid collider in green and one whose Trigger is on in dashed orange.
- New Character Mover, for a player that runs and jumps: on a kinematic body with its own collider, it moves the body by its Velocity, slides along walls, floors and ceilings, says whether it stands on a floor, rides a moving platform, and stands on a one-way ledge and jumps up through it.
- The Character Mover’s limits: it moves only a kinematic body that has no parent (under a parent its Velocity alone moves it), it does nothing on another kind of body, and the game gives it its own gravity.
For a Project's scripts:
- A collider with no RigidBody on its entity or up its parents is now solid, and a collider on a child moves and pushes with its parent’s body. Any zone made from a collider without a RigidBody of its own needs trigger: true on its BoxCollider or CircleCollider. Code that took such colliders for triggers must read the contact’s trigger instead.
- A collision contact and a collision event (CollisionContact, CollisionEvent: CollisionStarted, CollisionActive and the others) now carry bodyA, bodyB and trigger. Reading them needs no change; code that builds a contact or an event itself must add all three.
- RaycastHit now has trigger, and BoxHit and CircleHit have body and trigger. Code that writes one of these objects itself, such as a hit passed to closest or castBox to be filled, must include them. A query takes triggers: false to leave triggers out.
Shell Editor 0.4.0
- Editing together shows who is doing what: the other Members’ faces on what they have selected in the Hierarchy (three, then “+N”), “Ana is here too” with their face in the Inspector, and their name above what they have selected in the scene view.
- When another Member’s pointer is outside your scene view, an arrow with their name waits at its edge. Press it to centre your view on their pointer; your zoom stays.
- Say something by your pointer: with it over the scene view, press / and type. The others see the line as you type; Enter keeps it for 5 seconds, Esc clears it. It is never saved, and the Agent does not see it.
- The Collider tool (C) is in the scene view’s tools while a chosen entity has a box or circle collider: drag a handle to size the collider, or the middle ring to move its offset. Each drag is one undo step.
- Fit Collider to Sprite sizes a collider to its picture: the button beside the Collider tool, or Fit to Sprite in the collider’s ⋯ menu. A collider added to an entity with a picture starts fitted.
- Physics: a stack of boxes now stands, and a body with a bounce bounces off a floor with none. A fast fall onto a static platform lands instead of passing through, unless the body was already inside it; two fast moving bodies can still pass through each other.
- The Agent is told when it gives a tool an argument the tool does not take, instead of the argument being ignored.
- Scenes, prefabs and tilesets are unchanged: a Project needs no conversion for 0.4.0.
For a Project's scripts:
- A contact now bounces by the larger restitution of its two bodies (it used the smaller), and contacts are settled in several passes each step (physicsContacts.iterations, 8 unless set, a whole number from 1 to 64). A game tuned to the old bounce or to a sinking stack may move differently.
- A raycast or overlap given a mask and no layer now takes only the colliders on the mask’s layers; it used to take every collider, so it may return fewer hits.
- Code that writes out a whole CollidersPluginConfig or PhysicsPluginConfig must add iterations. Setting some fields with .config({ … }), or keeping the defaults, needs no change, and closest(query) calls work as before.
Shell Editor 0.3.0
- File actions are quicker in large Projects, as the Project’s server handles their file lookup in one request: Delete counts where a file is used, Save checks the files a saved file names, and Move works out which references to update. If Delete cannot finish its count, it says so instead of saying nothing uses the file.
- A new file keeps its row in the Assets panel while it is being made, and it cannot be opened, renamed, moved or deleted until it is there.
- A scene follows a prefab moved with its id, also when another file now has its old path.
- In a tileset’s Inspector, switching a terrain between 6 shapes and 15 tiles keeps the frames you leave, and switching back brings them back, also after a reload.
- A repeated notification is shown once with its count. At most four notifications that close by themselves are shown, the oldest going first; an error stays until you dismiss it.
- Other Members’ pointers in the scene view show their names.
- When New ▸ Splash Scene cannot write or confirm its script, the console says what to do, and the splash scene still leaves.
- The Agent works from one shorter guide, and each of its tools says how to use it.
- Scenes and prefabs are still format 3: a Project already converted for 0.2.0 needs no new conversion.
For a Project's scripts:
- Tileset files can now be version 3: a terrain may have kept, the frames of the way it is not drawn, never drawn. Code that reads tileset JSON must accept version 3 and leave kept alone; code that writes it must keep kept and version 3.
- CollisionResolverSystem and CircleCollisionResolverSystem no longer keep pushed and steps in their locals; code that read them must stop.
Shell Editor 0.2.0
- Scenes and prefabs now save in format 3. Older files still open. Ask your team for the Project conversion prompt and paste it into the Agent panel before editing an older Project.
- Files now have ids. The editor follows a file moved with its id; a picture or sound moved in a shell must keep its .meta file beside it.
- A save naming a JSON asset without its own id can be refused. Use Assets > Replace with that file itself; give any files it names their own ids first. Then save again.
For a Project's scripts:
- PixiRenderLayer, PixiLayer and $pixiRenderLayer are now RenderLayer, Layer and $renderLayer. Scene component keys sprite, renderLayer, colorOverlay, spriteSheet and nineSlice no longer have pixi: prefixes.
- Scripts that read or write scene JSON must read hierarchy from each scene entity’s parent and order. The old components.parent and components.children links are gone.
- File references can carry ?id= after their path. Use files.sameFile to compare files and pathOf(files.urlOf(value)) when code reads the path.
Shell Editor 0.1.0
- Shell Editor has a number now. Each new one is listed on this page with what it changed, the newest first.