{"id":15693908,"url":"https://github.com/ronoaldo/mercurio","last_synced_at":"2025-10-28T05:10:19.649Z","repository":{"id":37892261,"uuid":"402792841","full_name":"ronoaldo/mercurio","owner":"ronoaldo","description":"Mercurio Minetest Server open source repository.","archived":false,"fork":false,"pushed_at":"2025-06-18T16:10:17.000Z","size":85495,"stargazers_count":10,"open_issues_count":17,"forks_count":3,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-10-18T13:39:06.352Z","etag":null,"topics":["docker","game","minetest","minetest-server","server"],"latest_commit_sha":null,"homepage":"https://github.com/users/ronoaldo/projects/3","language":"Lua","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/ronoaldo.png","metadata":{"files":{"readme":"README.md","changelog":"news/news.md","contributing":null,"funding":".github/FUNDING.yml","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,"zenodo":null},"funding":{"github":null,"patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"custom":null}},"created_at":"2021-09-03T14:13:39.000Z","updated_at":"2025-01-24T02:04:58.000Z","dependencies_parsed_at":"2025-01-24T02:31:44.569Z","dependency_job_id":null,"html_url":"https://github.com/ronoaldo/mercurio","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/ronoaldo/mercurio","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ronoaldo%2Fmercurio","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ronoaldo%2Fmercurio/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ronoaldo%2Fmercurio/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ronoaldo%2Fmercurio/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ronoaldo","download_url":"https://codeload.github.com/ronoaldo/mercurio/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ronoaldo%2Fmercurio/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":281386600,"owners_count":26492016,"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","status":"online","status_checked_at":"2025-10-28T02:00:06.022Z","response_time":60,"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":["docker","game","minetest","minetest-server","server"],"created_at":"2024-10-03T18:50:07.645Z","updated_at":"2025-10-28T05:10:14.642Z","avatar_url":"https://github.com/ronoaldo.png","language":"Lua","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Mercurio Minetest Server\n\nHosting implementation of minetest server using custom Docker image\nfor the Mercurio minetest server.\n\n## Developing locally\n\nYou need to have both `docker` and `docker composer` installed and working, and\noptionally you can use `make` to run the scripts more easily.\n\nIn order to change some settings for your local develoopment environment, copy\nthe `docker-compose.dev.yml` as a local override. This way you can change things\nsuch as the server port:\n\n    cp docker-compose.dev.yml docker-compose.override.yml\n\n### Run a local server\n\nTo test locally, you can use:\n\n    make run\n\nThis command will use `docker compose` to execute all the services needed,\nincluding a local PostgreSQL database, the Discord chat bridge and the game\nserver itself.\n\nTo test the server, launch the minetest client and connect with `127.0.0.1`\nand port `30000`.\n\n### Local data storage\n\nThe containers will store data in a `.minetest` folder in the current directory.\nThe game data will be in `.minetest/world`, and the database files are under\n`.minetest/db`.\n\nTo make a backup you can use the following make target:\n\n    make backup\n\nBackups will be stored in `$HOME/backups/`.\n\n### Container shell\n\nSometimes you may want to open a shell interpreter inside the running container,\nin order to check if all things are right. There is a make target for that as well:\n\n    make shell\n\nThis will open a shell with `root` privileges so you can debug the game server.\nIt is required that you have the server running in the background (i.e. you need\nto have it running from `make run` first).\n\n### Troubheshooting\n\nSometimes you may run into permission issues. I'm not sure why/how to fix\nthem permanently, but I have made a small shell script to fix them as a\nworkaround:\n\n    make fix-perms\n\nThis one requires your login shell to have `sudo` privileges.\n\n## Install and update mods\n\nFor this server, we are using a local copy of the released mods from ContentDB\nwhenever possible, plus a few set of Git submodules when some special patch is\nneeded or when the mod is not published to the central repository.\n\nThe reason to use ContentDB is mostly because a) I'm using specific versions of\nthe mods, that are released by the mod authors and intended to be used by the\npublic and b) there is a team of people that curates the published mods to make\nsure they abide for the [documented policies](https://content.minetest.net/policy_and_guidance/).\n\nIf mods are available from ContentDB, one can use the command line tool `contentdb`\nthat I have developed to both add a new mod or to update existing ones. Please\ncheck the installation instructions here: https://github.com/ronoaldo/minetools#install-pre-compiled-binaries-on-linux.\n\n### Installing a new mod from ContentDB\n\nIt is as simple as running the `contentdb install` command. For instance, to install\nthe mod PA 28 from APercy, available at content.minetest.net/packages/**apercy/pa28**, use:\n\n    contentdb install apercy/pa28\n\nThe syntax is basically `author/modname` from the ContentDB API (same used in\nthe browser URL). The command **must be executed from the root folder of the project**.\n\n### Update mods from ContentDB\n\nSimilar to the [Installing a new mod from ContentDB](#installing-a-new-mod-from-contentdb)\npart, the tool can be used to update a mod:\n\n    contentdb install --update apercy/pa28\n\nThere is a convenience command in the tool that can be used to **update all at\nonce**:\n\n    contentdb update\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fronoaldo%2Fmercurio","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fronoaldo%2Fmercurio","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fronoaldo%2Fmercurio/lists"}