{"id":45253128,"url":"https://github.com/pz-umbrella/umbrella","last_synced_at":"2026-02-20T23:02:38.380Z","repository":{"id":167759589,"uuid":"642571584","full_name":"PZ-Umbrella/Umbrella","owner":"PZ-Umbrella","description":"EmmyLua type stubs for Project Zomboid's modding API","archived":false,"fork":false,"pushed_at":"2025-11-28T03:19:56.000Z","size":3454,"stargazers_count":64,"open_issues_count":0,"forks_count":3,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-11-30T14:56:55.034Z","etag":null,"topics":["emmylua","lua","projectzomboid","zomboid"],"latest_commit_sha":null,"homepage":"","language":"Lua","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/PZ-Umbrella.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,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2023-05-18T21:57:12.000Z","updated_at":"2025-11-28T03:19:54.000Z","dependencies_parsed_at":null,"dependency_job_id":"f1f1bc5b-6c9a-4bdf-bb7f-93944999b140","html_url":"https://github.com/PZ-Umbrella/Umbrella","commit_stats":null,"previous_names":["asledgehammer/umbrella","pz-umbrella/umbrella"],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/PZ-Umbrella/Umbrella","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PZ-Umbrella%2FUmbrella","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PZ-Umbrella%2FUmbrella/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PZ-Umbrella%2FUmbrella/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PZ-Umbrella%2FUmbrella/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/PZ-Umbrella","download_url":"https://codeload.github.com/PZ-Umbrella/Umbrella/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PZ-Umbrella%2FUmbrella/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29667119,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-20T19:49:36.704Z","status":"ssl_error","status_checked_at":"2026-02-20T19:44:05.372Z","response_time":59,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["emmylua","lua","projectzomboid","zomboid"],"created_at":"2026-02-20T23:02:35.798Z","updated_at":"2026-02-20T23:02:38.371Z","avatar_url":"https://github.com/PZ-Umbrella.png","language":"Lua","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Umbrella\nUmbrella is a collection of EmmyLua type stubs for Project Zomboid's Lua API. It can be used with compatible language servers to provide intellisense and in-IDE type checking for Project Zomboid mods.\n\n## Setup\n\n### EmmyLua (recommended)\nUmbrella's typings are catered towards the format used by the EmmyLua language server as it has the best support for advanced features such as generics.\n1. Install EmmyLua for your IDE. For VSCode, an [EmmyLua](https://marketplace.visualstudio.com/items?itemName=tangzx.emmylua) extension is available.\n2. Download Umbrella from [Releases](https://github.com/PZ-Umbrella/Umbrella/releases/latest), or clone it if you know how.\n3. At the root of your project, create `.emmyrc.json` with the following contents, replacing PATH_TO_UMBRELLA with the full path to your copy of Umbrella.\n```json\n{\n    \"$schema\": \"https://raw.githubusercontent.com/EmmyLuaLs/emmylua-analyzer-rust/refs/heads/main/crates/emmylua_code_analysis/resources/schema.json\",\n    \"workspace\": {\n        \"library\": [\n            \"PATH_TO_UMBRELLA/library\"\n        ]\n    }\n}\n```\n\n### LuaLS\nLuaLS is also supported by Umbrella. However, it does not support some features used by Umbrella, so it is by far the inferior language server for use with Umbrella.\n#### VSCode\nVSCode's LuaLS extension has a built-in addon manager that makes this the easiest to install. Do not confuse addons with extensions: addons are part of LuaLS, extensions are built into VSCode. There is no official Umbrella extension.\n1. Install [Git](https://git-scm.com/downloads), as LuaLS's addon manager needs it to download addons. You may need to restart your computer afterwards for the addon manager to work correctly.\n2. Install [LuaLS](https://marketplace.visualstudio.com/items?itemName=sumneko.lua).\n3. Open your project.\n4. Press **Ctrl-Shift-P** and search for ``Lua: Open Addon Manager``.\n5. Search for Umbrella (or Umbrella (Unstable) for unstable versions of Project Zomboid) and click enable. Enabled addons are specific to a project, so you will need to repeat steps 2-4 for every new project.\n\n#### Other IDEs\n1. Install LuaLS for your IDE.\n2. At the root of your project, create ``.luarc.json`` with the following contents, replacing PATH_TO_UMBRELLA with the full path to your copy of Umbrella.\n```json\n{\n    \"$schema\": \"https://raw.githubusercontent.com/LuaLS/vscode-lua/master/setting/schema.json\",\n    \"workspace.library\": [\"PATH_TO_UMBRELLA/\"],\n}\n```\n\n## Contact\nIf you need support with installation, we tend to hang out in the [PZ Modding Community discord server](https://discord.gg/756PPhcB3u).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpz-umbrella%2Fumbrella","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpz-umbrella%2Fumbrella","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpz-umbrella%2Fumbrella/lists"}