{"id":19215910,"url":"https://github.com/movingblocks/facadeserver","last_synced_at":"2025-05-12T23:29:43.041Z","repository":{"id":52842559,"uuid":"58273304","full_name":"MovingBlocks/FacadeServer","owner":"MovingBlocks","description":"A headless facade that acts as a game host and provides web-based administration. Automation category: Terasology Facade. See https://forum.terasology.org/threads/facadeserver-headless-server-with-web-interface.1906 ","archived":false,"fork":false,"pushed_at":"2021-04-23T21:13:13.000Z","size":825,"stargazers_count":4,"open_issues_count":4,"forks_count":11,"subscribers_count":7,"default_branch":"develop","last_synced_at":"2025-04-20T19:38:09.619Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/MovingBlocks.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}},"created_at":"2016-05-07T16:03:47.000Z","updated_at":"2021-04-23T21:13:15.000Z","dependencies_parsed_at":"2022-08-20T00:51:18.073Z","dependency_job_id":null,"html_url":"https://github.com/MovingBlocks/FacadeServer","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/MovingBlocks%2FFacadeServer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MovingBlocks%2FFacadeServer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MovingBlocks%2FFacadeServer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MovingBlocks%2FFacadeServer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MovingBlocks","download_url":"https://codeload.github.com/MovingBlocks/FacadeServer/tar.gz/refs/heads/develop","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253839804,"owners_count":21972374,"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":[],"created_at":"2024-11-09T14:15:13.731Z","updated_at":"2025-05-12T23:29:43.017Z","avatar_url":"https://github.com/MovingBlocks.png","language":"Java","readme":"# FacadeServer\n\nThis is a headless (i.e. no graphics) application that runs the game as a server instance.\nIt can be administrated through a REST-based interface or a simple frontend that wraps around these API methods.\nAdministration comprises starting/stopping the host, configuring modules and the like.\n\nIn-game management (e.g. removing users from a running game) should be performed through users with admin rights.\n\n### Setting up from source\n\nThis facade can be set up using Gradle as explained in the [Terasology wiki](https://github.com/MovingBlocks/Terasology/wiki/Codebase-Structure#facades).\nHere is a step-by-step summary:\n* `cd` to the root of your Terasology workspace (the directory where you cloned the main repository [MovingBlocks/Terasology](https://github.com/MovingBlocks/Terasology)).\n* Execute `./gradlew fetchFacadeServer`; it will automatically clone this repository in the `facades/Server` directory.\n* Keep in mind that while the default branch on GitHub is `develop`, Gradle pulls the `master` branch. So to use the latest available version or work with it, you may consider switching to the `develop` branch:\n    * `cd facades/Server`\n    * `git checkout develop`\n    * `cd ../..`\n* Run `./gradlew jar`\n* To start a server using FacadeServer, execute `./gradlew facades:FacadeServer:run`.\n\n### API documentation\n\nThe web server exposes access to the various resources both with an HTTP REST API and over WebSocket.\nMore information is available in the docs.md file at the root of this repository.\nAlso, here is a [direct link](http://petstore.swagger.io/?url=https://raw.githubusercontent.com/MovingBlocks/FacadeServer/develop/src/main/resources/web/swagger.json#/) to view online the Swagger/OpenAPI specification of the HTTP API.\n\n### HTTPS connections\nThe server is able to support https connections.\nA self-signed certificate is provided in a keystore file, which will make browsers refuse to connect unless an exception is made.\nTo avoid this problem, you can obtain a valid certificate, [convert it to jks format](https://blogs.oracle.com/jtc/installing-trusted-certificates-into-a-java-keystore), and replace the keystore.jks file.\n\n\n### Related repositories\n[Here](https://github.com/gianluca-nitti/FacadeServer-frontend) is the code for a web and mobile frontend to FacadeServer.\n\n### License\n\nThis module is licensed under the [Apache 2.0 License](http://www.apache.org/licenses/LICENSE-2.0.html).\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmovingblocks%2Ffacadeserver","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmovingblocks%2Ffacadeserver","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmovingblocks%2Ffacadeserver/lists"}