Log inGet started
World

Choose Your Side: Race, Faction and Class Picker Screens

Merged

pickerKit 1.0.3: preview styles, remembered choice, Picker.reopen/saved/render

#1
Author
claude-code @ auraAgent
Opened
Nov 16, 2026
From
contrib-r4y7c65e
Into
main
Merged
Nov 16, 2026

Adds built-in preview styles (previewStyle = portrait | stats | banner | showcase, or a custom fn(choiceId, box) -> widget; Picker.setPreviewStyle/previewStyle/previewStyles; pickerKit.previews.define), shown in the gallery (Preview pill, key P). The kit now remembers each player's confirmed choice in the engine's per-player runtime_data store by default (remember = true; false or a {get,set} store still work), marks it CURRENT on reopen, and adds Picker.saved(id, userId?), Picker.current(id), Picker.forget(id), Picker.reopen(id, overrides?) and Picker.render(opts, w, h) (draw without opening). Fixes: round emblems vanishing on large art (banner hall's open banner), wheel clamp error in a narrow stage. Removes every em dash from docs, comments and UI strings. Tests: 27 (10 new), all passing in tests.run. Version 1.0.3.

Source world: 35b72a74-fcea-4972-a0ff-805a28a7e5cb Contributed paths:

  • pickerKit.package/PickerGallery.component/README.md
  • pickerKit.package/PickerGallery.component/init.luau
  • pickerKit.package/README.md
  • pickerKit.package/api.module/README.md
  • pickerKit.package/api.module/init.luau
  • pickerKit.package/guides/example-hero-select-screen-for-a-small-arena-game.guide/guide.md
  • pickerKit.package/guides/how-to-add-a-choose-your-race-faction-or-class-screen-with-locked-choices.guide/guide.md
  • pickerKit.package/layouts.module/init.luau
  • pickerKit.package/package.yaml
  • pickerKit.package/parts.module/init.luau
  • pickerKit.package/pickerKitTests.testSuite/README.md
  • pickerKit.package/pickerKitTests.testSuite/init.luau
  • pickerKit.package/previews.module/.metadata
  • pickerKit.package/previews.module/README.md
  • pickerKit.package/previews.module/init.luau
  • pickerKit.package
  • pickerKit.package/PickerGallery.component
  • pickerKit.package/api.module
  • pickerKit.package/guides/example-hero-select-screen-for-a-small-arena-game.guide
  • pickerKit.package/guides/how-to-add-a-choose-your-race-faction-or-class-screen-with-locked-choices.guide
  • pickerKit.package/layouts.module
  • pickerKit.package/parts.module
  • pickerKit.package/pickerKitTests.testSuite
  • pickerKit.package/previews.module
  • pickerKit.package/PickerHost.component/init.luau
  • scenes/gallery.scene/authoring/state.json
  • scenes/gallery.scene/build.luau
  • scenes/gallery.scene/scene.json

24 files changed

  • ChangedpickerKit.packageFolderBeforeAfter
  • ChangedpickerKit.package/PickerGallery.componentFolderBeforeAfter
  • ChangedpickerKit.package/PickerGallery.component/README.md651 B → 723 BBeforeAfter
  • ChangedpickerKit.package/PickerGallery.component/init.luau9.3 KB → 9.9 KBBeforeAfter
  • ChangedpickerKit.package/README.md13.0 KB → 17.6 KBBeforeAfter
  • ChangedpickerKit.package/api.moduleFolderBeforeAfter
  • ChangedpickerKit.package/api.module/README.md703 B → 1.1 KBBeforeAfter
  • ChangedpickerKit.package/api.module/init.luau33.1 KB → 40.1 KBBeforeAfter
  • ChangedpickerKit.package/guides/example-hero-select-screen-for-a-small-arena-game.guideFolderBeforeAfter
  • ChangedpickerKit.package/guides/example-hero-select-screen-for-a-small-arena-game.guide/guide.md5.3 KB → 6.0 KBBeforeAfter
  • ChangedpickerKit.package/guides/how-to-add-a-choose-your-race-faction-or-class-screen-with-locked-choices.guideFolderBeforeAfter
  • ChangedpickerKit.package/guides/how-to-add-a-choose-your-race-faction-or-class-screen-with-locked-choices.guide/guide.md6.8 KB → 8.5 KBBeforeAfter
  • ChangedpickerKit.package/layouts.moduleFolderBeforeAfter
  • ChangedpickerKit.package/layouts.module/init.luau43.3 KB → 43.6 KBBeforeAfter
  • ChangedpickerKit.package/package.yaml766 B → 1.0 KBBeforeAfter
  • ChangedpickerKit.package/parts.moduleFolderBeforeAfter
  • ChangedpickerKit.package/parts.module/init.luau30.1 KB → 31.8 KBBeforeAfter
  • ChangedpickerKit.package/pickerKitTests.testSuiteFolderBeforeAfter
  • ChangedpickerKit.package/pickerKitTests.testSuite/README.md879 B → 1.3 KBBeforeAfter
  • ChangedpickerKit.package/pickerKitTests.testSuite/init.luau10.5 KB → 15.5 KBBeforeAfter
  • AddedpickerKit.package/previews.moduleFolderAfter
  • AddedpickerKit.package/previews.module/.metadata50 BAfter
  • AddedpickerKit.package/previews.module/README.md903 BAfter
  • AddedpickerKit.package/previews.module/init.luau26.8 KBAfter

Checks

No checks have been posted.

Reviews

No reviews yet.

Conversation

No comments yet.

Sign in to comment or review.