{"id":13797609,"url":"https://github.com/azigler/ranvier-zpanel","last_synced_at":"2025-05-13T04:32:01.505Z","repository":{"id":38984770,"uuid":"283096730","full_name":"azigler/ranvier-zpanel","owner":"azigler","description":"Web-based control panel and building client for Ranvier","archived":false,"fork":false,"pushed_at":"2024-03-30T05:55:20.000Z","size":1028,"stargazers_count":3,"open_issues_count":0,"forks_count":1,"subscribers_count":3,"default_branch":"master","last_synced_at":"2024-04-15T07:24:31.002Z","etag":null,"topics":["backend","frontend","mud","ranvier","webdev"],"latest_commit_sha":null,"homepage":"https://www.andrewzigler.com/portfolio/ranvier-zpanel-ranvier-bundle/","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/azigler.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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},"funding":{"ko_fi":"andrewzigler"}},"created_at":"2020-07-28T04:15:20.000Z","updated_at":"2024-04-30T07:54:04.080Z","dependencies_parsed_at":"2024-04-30T07:53:43.328Z","dependency_job_id":"7f8366ea-7eff-4ea1-9163-50fde395e9a0","html_url":"https://github.com/azigler/ranvier-zpanel","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/azigler%2Franvier-zpanel","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/azigler%2Franvier-zpanel/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/azigler%2Franvier-zpanel/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/azigler%2Franvier-zpanel/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/azigler","download_url":"https://codeload.github.com/azigler/ranvier-zpanel/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225176595,"owners_count":17433009,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["backend","frontend","mud","ranvier","webdev"],"created_at":"2024-08-04T00:00:25.101Z","updated_at":"2024-11-18T12:31:22.041Z","avatar_url":"https://github.com/azigler.png","language":"JavaScript","funding_links":["https://ko-fi.com/andrewzigler"],"categories":["Categories"],"sub_categories":["Building Tools"],"readme":"![](https://images.prismic.io/andrewzigler/dec91971-43b6-4aed-856d-ff4b5a655969_ranvier-zpanel.jpg?ixlib=gatsbyFP\u0026auto=compress%2Cformat\u0026fit=max\u0026q=50\u0026rect=0%2C0%2C1200%2C628\u0026w=1200\u0026h=628)\n\n# ranvier-zpanel\n\n\u003e Web-based control panel and building client for Ranvier\n\nCreate and modify game data for Ranvier via a web app. Built with [mithril-starter-kit](https://github.com/dhinesh03/mithril-starter-kit).\n\nTo use this bundle, you will need a specific checkout of Ranvier. You __MUST__ use my experimental fork ([azigler/zigmud](https://github.com/azigler/zigmud)) alongside a checkout of my experimental core:develop branch ([azigler/core:develop](https://github.com/azigler/core/tree/develop)).\n\nThis bundle __WILL NOT WORK__ with a [regular Ranvier checkout](https://github.com/RanvierMUD/ranviermud).\n\nAs of now, this bundle has only been tested with [ranvier-datasource-couchdb](https://github.com/azigler/ranvier-datasource-couchdb) serving all entity data.\n\nThis bundle requires Ranvier to be using at least [Node v12.18.2 LTS](https://nodejs.org/en/blog/release/v12.18.2/).\n\n### Instructions\n\n1. Install this bundle in your Ranvier repository.\n\n2. Update `zPanel` in your `ranvier.json` to include the port and URL you'll use for the web client:\n\n```\n\"zPanel\": {\n    \"port\": 4335,\n    \"url\": \"localhost\"\n  },\n```\n\n3. Add `zpanel: true` to the `Account` metadata of whomover can access zPanel and the accompanying API.\n\n4. When the server next starts, the app will compile and serve zPanel at the address provided (e.g., `localhost:4335`). Navigate to the address to log in and begin editing.\n\n### Usage\n\nCurrently this tool allows for the creation of very basic area, room, item, and NPC entities. When items and NPCs are created and updated they can be immediately spawned into the game from the new definition. At this time, you must reboot the server in order to see changes to rooms.\n\n### Extending\n\nThe app is built with [Mithril](https://mithril.js.org/index.html) and [Construct-ui](https://vrimar.github.io/construct-ui/). You can use the `npm start` package script to run a Webpack development server for the Mithril app, but you will also need to run the game server to launch the API so it may be more effective to just reboot Ranvier when needed. The API is built with [hapi](https://hapi.dev/) and uses an HTTP cookie for authentication. You can readily add to the API and expand on the provided interface options since everything in the app potentially has access to state via the `server-event` that launches this bundle.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fazigler%2Franvier-zpanel","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fazigler%2Franvier-zpanel","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fazigler%2Franvier-zpanel/lists"}