{"id":21989118,"url":"https://github.com/repcomm/yarr","last_synced_at":"2026-04-15T06:33:50.315Z","repository":{"id":187144503,"uuid":"675483313","full_name":"RepComm/yarr","owner":"RepComm","description":"A proof of concept MMO w/ pocketbase","archived":false,"fork":false,"pushed_at":"2023-10-29T21:19:42.000Z","size":21405,"stargazers_count":1,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-23T02:44:22.236Z","etag":null,"topics":["3d","blender","customization","game","mmo","multiplayer","penguin","pocketbase","preact","realtime","typescript","wip","yarr"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/RepComm.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2023-08-07T03:12:08.000Z","updated_at":"2023-10-29T21:26:10.000Z","dependencies_parsed_at":"2023-10-29T22:23:04.353Z","dependency_job_id":null,"html_url":"https://github.com/RepComm/yarr","commit_stats":null,"previous_names":["repcomm/yarr"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/RepComm/yarr","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RepComm%2Fyarr","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RepComm%2Fyarr/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RepComm%2Fyarr/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RepComm%2Fyarr/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/RepComm","download_url":"https://codeload.github.com/RepComm/yarr/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RepComm%2Fyarr/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31830121,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-14T18:05:02.291Z","status":"online","status_checked_at":"2026-04-15T02:00:06.175Z","response_time":63,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["3d","blender","customization","game","mmo","multiplayer","penguin","pocketbase","preact","realtime","typescript","wip","yarr"],"created_at":"2024-11-29T19:27:52.130Z","updated_at":"2026-04-15T06:33:50.251Z","avatar_url":"https://github.com/RepComm.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# yarr\n\n![img](./example.png)\n![img](./example1.png)\n![img](./example2.png)\n![img](./example3.png)\n![img](./example4.png)\n![img](./example5.png)\n\n## Implemented\n- `/` - home, character selector\n- `/play` - main gameplay here\n- characters\n - profile cards\n   - player w/ items attached\n - equipped items\n - floating name\n - click-to-walk\n - waddle anim\n - room join/leave by updating character.room in db\n- Clickable callbacks (raycasting)\n\n### Rooms\n- Coffee Shop\n- Town model (incomplete)\n\n### GLTF userData (blender custom props):\n - `obj.userData[\"spawn-from\"]` - DbRoom.label\n    - obj is spawn position if previous room.label is this value\n - `mesh.userData[\"goto-room\"]` - DbRoom.label\n    - mesh is clickable, joins room with this value\n - `material.userData.emission` - float\n    - emissiveIntensity of material, when included, emission property of material defaults to white instead of black\n - `mesh.userData.invis` - \"true\"|\"false\"\n    - when true sets mesh.visible = false\n - `material.userData.toon` - \"true\"|\"false\"\n    - when set to \"false\" skips toon material conversion\n\n- Rooms, Items, Assets fully from database uploads, no code required to create new ones\n\n## running\n- `npm install`: Installs dependencies\n\n- `npm run dev`: Run a development, HMR web server\n\n- `npm run build`: Production-ready client build\n\n- `npm run db` : uses `pocketbase` as a top level command, you'll want to add it to your path, or run it differently - the 'backend' as it were\nPocketbase is configured in package.json to host the /build directory, which is generated by `npm run build`\n\n## database\npocketbase is used to:\n- serve the web client\n- serve game assets for rooms and items\n- do realtime client updates via pub/sub\n\nThe schema can be loaded from pb_schema.json\n\n- users\n  - name - display name for account\n  - characters - multiple characters per player\n    - inventory - items the player owns\n    - equipped - items the player has equipped (subset of inventory)\n    - x,y,z - position\n    - rx,ry,rz - euler rotation\n    - name - name of the character\n    - room - set this to handle all room updates\n- items\n  - definition - item_defs entry\n  - owner - who owns this item\n  - count\n- item_defs\n  - wearable - boolean\n  - wearable_bone_name - string\n    - obj.name attach point\n  - asset - DbAsset\n  - label - string\n  - description - string\n- rooms\n  - model_placements - DbModelPlacements\n  - occupants - DbCharacters[]\n  - label - string\n  - description - string\n- model_placements\n  - asset - what model to show\n  - placements - JSON array of {x,y,z}\n  \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frepcomm%2Fyarr","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frepcomm%2Fyarr","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frepcomm%2Fyarr/lists"}