Log inGet started
Package

styleRoles.package

This package holds more than this page lists. See all of its files in its world.

README.md

styleRoles: players, enemies and pickups that read apart under one look

One art style over a whole game, and the hero, the monsters and the coins still read as three different things. styleRoles gives you sixteen game roles to pick from, in sixteen sets: seven tuned for each kind of look in the Style Cookbook (a toon game, an ink comic, a watercolor storybook, a pencil sketch, pen and chalk, a paper cutout, and line and wash) and nine for a kind of game (a bright platformer, a tense arena shooter, an adventure or RPG with friends and foes, a racer, a horror game, a calm cozy one, a retro arcade one, a strategy or tower defence game and a stealth game) that sit over whichever look is on. Give a thing a role in one call; switch the whole game from one set of roles to another in one call; check on the frame the player sees how far apart the groups read; write your own set when none of them fits.

Version 1.4.2. Depends on styleKit 1.7.8 (style channels, sets that extend the look, the Roles glaze block). Works with every styleKit block package: toonBlocks, inkBlocks, watercolorBlocks, pencilBlocks, paperBlocks and starterBlocks.

Install and use

Install styleRoles from ZeroMind (search "players enemies pickups read apart" or "styleRoles"). It brings styleKit. The shortest way to see it work, in any scene with a styleKit look on:

local StyleRoles = require("~styleRoles.StyleRoles")
StyleRoles.give(entity.find("Goblin"), "enemy")   -- a heavier line in red ink
StyleRoles.give(entity.find("Coin"), "pickup")    -- bright, keeps its own colour

The scene picks the role set that suits its look by itself, so that is all it takes. A whole game, with the set picked by hand:

local StyleKit = require("~styleKit.StyleKit")
local StyleRoles = require("~styleRoles.StyleRoles")

StyleKit.applyLook("comicInkCel")                    -- any look (toonBlocks here)
StyleRoles.use("toonGame")                           -- the whole game's roles: one change

StyleRoles.give(entity.find("Player"), "hero")       -- one thing, one change
StyleRoles.give(entity.find("Goblin"), "enemy")
StyleRoles.giveAll({ "Coin1", "Coin2", "Coin3" }, "pickup")
StyleRoles.give(entity.find("Dragon"), "boss")
StyleRoles.give(entity.find("ScoreSign"), "asRendered")  -- a label left exactly as rendered

print(StyleRoles.of(entity.find("Goblin")).line)    -- what it gets under the current set
StyleRoles.use("inkComic")                           -- same roles, now tuned for an ink comic

A role sits on the object as a synced StyleChannel component (part of styleKit), so you can also add it from the editor's inspector: add styleKit.StyleChannel to an entity and type its role. Everything under the object takes the role with it (a character's mesh, a sword in its hand); a child with a role of its own keeps its own.

Things with no role look exactly as they did before. A scene where nothing has a role makes no extra passes at all.

The roles

RoleForWhat it does in most sets
herothe player's own characterthe clearest thing on screen: a bold clean line, little paper or grain
partnera co-op partner or second playerlike the hero, a little lighter, keeps a touch of its own colour
enemya common enemya heavier, darker line, often in its own ink colour
elitea tougher enemyheavier still
bossa bossthe heaviest line in the scene
pickupa coin, gem or health pickupbright and clean: little shade, keeps its own colour
rarePickupa rare pickup or power-upthe brightest thing on screen, no shading at all
usablea lever, door, switch, chesta clear line, lighter shading
objectivea goal, flag, exitlike usable, a little stronger
hazardspikes, saws, lavaa strong line, keeps a warning colour
projectilebullets, arrows, fireballsthin line, no shading, full colour
friendlya shopkeeper or villagera softer, warmer line
propcrates, barrels, wallsa thin quiet line so it stays behind the cast
ghostfaded, ghosted or inactive thingsa faint line, little shading
distantthe far backdropthe lightest line, sinks into the page
asRenderedlabels, signs, in-world HUDleft exactly as rendered, no look at all

Each role picks a variant of the look (player, enemy, pickup, interactive, hazard, friendly, background, or asRendered), a line weight (1 is the look as drawn), how much of each kind of mark reaches it (line, tone, fill, paper showing through, each 0 to 1), a value (every shipped block reads it as "how much of its own colour the thing keeps") and an ink colour for blocks that colour lines per object.

The sixteen sets

Sets for a kind of look

SetUse it withWhat it does
toonGametoonBlocks looks (Comic ink cel, Saturday morning, Clear line, ...)hero in bold navy ink, enemies in heavy dark red, boss heaviest, coins outlined in their own colour without hard bands
inkComicinkBlocks looks (Comic ink, Ink drawing, Noir, ...)hero crisp, enemies in a heavy deep line and darker wash, coins keep their gold through the ink; adds an ink line per variant
watercolorStorybookwatercolorBlocks looks (Picture book, Watercolor, ...)hero crisp with little wash and no paper showing, enemies in deep washes, coins bright and pure
pencilSketchpencilBlocks' graphite, charcoal, coloured pencil, blueprint and storybook lookshero clean, enemies shaded dark and close, props sparse, coins keep their colour among the graphite
paperCutoutpaperBlocks grounds under any lookhero printed clean, enemies on the paper's grain, coins as bright clean card
lineAndWashUrban sketch, Brush and washink lines per variant over a wash; pickups bright, props pale
penAndChalkBallpoint notebook, Technical sketch, Margin doodles, Conte figure studythe pencil set retuned for one-colour media: players light with a green line, enemies packed dark in near-black, pickups hatched in their own colour with a heavy orange line

Sets for a kind of game

SetForWhat it does
brightPlatformerjump-and-run, kids' gameshero in a bold royal blue, enemies in tomato red, coins gold and power-ups magenta so they pop, hazards hot orange, scenery thin and soft
arenaShootertense arena and action shootersenemies in a very heavy hot red line, bosses heaviest, your side thin cool cyan, ammo and health acid yellow, scenery pushed back with less tone
rpgFriendsAndFoesadventures and RPGsthe hero and the party in blues and greens, townsfolk and quest givers in warm gold, foes in wine red deepening to purple for elites and bosses, loot gold, rare items violet
racingracers and kartsyour car electric blue, teammates sky blue, rivals orange-red with the leader heaviest, boosts nitro green, checkpoints green, the track side thin so it streams past
spookyhorror, Halloween, hauntedthe hero in cold moonlight blue, monsters sickly green, elites bruise violet, the boss near-black and heavy, treasure candle gold, spirits pale and faint
cozyfarming, life sims, calm gamessoft, near-even lines in warm faded colours: the player in denim blue, neighbours olive, pests only gently apart in muted plum, harvest honey, tools sage
retroarcade, 8-bit and 16-bit style, pixel gameschunky, nearly even outlines in loud console colours: the hero lime green, allies sky blue, enemies hot magenta, the boss a deep violet slab, coins and power-ups orange and pink, scenery flat and dark
strategystrategy, tower defence, tacticsyour units royal blue, allies teal, enemy units crimson with elites and the commander heavier, resources gold, build spots cyan, the map thin and quiet
stealthstealth, heists, infiltrationyou in cool cyan, guards amber warming to red for the alert ones and the boss, cameras and lasers hot red, keys and loot pale gold, everything else low

Each of these extends: look: its line weights and inks sit over the set the look suits (toon game under a toon look, pencil sketch under a pencil look), which keeps deciding how much shading, wash and paper reach each role and what the value does. So all seven work under every look, they fill the same roles, they follow a look change by themselves, and a game swaps from one to another with the same one call: StyleRoles.use("racing"). The role names fit any game: partner is a co-op player, an ally or a companion, friendly any NPC on your side, enemy / elite / boss small enemies, tough ones and bosses, pickup a coin, rarePickup a power-up, usable anything you can use.

Each set's own README holds its full table. With no set picked, the stack takes the set that suits its look by itself (each set names the looks and packages it is for), so giving roles is often all you do.

StyleRoles.use(id) does two things: picks the set (StyleKit.setRoles(id)) and, where the set colours a variant's line (enemies in red ink), adds a copy of the stack's first Line entry drawn only on that variant, in that ink, replacing the copies the last set added. StyleRoles.use(id, { lines = false }) picks the roles alone. StyleKit.setRoles("none") turns every role off at once, to compare.

The Role Showcase scene in the Style Cookbook world shows all of this: a hero and partner, three grunts, an elite and a boss, coins, gems, a power-up, a lever, a goal flag, a saw blade, a shopkeeper, props, a ghost, a far backdrop and a sign kept as rendered, with a panel that switches between the seven look sets (each with its look), the seven game sets (keeping the look) and "Roles off". Put the same panel in your own scene with entity.spawn("RoleSwitcher").component.add("styleRoles.RoleSetSwitcher", {}).

Write your own set

A role set is a styleRoleSet asset: a folder holding roles.yaml, a README.md and a .metadata. Start from a shipped one with extends: and write only what differs:

name: My platformer
summary: Toon game roles, with enemies drawn twice as heavy and coins without paper.
extends: toonGame
forLooks: [comicInkCel]
lines:
  enemy: { ink: "#4a0030" }      # enemies' line in plum ink (StyleRoles.use adds the line)
roles:
  enemy: { line: 2.4 }
  pickup: { marks: { paper: 0 }, value: 1 }
  checkpoint:                    # a role of your own
    summary: A checkpoint flag.
    variant: interactive
    line: 1.8
    marks: { line: 1, tone: 0.5, fill: 1, paper: 1 }
    value: 0.7

Save it as mySets/myPlatformer.styleRoleSet/roles.yaml anywhere in your world; it registers on every machine at once. StyleRoles.use("myPlatformer"). Every field a role leaves out comes from the set it extends; a role name the set does not know is read as a variant name.

API

CallWhat it does
StyleRoles.use(setId, opts?)Switch the whole game to a role set in one change, with its variant lines and its glazes (a Roles glaze per group: blue for the players, red for the enemies, gold for the pickups, in each medium's own colours). "" follows the look. { lines = false } switches the roles alone.
StyleRoles.give(entity, role?)Give one object (and everything under it) a role; nil takes it away.
StyleRoles.giveAll(list, role?)The same for a list of entities, ids or names; returns how many.
StyleRoles.of(entity)The role it carries and what it gets now: { role, variant, asRendered, line, marks, value, ink, owner }.
StyleRoles.sets() / roles(setId?)Every installed set / one set's roles in picker order.
StyleRoles.clear()Put the scene back as it was before roles: every StyleChannel removed, the variant lines taken off, the set cleared.
StyleRoles.ROLESThe sixteen role names.
StyleRoles.GENRESThe nine sets for a kind of game. StyleRoles.sets() marks each set kind = "look" or "game".
ReadApart.measure(groups?)The squint test, measured: how far apart players, enemies and pickups read on the presented frame (CIE Lab distance of each group's averaged part of the frame; 1 to 3 with roles off, about 8 and more reads at a glance). require("~styleRoles.ReadApart").

Lower-level: styleKit's StyleKit.setChannel(entity, { line, marks, value, ink, variant }) sets any field by hand over the role, and StyleKit.add(block, { variant = "enemy" }) adds a block drawn only on one variant (two inks in one slot).

The RoleSetSwitcher component puts up the on-screen set picker; its looks field maps each set to the look its button also applies.

Multiplayer

Roles live on each object as a synced component, and the role set on the scene's synced StyleStack, so every player sees the same roles on the same things, roles are saved with the scene and come back on reload, and a role changed in play reaches every player at once (a change made by a player who does not own the object is sent to its owner). Verified with two clients in play: a role given in one reached the other within 1.5 seconds.

How far apart the groups read, look by look

The Role Showcase scene under each look, with the role set the look picks, measured with ReadApart on the presented frame (the least CIE Lab distance between the players, the enemies and the pickups; with no roles the groups sit 1 to 3 apart, told apart at a glance is about 8 and more):

LookSetRoles onRoles off
Comic ink cel (toon)toonGame59.348.3
Comic inkinkComic14.32.5
Picture book (watercolor)watercolorStorybook19.416.3
Paper cutout gamepaperCutout19.614.4
Urban sketch (line and wash)lineAndWash13.214.2
Pencil sketchpencilSketch9.31.2
Charcoal studypencilSketch21.42.0
Coloured pencil washpencilSketch19.818.6
Storybook pencilpencilSketch27.722.1
BlueprintpencilSketch14.20.4
White charcoal nightpencilSketch17.28.0
Field notes on kraftpencilSketch26.524.3
Bold ink sketchpencilSketch19.73.0
Conte figure studypenAndChalk10.11.0
Margin doodlespenAndChalk8.62.5
Technical sketchpenAndChalk6.91.0
Ballpoint notebookpenAndChalk6.01.6

Two blocks in one slot, one for the player and one for the enemies: docs/shared_slot_player_enemy.jpg (how-to guide, step 6). Pictures of the same square: docs/showcase_toon.jpg (toon), docs/showcase_ink.jpg (ink comic), docs/showcase_pencil.jpg (pencil sketch with roles) beside docs/showcase_pencil_off.jpg (the same look with roles off, where everything is one grey), and docs/showcase_ballpoint.jpg (ballpoint with the pen and chalk set). Under pencil the players stay light with a blue outline, the enemies are packed dark with a heavy red one, and the coins keep their colour; with roles off all three are the same grey. The measure script is design/roles/read_apart_showcase.luau in the Style Cookbook world. Ballpoint and technical sketch are the closest pairs left (players and pickups both stay light in a one-colour pen).

What it costs

The whole look (median)averageToon ink (median)styleKit (median)
Roles off0.44 ms0.53 ms0.11 ms0.32 ms
150 things with a role, toon game set0.63 ms0.78 ms0.17 ms0.44 ms
600 things with a role, toon game set0.93 ms1.25 ms0.26 ms0.64 ms
600 things with a role, before this release (toonBlocks 1.3.5, styleKit 1.6.3)1.33 ms2.29 ms0.60 ms0.55 ms

Measured on 11 November 2026 with toonBlocks' busy bench (design/roles/bench_roles.luau in the Style Cookbook world): 2,500 things, 250 of them moving, 25 a second appearing and 25 disappearing, 10 recoloured a second, under the Comic ink cel look; script time the look spends each frame. It ran in a test client of its own drawing 14 to 17 frames a second on a shared, busy desktop, which overstates every per-frame number; your game on its own will measure lower. What changed: toonBlocks 1.3.6 draws every role ink through one shared flood (104 render passes a frame for 600 role holders in nine inks before, 22 now), and styleKit 1.6.4 rebuilds the role mask at most four times a second while roles keep changing. So the whole look stays under a millisecond on the median frame with 600 role holders, and well under one (about 0.6 ms) with the 150 or so a typical level gives roles to. What is left is mostly styleKit queuing its eight mask passes and their selection lists again every frame (#24548): with hundreds of role holders and a slow client the average frame can pass 1 ms. The GPU time of the look did not change measurably.

Known limits

  • At most eight distinct settings per scene (#22178, #24549). A full-screen pass cannot tell which object a pixel belongs to, and a geometry pass carries no per-object value, so objects are grouped by what they ask for and each group is one extra drawing pass. Sixteen roles fit easily because roles sharing a setting share a pass; a ninth distinct setting draws as if it had no role (StyleKit._status().parts says how many were drawn).
  • Passes are queued again every frame (#24548), which is most of the cost above.
  • A pass reads no depth unless it also writes the scene picture (#24550), so a line drawn just outside a silhouette is matched to the nearest surface around it; at the very edge of two overlapping role holders a line can take the one in front.
  • An unknown blend draws as replace (#24551): the mask passes use opaque on purpose.
  • Post effects share no per-camera inputs (#17427): a second camera (a minimap, a split screen) reads the roles of the main view's mask.
  • Ink colours per object reach only toonBlocks' ink directly. Other line blocks take a per-variant colour through the extra line StyleRoles.use adds.
  • Two engines on one account collide as one player (#14448), so the multiplayer check used two clients of different players; the web check in a browser engine is yours to run (#20946).
  • An editor that had styleKit 1.4 open when the update arrived keeps the old StyleStack fields until it restarts; styleKit 1.5.1 keeps the role set on a StyleRoleSet component beside the stack, so switching sets works there too.
  • Installs with several dependencies are slow (#21420), and the ZeroMind description can lag a release (#19258).
  • Other engine issues noted while building this: #22478, #24593.
  • Other engine issues that apply here: a two-client editor sometimes refuses to load two different scenes at once (#24666, #24667); a world boot can wait about 30 s on a network handshake before content starts (#24669); the web build was not checked from here (#20946).

How far apart they read

On a plain stage (1.3.0). One player, five enemies and five pickups, all eleven in the same plain white material, under a sun: what a person sees the first time they try it in a fresh world, and the hardest case, because only the look and the roles tell the groups apart. Measured with ReadApart on the presented frame (least CIE Lab distance between the three groups; about 8 and more reads at a glance) by design/roles/read_apart_fresh.luau in the Style Cookbook world on 12 November 2026. "Before" is styleRoles 1.2.3 on styleKit 1.6.5, the release a person tried and found the ink, pencil and watercolor groups hard to tell apart.

LookSetRoles offRoles on, beforeRoles on, now
Comic inkinkComic0.611.519.4
Ink drawinginkComic0.210.117.4
Pencil sketchpencilSketch1.810.726.5
WatercolorwatercolorStorybook0.64.222.6
Picture bookwatercolorStorybook0.54.018.9
Paper cutout gamepaperCutout7.820.243.0

What changed: every set for a kind of look but the toon one now carries glazes, which StyleRoles.use lays as a Roles glaze over each group (styleKit 1.7.0): the players in blue, the enemies in red and a little deeper, the pickups in gold and a little lighter, in each medium's own colours (ultramarine, alizarin and gamboge for watercolor; the animator's blue, red and ochre pencils; the comic's spot colours; coloured card). The weights, marks and line inks the sets already gave are kept, so a squint now sees three colours as well as three weights. With every group in one grey, a heavier line and a darker shade alone left the hero and the enemies 4 apart under watercolor. The toon set needs no glaze (59 apart on the Role Showcase). The styleRoles suite checks this table's looks every run ("tells the three groups apart under every family of look, better than with roles off": 12 or more with roles on, and 8 or more above roles off).

On the Role Showcase (1.2.x, before glazes).

Measured with ReadApart on the Role Showcase (two players, five enemies, eight pickups, all plain white or metal materials, which is the hard case: only the look tells them apart), least distance between the three groups:

LookRoles offIts own setNotes
Pencil sketch1.26.4players-enemies 12.8, enemies-pickups 8.9 (was 1.1 to 2 before 1.1.0)
Ink comic1.42.3enemies now drawn in a heavy crimson line (the ink set used to turn it black); pickups 7 to 9 from both
Pencil sketch + a game set1.24.3 (cozy) to 8.7 (platformer)racing 8.2, arena 5.7, rpg 5.8
Ink comic + a game set1.41.7 (cozy) to 8.2 (platformer)racing 6.7, spooky 5.8, arena 5.4

Toon, watercolor, paper and line-and-wash looks keep the scene's own colours, so their groups already sit 12 to 40 apart with roles off and the roles widen that. Cozy is soft on purpose. A game whose cast has its own colours reads further apart than this all-white cast.

Guides and workflow

  • Make players, enemies and pickups read apart with one look (guides/make-players-enemies-and-pickups-read-apart): the how-to.
  • Example: styling a piece of Summit Sprint with game roles (guides/example-summit-sprint-roles): a small platformer styled step by step.
  • restyleWithRoles (workflows/restyleWithRoles.workflow): give an existing game roles in stages, every stage undoable.
  • styleRoles agent skill (skills/styleRoles.agentSkill): what an agent in a world with this installed can do.

Version history

1.4.2 (2026-11-12): the Summit Sprint example guide followed step by step on a fresh fork with this release, and corrected where it differed: inkBlocks 1.2.8 and earlier were refused there (1.2.9 installs), the game's styleKit reads the new version straight after the update, the roles line the log can still show once after reopening is harmless, a role given to each pickup reaches its coin model (checked: 41 of 41, with the tip that a role on the model itself wins, so clear its channel to move it), and there are eight other sets for a kind of game, not six. Pins styleKit 1.7.8. Nothing else changed.

1.4.1 (2026-11-12): a roles-on look-over of every family. Toon game set: pickups and rare pickups mixed most of the object's own colour into their line (value 0.8 and 1), so on a light object the gold ink came out a pale grey; now 0.3 and 0.4 with slightly heavier lines (1.5 and 1.8), and the gold and violet read. Watercolor storybook set: the hero, meant to be the clearest thing on screen, was the faintest figure (value 0.35 kept a light body near white); now 0.15 with a fuller player glaze (amount 0.85, lightness 0.85), and the plain-stage squint test went from 20.8 to 22.1. Paper cutout set: the player glaze (amount 0.6, lightness 1.05) left the hero nearly invisible on cream card, and the pickup glaze (lightness 1.12) turned the coins cream; both deepened, and Parchment map went from 28.4 to 34.4. The read-apart guide's expected numbers were measured again on the current release, the three paper looks and the two new game sets included. Pins styleKit 1.7.7.

1.4.0 (2026-11-12): more choice and clearer defaults and guides. Two new sets for kinds of game, Strategy (tower defence, real-time strategy, tactics: your units royal blue, allies teal, enemy units crimson, resources gold, build spots cyan) and Stealth (you in cool cyan, guards in amber warming to red for the alert ones, cameras and lasers hot red, loot pale gold), so nine sets for kinds of game and sixteen in all, every one swapped in with StyleRoles.use. Every set for a kind of game names noLook: toonGame (styleKit 1.7.6), so its roles carry their groups before a look is on. The paper cutout set follows paperBlocks' three looks (Paper cutout game, Chalkboard lesson, Parchment map). The how-to guide gains a table of which role to give what in a game, a squint test section with the numbers to expect for each family of look, and a checklist for something that does not pick up its role (stand-ins such as pickupsKit's coins, a look missing after a second family, the switcher's corner, no look on). The read-apart test measures the paper look from paperBlocks, which now ships it. Pins styleKit 1.7.6.

1.3.7 (2026-11-12): pins styleKit 1.7.5, whose checks pass in a world that holds only styleRoles and styleKit (1.7.4's "clearing puts the frame back as rendered" used a starterBlocks paper such a world does not have). Nothing else changed.

1.3.6 (2026-11-12): pins styleKit 1.7.4, so styleRoles installs on its own into an empty world (1.3.5 was refused there: styleKit's agent skill brought lookbookKit, whose starterBlocks pin an empty world could not meet). Nothing else changed.

1.3.5 (2026-11-12): pins styleKit 1.7.3 (the faster stand-in index and the throttled look rescan on top of #12's fixes). The switcher's corner fix and the pencil sketch set's README from 1.3.4 were checked here: the panel lays out at the top right (x 1014 to 1264 of 1280, 16 from the top), the full-screen box around it takes no pointer (a click in the middle of the screen reaches the game), and the README table matches roles.yaml row for row.

1.3.4 (2026-11-12): the RoleSetSwitcher panel sits in the corner it names. Its default, topRight, drew at top left over the game's own HUD: a screen's root node is laid out from the top left whatever its right or bottom say, so the panel is now pinned inside a full-screen root. The pencil sketch set's README table now matches its roles.yaml (it still listed the weights and marks from before 1.3.0: pickups with no shading and value 0, where the set draws them in coloured pencil with value 1 and line 2). Pins styleKit 1.7.2, which makes a role given to a pickupsKit coin reach the coin's model and finds a look that a later install moved.

1.3.2 (2026-11-12): the read-apart test now runs on what the packages ship. Its paper look, Paper cutout game, lived only in the Style Cookbook world's own folders, so in a world that installed the packages alone applyLook found nothing and that step measured the look before it; the look now ships in toonBlocks 1.3.10 (which brings paperBlocks), and the paper cutout set names it in forLooks, so it follows that look by itself. The test checks that each look applied and that the stack reports it before measuring, names in its log any look whose package is not installed and leaves it out (skipped only when none is). No other change.

1.3.1 (2026-11-12): the Summit Sprint example guide run again step by step on a fresh fork with 1.3.0: step 4 now names the four glazes use adds, step 5 what the roles reach (917 things in 7 distinct settings) and what you see (the player in a blue glaze and line, the only coloured figure on the ink page), and step 2 says to open the world again after updating the game's styleKit even when VERSION already reads right (on the run it read 1.7.0 at once, yet use added no lines until the world was opened again). No code changed.

1.3.0 (2026-11-12): groups that share a material read apart under every look. The ink comic, pencil sketch, pen and chalk, watercolor storybook, line and wash and paper cutout sets carry glazes (a colour per group), which use adds as Roles glaze entries beside the variant lines and clear takes off; the sets for kinds of game inherit them through extends: look. On a plain stage of one player, five enemies and five pickups in one white material, the least distance between the groups with roles on rose from 4.2 to 22.6 under Watercolor, 10.7 to 26.5 under Pencil sketch, 10.1 to 17.4 under Ink drawing and 20.2 to 43.0 under Paper cutout game (table above). Two tests: the plain stage under six looks, roles off and on; and things with no role keeping the plain line under Comic ink cel with the arena shooter set (they were drawn in the hazard line's orange; the cause was in styleKit and is fixed in 1.7.0). Pins styleKit 1.7.0.

1.2.3 (2026-11-11): pins styleKit 1.6.5 (styleKit 1.6.5 draws a newly switched-on look's settled picture from its first frames instead of a lighter, half-set one for two to four seconds; lookbookKit 1.0.44 finds its Lookbook scene where it is installed). Nothing else changed.

1.2.2 (2026-11-11): a frame test for two blocks sharing one slot (a blue depthLine drawn only on the player and a red sketchLine only on the enemies, under a black line for everything else; with their variants swapped the colours swap), and a picture of it on the Role Showcase (docs/shared_slot_player_enemy.jpg: an ink brush line for the player, an ink pen line for the enemies). The how-to guide's example of it now passes setInk = 0, without which a look that picks an ink set (Comic ink) overrode the colours. No code changed.

1.2.1 (2026-11-11): the Summit Sprint example run again on a fresh fork with styleRoles 1.2.0, styleKit 1.6.4 and toonBlocks 1.3.6 (the player, hazards, platforms, checkpoints, coins and scenery all took their roles under the toon look), and its text brought up to date: the versions to check, what to do when an older styleKit is already in the game, and the seven sets for a kind of game. The how-to guide names the horror and retro sets in its opening. No code changed.

1.2.0 (2026-11-11): a retro arcade set for a kind of game (retro), and a pen and chalk set for a kind of look (penAndChalk, picked by the ballpoint, technical sketch, margin doodle and conte looks, where the pencil set's blue and red leads sank into the medium: players and pickups now read 6 to 10 apart there, from 3 to 6). ReadApart.byRole found no groups (it read an owner field StyleKit.channels() does not give); fixed. A table of how far apart the groups read under every look and pictures of the Role Showcase (docs/). The cost measured again with toonBlocks 1.3.6 and styleKit 1.6.4. Pins styleKit 1.6.4 (a role given to a player template reaches every player; the role mask rebuilt at most four times a second). Every README in the package (each block, look, shader and guide) now ends with a Known limits section naming the engine issues that apply there.

1.1.3 (2026-11-11): the cost measured again with 2,500 things, with and without roles, and written into the how-to guide's "Cost and limits" with a table (roles off 0.41 ms, 600 roles 1.27 to 1.39 ms median, after toonBlocks 1.3.4 halved the passes the toon ink draws for role lines). No code changed.

1.1.2 (2026-11-11): the test suite passes in a world where styleRoles is the only package installed. The "follows the look" test now runs on two role sets and look names of its own instead of pencilBlocks' and inkBlocks' looks, and the pencil squint test stands down with its reason where pencilBlocks is not installed. Run twice in a fresh world: 6 of 7 pass, 1 skipped (the pencil test), none failed. No code outside the tests changed.

1.1.1 (2026-11-11): ReadApart.measure keeps the part of a thing inside the frame when it stands at the edge of the screen (a player close to the camera made the whole measure fail), and the Summit Sprint example guide gains the bright platformer step and the note that a game which already ships an older styleKit must update it. Pins styleKit 1.6.2.

1.1.0 (2026-11-11): six role sets for kinds of game (bright platformer, harsh arena shooter, RPG friends and foes, racing, spooky, calm cozy), each laid over the set the look suits (styleKit 1.6.1's extends: look), so every one works under every look and a game swaps between them with one call; StyleRoles.GENRES, and sets() marks each set's kind. The pencil sketch set retuned to read at a squint (players light with a blue lead, enemies packed dark with a heavy red lead, pickups in their own colour in coloured pencil with an ochre lead) with pencilBlocks 1.3.0; the ink comic set given spot colour (blue hero, crimson enemies) with inkBlocks 1.2.0. use hands a variant's ink to pencil lines (lead) and keeps an ink line's own ink when an ink pigment set is picked (setInk = 0), which made the ink comic set's enemy line black before. New ReadApart module, the squint test measured on the presented frame. The switcher panel lists the game sets under "Kind of game". Tests: 7 of 7 (new: game sets over a look's set, a game set follows a look change, the squint test under pencil).

1.0.1 (2026-11-11): the example guide (styling the Stump Run of Summit Sprint, run on a fork) and a pin on styleKit 1.5.1, which keeps the role set working in an editor that had an older styleKit open.

1.0.0 (2026-11-11): first release. Sixteen roles in six sets (toon game, ink comic, watercolor storybook, pencil sketch, paper cutout, line and wash), StyleRoles.use, give, giveAll, of, clear, the RoleSetSwitcher panel, the how-to and example guides, the restyle workflow and the agent skill. Tests: 4 of 4 pass.