{"id":15105376,"url":"https://github.com/berttejeda/bert.minecraft","last_synced_at":"2026-02-08T00:01:44.982Z","repository":{"id":254864924,"uuid":"847786664","full_name":"berttejeda/bert.minecraft","owner":"berttejeda","description":"This repository contains resources for launching a minecraft server and a minecraft mods file host via docker.","archived":false,"fork":false,"pushed_at":"2024-08-26T15:51:08.000Z","size":3262,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-01-12T22:36:55.283Z","etag":null,"topics":["docker","docker-compose","gaming","linux","minecraft","minecraft-forge"],"latest_commit_sha":null,"homepage":"","language":null,"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/berttejeda.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}},"created_at":"2024-08-26T14:44:31.000Z","updated_at":"2025-03-25T03:05:02.000Z","dependencies_parsed_at":"2024-08-26T17:41:31.611Z","dependency_job_id":null,"html_url":"https://github.com/berttejeda/bert.minecraft","commit_stats":null,"previous_names":["berttejeda/bert.minecraft"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/berttejeda/bert.minecraft","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/berttejeda%2Fbert.minecraft","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/berttejeda%2Fbert.minecraft/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/berttejeda%2Fbert.minecraft/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/berttejeda%2Fbert.minecraft/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/berttejeda","download_url":"https://codeload.github.com/berttejeda/bert.minecraft/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/berttejeda%2Fbert.minecraft/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29213461,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-07T23:58:20.073Z","status":"ssl_error","status_checked_at":"2026-02-07T23:58:07.729Z","response_time":63,"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":["docker","docker-compose","gaming","linux","minecraft","minecraft-forge"],"created_at":"2024-09-25T20:23:46.430Z","updated_at":"2026-02-08T00:01:39.973Z","avatar_url":"https://github.com/berttejeda.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# Overview\n\nThis repository contains resources for launching a minecraft server\nand a minecraft mods file host via docker, specifically via `docker-compose`.\n\n# Docker\n\nMake sure you've installed docker on your host.\n\nSee [docker-compose.yaml](docker-compose.yaml) for the project setup.\n\n# Details - Hardware\n\n- Make/Model: Intel NUC 11 Business Mini PC\n- CPU: Intel Core i7-1165G7\n- Memory: 64GB RAM\n- Storage: 1TB SSD\n- OS: Ubuntu 24.04 LTS\n\n# Details - Minecraft\n\n- Minecraft client: [SKLauncher](https://skmedix.pl/)\n- Minecraft version: 1.20.6\n- Forge version: 1.20.6\n- List of MODS:\n  - BiomesOPlenty-forge-1.20.6-18.4.0.8.jar\n  - skinlayers3d-forge-1.6.6-mc1.20.6-all.jar\n  - journeymap-1.20.6-5.10.0-forge.jar\n  - TerraBlender-forge-1.20.6-3.5.0.5.jar\n  - GlitchCore-forge-1.20.6-1.1.0.10.jar\n\n# Mods\n\n- The list of mods enabled on the server can be found in [mods.txt](mods.txt)\n- Take note of the http paths:\n  - These match the [mods](mods) directory structure\n  - The `minecraft-mods-server` containers serves these up to the `minecraft-server`, see [docker-compose.yaml](docker-compose.yaml)\n- For the mods to work, you'll need to download them via CurseForge or through some other means (use Google)\n- To download the terrablender mod, for example, you'd follow the below steps:\n  1. Navigate to https://www.curseforge.com/minecraft/mc-mods/terrablender\n  1. Click 'View all' next to 'Game Versions'\n  1. Download the version of the mod compatible with minecraft version 1.20.6\n  1. Copy the mod to the [mods](mods) directory\n\nNote: You will also need to copy these same mods to your minecraft client mods folder.\n\nWe'll cover that in the next sections.\n\n# Launching the server\n\n1. Ensure you have all the mods in place, as per [mods.txt](mods.txt)\u003cbr /\u003e\n   Again, these should be copied to the [mods](mods) directory\n1. Launch the servers via docker-compose with `docker-compose up -d`\n1. Follow logs `docker-compose logs -f --tail=20`\n\n# Launching the client \u0026 copying in the mods\n\nBy this point you should already have done the following:\n\n1. Downloaded your minecraft client, e.g. [SKLauncher](https://skmedix.pl/)\n1. Downloaded any applicable mods\n\nUpon first launch of your client, your local minecraft profile directory should have been created.\n\nAt this point, you should be able to copy your mods to the minecraft profile's mods directory.\n\n- On OSX, this should be `~/Library/Application Support/minecraft/mods`\n- On Windows, this should be `%APPDATA%\\.minecraft\\mods`\n\nYou can create any of these folder's if they don't already exist.\n\n# Launching the client \u0026 Connecting to your Minecraft Server\n\nAt this point, you should be ready to connect to your minecraft server.\n\n## Login via Offline Mode\n\nEnsure you login via 'offline mode', as illustrated:\n\n![](assets/client_login.png)\n\nEnter in a username of your choice, as there are no server-side user restrictions in place.\n\n## Add an installation \u0026 configure forge settings\n\nOnce you've logged in, you'll need to add an installation and configure it to use forge, as illustrated:\n\n1. Click the `+` next to _Installations Manager_\u003cbr /\u003e\n   ![](assets/installation_manager_add.png)\n1. From the installation details view, ensure you select Forge version 1.20.6\u003cbr /\u003e\n   ![](assets/installation_manager_forge.png)\n\n## Launch installation and connect to server\n\nAt this point, you're ready to play and connect!\n\nFollow the illusration below:\n\n![](assets/installation_join.png)\n\n# Troubleshooting\n\nThe scenarios in the next sections are what I've encountered so far.\n\n## Sever Error - Minecraft server is stuck during the forge installer phase\n\nScenario:\n\n  - Minecraft server fails to start\n  - Upon viewing the logs with `docker-compose logs`, you see something similar to the below:\u003cbr /\u003e\n  ```bash\n  minecraft-server ... Downloading Forge installer 50.1.0 for Minecraft 1.20.6\n  minecraft-server ... Running Forge 50.1.0 installer for Minecraft 1.20.6. This might take a while...\n  ```\n\nPossible Cause:\n\n  - The server process is unable to write to tis `/data` directory\n\nTroubleshooting Steps:\n\n  - Check the container logs for entries similar to `Permission Denied`\n  - If you're using a volume mount for the server's data path, ensure the container has enough permissions to write to it\n\n## Server Error - Minecraft server fails to start\n\nScenario:\n\n  - Minecraft server fails to start\n  - Upon viewing the logs with `docker-compose logs`, you see something similar to the below:\u003cbr /\u003e\n  ```bash\n  minecraft-server ... ERROR : 'mcopy' command failed. Version is 1.39.10\n  minecraft-server ... me.itzg.helpers.http.FailedRequestException: HTTP request of http://minecraft-mods-server/1.20.6/TerraBlender-forge-1.20.6-3.5.0.5.jar failed with 404 Not Found: Extracting filename\n  ```\n\nPossible Cause:\n\n  - You haven't copied the list of mods referenced in [mods.txt](mods.txt) to your [mods/1.20.6][mods/1.20.6] directory _before_ starting this `docker-compose` project\n  - The mods file host container does not have sufficient permissions to the directory in which the mods are stored\n\nTroubleshooting Steps:\n\n  - Make sure you've downloaded any mods referenced in [mods.txt](mods.txt) and placed them in the appropriate local directory\n  - Ensure all containers have enough permissions to write to their respective data directories  \n\n## Client Error - Mismatched Mod Channel List\n\nScenario:\n\n  - Upon attempting to join the Minecraft sever, your client displays the following error:\u003cbr /\u003e\n    ![](assets/error_mismatched_mod_channel_list.png)\n\nPossible Cause:\n\n  - You haven't copied the list of mods referenced in [mods.txt](mods.txt) to your minecraft profile's mods directory\n\n    - On OSX, this should be `~/Library/Application Support/minecraft/mods`\n    - On Windows, this should be `%APPDATA%\\.minecraft\\mods` \n\nTroubleshooting Steps:\n\n  - Make sure you've downloaded any mods referenced in [mods.txt](mods.txt) and placed them in the minecraft profile's mods directory\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fberttejeda%2Fbert.minecraft","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fberttejeda%2Fbert.minecraft","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fberttejeda%2Fbert.minecraft/lists"}