\nServerside player profiles for hotseat multiplayer, adventure maps, and plural systems.
\nRequires Connector and FFAPI on (neo)forge.
<\/b>
\n<\/center><\/p>\n—<\/p>\n
**Switchy** allows players to create and switch between **player profiles**, which save part of their player data.<\/p>\n
This is both **data-driven** and **player-customizable**. Here’s a profile with Styled Nicknames and Fabric Tailor (+SCH):<\/br>
\n
\nSupport is also built-in (via data) for Lampblack Pronouns, [Trinkets](modrinth.com\/mod\/trinkets)\/Accessories, Pehkui (width\/height), and Origins.<\/p>\n
You can even fluently chat using the display names of other profiles, just like PluralKit:
\n<\/br>
\nThis is fully compatible with well-behaved chat bridges, like our cantilever fork!<\/p>\n
## Usage<\/p>\n
> _**Disclaimer**: All mods that manipulate player data have a save corruption risk!
\nAlways take backups of your worlds, especially when updating mods._<\/p>\n
**Just run `\/switchy` and follow the hints!** This covers renaming, toggling components, and making new profiles.<\/p>\n
After this, you can freely switch profiles via `\/switch ` or by clicking `` in the profile list.
\nSwitching into a profile restores component data to **the state it was in was when the profile was last used**.
\nSo to change e.g. a fabric tailor skin for a profile, switch into the profile first, set the skin, and switch out.<\/p>\nYou can use `\/switchy say` to send a chat message as if you were switched into a specific profile.
\nUse `\/switchy edit tag text` to match regular chat messages based on a pattern.
\nDisplay names look slightly different to styled nicknames\/chat, so just adjust their configs to match.<\/p>\nProfiles are per-world, so speed things up by running `\/switchy export` to get your name\/skin data to save to a .json file.
\nTo import, upload the file (e.g. to tmpfiles.org) and paste the link into `\/switchy import all `.
\nYou can also import from PK (and import from \/ export to Utter) – use `\/switchy import ` to filter imports.<\/p>\n## Compatibility<\/p>\n
> Note: If Switchy crashes your 1.20 modpack, set `fastSingleplayerReconnect` to `false` in `config\/switchy.toml`<\/p>\n
For compatibility with new mods, components are defined like so:<\/p>\n
“`json5
\n\/\/ data\/minecraft\/switchy_components\/inventory\/ender_chest.json (minecraft:inventory\/ender_chest)
\n{
\n “enabled”: true, \/\/ whether to load the component at all. use this instead of deleting default files, as they’ll regenerate.
\n “codec”: “inventory”, \/\/ which codec (from the registry in SwitchyComponentTypes) to use to deserialize the data. defaults to “nbt” (passthrough)
\n “path”: “EnderItems”, \/\/ NBT path targeting the part of player.dat to load from \/ modify to
\n “preview”: “inventory”, \/\/ which text previewer (from the registry in SwitchyComponentTypes) to use in chat. null = toString(), use “trunc” for long data. Start with $ to use an NBT path for passthrough components.
\n “prefix”: “\ud83d\udc41 “, \/\/ a prefix to add to the text preview, for glanceability
\n “emptyChecker”: “inventory”, \/\/ which empty checker (from the registry in SwitchyComponentTypes) to use to prevent profile deletion for precious data. Start with $ to use an NBT path for passthrough components.
\n “group”: “inventory”, \/\/ components with a matching group ID will be previewed and toggled as if they’re one component
\n “default”: [], \/\/ default value. JSON serialized. set to “$copy” to copy the value from previous. set to null or omit to delete the key from player data as the initial value.
\n “hidden”: false \/\/ hides the component preview in the profiles list (still shown in the components list)
\n}
\n“`<\/p>\n
Feel free to PR components (and previewers\/etc with **no dependencies**) into the main mod – see existing examples.<\/p>\n
Switching data outside player NBT requires an addon. API TBD – Interested addon devs can hit up the issues page.<\/p>\n
## Afterword<\/p>\n
If you’re a plural system (or a friend to one) and appreciate our work, please consider reading and sharing sys.guide, our plurality handbook.<\/p>\n
Switchy was our first original minecraft mod, made during the mod jam ModFest: Singularity.
\nSince making it, the minecraft modding community has given us friendship, mentorship,
\nendless favours, an outlet for self-expression, and reinforced our passion for software as an art.
\nEveryone who’s been a part of that – and you should know who you are – thank you.<\/p>\n","protected":false},"excerpt":{"rendered":"
Play multiple characters in one world! Opt-in, customizable player profiles for hotseat multiplayer, lets plays, plural systems, RP servers, or just for fun!<\/p>\n","protected":false},"featured_media":151191,"template":"","meta":{"_minecraft_slug":"switchy","_minecraft_project_id":"ss0QuCRx","_minecraft_author":"sisby-folk","_minecraft_license":"LGPL-3.0-only","_minecraft_downloads":77124,"_minecraft_follows":248,"_minecraft_client_side":"optional","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"switchy.zip","_minecraft_size_bytes":172542149,"_minecraft_version_count":245,"_minecraft_updated_at":"2026-05-16T00:23:20.779208Z","_minecraft_date_created":"2022-08-15T07:49:47.088108Z","_minecraft_date_modified":"2026-04-13T13:53:21.318177Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/switchy","_minecraft_icon_attachment_id":151191,"_minecraft_imported_at":"2026-06-09T02:52:22+00:00","_minecraft_import_hash":"019c5631e9f9355ef43f8f26beef8d1c","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[97,104,873,126,158,98,867,92],"mod_loader":[99,106,160,100],"minecraft_version":[53,56,57,58,36,94,37,83,167,163],"class_list":["post-151190","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-fabric","mod_category-forge","mod_category-library","mod_category-management","mod_category-neoforge","mod_category-quilt","mod_category-social","mod_category-utility","mod_loader-fabric","mod_loader-forge","mod_loader-neoforge","mod_loader-quilt","minecraft_version-1-18-2","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20-1","minecraft_version-1-20-4","minecraft_version-1-21-1","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\n
Switchy - Minecraft<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/vpesports.com\/minecraft\/mods\/switchy\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Switchy - Minecraft\" \/>\n<meta property=\"og:description\" content=\"Play multiple characters in one world! Opt-in, customizable player profiles for hotseat multiplayer, lets plays, plural systems, RP servers, or just for fun!\" \/>\n<meta property=\"og:url\" content=\"https:\/\/vpesports.com\/minecraft\/mods\/switchy\/\" \/>\n<meta property=\"og:site_name\" content=\"Minecraft\" \/>\n<meta property=\"og:image\" content=\"https:\/\/cdn.modrinth.com\/data\/ss0QuCRx\/images\/0fd2d9d7ccb66e457f7604e09803c1b6457418c6.png\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"3 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/switchy\\\/\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/switchy\\\/\",\"name\":\"Switchy - Minecraft\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/switchy\\\/#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/switchy\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/switchy-icon-d29491353c92008b39e0aace0c9f8ca25da21ee5.png\",\"datePublished\":\"2026-06-09T02:52:21+00:00\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/switchy\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/switchy\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/switchy\\\/#primaryimage\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/switchy-icon-d29491353c92008b39e0aace0c9f8ca25da21ee5.png\",\"contentUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/switchy-icon-d29491353c92008b39e0aace0c9f8ca25da21ee5.png\",\"width\":128,\"height\":128},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/switchy\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Mods\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Switchy\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\",\"name\":\"Minecraft\",\"description\":\"\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Switchy - Minecraft","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/vpesports.com\/minecraft\/mods\/switchy\/","og_locale":"en_US","og_type":"article","og_title":"Switchy - Minecraft","og_description":"Play multiple characters in one world! Opt-in, customizable player profiles for hotseat multiplayer, lets plays, plural systems, RP servers, or just for fun!","og_url":"https:\/\/vpesports.com\/minecraft\/mods\/switchy\/","og_site_name":"Minecraft","og_image":[{"url":"https:\/\/cdn.modrinth.com\/data\/ss0QuCRx\/images\/0fd2d9d7ccb66e457f7604e09803c1b6457418c6.png","type":"","width":"","height":""}],"twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"3 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/vpesports.com\/minecraft\/mods\/switchy\/","url":"https:\/\/vpesports.com\/minecraft\/mods\/switchy\/","name":"Switchy - Minecraft","isPartOf":{"@id":"https:\/\/vpesports.com\/minecraft\/#website"},"primaryImageOfPage":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/switchy\/#primaryimage"},"image":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/switchy\/#primaryimage"},"thumbnailUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/switchy-icon-d29491353c92008b39e0aace0c9f8ca25da21ee5.png","datePublished":"2026-06-09T02:52:21+00:00","breadcrumb":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/switchy\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/vpesports.com\/minecraft\/mods\/switchy\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/vpesports.com\/minecraft\/mods\/switchy\/#primaryimage","url":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/switchy-icon-d29491353c92008b39e0aace0c9f8ca25da21ee5.png","contentUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/switchy-icon-d29491353c92008b39e0aace0c9f8ca25da21ee5.png","width":128,"height":128},{"@type":"BreadcrumbList","@id":"https:\/\/vpesports.com\/minecraft\/mods\/switchy\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/vpesports.com\/minecraft\/"},{"@type":"ListItem","position":2,"name":"Mods","item":"https:\/\/vpesports.com\/minecraft\/mods\/"},{"@type":"ListItem","position":3,"name":"Switchy"}]},{"@type":"WebSite","@id":"https:\/\/vpesports.com\/minecraft\/#website","url":"https:\/\/vpesports.com\/minecraft\/","name":"Minecraft","description":"","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/vpesports.com\/minecraft\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"}]}},"_links":{"self":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod\/151190","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod"}],"about":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/types\/mod"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media\/151191"}],"wp:attachment":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media?parent=151190"}],"wp:term":[{"taxonomy":"mod_category","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_category?post=151190"},{"taxonomy":"mod_loader","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_loader?post=151190"},{"taxonomy":"minecraft_version","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/minecraft_version?post=151190"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}
![\"mod](\"https:\/\/cdn.modrinth.com\/data\/ss0QuCRx\/images\/0fd2d9d7ccb66e457f7604e09803c1b6457418c6.png\"\/)
<\/center><\/p>\n